{ "info": { "author": "mbello", "author_email": "mbello@users.noreply.github.com", "bugtrack_url": null, "classifiers": [ "License :: CC0 1.0 Universal (CC0 1.0) Public Domain Dedication", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3.5", "Programming Language :: Python :: 3.6", "Programming Language :: Python :: 3.7" ], "description": "## Description\n\nSimple functions to set or get values from a nested dict structure or in fact a deep structure of any object, because\nsince version 2 we no longer assume we are dealing with dicts.\n\nAlthough we make your life easier if working with dicts (see the default argument that was left for this purpose),\nwe now let you use custom getter, setter, deleter callables so that you can traverse a nested structure of any kind of \nobject.\n\nThis module DOES NOT implement dotted notation as an alternative access method for dicts.\nI generally do not like changing python dicts to enable dot notation, hence no available\npackage fitted my needs for a simple deep accessor.\n\n\n## Functions\n\n*deep_get* accepts:\n- d: required. Any object, usually a dictionary.\n- key: required. A string or anything accepted by the list() constructor.\n- default: optional, callable: a callable to be used as default for the dict .setdefault function. If d is not a dict, use a custom getter instead.\n- getter: optional, callable. If getter is set, default is ignored. Must be a callable that accepts an object and a key as arguments. (ex. lambda o, k: o[k])\n- sep: optional, string: by default it is a dot '.', you can use anything the string function split will accept\n\nReturns the value corresponding to 'key' on 'd'\n\n\n*deep_set* accepts:\n- d: same as above\n- key: same as above\n- value: required, self explanatory\n- default: optional, callable: If set, will use setdefault to traverse the nested dict structure. See comments from deep_get.\n- getter: same as above.\n- setter: optional, callable. A callable that takes 3 parameters: o, k, v - where o = any object, k = key, v = value \n- sep: same as above\n\nNo return value\n\n\n*deep_del* accepts:\n- d: same as above\n- key: same as above\n- sep: same as above\n- getter: same as above. However, make your getter return None if you want to avoid exceptions being raised.\n- deleter: optional callable: A callable that takes 2 parameters: o, k (object and key). By default we call 'del o[k]'\n\nReturns a tuple:\n(True, ) or\n(False, None)\n\n\n## Usage\n\n from dict_deep import deep_get, deep_set, deep_del\n \n \n i = 1\n \n \n # Alternative 1\n d = {'a': {'b': {}}}\n deep_set(d, \"a.b.c\", \"Hello World\")\n print(\"{}: {}\".format(i, deep_get(d, \"a.b.c\")))\n i += 1\n\n\n # Alternative 2\n d = {}\n deep_set(d, ['a', 'b', 'c'], \"Hello World\", default=lambda: dict())\n print(\"{}: {}\".format(i, deep_get(d, \"a.b.c\"))) \n i += 1\n \n \n # Alternative 3\n d = {}\n deep_set(d, \"a->b->c\", \"Hello World\", default=lambda: dict(), sep=\"->\")\n print(\"{}: {}\".format(i, deep_get(d, \"a->b->c\", sep=\"->\")))\n i += 1\n \n \n # Alternative 4\n d = {}\n deep_set(d, \"a->b->c\", \"Hello World\", getter=lambda o, k: o.setdefault(k, dict()), sep=\"->\")\n print(\"{}: {}\".format(i, deep_get(d, \"a->b->c\", sep=\"->\")))\n i += 1\n \n \n # Alternative 5\n d = {}\n keys = 'a.b.c'\n keys = keys.split()\n _ = deep_get(d=d, key=keys[0:-1], default=lambda: dict(), sep=\".\")\n _[keys[-1]] = \"Hello World\"\n print(\"{}: {}\".format(i, deep_get(d, keys)))\n i += 1\n \n \n # deep_del\n d = {}\n deep_set(d, \"1.1.1\", 'a', default=lambda: dict())\n deep_set(d, \"1.1.2\", 'Hello World')\n deep_set(d, \"1.1.3\", 'c')\n print(\"{}: {}\".format(i, deep_del(d, \"1.1.2\")[1]))\n print(d)", "description_content_type": "text/markdown", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/mbello/dict-deep", "keywords": "dict dotted keys,deep dict access,nested dict access,deep_get,deep_set,deep_del", "license": "CC0-1.0", "maintainer": "mbello", "maintainer_email": "mbello@users.noreply.github.com", "name": "dict-deep", "package_url": "https://pypi.org/project/dict-deep/", "platform": "", "project_url": "https://pypi.org/project/dict-deep/", "project_urls": { "Homepage": "https://github.com/mbello/dict-deep", "Repository": "https://github.com/mbello/dict-deep" }, "release_url": "https://pypi.org/project/dict-deep/2.0.2/", "requires_dist": null, "requires_python": ">=3.5,<4.0", "summary": "Very simple deep_set and deep_get functions to access nested dicts (or any object) using 'dotted strings' as key.", "version": "2.0.2" }, "last_serial": 4879133, "releases": { "1.2.1": [ { "comment_text": "", "digests": { "md5": "52d027ffdb173ffb69bd71289aa993ab", "sha256": "f3714b2000608bb84392178680722108ae8c2032592733a3fc4f9a8055229043" }, "downloads": -1, "filename": "dict_deep-1.2.1-py3-none-any.whl", "has_sig": false, "md5_digest": "52d027ffdb173ffb69bd71289aa993ab", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.5,<4.0", "size": 3692, "upload_time": "2019-02-27T17:56:09", "url": "https://files.pythonhosted.org/packages/76/66/0e28d25edf9273e885d523518489538b64124c15454d5d03d1202168051e/dict_deep-1.2.1-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "2dbd2fdb249d716ed78ac40a70402453", "sha256": "4f3e930bb7e00dc3660fd9df7efa93d2473eeafeaa2cbce9960506804b5798a7" }, "downloads": -1, "filename": "dict-deep-1.2.1.tar.gz", "has_sig": false, "md5_digest": "2dbd2fdb249d716ed78ac40a70402453", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.5,<4.0", "size": 2495, "upload_time": "2019-02-27T17:56:07", "url": "https://files.pythonhosted.org/packages/0d/c0/5bbb5ed85610b372d858caec130ea1318304a000a6c480a1e1d4f3717589/dict-deep-1.2.1.tar.gz" } ], "1.2.2": [ { "comment_text": "", "digests": { "md5": "17bb36fa81a7e97403ca0af11ca5a0b3", "sha256": "6c9e079294641338385a24719aeef2e7002cdee5d9e08c414454937a10225be9" }, "downloads": -1, "filename": "dict_deep-1.2.2-py3-none-any.whl", "has_sig": false, "md5_digest": "17bb36fa81a7e97403ca0af11ca5a0b3", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.5,<4.0", "size": 4271, "upload_time": "2019-02-27T18:24:56", "url": "https://files.pythonhosted.org/packages/fa/46/a5aee30662d7ff5832a507e28e6604932071c07ddaf4f1ccda39f41ffddb/dict_deep-1.2.2-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "b5f9cfd4473e006052fa5a80df3900ee", "sha256": "889407428e9ba226aaff7752d76e0fcf1802120a9183e0f5977af64bbd2350d9" }, "downloads": -1, "filename": "dict-deep-1.2.2.tar.gz", "has_sig": false, "md5_digest": "b5f9cfd4473e006052fa5a80df3900ee", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.5,<4.0", "size": 2757, "upload_time": "2019-02-27T18:24:54", "url": "https://files.pythonhosted.org/packages/8e/23/dd5e7e9feb19be399d93091821063e09d7a581e6d5154596c57236b47a85/dict-deep-1.2.2.tar.gz" } ], "2.0.1": [ { "comment_text": "", "digests": { "md5": "a8097ecc60835790f741ec673b25f000", "sha256": "330ba1adc8a65f6aa6645f1e25cdd713bdc27524a0949cf810beedeb26d96ecd" }, "downloads": -1, "filename": "dict_deep-2.0.1-py3-none-any.whl", "has_sig": false, "md5_digest": "a8097ecc60835790f741ec673b25f000", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.5,<4.0", "size": 4673, "upload_time": "2019-02-28T10:57:19", "url": "https://files.pythonhosted.org/packages/1f/ff/5afbe2d717d61b3bb7486b4ca2969df65e06d48ed7e5615a291f8b38ed8b/dict_deep-2.0.1-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "16100e81ce0293d2be29e1b4a7ce6e6b", "sha256": "ebf8c511320a014959ae8fd1783b74cada49a7f69768d21ef1af5603b5daebd5" }, "downloads": -1, "filename": "dict-deep-2.0.1.tar.gz", "has_sig": false, "md5_digest": "16100e81ce0293d2be29e1b4a7ce6e6b", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.5,<4.0", "size": 3318, "upload_time": "2019-02-28T10:57:17", "url": "https://files.pythonhosted.org/packages/d4/31/4f6e93836e75b1bfd89844ff9e85bc930a169b7f5cbe3953c869076d60bc/dict-deep-2.0.1.tar.gz" } ], "2.0.2": [ { "comment_text": "", "digests": { "md5": "95c5b88a5795e167f1d9c1db064d7c7b", "sha256": "b30fef55add77505b14abd9f9a0bfa1995b385abcde4902ea48ee68aea2c35d6" }, "downloads": -1, "filename": "dict_deep-2.0.2-py3-none-any.whl", "has_sig": false, "md5_digest": "95c5b88a5795e167f1d9c1db064d7c7b", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.5,<4.0", "size": 4678, "upload_time": "2019-02-28T13:05:45", "url": "https://files.pythonhosted.org/packages/04/cc/2a68318f057d83f784e4a880c75b214833c4661d72a030557c3b9d6837ad/dict_deep-2.0.2-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "9d9042cc640f0d5e64cfbf8972ff168d", "sha256": "7248badf8d985e76c8de426eb38bd181cb3602cb16558ac40f0c035f9dcd1f40" }, "downloads": -1, "filename": "dict-deep-2.0.2.tar.gz", "has_sig": false, "md5_digest": "9d9042cc640f0d5e64cfbf8972ff168d", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.5,<4.0", "size": 3316, "upload_time": "2019-02-28T13:05:44", "url": "https://files.pythonhosted.org/packages/f1/7e/bab8ce9b92de33e88be4dc085c34bce01fcd15833b1fd3cdeed3e827b3dc/dict-deep-2.0.2.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "95c5b88a5795e167f1d9c1db064d7c7b", "sha256": "b30fef55add77505b14abd9f9a0bfa1995b385abcde4902ea48ee68aea2c35d6" }, "downloads": -1, "filename": "dict_deep-2.0.2-py3-none-any.whl", "has_sig": false, "md5_digest": "95c5b88a5795e167f1d9c1db064d7c7b", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.5,<4.0", "size": 4678, "upload_time": "2019-02-28T13:05:45", "url": "https://files.pythonhosted.org/packages/04/cc/2a68318f057d83f784e4a880c75b214833c4661d72a030557c3b9d6837ad/dict_deep-2.0.2-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "9d9042cc640f0d5e64cfbf8972ff168d", "sha256": "7248badf8d985e76c8de426eb38bd181cb3602cb16558ac40f0c035f9dcd1f40" }, "downloads": -1, "filename": "dict-deep-2.0.2.tar.gz", "has_sig": false, "md5_digest": "9d9042cc640f0d5e64cfbf8972ff168d", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.5,<4.0", "size": 3316, "upload_time": "2019-02-28T13:05:44", "url": "https://files.pythonhosted.org/packages/f1/7e/bab8ce9b92de33e88be4dc085c34bce01fcd15833b1fd3cdeed3e827b3dc/dict-deep-2.0.2.tar.gz" } ] }