[jira] Commented: (AVRO-52) Need a usage/lifecycle test to explain the python API

["Doug Cutting (JIRA)" <ji...@apache.org>]

    [ https://issues.apache.org/jira/browse/AVRO-52?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12731192#action_12731192 ] 

Doug Cutting commented on AVRO-52:
----------------------------------

What should we do with this?  Perhaps we should have an examples/ tree that contains runnable code, that we can run from unit tests.  We could also link to it from the documentation.  Thoughts?

> Need a usage/lifecycle test to explain the python API
> -----------------------------------------------------
>
>                 Key: AVRO-52
>                 URL: https://issues.apache.org/jira/browse/AVRO-52
>             Project: Avro
>          Issue Type: Test
>          Components: python
>            Reporter: Philip Zeyliger
>         Attachments: AVRO-52.patch
>
>
> AVRO/python will eventually need something analogous to http://wiki.apache.org/thrift/ThriftUsagePython, the Thrift Lightning talk at http://x1024.net/blog/, or  http://code.google.com/apis/protocolbuffers/docs/pythontutorial.html .  While the API is still being developed, however, it may make sense to simply have a unit test that illustrates reasonable usage of the APIs.  This can also serve as a place that users look at to learn the APIs and comment on their friendliness and pythonicity.

-- 
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.