Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/gruns/orderedmultidict
📚 Ordered Multivalue Dictionary. Helps power furl.
https://github.com/gruns/orderedmultidict
Last synced: 17 days ago
JSON representation
📚 Ordered Multivalue Dictionary. Helps power furl.
- Host: GitHub
- URL: https://github.com/gruns/orderedmultidict
- Owner: gruns
- License: other
- Created: 2012-01-04T04:37:01.000Z (almost 13 years ago)
- Default Branch: master
- Last Pushed: 2022-03-15T23:08:26.000Z (over 2 years ago)
- Last Synced: 2024-10-17T15:39:30.974Z (27 days ago)
- Language: Python
- Homepage:
- Size: 181 KB
- Stars: 66
- Watchers: 10
- Forks: 13
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
orderedmultidict
### omdict is an ordered multivalue dictionary that retains
method parity with Python's [dict](http://docs.python.org/library/stdtypes.html#dict) and helps power [furl](https://github.com/gruns/furl).
A multivalue dictionary is a dictionary that can store multiple values per\
key. An ordered multivalue dictionary is a multivalue dictionary that\
retains the order of insertions and deletions.
orderedmultidict is well tested, [Unlicensed](http://unlicense.org/) in the public domain,\
supports Python 2, Python 3, PyPy2, and PyPy3.
Code time: omdict can store multiple values per key.
```python
>>> from orderedmultidict import omdict
>>> omd = omdict()
>>> omd[1] = 1
>>> omd[1]
1
>>> omd.add(1, 11)
>>> omd.getlist(1)
[1, 11]
>>> omd.addlist(1, [111, 1111])
>>> omd.getlist(1)
[1, 11, 111, 1111]
>>> omd.allitems()
[(1, 1), (1, 11), (1, 111), (1, 1111)]
```
omdict retains insertion and deletion order.
```python
>>> omd = omdict()
>>> omd[2] = 2
>>> omd[1] = 1
>>> omd.items()
[(2, 2), (1, 1)]
>>> omd[2] = 'sup'
>>> omd.items()
[(2, 'sup'), (1, 1)]
```
Method parity with dict is retained; omdict can be a drop-in replacement.
```python
>>> d, omd = dict(), omdict()
>>> d.update([(1,1), (1,11), (2,2), (2,22)])
>>> omd.update([(1,1), (1,11), (2,2), (2,22)])
>>> d[1], omd[1]
(11, 11)
>>> d[3] = 3
>>> omd[3] = 3
>>> d.get(3), omd.get(3)
(3, 3)
>>> d.items() == omd.items()
True
```
### API
See all of omdict's methods, with examples, in omdict's API document,\
[API.md](https://github.com/gruns/orderedmultidict/blob/master/API.md).
### Installation
Installing orderedmultidict with pip is easy.
```
$ pip install orderedmultidict
```