platformdirs Changelog

platformdirs 2.3.0

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

platformdirs 2.2.0

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

platformdirs 2.1.0

• 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

• Fix __version__ and __version_info__

platformdirs 2.0.1

• Documentation fixes

platformdirs 2.0.0

• 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

• [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

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

• Fix for Python 3.6 support

appdirs 1.4.2

• [PR #84] Allow installing without setuptools

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

• Add Python 3.6 support

appdirs 1.4.1

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

• [issue #55] Make appname optional

appdirs 1.4.0

• [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

• [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

• [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

• [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.