diff options
| -rw-r--r-- | .gitignore | 1 | ||||
| -rw-r--r-- | python-diot.spec | 643 | ||||
| -rw-r--r-- | sources | 1 |
3 files changed, 645 insertions, 0 deletions
@@ -0,0 +1 @@ +/diot-0.1.7.tar.gz diff --git a/python-diot.spec b/python-diot.spec new file mode 100644 index 0000000..560c3a7 --- /dev/null +++ b/python-diot.spec @@ -0,0 +1,643 @@ +%global _empty_manifest_terminate_build 0 +Name: python-diot +Version: 0.1.7 +Release: 1 +Summary: Python dictionary with dot notation. +License: MIT +URL: https://github.com/pwwang/diot +Source0: https://mirrors.nju.edu.cn/pypi/web/packages/87/7f/40656b06ec804e205de5c7b1c4f917d64bef6a173e9e02496a67e6ce1118/diot-0.1.7.tar.gz +BuildArch: noarch + +Requires: python3-inflection + +%description + + +[![pypi][1]][2] [![tag][3]][4] [![codacy quality][7]][8] [![coverage][9]][8] ![pyver][10] ![building][6] ![docs][5] + +Python dictionary with dot notation (A re-implementation of [python-box](https://github.com/cdgriffith/Box) with some issues fixed and simplified) + +```python +from diot import Diot + +movie_data = { + "movies": { + "Spaceballs": { + "imdb stars": 7.1, + "rating": "PG", + "length": 96, + "director": "Mel Brooks", + "stars": [{"name": "Mel Brooks", "imdb": "nm0000316", "role": "President Skroob"}, + {"name": "John Candy","imdb": "nm0001006", "role": "Barf"}, + {"name": "Rick Moranis", "imdb": "nm0001548", "role": "Dark Helmet"} + ] + }, + "Robin Hood: Men in Tights": { + "imdb stars": 6.7, + "rating": "PG-13", + "length": 104, + "director": "Mel Brooks", + "stars": [ + {"name": "Cary Elwes", "imdb": "nm0000144", "role": "Robin Hood"}, + {"name": "Richard Lewis", "imdb": "nm0507659", "role": "Prince John"}, + {"name": "Roger Rees", "imdb": "nm0715953", "role": "Sheriff of Rottingham"}, + {"name": "Amy Yasbeck", "imdb": "nm0001865", "role": "Marian"} + ] + } + } +} + +# Box is a conversion_box by default, pass in `conversion_box=False` to disable that behavior +# Explicitly tell Diot to convert dict/list inside +movie_diot = Diot(movie_data) + +movie_diot.movies.Robin_Hood_Men_in_Tights.imdb_stars +# 6.7 + +movie_diot.movies.Spaceballs.stars[0].name +# 'Mel Brooks' + +# Different as box, you have to use Diot for new data in a list +movie_diot.movies.Spaceballs.stars.append( + Diot({"name": "Bill Pullman", "imdb": "nm0000597", "role": "Lone Starr"})) +movie_diot.movies.Spaceballs.stars[-1].role +# 'Lone Starr' +``` + +## Install +```shell +pip install -U diot +``` + +## API + +https://pwwang.github.io/diot/api/diot/ + + +## Usage + +### Diot + +Instantiated the same ways as `dict` +```python +Diot({'data': 2, 'count': 5}) +Diot(data=2, count=5) +Diot({'data': 2, 'count': 1}, count=5) +Diot([('data', 2), ('count', 5)]) + +# All will create +# Diot([('data', 2), ('count', 5)], diot_nest = True, diot_transform = 'safe') +``` + +Same as `python-box`, `Diot` is a subclass of dict which overrides some base functionality to make sure everything stored in the dict can be accessed as an attribute or key value. + +```python +diot = Diot({'data': 2, 'count': 5}) +diot.data == diot['data'] == getattr(diot, 'data') +``` + +By default, diot uses a safe transformation to transform keys into safe names that can be accessed by `diot.xxx` +```python +dt = Diot({"321 Is a terrible Key!": "yes, really"}) +dt._321_Is_a_terrible_Key_ +# 'yes, really' +``` + +Different as `python-box`, duplicate attributes are not allowed. +```python +dt = Diot({"!bad!key!": "yes, really", ".bad.key.": "no doubt"}) +# KeyError +``` + +Use different transform functions: + +```python +dt = Diot(oneTwo = 12, diot_transform = 'snake_case') +# or use alias: +# dt = SnakeDiot(oneTwo = 12) +dt.one_two == dt['one_two'] == dt['oneTwo'] == 12 + +dt = Diot(one_two = 12, diot_transform = 'camel_case') +# or use alias: +# dt = CamelDiot(one_two = 12) +dt.oneTwo == dt['one_two'] == dt['oneTwo'] == 12 + +dt = Diot(one_two = 12, diot_transform = 'upper') +dt.ONE_TWO == dt['one_two'] == dt['ONETWO'] == 12 + +dt = Diot(ONE_TWO = 12, diot_transform = 'lower') +dt.one_two == dt['ONE_TWO'] == dt['one_two'] == 12 +``` + +Use your own transform function: + +```python +import inflection + +dt = Diot(post = 10, diot_transform = inflection.pluralize) +dt.posts == dt['posts'] == dt['post'] == 10 +``` + +### OrderedDiot +```python +diot_of_order = OrderedDiot() +diot_of_order.c = 1 +diot_of_order.a = 2 +diot_of_order.d = 3 + +list(diot_of_order.keys()) == ['c', 'a', 'd'] + +# insertion allowed for OrderedDiot +od = OrderedDiot() +od.insert(0, "c", "d") +od.insert(None, "x", "y") +od.insert_before('c', "e", "f") +od.insert_after("a", ("g", "h")) + +od2 = OrderedDiot() +od2.a1 = 'b1' +od2.c1 = 'd1' +od.insert(-1, od2) + +od3 = OrderedDiot() +od3.a2 = 'b2' +od3.c2 = 'd2' +od.insert_before('c', od3) +``` + +### FrozenDiot + +```python +fd = FrozenDiot(a=1, b=3) +fd.c = 3 # DiotFrozenError +with fd.thaw(): + fd.c = 3 +fd.c == 3 +``` + +### Missing key handler + +```python +d = Diot(a=1, b=2, diot_missing=ValueError) +d['c'] # ValueError +d.c # AttributeError from ValueError + +d = Diot(a=1, b=2, diot_missing=ValueError("Custom message")) + +d = Diot(a=1, b=2, diot_missing=None) +# d.c is None + +d = Diot(a=1, b=2, diot_missing=lambda key, diot: diot.a + diot.b) +# d.c == 3 +``` + +[1]: https://img.shields.io/pypi/v/diot?style=flat-square +[2]: https://pypi.org/project/diot/ +[3]: https://img.shields.io/github/tag/pwwang/diot?style=flat-square +[4]: https://github.com/pwwang/diot +[5]: https://img.shields.io/github/actions/workflow/status/pwwang/diot/docs.yml?label=docs&style=flat-square +[6]: https://img.shields.io/github/actions/workflow/status/pwwang/diot/build.yml?style=flat-square +[7]: https://img.shields.io/codacy/grade/738e49b9cc1745c4ae6a7bb3b198cc3d?style=flat-square +[8]: https://app.codacy.com/gh/pwwang/diot/dashboard +[9]: https://img.shields.io/codacy/coverage/738e49b9cc1745c4ae6a7bb3b198cc3d?style=flat-square +[10]: https://img.shields.io/pypi/pyversions/diot?style=flat-square + + +%package -n python3-diot +Summary: Python dictionary with dot notation. +Provides: python-diot +BuildRequires: python3-devel +BuildRequires: python3-setuptools +BuildRequires: python3-pip +%description -n python3-diot + + +[![pypi][1]][2] [![tag][3]][4] [![codacy quality][7]][8] [![coverage][9]][8] ![pyver][10] ![building][6] ![docs][5] + +Python dictionary with dot notation (A re-implementation of [python-box](https://github.com/cdgriffith/Box) with some issues fixed and simplified) + +```python +from diot import Diot + +movie_data = { + "movies": { + "Spaceballs": { + "imdb stars": 7.1, + "rating": "PG", + "length": 96, + "director": "Mel Brooks", + "stars": [{"name": "Mel Brooks", "imdb": "nm0000316", "role": "President Skroob"}, + {"name": "John Candy","imdb": "nm0001006", "role": "Barf"}, + {"name": "Rick Moranis", "imdb": "nm0001548", "role": "Dark Helmet"} + ] + }, + "Robin Hood: Men in Tights": { + "imdb stars": 6.7, + "rating": "PG-13", + "length": 104, + "director": "Mel Brooks", + "stars": [ + {"name": "Cary Elwes", "imdb": "nm0000144", "role": "Robin Hood"}, + {"name": "Richard Lewis", "imdb": "nm0507659", "role": "Prince John"}, + {"name": "Roger Rees", "imdb": "nm0715953", "role": "Sheriff of Rottingham"}, + {"name": "Amy Yasbeck", "imdb": "nm0001865", "role": "Marian"} + ] + } + } +} + +# Box is a conversion_box by default, pass in `conversion_box=False` to disable that behavior +# Explicitly tell Diot to convert dict/list inside +movie_diot = Diot(movie_data) + +movie_diot.movies.Robin_Hood_Men_in_Tights.imdb_stars +# 6.7 + +movie_diot.movies.Spaceballs.stars[0].name +# 'Mel Brooks' + +# Different as box, you have to use Diot for new data in a list +movie_diot.movies.Spaceballs.stars.append( + Diot({"name": "Bill Pullman", "imdb": "nm0000597", "role": "Lone Starr"})) +movie_diot.movies.Spaceballs.stars[-1].role +# 'Lone Starr' +``` + +## Install +```shell +pip install -U diot +``` + +## API + +https://pwwang.github.io/diot/api/diot/ + + +## Usage + +### Diot + +Instantiated the same ways as `dict` +```python +Diot({'data': 2, 'count': 5}) +Diot(data=2, count=5) +Diot({'data': 2, 'count': 1}, count=5) +Diot([('data', 2), ('count', 5)]) + +# All will create +# Diot([('data', 2), ('count', 5)], diot_nest = True, diot_transform = 'safe') +``` + +Same as `python-box`, `Diot` is a subclass of dict which overrides some base functionality to make sure everything stored in the dict can be accessed as an attribute or key value. + +```python +diot = Diot({'data': 2, 'count': 5}) +diot.data == diot['data'] == getattr(diot, 'data') +``` + +By default, diot uses a safe transformation to transform keys into safe names that can be accessed by `diot.xxx` +```python +dt = Diot({"321 Is a terrible Key!": "yes, really"}) +dt._321_Is_a_terrible_Key_ +# 'yes, really' +``` + +Different as `python-box`, duplicate attributes are not allowed. +```python +dt = Diot({"!bad!key!": "yes, really", ".bad.key.": "no doubt"}) +# KeyError +``` + +Use different transform functions: + +```python +dt = Diot(oneTwo = 12, diot_transform = 'snake_case') +# or use alias: +# dt = SnakeDiot(oneTwo = 12) +dt.one_two == dt['one_two'] == dt['oneTwo'] == 12 + +dt = Diot(one_two = 12, diot_transform = 'camel_case') +# or use alias: +# dt = CamelDiot(one_two = 12) +dt.oneTwo == dt['one_two'] == dt['oneTwo'] == 12 + +dt = Diot(one_two = 12, diot_transform = 'upper') +dt.ONE_TWO == dt['one_two'] == dt['ONETWO'] == 12 + +dt = Diot(ONE_TWO = 12, diot_transform = 'lower') +dt.one_two == dt['ONE_TWO'] == dt['one_two'] == 12 +``` + +Use your own transform function: + +```python +import inflection + +dt = Diot(post = 10, diot_transform = inflection.pluralize) +dt.posts == dt['posts'] == dt['post'] == 10 +``` + +### OrderedDiot +```python +diot_of_order = OrderedDiot() +diot_of_order.c = 1 +diot_of_order.a = 2 +diot_of_order.d = 3 + +list(diot_of_order.keys()) == ['c', 'a', 'd'] + +# insertion allowed for OrderedDiot +od = OrderedDiot() +od.insert(0, "c", "d") +od.insert(None, "x", "y") +od.insert_before('c', "e", "f") +od.insert_after("a", ("g", "h")) + +od2 = OrderedDiot() +od2.a1 = 'b1' +od2.c1 = 'd1' +od.insert(-1, od2) + +od3 = OrderedDiot() +od3.a2 = 'b2' +od3.c2 = 'd2' +od.insert_before('c', od3) +``` + +### FrozenDiot + +```python +fd = FrozenDiot(a=1, b=3) +fd.c = 3 # DiotFrozenError +with fd.thaw(): + fd.c = 3 +fd.c == 3 +``` + +### Missing key handler + +```python +d = Diot(a=1, b=2, diot_missing=ValueError) +d['c'] # ValueError +d.c # AttributeError from ValueError + +d = Diot(a=1, b=2, diot_missing=ValueError("Custom message")) + +d = Diot(a=1, b=2, diot_missing=None) +# d.c is None + +d = Diot(a=1, b=2, diot_missing=lambda key, diot: diot.a + diot.b) +# d.c == 3 +``` + +[1]: https://img.shields.io/pypi/v/diot?style=flat-square +[2]: https://pypi.org/project/diot/ +[3]: https://img.shields.io/github/tag/pwwang/diot?style=flat-square +[4]: https://github.com/pwwang/diot +[5]: https://img.shields.io/github/actions/workflow/status/pwwang/diot/docs.yml?label=docs&style=flat-square +[6]: https://img.shields.io/github/actions/workflow/status/pwwang/diot/build.yml?style=flat-square +[7]: https://img.shields.io/codacy/grade/738e49b9cc1745c4ae6a7bb3b198cc3d?style=flat-square +[8]: https://app.codacy.com/gh/pwwang/diot/dashboard +[9]: https://img.shields.io/codacy/coverage/738e49b9cc1745c4ae6a7bb3b198cc3d?style=flat-square +[10]: https://img.shields.io/pypi/pyversions/diot?style=flat-square + + +%package help +Summary: Development documents and examples for diot +Provides: python3-diot-doc +%description help + + +[![pypi][1]][2] [![tag][3]][4] [![codacy quality][7]][8] [![coverage][9]][8] ![pyver][10] ![building][6] ![docs][5] + +Python dictionary with dot notation (A re-implementation of [python-box](https://github.com/cdgriffith/Box) with some issues fixed and simplified) + +```python +from diot import Diot + +movie_data = { + "movies": { + "Spaceballs": { + "imdb stars": 7.1, + "rating": "PG", + "length": 96, + "director": "Mel Brooks", + "stars": [{"name": "Mel Brooks", "imdb": "nm0000316", "role": "President Skroob"}, + {"name": "John Candy","imdb": "nm0001006", "role": "Barf"}, + {"name": "Rick Moranis", "imdb": "nm0001548", "role": "Dark Helmet"} + ] + }, + "Robin Hood: Men in Tights": { + "imdb stars": 6.7, + "rating": "PG-13", + "length": 104, + "director": "Mel Brooks", + "stars": [ + {"name": "Cary Elwes", "imdb": "nm0000144", "role": "Robin Hood"}, + {"name": "Richard Lewis", "imdb": "nm0507659", "role": "Prince John"}, + {"name": "Roger Rees", "imdb": "nm0715953", "role": "Sheriff of Rottingham"}, + {"name": "Amy Yasbeck", "imdb": "nm0001865", "role": "Marian"} + ] + } + } +} + +# Box is a conversion_box by default, pass in `conversion_box=False` to disable that behavior +# Explicitly tell Diot to convert dict/list inside +movie_diot = Diot(movie_data) + +movie_diot.movies.Robin_Hood_Men_in_Tights.imdb_stars +# 6.7 + +movie_diot.movies.Spaceballs.stars[0].name +# 'Mel Brooks' + +# Different as box, you have to use Diot for new data in a list +movie_diot.movies.Spaceballs.stars.append( + Diot({"name": "Bill Pullman", "imdb": "nm0000597", "role": "Lone Starr"})) +movie_diot.movies.Spaceballs.stars[-1].role +# 'Lone Starr' +``` + +## Install +```shell +pip install -U diot +``` + +## API + +https://pwwang.github.io/diot/api/diot/ + + +## Usage + +### Diot + +Instantiated the same ways as `dict` +```python +Diot({'data': 2, 'count': 5}) +Diot(data=2, count=5) +Diot({'data': 2, 'count': 1}, count=5) +Diot([('data', 2), ('count', 5)]) + +# All will create +# Diot([('data', 2), ('count', 5)], diot_nest = True, diot_transform = 'safe') +``` + +Same as `python-box`, `Diot` is a subclass of dict which overrides some base functionality to make sure everything stored in the dict can be accessed as an attribute or key value. + +```python +diot = Diot({'data': 2, 'count': 5}) +diot.data == diot['data'] == getattr(diot, 'data') +``` + +By default, diot uses a safe transformation to transform keys into safe names that can be accessed by `diot.xxx` +```python +dt = Diot({"321 Is a terrible Key!": "yes, really"}) +dt._321_Is_a_terrible_Key_ +# 'yes, really' +``` + +Different as `python-box`, duplicate attributes are not allowed. +```python +dt = Diot({"!bad!key!": "yes, really", ".bad.key.": "no doubt"}) +# KeyError +``` + +Use different transform functions: + +```python +dt = Diot(oneTwo = 12, diot_transform = 'snake_case') +# or use alias: +# dt = SnakeDiot(oneTwo = 12) +dt.one_two == dt['one_two'] == dt['oneTwo'] == 12 + +dt = Diot(one_two = 12, diot_transform = 'camel_case') +# or use alias: +# dt = CamelDiot(one_two = 12) +dt.oneTwo == dt['one_two'] == dt['oneTwo'] == 12 + +dt = Diot(one_two = 12, diot_transform = 'upper') +dt.ONE_TWO == dt['one_two'] == dt['ONETWO'] == 12 + +dt = Diot(ONE_TWO = 12, diot_transform = 'lower') +dt.one_two == dt['ONE_TWO'] == dt['one_two'] == 12 +``` + +Use your own transform function: + +```python +import inflection + +dt = Diot(post = 10, diot_transform = inflection.pluralize) +dt.posts == dt['posts'] == dt['post'] == 10 +``` + +### OrderedDiot +```python +diot_of_order = OrderedDiot() +diot_of_order.c = 1 +diot_of_order.a = 2 +diot_of_order.d = 3 + +list(diot_of_order.keys()) == ['c', 'a', 'd'] + +# insertion allowed for OrderedDiot +od = OrderedDiot() +od.insert(0, "c", "d") +od.insert(None, "x", "y") +od.insert_before('c', "e", "f") +od.insert_after("a", ("g", "h")) + +od2 = OrderedDiot() +od2.a1 = 'b1' +od2.c1 = 'd1' +od.insert(-1, od2) + +od3 = OrderedDiot() +od3.a2 = 'b2' +od3.c2 = 'd2' +od.insert_before('c', od3) +``` + +### FrozenDiot + +```python +fd = FrozenDiot(a=1, b=3) +fd.c = 3 # DiotFrozenError +with fd.thaw(): + fd.c = 3 +fd.c == 3 +``` + +### Missing key handler + +```python +d = Diot(a=1, b=2, diot_missing=ValueError) +d['c'] # ValueError +d.c # AttributeError from ValueError + +d = Diot(a=1, b=2, diot_missing=ValueError("Custom message")) + +d = Diot(a=1, b=2, diot_missing=None) +# d.c is None + +d = Diot(a=1, b=2, diot_missing=lambda key, diot: diot.a + diot.b) +# d.c == 3 +``` + +[1]: https://img.shields.io/pypi/v/diot?style=flat-square +[2]: https://pypi.org/project/diot/ +[3]: https://img.shields.io/github/tag/pwwang/diot?style=flat-square +[4]: https://github.com/pwwang/diot +[5]: https://img.shields.io/github/actions/workflow/status/pwwang/diot/docs.yml?label=docs&style=flat-square +[6]: https://img.shields.io/github/actions/workflow/status/pwwang/diot/build.yml?style=flat-square +[7]: https://img.shields.io/codacy/grade/738e49b9cc1745c4ae6a7bb3b198cc3d?style=flat-square +[8]: https://app.codacy.com/gh/pwwang/diot/dashboard +[9]: https://img.shields.io/codacy/coverage/738e49b9cc1745c4ae6a7bb3b198cc3d?style=flat-square +[10]: https://img.shields.io/pypi/pyversions/diot?style=flat-square + + +%prep +%autosetup -n diot-0.1.7 + +%build +%py3_build + +%install +%py3_install +install -d -m755 %{buildroot}/%{_pkgdocdir} +if [ -d doc ]; then cp -arf doc %{buildroot}/%{_pkgdocdir}; fi +if [ -d docs ]; then cp -arf docs %{buildroot}/%{_pkgdocdir}; fi +if [ -d example ]; then cp -arf example %{buildroot}/%{_pkgdocdir}; fi +if [ -d examples ]; then cp -arf examples %{buildroot}/%{_pkgdocdir}; fi +pushd %{buildroot} +if [ -d usr/lib ]; then + find usr/lib -type f -printf "/%h/%f\n" >> filelist.lst +fi +if [ -d usr/lib64 ]; then + find usr/lib64 -type f -printf "/%h/%f\n" >> filelist.lst +fi +if [ -d usr/bin ]; then + find usr/bin -type f -printf "/%h/%f\n" >> filelist.lst +fi +if [ -d usr/sbin ]; then + find usr/sbin -type f -printf "/%h/%f\n" >> filelist.lst +fi +touch doclist.lst +if [ -d usr/share/man ]; then + find usr/share/man -type f -printf "/%h/%f.gz\n" >> doclist.lst +fi +popd +mv %{buildroot}/filelist.lst . +mv %{buildroot}/doclist.lst . + +%files -n python3-diot -f filelist.lst +%dir %{python3_sitelib}/* + +%files help -f doclist.lst +%{_docdir}/* + +%changelog +* Wed Apr 12 2023 Python_Bot <Python_Bot@openeuler.org> - 0.1.7-1 +- Package Spec generated @@ -0,0 +1 @@ +7bef7e296fdc759bf929ab8c06525338 diot-0.1.7.tar.gz |