diff options
author | jnothman <jnothman@student.usyd.edu.au> | 2012-12-07 00:53:17 +1100 |
---|---|---|
committer | jnothman <jnothman@student.usyd.edu.au> | 2012-12-07 00:53:17 +1100 |
commit | edd2e52373246c7d55ee59bf3bd46cda60e3be6d (patch) | |
tree | 7b25f27e62853c210bd0c5b5235830e773c89889 | |
parent | 15f309c0b197abe86e94fb3840ff8979b35c7e0c (diff) | |
download | msgpack-python-edd2e52373246c7d55ee59bf3bd46cda60e3be6d.tar.gz |
Fix README re default use_list=True
-rw-r--r-- | README.rst | 15 |
1 files changed, 7 insertions, 8 deletions
@@ -29,21 +29,20 @@ msgpack provides ``dumps`` and ``loads`` as alias for compatibility with ``pack`` and ``dump`` packs to file-like object. ``unpack`` and ``load`` unpacks from file-like object. +:: + >>> import msgpack >>> msgpack.packb([1, 2, 3]) '\x93\x01\x02\x03' >>> msgpack.unpackb(_) - (1, 2, 3) - + [1, 2, 3] -``unpack`` unpacks msgpack's array to Python's tuple. -To unpack it to list, Use ``use_list`` option. +``unpack`` unpacks msgpack's array to Python's list, but can unpack to tuple:: - >>> msgpack.unpackb(b'\x93\x01\x02\x03', use_list=True) - [1, 2, 3] + >>> msgpack.unpackb(b'\x93\x01\x02\x03', use_list=False) + (1, 2, 3) -The default behavior will be changed in the future. (probably 0.4) -You should always pass the ``use_list`` keyword argument. +You should always pass the ``use_list`` keyword argument. See performance issues relating to use_list_ below. Read the docstring for other options. |