File: index.rst

package info (click to toggle)
python-immutabledict 4.2.2-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 248 kB
  • sloc: python: 359; makefile: 30
file content (32 lines) | stat: -rw-r--r-- 961 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
Welcome to immutabledict’s documentation!
=========================================

This site covers immutabledict’s API documentation for version |release|. For more information about immutabledict, see `the Github repository <https://github.com/corenting/immutabledict>`_.

Usage
-----

The :class:`.immutabledict`  class can be used as a drop-in replacement for :class:`dict`.

For replacing an :class:`collections.OrderedDict`, you can use an :class:`.ImmutableOrderedDict`. The API is the same as :class:`.immutabledict`, but it will use an :class:`collections.OrderedDict` under the hood.

.. code-block:: python

   from immutabledict import immutabledict

   my_item = immutabledict({"a": "value", "b": "other_value"})
   print(my_item["a"]) # Print "value"

Some additional methods are provided, see the API reference.


API reference
-------------

.. toctree::
   :maxdepth: 1

   /api/immutabledict
   /api/immutable_ordered_dict
   changelog