Mercurial > hg
view mercurial/thirdparty/cbor/README.rst @ 37126:4bd73a955ab0
thirdparty: vendor cbor2 python library
CBOR stands for Concise Binary Object Representation, which is a data format
which is very compact and extensible.
This patch moves the python library which can serilaize and deserialize python
objects to/from cbor formats. The library is taken from
https://github.com/agronholm/cbor2/ from commit
84181540f6eb650437e3f73cd104a65661fe8e67.
Unrequired files from the cbor library - docs/, tests/, setup.py, setup.cfg,
and tox.ini - have not been vendored.
There is another python library for cbor at
https://github.com/brianolson/cbor_py/ which is used in evolve extension and was
imported in initial version of this series. That library though contains C code
and is bit faster, but has known bugs around serializing nested structures, is
unmaintained, raises an Exception object instead of a more dedicated Error type.
So, it's better to use a bug free and actively maintained library.
This library is not yet used and will be used in later commits.
# no-check-commit because we are importing a third library module
Differential Revision: https://phab.mercurial-scm.org/D2750
author | Pulkit Goyal <7895pulkit@gmail.com> |
---|---|
date | Mon, 26 Mar 2018 08:33:57 -0700 |
parents | |
children |
line wrap: on
line source
.. image:: https://travis-ci.org/agronholm/cbor2.svg?branch=master :target: https://travis-ci.org/agronholm/cbor2 :alt: Build Status .. image:: https://coveralls.io/repos/github/agronholm/cbor2/badge.svg?branch=master :target: https://coveralls.io/github/agronholm/cbor2?branch=master :alt: Code Coverage This library provides encoding and decoding for the Concise Binary Object Representation (CBOR) (`RFC 7049`_) serialization format. There exists another Python CBOR implementation (cbor) which is faster on CPython due to its C extensions. On PyPy, cbor2 and cbor are almost identical in performance. The other implementation also lacks documentation and a comprehensive test suite, does not support most standard extension tags and is known to crash (segfault) when passed a cyclic structure (say, a list containing itself). .. _RFC 7049: https://tools.ietf.org/html/rfc7049 Project links ------------- * `Documentation <http://cbor2.readthedocs.org/>`_ * `Source code <https://github.com/agronholm/cbor2>`_ * `Issue tracker <https://github.com/agronholm/cbor2/issues>`_