{
"info": {
"author": "Zhiming Wang",
"author_email": "i@zhimingwang.org",
"bugtrack_url": null,
"classifiers": [
"Development Status :: 5 - Production/Stable",
"Intended Audience :: Developers",
"License :: OSI Approved :: MIT License",
"Operating System :: OS Independent",
"Programming Language :: Python",
"Programming Language :: Python :: 2",
"Programming Language :: Python :: 2.7",
"Programming Language :: Python :: 3",
"Programming Language :: Python :: 3.4",
"Programming Language :: Python :: 3.5",
"Programming Language :: Python :: 3.6",
"Programming Language :: Python :: 3.7",
"Programming Language :: Python :: Implementation :: CPython",
"Programming Language :: Python :: Implementation :: PyPy",
"Topic :: Software Development :: Libraries :: Python Modules"
],
"description": "\n============\n xdgappdirs\n============\n\nThis is a fork and almost drop-in replacement of `appdirs\n`_ that follows the XDG BaseDir Spec on macOS\nwhen the relevant ``XDG_*`` environment variables are available. For instance,\non macOS, when ``XDG_CONFIG_HOME`` is set to ``/Users/steve/.config``,\n``user_config_dir('foo')`` evaluates to ``/Users/steve/.config/foo``, whereas\nwhen ``XDG_CONFIG_HOME`` is not set or empty, it evaluates to\n``/Users/steve/Library/Application Support/foo``. This gives XDG fans a choice\nwhile not mandating ``.config`` for everyone else, especially for GUI apps.\n\nOther changes:\n\n- Reverts `ActiveState/appdirs#100\n `_. On macOS,\n ``user_config_dir`` and ``site_config_dir`` evaluates to subdirs of\n ``~/Library/Application Support`` and ``/Library/Application Support`` (unless\n the relevant ``XDG_*`` env vars are set and non-empty), rather than subdirs of\n ``~/Library/Preferences`` and ``/Library/Preferences``, which are specifically\n for plists and not suitable for anything else. You don't need ``appdirs`` to\n tell you where to write plists.\n\n- Properly handle empty ``XDG_*`` env vars. According to XDG BaseDir Spec,\n defaults should be used when the env vars are empty.\n\n- Support for returning `pathlib.Path`\n ([contributed](https://github.com/zmwangx/xdgappdirs/pull/1) by @pmav99).\n\nThe original README for ``appdirs`` follows.\n\nthe problem\n===========\n\nWhat directory should your app use for storing user data? If running on macOS, you\nshould use::\n\n ~/Library/Application Support/\n\nIf on Windows (at least English Win XP) that should be::\n\n C:\\Documents and Settings\\\\Application Data\\Local Settings\\\\\n\nor possibly::\n\n C:\\Documents and Settings\\\\Application Data\\\\\n\nfor `roaming profiles `_ but that is another story.\n\nOn Linux (and other Unices) the dir, according to the `XDG\nspec `_, is::\n\n ~/.local/share/\n\n\n``appdirs`` to the rescue\n=========================\n\nThis kind of thing is what the ``appdirs`` module is for. ``appdirs`` will\nhelp you choose an appropriate:\n\n- user data dir (``user_data_dir``)\n- user config dir (``user_config_dir``)\n- user cache dir (``user_cache_dir``)\n- site data dir (``site_data_dir``)\n- site config dir (``site_config_dir``)\n- user log dir (``user_log_dir``)\n\nand also:\n\n- is a single module so other Python packages can include their own private copy\n- is slightly opinionated on the directory names used. Look for \"OPINION\" in\n documentation and code for when an opinion is being applied.\n\n\nsome example output\n===================\n\nOn macOS::\n\n >>> from appdirs import *\n >>> appname = \"SuperApp\"\n >>> appauthor = \"Acme\"\n >>> user_data_dir(appname, appauthor)\n '/Users/trentm/Library/Application Support/SuperApp'\n >>> site_data_dir(appname, appauthor)\n '/Library/Application Support/SuperApp'\n >>> user_cache_dir(appname, appauthor)\n '/Users/trentm/Library/Caches/SuperApp'\n >>> user_log_dir(appname, appauthor)\n '/Users/trentm/Library/Logs/SuperApp'\n\nOn Windows 7::\n\n >>> from appdirs import *\n >>> appname = \"SuperApp\"\n >>> appauthor = \"Acme\"\n >>> user_data_dir(appname, appauthor)\n 'C:\\\\Users\\\\trentm\\\\AppData\\\\Local\\\\Acme\\\\SuperApp'\n >>> user_data_dir(appname, appauthor, roaming=True)\n 'C:\\\\Users\\\\trentm\\\\AppData\\\\Roaming\\\\Acme\\\\SuperApp'\n >>> user_cache_dir(appname, appauthor)\n 'C:\\\\Users\\\\trentm\\\\AppData\\\\Local\\\\Acme\\\\SuperApp\\\\Cache'\n >>> user_log_dir(appname, appauthor)\n 'C:\\\\Users\\\\trentm\\\\AppData\\\\Local\\\\Acme\\\\SuperApp\\\\Logs'\n\nOn Linux::\n\n >>> from appdirs import *\n >>> appname = \"SuperApp\"\n >>> appauthor = \"Acme\"\n >>> user_data_dir(appname, appauthor)\n '/home/trentm/.local/share/SuperApp\n >>> site_data_dir(appname, appauthor)\n '/usr/local/share/SuperApp'\n >>> site_data_dir(appname, appauthor, multipath=True)\n '/usr/local/share/SuperApp:/usr/share/SuperApp'\n >>> user_cache_dir(appname, appauthor)\n '/home/trentm/.cache/SuperApp'\n >>> user_log_dir(appname, appauthor)\n '/home/trentm/.cache/SuperApp/log'\n >>> user_config_dir(appname)\n '/home/trentm/.config/SuperApp'\n >>> site_config_dir(appname)\n '/etc/xdg/SuperApp'\n >>> os.environ['XDG_CONFIG_DIRS'] = '/etc:/usr/local/etc'\n >>> site_config_dir(appname, multipath=True)\n '/etc/SuperApp:/usr/local/etc/SuperApp'\n\n\n``AppDirs`` for convenience\n===========================\n\n::\n\n >>> from appdirs import AppDirs\n >>> dirs = AppDirs(\"SuperApp\", \"Acme\")\n >>> dirs.user_data_dir\n '/Users/trentm/Library/Application Support/SuperApp'\n >>> dirs.site_data_dir\n '/Library/Application Support/SuperApp'\n >>> dirs.user_cache_dir\n '/Users/trentm/Library/Caches/SuperApp'\n >>> dirs.user_log_dir\n '/Users/trentm/Library/Logs/SuperApp'\n\n\n\nPer-version isolation\n=====================\n\nIf you have multiple versions of your app in use that you want to be\nable to run side-by-side, then you may want version-isolation for these\ndirs::\n\n >>> from appdirs import AppDirs\n >>> dirs = AppDirs(\"SuperApp\", \"Acme\", version=\"1.0\")\n >>> dirs.user_data_dir\n '/Users/trentm/Library/Application Support/SuperApp/1.0'\n >>> dirs.site_data_dir\n '/Library/Application Support/SuperApp/1.0'\n >>> dirs.user_cache_dir\n '/Users/trentm/Library/Caches/SuperApp/1.0'\n >>> dirs.user_log_dir\n '/Users/trentm/Library/Logs/SuperApp/1.0'\n\n\nappdirs Changelog\n=================\n\nxdgappdirs 1.4.5\n----------------\n- Add support for returning ``pathlib.Path`` (#1).\n\nxdgappdirs 1.4.4.3\n------------------\n- Rename module to ``xdgappdirs`` to allow coexistence with ``appdirs``.\n\nxdgappdirs 1.4.4\n----------------\n- Deviate from appdirs (see top of README)\n- [PR #92] Don't import appdirs from setup.py which resolves issue #91\n- Add Python 3.7 support\n- Remove support for end-of-life Pythons 2.6, 3.2, and 3.3\n\nProject officially classified as Stable which is important\nfor inclusion in other distros such as ActivePython.\n\nappdirs 1.4.3\n-------------\n- [PR #76] Python 3.6 invalid escape sequence deprecation fixes\n- Fix for Python 3.6 support\n\nappdirs 1.4.2\n-------------\n- [PR #84] Allow installing without setuptools\n- [PR #86] Fix string delimiters in setup.py description\n- Add Python 3.6 support\n\nappdirs 1.4.1\n-------------\n- [issue #38] Fix _winreg import on Windows Py3\n- [issue #55] Make appname optional\n\nappdirs 1.4.0\n-------------\n- [PR #42] AppAuthor is now optional on Windows\n- [issue 41] Support Jython on Windows, Mac, and Unix-like platforms. Windows\n support requires `JNA `_.\n- [PR #44] Fix incorrect behaviour of the site_config_dir method\n\nappdirs 1.3.0\n-------------\n- [Unix, issue 16] Conform to XDG standard, instead of breaking it for\n everybody\n- [Unix] Removes gratuitous case mangling of the case, since \\*nix-es are\n usually case sensitive, so mangling is not wise\n- [Unix] Fixes the utterly wrong behaviour in ``site_data_dir``, return result\n based on XDG_DATA_DIRS and make room for respecting the standard which\n specifies XDG_DATA_DIRS is a multiple-value variable\n- [Issue 6] Add ``*_config_dir`` which are distinct on nix-es, according to\n XDG specs; on Windows and Mac return the corresponding ``*_data_dir``\n\nappdirs 1.2.0\n-------------\n\n- [Unix] Put ``user_log_dir`` under the *cache* dir on Unix. Seems to be more\n typical.\n- [issue 9] Make ``unicode`` work on py3k.\n\nappdirs 1.1.0\n-------------\n\n- [issue 4] Add ``AppDirs.user_log_dir``.\n- [Unix, issue 2, issue 7] appdirs now conforms to `XDG base directory spec\n `_.\n- [Mac, issue 5] Fix ``site_data_dir()`` on Mac.\n- [Mac] Drop use of 'Carbon' module in favour of hardcoded paths; supports\n Python3 now.\n- [Windows] Append \"Cache\" to ``user_cache_dir`` on Windows by default. Use\n ``opinion=False`` option to disable this.\n- Add ``appdirs.AppDirs`` convenience class. Usage:\n\n >>> dirs = AppDirs(\"SuperApp\", \"Acme\", version=\"1.0\")\n >>> dirs.user_data_dir\n '/Users/trentm/Library/Application Support/SuperApp/1.0'\n\n- [Windows] Cherry-pick Komodo's change to downgrade paths to the Windows short\n paths if there are high bit chars.\n- [Linux] Change default ``user_cache_dir()`` on Linux to be singular, e.g.\n \"~/.superapp/cache\".\n- [Windows] Add ``roaming`` option to ``user_data_dir()`` (for use on Windows only)\n and change the default ``user_data_dir`` behaviour to use a *non*-roaming\n profile dir (``CSIDL_LOCAL_APPDATA`` instead of ``CSIDL_APPDATA``). Why? Because\n a large roaming profile can cause login speed issues. The \"only syncs on\n logout\" behaviour can cause surprises in appdata info.\n\n\nappdirs 1.0.1 (never released)\n------------------------------\n\nStarted this changelog 27 July 2010. Before that this module originated in the\n`Komodo `_ product as ``applib.py`` and then\nas `applib/location.py\n`_ (used by\n`PyPM `_ in `ActivePython\n`_). This is basically a fork of\napplib.py 1.0.1 and applib/location.py 1.0.1.\n\n\n",
"description_content_type": "",
"docs_url": null,
"download_url": "",
"downloads": {
"last_day": -1,
"last_month": -1,
"last_week": -1
},
"home_page": "https://github.com/zmwangx/xdgappdirs",
"keywords": "application directory log cache user",
"license": "MIT",
"maintainer": "",
"maintainer_email": "",
"name": "xdgappdirs",
"package_url": "https://pypi.org/project/xdgappdirs/",
"platform": "",
"project_url": "https://pypi.org/project/xdgappdirs/",
"project_urls": {
"Homepage": "https://github.com/zmwangx/xdgappdirs"
},
"release_url": "https://pypi.org/project/xdgappdirs/1.4.5/",
"requires_dist": null,
"requires_python": "",
"summary": "A small Python module for determining appropriate platform-specific dirs, e.g. a \"user data dir\".",
"version": "1.4.5"
},
"last_serial": 4815179,
"releases": {
"1.4.4": [
{
"comment_text": "",
"digests": {
"md5": "3e36115c9e122b4b0683a37faf5bf3bb",
"sha256": "91644d7cca2df8fced103d5148e48cb5fbe1e6557c85568df62526402b35e006"
},
"downloads": -1,
"filename": "xdgappdirs-1.4.4-py2.py3-none-any.whl",
"has_sig": false,
"md5_digest": "3e36115c9e122b4b0683a37faf5bf3bb",
"packagetype": "bdist_wheel",
"python_version": "py2.py3",
"requires_python": null,
"size": 10144,
"upload_time": "2018-10-21T08:31:56",
"url": "https://files.pythonhosted.org/packages/31/ef/e1b6f26535c9c535f323b1b30cb2a13d25c6192630541567995a1e6f6450/xdgappdirs-1.4.4-py2.py3-none-any.whl"
},
{
"comment_text": "",
"digests": {
"md5": "874dc9aefd51838cb5bb14d2de234b98",
"sha256": "d002ba138c395a6e643daf9980107c96f09a4ed6993285a465892e275924f163"
},
"downloads": -1,
"filename": "xdgappdirs-1.4.4.tar.gz",
"has_sig": false,
"md5_digest": "874dc9aefd51838cb5bb14d2de234b98",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 14047,
"upload_time": "2018-10-21T08:32:00",
"url": "https://files.pythonhosted.org/packages/34/4b/ae821cf4774ae9234975b035c0d1dc4df1cfe5383f254494b3f352c9dd14/xdgappdirs-1.4.4.tar.gz"
}
],
"1.4.4.1": [
{
"comment_text": "",
"digests": {
"md5": "8fd6631d48ed3c8359cd40707254b930",
"sha256": "882860dff483a91dafae68eafe02b25f29e26a185a7c372ae704e955d4a27df3"
},
"downloads": -1,
"filename": "xdgappdirs-1.4.4.1-py2.py3-none-any.whl",
"has_sig": false,
"md5_digest": "8fd6631d48ed3c8359cd40707254b930",
"packagetype": "bdist_wheel",
"python_version": "py2.py3",
"requires_python": null,
"size": 10168,
"upload_time": "2018-10-21T08:38:02",
"url": "https://files.pythonhosted.org/packages/45/18/a1e00aa68bc62ee491598df1466912fd29f3c4aaee5e853cce9d57bf0a2b/xdgappdirs-1.4.4.1-py2.py3-none-any.whl"
},
{
"comment_text": "",
"digests": {
"md5": "b119ee0a6541f4005983798eead8e4ef",
"sha256": "13dede2fc4e54d2f6570be50bd6a5b8a91f5d9f5b88284d9083e216df8ec3e7f"
},
"downloads": -1,
"filename": "xdgappdirs-1.4.4.1.tar.gz",
"has_sig": false,
"md5_digest": "b119ee0a6541f4005983798eead8e4ef",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 14047,
"upload_time": "2018-10-21T08:38:03",
"url": "https://files.pythonhosted.org/packages/a0/b2/cdc03c6489c5ebb50fa76da0aca2248daf3c9a278ba2aff6d6efa0399629/xdgappdirs-1.4.4.1.tar.gz"
}
],
"1.4.4.2": [
{
"comment_text": "",
"digests": {
"md5": "bc4a6fa075b441de732c7e930013961c",
"sha256": "28b784a11cb7b4df18462bbfe8abab67f8b0492561539d1f7b2c93410d4367d9"
},
"downloads": -1,
"filename": "xdgappdirs-1.4.4.2-py2.py3-none-any.whl",
"has_sig": false,
"md5_digest": "bc4a6fa075b441de732c7e930013961c",
"packagetype": "bdist_wheel",
"python_version": "py2.py3",
"requires_python": null,
"size": 10177,
"upload_time": "2018-10-21T08:40:33",
"url": "https://files.pythonhosted.org/packages/3f/6f/a5e705c8b968259ce97b7ac043cfe695d1081e1fcafa5fa9a0e0bf4646b1/xdgappdirs-1.4.4.2-py2.py3-none-any.whl"
},
{
"comment_text": "",
"digests": {
"md5": "8f27bfe0eb58cbe13c8a2e2823e8ae57",
"sha256": "44e5815dbe36a7750adf0584b55958d09c0a817649182e78be84aff35e54790c"
},
"downloads": -1,
"filename": "xdgappdirs-1.4.4.2.tar.gz",
"has_sig": false,
"md5_digest": "8f27bfe0eb58cbe13c8a2e2823e8ae57",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 14073,
"upload_time": "2018-10-21T08:40:35",
"url": "https://files.pythonhosted.org/packages/6a/e8/090c512b926b383da5e38c75e813ff27243f2a2939f93d3950c23d125766/xdgappdirs-1.4.4.2.tar.gz"
}
],
"1.4.4.3": [
{
"comment_text": "",
"digests": {
"md5": "9dbee5762341ad4e8dd4275461d2be2c",
"sha256": "02f4b6e7aec4a124c0ee71a05c58fe34a10607a61436cfcbc8b2f4306b743b57"
},
"downloads": -1,
"filename": "xdgappdirs-1.4.4.3-py2.py3-none-any.whl",
"has_sig": false,
"md5_digest": "9dbee5762341ad4e8dd4275461d2be2c",
"packagetype": "bdist_wheel",
"python_version": "py2.py3",
"requires_python": null,
"size": 15088,
"upload_time": "2018-10-21T08:52:18",
"url": "https://files.pythonhosted.org/packages/d3/fa/74eebc5ad11c8b30c6935d19544962e8360b0889bf54e23f429c621bba87/xdgappdirs-1.4.4.3-py2.py3-none-any.whl"
},
{
"comment_text": "",
"digests": {
"md5": "58155f0ad6fc4120d9f1e6aa709c73f2",
"sha256": "fdafa985b8fa760e918fc9d1542ff5c582d9adb9a79875c4329f662c4c435eaf"
},
"downloads": -1,
"filename": "xdgappdirs-1.4.4.3.tar.gz",
"has_sig": false,
"md5_digest": "58155f0ad6fc4120d9f1e6aa709c73f2",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 11071,
"upload_time": "2018-10-21T08:52:19",
"url": "https://files.pythonhosted.org/packages/ae/6e/3d4250e161cde0e71f4c32b3f0f8ad21fc3b33aac3c57beffca7baecbb4b/xdgappdirs-1.4.4.3.tar.gz"
}
],
"1.4.5": [
{
"comment_text": "",
"digests": {
"md5": "47d245bbd4244c7cae851f8982c2749f",
"sha256": "8fa4b473049de5badd31dc98861cf16af6cff281b5178e99755562bcb5f0cd88"
},
"downloads": -1,
"filename": "xdgappdirs-1.4.5-py2.py3-none-any.whl",
"has_sig": false,
"md5_digest": "47d245bbd4244c7cae851f8982c2749f",
"packagetype": "bdist_wheel",
"python_version": "py2.py3",
"requires_python": null,
"size": 15371,
"upload_time": "2019-02-13T10:55:16",
"url": "https://files.pythonhosted.org/packages/14/fa/429b43bd4347e9e0ac6245281bc4f5da256368191b527be34b271700955c/xdgappdirs-1.4.5-py2.py3-none-any.whl"
}
]
},
"urls": [
{
"comment_text": "",
"digests": {
"md5": "47d245bbd4244c7cae851f8982c2749f",
"sha256": "8fa4b473049de5badd31dc98861cf16af6cff281b5178e99755562bcb5f0cd88"
},
"downloads": -1,
"filename": "xdgappdirs-1.4.5-py2.py3-none-any.whl",
"has_sig": false,
"md5_digest": "47d245bbd4244c7cae851f8982c2749f",
"packagetype": "bdist_wheel",
"python_version": "py2.py3",
"requires_python": null,
"size": 15371,
"upload_time": "2019-02-13T10:55:16",
"url": "https://files.pythonhosted.org/packages/14/fa/429b43bd4347e9e0ac6245281bc4f5da256368191b527be34b271700955c/xdgappdirs-1.4.5-py2.py3-none-any.whl"
}
]
}