Avsc
NOTE:
This is a clone of mtth/avsc repo.
The reason we have a separate repo is because CDAP supports avro-based schemas which has subtle changes (relaxed rules)
- Map can support complex types
- Names can have
-
(hyphens).
So this repo adds those rules to the parser
Pure JavaScript implementation of the Avro specification.
Features
- Blazingly fast and compact serialization! Typically faster than JSON with much smaller encodings.
- All the Avro goodness and more: type inference, schema evolution, and remote procedure calls.
- Support for serializing arbitrary JavaScript objects.
- Unopinionated 64-bit integer compatibility.
Installation
$ npm install cdap-avsc
avsc
is compatible with all versions of node.js since 0.11
and major
browsers via browserify (see the full compatibility table
here). For convenience, you can also find compiled
distributions with the releases (but please host your own copy).
Documentation
Examples
Inside a node.js module, or using browserify:
const avro = ;
-
Encode and decode values from a known schema:
const type = avro;const buf = type; // Encoded buffer.const val = type; // {kind: 'CAT', name: 'Albert'} -
Infer a value's type and encode similar values:
const val = city: 'Cambridge' zipCodes: '02138' '02139' visits: 2;const type = avro;// We can now encode the value:const buf = type;// And also any values with a matching structure:const bufs =typetype; -
Get a readable stream of decoded values from an Avro container file:
avro; -
Implement a TCP server for an IDL-defined protocol:
avro;