platformdirs Changelog#

platformdirs 3.0.0 (2023-02-06)#

  • BREAKING Changed the config directory on macOS to point to */Library/Application Support

  • macOS: remove erroneous trailing slash from user_config_dir and user_data_dir

platformdirs 2.6.2 (2022-12-28)#

  • Fix missing typing-extensions dependency.

platformdirs 2.6.1 (2022-12-28)#

  • Add detection of $PREFIX for android.

platformdirs 2.6.0 (2022-12-06)#

  • BREAKING Correct the log directory on Linux/Unix from XDG_CACHE_HOME to XDG_STATE_HOME per the XDG spec

platformdirs 2.5.4 (2022-11-12)#

  • Fix licensing metadata

platformdirs 2.5.3 (2022-11-06)#

  • Support 3.11

  • Bump dependencies

platformdirs 2.5.2 (2022-04-18)#

  • Move packaging to hatchling from setuptools

  • Treat android shells as unix

platformdirs 2.5.1 (2022-02-19)#

  • Add native support for nuitka

platformdirs 2.5.0 (2022-02-09)#

  • Add support for Termux subsystems

platformdirs 2.4.1 (2021-12-26)#

  • Drop python 3.6 support

platformdirs 2.4.0 (2021-09-25)#

  • Add user_documents_dir

platformdirs 2.3.0 (2021-08-31)#

  • Add user_runtime_dir and its path-returning equivalent (#37)

platformdirs 2.2.0 (2021-07-29)#

  • Unix: Fallback to default if XDG environment variable is empty

platformdirs 2.1.0 (2021-07-25)#

  • Add readthedocs.org documentation via Sphinx

  • Modernize project layout

  • Drop Python 2.7 and 3.5 support

  • Android support

  • Add type annotations

  • Reorganize project layout to platform specific classes, see PlatformDirsABC and it’s implementations: Android, MacOS, Unix and Windows

  • Add *_path API, returning pathlib.Path objects instead of str (user_data_path, user_config_path, user_cache_path, user_state_path, user_log_path, site_data_path, site_config_path) - by @papr

platformdirs 2.0.2 (2021-07-13)#

  • Fix __version__ and __version_info__

platformdirs 2.0.1 (never released)#

  • Documentation fixes

platformdirs 2.0.0 (2021-07-12)#

  • BREAKING Name change as part of the friendly fork

  • BREAKING Remove support for end-of-life Pythons 2.6, 3.2, and 3.3

  • BREAKING Correct the config directory on OSX/macOS

  • Add Python 3.7, 3.8, and 3.9 support

appdirs 1.4.4 (2020-05-11)#

  • [PR #92] Don’t import appdirs from setup.py which resolves issue #91

Project officially classified as Stable which is important for inclusion in other distros such as ActivePython.

appdirs 1.4.3 (2017-03-07)#

  • [PR #76] Python 3.6 invalid escape sequence deprecation fixes

  • Fix for Python 3.6 support

appdirs 1.4.2 (2017-02-24)#

  • [PR #84] Allow installing without setuptools

  • [PR #86] Fix string delimiters in setup.py description

  • Add Python 3.6 support

appdirs 1.4.1 (2017-02-23)#

  • [issue #38] Fix _winreg import on Windows Py3

  • [issue #55] Make appname optional

appdirs 1.4.0 (2017-08-17)#

  • [PR #42] AppAuthor is now optional on Windows

  • [issue 41] Support Jython on Windows, Mac, and Unix-like platforms. Windows support requires JNA.

  • [PR #44] Fix incorrect behaviour of the site_config_dir method

appdirs 1.3.0 (2014-04-22)#

  • [Unix, issue 16] Conform to XDG standard, instead of breaking it for everybody

  • [Unix] Removes gratuitous case mangling of the case, since *nix-es are usually case sensitive, so mangling is not wise

  • [Unix] Fixes the utterly wrong behaviour in site_data_dir, return result based on XDG_DATA_DIRS and make room for respecting the standard which specifies XDG_DATA_DIRS is a multiple-value variable

  • [Issue 6] Add *_config_dir which are distinct on nix-es, according to XDG specs; on Windows and Mac return the corresponding *_data_dir

appdirs 1.2.0 (2011-01-26)#

  • [Unix] Put user_log_dir under the cache dir on Unix. Seems to be more typical.

  • [issue 9] Make unicode work on py3k.

appdirs 1.1.0 (2010-09-02)#

  • [issue 4] Add AppDirs.user_log_dir.

  • [Unix, issue 2, issue 7] appdirs now conforms to XDG base directory spec.

  • [Mac, issue 5] Fix site_data_dir() on Mac.

  • [Mac] Drop use of ‘Carbon’ module in favour of hardcoded paths; supports Python3 now.

  • [Windows] Append “Cache” to user_cache_dir on Windows by default. Use opinion=False option to disable this.

  • Add appdirs.AppDirs convenience class. Usage:

    >>> dirs = AppDirs("SuperApp", "Acme", version="1.0")
>>> dirs.user_data_dir
'/Users/trentm/Library/Application Support/SuperApp/1.0'

  • [Windows] Cherry-pick Komodo’s change to downgrade paths to the Windows short paths if there are high bit chars.

  • [Linux] Change default user_cache_dir() on Linux to be singular, e.g. “~/.superapp/cache”.

  • [Windows] Add roaming option to user_data_dir() (for use on Windows only) and change the default user_data_dir behaviour to use a non-roaming profile dir (CSIDL_LOCAL_APPDATA instead of CSIDL_APPDATA). Why? Because a large roaming profile can cause login speed issues. The “only syncs on logout” behaviour can cause surprises in appdata info.

appdirs 1.0.1 (never released)#

Started this changelog 27 July 2010. Before that this module originated in the Komodo product as applib.py and then as applib/location.py (used by PyPM in ActivePython). This is basically a fork of applib.py 1.0.1 and applib/location.py 1.0.1.