{ "info": { "author": "Kade Robertson", "author_email": "kade@kaderobertson.pw", "bugtrack_url": null, "classifiers": [ "Development Status :: 5 - Production/Stable", "License :: OSI Approved :: MIT License", "Operating System :: OS Independent", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3.0", "Programming Language :: Python :: 3.1", "Programming Language :: Python :: 3.2", "Programming Language :: Python :: 3.3", "Programming Language :: Python :: 3.4", "Programming Language :: Python :: 3.5", "Programming Language :: Python :: 3.6", "Programming Language :: Python :: 3.7", "Programming Language :: Python :: 3.8" ], "description": "# config-better\n\n[![PyPI](https://img.shields.io/pypi/v/config-better.svg?style=flat-square)](https://pypi.org/project/config-better/)\n[![CircleCI Build Status](https://img.shields.io/circleci/token/a23936ed1748d98b98003357c1e205619209af66/project/github/kade-robertson/config-better/master.svg?style=flat-square)](https://circleci.com/gh/kade-robertson/config-better)\n[![Codecov](https://img.shields.io/codecov/c/github/kade-robertson/config-better.svg?style=flat-square)](https://codecov.io/gh/kade-robertson/config-better)\n\nMake use of directories for configuration / data / caching better and more user-friendly!\n\nThis module provides support for the XDG Base Directory specification, and OS-friendly fallbacks for Windows, Mac OS, and Linux if not otherwise specified.\n\n## Usage\n\n```python\nimport os.path\n\nimport configbetter\n\nc = configbetter.Config('appname')\n\nwith open(os.path.join(c.config, 'config.json')) as conf:\n # ...\n```\n\nAvailable parameters for creating a `Config` instance:\n\n- `force_unix` allows you to force using Unix-like paths on Windows/Darwin if desired. This isn't really recommended on Windows but on Darwin it seems as though programs without a GUI usually use Unix-like configuration paths while GUI apps use the \"standard\" Darwin paths. By default this is `False`.\n\nAvailable properties of `Config`:\n\n- `.cache`, which points to `$XDG_CACHE_HOME` if available, otherwise uses a generic system equivalent.\n- `.config`, which points to `$XDG_CONFIG_HOME` if available, otherwise uses a generic system equivalent.\n- `.data`, which points to `$XDG_DATA_HOME` if available, otherwise uses a generic system equivalent.\n\nAdditionally, the following methods are provided:\n\n- `.makedirs()` will create the cache, config and data directories if they do not already exist, including all parent directories.\n- `.rmdirs()` will remove any program-specific directories that would have been created by config-better.\n\n## Installation\n\n```bash\npip install config-better\n```\n\n## Developing\n\n1. Clone the repo\n2. `git checkout -b some-feature-or-bugfix`\n3. Do work\n4. Test with `pytest` (add tests to maintain coverage as best as possible)\n5. Run `yapf -ir .` and `isort -rc .` to standardize.\n6. Make a PR.\n\n\n", "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/kade-robertson/config-better", "keywords": "config better xdg directory", "license": "MIT", "maintainer": "", "maintainer_email": "", "name": "config-better", "package_url": "https://pypi.org/project/config-better/", "platform": "", "project_url": "https://pypi.org/project/config-better/", "project_urls": { "Homepage": "https://github.com/kade-robertson/config-better" }, "release_url": "https://pypi.org/project/config-better/1.1.0/", "requires_dist": null, "requires_python": ">=3.0.*", "summary": "Configure your application in a friendlier and more consistent way!", "version": "1.1.0" }, "last_serial": 5514156, "releases": { "0.1.0": [ { "comment_text": "", "digests": { "md5": "14b991ef5ad18fc7818ede37495db7aa", "sha256": "bccf0b9133a16210ae5fa65462974993ce0d60e8d2c71e32b218f7fff33fe5b2" }, "downloads": -1, "filename": "config_better-0.1.0-py3-none-any.whl", "has_sig": false, "md5_digest": "14b991ef5ad18fc7818ede37495db7aa", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=2.7.3, !=3.0.*, !=3.1.*, !=3.2.*", "size": 3825, "upload_time": "2019-03-01T22:42:50", "url": "https://files.pythonhosted.org/packages/d5/c8/be6550d48faac3cca3473fd3e3736789aa4e5c86ce73de508b8c37223bad/config_better-0.1.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "333e3b8d6e04d2be0b993136cb14c240", "sha256": "9e79776d3191f1e530a497c9cd3a6bbc0a88ed3529537ae15b24396ac16c58cc" }, "downloads": -1, "filename": "config-better-0.1.0.tar.gz", "has_sig": false, "md5_digest": "333e3b8d6e04d2be0b993136cb14c240", "packagetype": "sdist", "python_version": "source", "requires_python": ">=2.7.3, !=3.0.*, !=3.1.*, !=3.2.*", "size": 2157, "upload_time": "2019-03-01T22:42:52", "url": "https://files.pythonhosted.org/packages/70/c9/b068921c7297dd6ae8e269c41b7995672305156d9218b6eb6f4ad38bd740/config-better-0.1.0.tar.gz" } ], "0.2.0": [ { "comment_text": "", "digests": { "md5": "d481eca413e40d8a38bbf8e764e951fb", "sha256": "b753abee0deb02ba21e9f302777200be4a312821fc39786385c5a49589cbc968" }, "downloads": -1, "filename": "config_better-0.2.0-py3-none-any.whl", "has_sig": false, "md5_digest": "d481eca413e40d8a38bbf8e764e951fb", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=2.7.3, !=3.0.*, !=3.1.*, !=3.2.*", "size": 4586, "upload_time": "2019-03-01T23:28:49", "url": "https://files.pythonhosted.org/packages/b7/21/de536fd8fdfdf058fb68111aa84fec1d83747111d98bd2bee4a720140a4d/config_better-0.2.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "ca3d4b97e5ec50c5f505477afb95687d", "sha256": "cf7d517cbd916e3d2b1e090a4304be4624b85b030c941f2c3fa176e89cca4f3e" }, "downloads": -1, "filename": "config-better-0.2.0.tar.gz", "has_sig": false, "md5_digest": "ca3d4b97e5ec50c5f505477afb95687d", "packagetype": "sdist", "python_version": "source", "requires_python": ">=2.7.3, !=3.0.*, !=3.1.*, !=3.2.*", "size": 2687, "upload_time": "2019-03-01T23:28:51", "url": "https://files.pythonhosted.org/packages/af/51/c05c151503bfc0fdf065742975f6384f59a8d300b99657848e617b6782a2/config-better-0.2.0.tar.gz" } ], "1.0.0": [ { "comment_text": "", "digests": { "md5": "7ff64409ccfde2ad12d82b3bd92a88e3", "sha256": "4364e95b216170e3d46132ddebb49a21c202c75f1ddc8f9072089f43895d5845" }, "downloads": -1, "filename": "config_better-1.0.0-py3-none-any.whl", "has_sig": false, "md5_digest": "7ff64409ccfde2ad12d82b3bd92a88e3", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.5.*", "size": 6056, "upload_time": "2019-04-02T23:40:05", "url": "https://files.pythonhosted.org/packages/07/f5/801b99804aaaeecf4796b1a6057e2cf6749ba2df25746c4418e0d1cc4e6f/config_better-1.0.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "7e7c804d9b322df1b232994ddf9281d6", "sha256": "5d076c73b8be7370d692915fca6ada4e0a89aa27dc15465591a5c631545aa711" }, "downloads": -1, "filename": "config-better-1.0.0.tar.gz", "has_sig": false, "md5_digest": "7e7c804d9b322df1b232994ddf9281d6", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.5.*", "size": 4085, "upload_time": "2019-04-02T23:40:06", "url": "https://files.pythonhosted.org/packages/de/fc/d76eb54803d95e3f4eaf721376e04d6a66be9627fdf10828d1d107cd2e9e/config-better-1.0.0.tar.gz" } ], "1.0.1": [ { "comment_text": "", "digests": { "md5": "0642e526efd4e681b4fe9d6e65f2b41b", "sha256": "ca743646d9981f0724d21360b22f25cd4d0ba9c74130f56308c96dcc0f9ab7fe" }, "downloads": -1, "filename": "config_better-1.0.1-py3-none-any.whl", "has_sig": false, "md5_digest": "0642e526efd4e681b4fe9d6e65f2b41b", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.5.*", "size": 5794, "upload_time": "2019-05-02T15:44:52", "url": "https://files.pythonhosted.org/packages/26/29/1a59db65893c7fdae13e6c6b61fc568987652845b46701e9b7cd78eddc50/config_better-1.0.1-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "f2f8517833f0c5e3b353d4a206ed67d8", "sha256": "28ff184c262e87f179f764271b291a173bf8520f7f2e3b49db6eda123e358d06" }, "downloads": -1, "filename": "config-better-1.0.1.tar.gz", "has_sig": false, "md5_digest": "f2f8517833f0c5e3b353d4a206ed67d8", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.5.*", "size": 4423, "upload_time": "2019-05-02T15:44:53", "url": "https://files.pythonhosted.org/packages/79/f7/3b842c2350156b55dd9f790ebfe72fb5223d069138295150d78aac5b4864/config-better-1.0.1.tar.gz" } ], "1.1.0": [ { "comment_text": "", "digests": { "md5": "a02366bbeea38c9d41177e1261c7d784", "sha256": "00ff28afd0026bff140829b3675d8fb284ff7b95f28e2d71e5031435e1e6c25b" }, "downloads": -1, "filename": "config_better-1.1.0-py3-none-any.whl", "has_sig": false, "md5_digest": "a02366bbeea38c9d41177e1261c7d784", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.0.*", "size": 6448, "upload_time": "2019-07-10T21:51:17", "url": "https://files.pythonhosted.org/packages/41/c3/1e68f348116d00c22ff253656136151fd91e81e3fd0e9a575113c8a1357f/config_better-1.1.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "0051cd1bf3d952a6d6ece91e13fba9b4", "sha256": "cafb848b46d1740a42b2d279b0c8979c1b4b6e8a4a9d4f439bc059ac87f74d43" }, "downloads": -1, "filename": "config-better-1.1.0.tar.gz", "has_sig": false, "md5_digest": "0051cd1bf3d952a6d6ece91e13fba9b4", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.0.*", "size": 4518, "upload_time": "2019-07-10T21:51:18", "url": "https://files.pythonhosted.org/packages/a2/b9/88f4eec983a2383055f897efaf90032eb81df54beb871518b65876fea2f7/config-better-1.1.0.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "a02366bbeea38c9d41177e1261c7d784", "sha256": "00ff28afd0026bff140829b3675d8fb284ff7b95f28e2d71e5031435e1e6c25b" }, "downloads": -1, "filename": "config_better-1.1.0-py3-none-any.whl", "has_sig": false, "md5_digest": "a02366bbeea38c9d41177e1261c7d784", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.0.*", "size": 6448, "upload_time": "2019-07-10T21:51:17", "url": "https://files.pythonhosted.org/packages/41/c3/1e68f348116d00c22ff253656136151fd91e81e3fd0e9a575113c8a1357f/config_better-1.1.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "0051cd1bf3d952a6d6ece91e13fba9b4", "sha256": "cafb848b46d1740a42b2d279b0c8979c1b4b6e8a4a9d4f439bc059ac87f74d43" }, "downloads": -1, "filename": "config-better-1.1.0.tar.gz", "has_sig": false, "md5_digest": "0051cd1bf3d952a6d6ece91e13fba9b4", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.0.*", "size": 4518, "upload_time": "2019-07-10T21:51:18", "url": "https://files.pythonhosted.org/packages/a2/b9/88f4eec983a2383055f897efaf90032eb81df54beb871518b65876fea2f7/config-better-1.1.0.tar.gz" } ] }