avro-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Wyatt Andersen (JIRA)" <j...@apache.org>
Subject [jira] [Updated] (AVRO-2001) Add support for doc in the Ruby library for Avro schemas
Date Fri, 24 Feb 2017 15:50:44 GMT

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

Wyatt Andersen updated AVRO-2001:
---------------------------------
    Description: 
The Avro schema and protocol specification(http://avro.apache.org/docs/current/spec.html)
allows for an optional attribute "doc" defined as, "a JSON string describing this field for
users." Users should be able to include a doc with each field for "records" (http://avro.apache.org/docs/current/spec.html#N10085)
and "enums" (http://avro.apache.org/docs/current/spec.html#N10186).

This doc attribute should be stripped when transforming into "Parsing Canonical Form" (http://avro.apache.org/docs/current/spec.html#N10815).

Currently, the Ruby Avro library (https://github.com/apache/avro/tree/master/lang/ruby) does
not support doc. It is supported in other languages libraries, for example PHP (https://github.com/apache/avro/blob/master/lang/php/lib/avro/schema.php#L46).

Not supporting doc in Ruby causes confusion for the end user, and prevents that end use from
taking advantage of a useful tool for managing complex schema. 

doc should be supported for schema and protocols in the Apache Ruby Avro library.

Possible implementation: https://github.com/lostphilosopher/avro/tree/avro_2001 based on https://github.com/apache/avro/pull/14/commits/164fb49f80dfaac421639e6249a6f92c802a50b6.


  was:
The Avro schema and protocol specification(http://avro.apache.org/docs/current/spec.html)
allows for an optional attribute "doc" defined as, "a JSON string describing this field for
users." Users should be able to include a doc with each field for "records" (http://avro.apache.org/docs/current/spec.html#N10085)
and "enums" (http://avro.apache.org/docs/current/spec.html#N10186).

This doc attribute should be stripped when transforming into "Parsing Canonical Form" (http://avro.apache.org/docs/current/spec.html#N10815).

Currently, the Ruby Avro library (https://github.com/apache/avro/tree/master/lang/ruby) does
not support doc. It is supported in other languages libraries, for example PHP (https://github.com/apache/avro/blob/master/lang/php/lib/avro/schema.php#L46).

Not supporting doc in Ruby causes confusion for the end user, and prevents that end use from
taking advantage of a useful tool for managing complex schema. 

doc should be supported for schema and protocols in the Apache Ruby Avro library.

Possible implementation: https://github.com/lostphilosopher/avro based on https://github.com/apache/avro/pull/14/commits/164fb49f80dfaac421639e6249a6f92c802a50b6.



> Add support for doc in the Ruby library for Avro schemas
> --------------------------------------------------------
>
>                 Key: AVRO-2001
>                 URL: https://issues.apache.org/jira/browse/AVRO-2001
>             Project: Avro
>          Issue Type: New Feature
>          Components: ruby
>            Reporter: Wyatt Andersen
>            Priority: Minor
>              Labels: features
>
> The Avro schema and protocol specification(http://avro.apache.org/docs/current/spec.html)
allows for an optional attribute "doc" defined as, "a JSON string describing this field for
users." Users should be able to include a doc with each field for "records" (http://avro.apache.org/docs/current/spec.html#N10085)
and "enums" (http://avro.apache.org/docs/current/spec.html#N10186).
> This doc attribute should be stripped when transforming into "Parsing Canonical Form"
(http://avro.apache.org/docs/current/spec.html#N10815).
> Currently, the Ruby Avro library (https://github.com/apache/avro/tree/master/lang/ruby)
does not support doc. It is supported in other languages libraries, for example PHP (https://github.com/apache/avro/blob/master/lang/php/lib/avro/schema.php#L46).
> Not supporting doc in Ruby causes confusion for the end user, and prevents that end use
from taking advantage of a useful tool for managing complex schema. 
> doc should be supported for schema and protocols in the Apache Ruby Avro library.
> Possible implementation: https://github.com/lostphilosopher/avro/tree/avro_2001 based
on https://github.com/apache/avro/pull/14/commits/164fb49f80dfaac421639e6249a6f92c802a50b6.



--
This message was sent by Atlassian JIRA
(v6.3.15#6346)

Mime
View raw message