Stowage/msgpack-python
2
0
Fork 0
mirror of https://github.com/msgpack/msgpack-python.git synced 2025-10-19 20:03:16 +00:00
Code Issues Projects Releases Packages Wiki Activity

Merge pull request #35 from jnothman/patch-1

Browse source 
Fix README re default use_list=True
This commit is contained in:
INADA Naoki 2012-12-06 18:23:04 -08:00
commit f8d7dea762
1 changed files with 8 additions and 9 deletions
Download patch file Download diff file Expand all files Collapse all files

17
README.rst
View file

@ -29,21 +29,20 @@ msgpack provides ``dumps`` and ``loads`` as alias for compatibility with
``pack`` and ``dump`` packs to file-like object. ``pack`` and ``dump`` packs to file-like object.
``unpack`` and ``load`` unpacks from file-like object. ``unpack`` and ``load`` unpacks from file-like object.
::
>>> import msgpack >>> import msgpack
>>> msgpack.packb([1, 2, 3]) >>> msgpack.packb([1, 2, 3])
'\x93\x01\x02\x03' '\x93\x01\x02\x03'
>>> msgpack.unpackb(_) >>> msgpack.unpackb(_)
(1, 2, 3)
``unpack`` unpacks msgpack's array to Python's tuple.
To unpack it to list, Use ``use_list`` option.
>>> msgpack.unpackb(b'\x93\x01\x02\x03', use_list=True)
[1, 2, 3] [1, 2, 3]
The default behavior will be changed in the future. (probably 0.4) ``unpack`` unpacks msgpack's array to Python's list, but can unpack to tuple::
You should always pass the ``use_list`` keyword argument.
>>> msgpack.unpackb(b'\x93\x01\x02\x03', use_list=False)
(1, 2, 3)
You should always pass the ``use_list`` keyword argument. See performance issues relating to use_list_ below.
Read the docstring for other options. Read the docstring for other options.