[jira] [Updated] (AVRO-2653) Update Apache Avro documentation

2019-12-11 Thread Loo Zheng Yuan (Jira)


 [ 
https://issues.apache.org/jira/browse/AVRO-2653?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
 ]

Loo Zheng Yuan updated AVRO-2653:
-
Description: 
I recently started exploring Avro files using the python library and was met 
with many obstacles. I later found that it was because the Python 
[documentation|https://avro.apache.org/docs/current/gettingstartedpython.html] 
was outdated, but AVRO-2441 already addressed this and merged to `master` since 
4 Jul (5 months ago from time of writing). Unfortunately, till now the changes 
are still not visible on the website. Not that it matters for me, but I think 
it will help others a lot if they're literally getting started on Avro with 
Python.

I noted that version 1.9.1 was released on 2 Sep but the website documentations 
were not updated. Was wondering when is earliest we can have the changes 
reflect on the doc site?
 Thank you!

  was:
I recently started exploring Avro files using the python library and was met 
with many obstacles. I later found that it was that the 
[documentation|https://avro.apache.org/docs/current/gettingstartedpython.html] 
on Python was outdated, but a AVRO-2441 already addressed this and merged in 
since 4 Jul (5 months ago from time of writing). Unfortunately, till now the 
changes are still not visible on the website.

I noted that version 1.9.1 was released on 2 Sep but the website documentations 
were not updated. Was wondering when is earliest we can have the changes 
reflect on the doc site?
Thank you!


> Update Apache Avro documentation
> 
>
> Key: AVRO-2653
> URL: https://issues.apache.org/jira/browse/AVRO-2653
> Project: Apache Avro
>  Issue Type: Task
>Reporter: Loo Zheng Yuan
>Priority: Major
>
> I recently started exploring Avro files using the python library and was met 
> with many obstacles. I later found that it was because the Python 
> [documentation|https://avro.apache.org/docs/current/gettingstartedpython.html]
>  was outdated, but AVRO-2441 already addressed this and merged to `master` 
> since 4 Jul (5 months ago from time of writing). Unfortunately, till now the 
> changes are still not visible on the website. Not that it matters for me, but 
> I think it will help others a lot if they're literally getting started on 
> Avro with Python.
> I noted that version 1.9.1 was released on 2 Sep but the website 
> documentations were not updated. Was wondering when is earliest we can have 
> the changes reflect on the doc site?
>  Thank you!



--
This message was sent by Atlassian Jira
(v8.3.4#803005)


[jira] [Created] (AVRO-2653) Update Apache Avro documentation

2019-12-11 Thread Loo Zheng Yuan (Jira)
Loo Zheng Yuan created AVRO-2653:


 Summary: Update Apache Avro documentation
 Key: AVRO-2653
 URL: https://issues.apache.org/jira/browse/AVRO-2653
 Project: Apache Avro
  Issue Type: Task
Reporter: Loo Zheng Yuan


I recently started exploring Avro files using the python library and was met 
with many obstacles. I later found that it was that the 
[documentation|https://avro.apache.org/docs/current/gettingstartedpython.html] 
on Python was outdated, but a AVRO-2441 already addressed this and merged in 
since 4 Jul (5 months ago from time of writing). Unfortunately, till now the 
changes are still not visible on the website.

I noted that version 1.9.1 was released on 2 Sep but the website documentations 
were not updated. Was wondering when is earliest we can have the changes 
reflect on the doc site?
Thank you!



--
This message was sent by Atlassian Jira
(v8.3.4#803005)


[jira] [Commented] (AVRO-831) Enhance the Python `distutils` control file `setup.py` to build Avro/Python without a pre-processing step.

2019-12-11 Thread Ryan Skraba (Jira)


[ 
https://issues.apache.org/jira/browse/AVRO-831?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=16993545#comment-16993545
 ] 

Ryan Skraba commented on AVRO-831:
--

Thanks so much [~kojiromike].  I wanted to point out a super side effect of 
this work:  the {{lang/py}} avro module can be imported into intellij (also 
probably PyCharm) via "Create project from an existing source" without any 
extra steps.  In the past, I had to fiddle with some module settings, so this 
is pretty nice!




> Enhance the Python `distutils` control file `setup.py` to build Avro/Python 
> without a pre-processing step.
> --
>
> Key: AVRO-831
> URL: https://issues.apache.org/jira/browse/AVRO-831
> Project: Apache Avro
>  Issue Type: Improvement
>  Components: python
> Environment: Operating environments supporting the Python programming 
> language.
>Reporter: Joseph Koshy
>Assignee: Michael A. Smith
>Priority: Major
>  Labels: build, python
> Fix For: 1.10.0
>
> Attachments: setup.patch
>
>   Original Estimate: 4h
>  Remaining Estimate: 4h
>
> Avro's build process for its Python bindings currently needs a set of 
> pre-processing steps that need to be executed before the build proper is 
> started.  These pre-processing steps are executed by {{ant}}.
> The attached patch folds these pre-processing steps into the {{setup.py}} 
> control script that is input to Python's {{distutils}} build tool kit.  This 
> eliminates the dependency on {{ant}}.
> In the patch:
> * Source files that need keyword expansion are renamed to use a {{.in}} 
> extension.  The build process will generate the appropriately transformed 
> {{.py}} files from these {{.in}} files.
> * {{setup.py}} supports a new command {{make_interop_data}}, used to generate 
> test data for use with interoperability test code.



--
This message was sent by Atlassian Jira
(v8.3.4#803005)