NewYour coding agent can read the release notes before it upgrades.Set up the MCP server β
PyPI, #42 most downloaded on PyPI
A small Python package for determining appropriate platform-specific dirs, e.g. a `user data dir`.
Latest stable
4.14.8
Last release 2 days ago
20 Nov 2026
Release timing varies
gaps range from 8 days to 2 months
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
6 years old
101 releases Β· first in 2021
Drag across the ruler to compare, or tap a release to open it.
Check Unix runtime directory parents, including sticky directories and symlink targets. Recheck the path after creating a missing XDG runtime director
ensure_exists repairs its permissions. Raise an error if no safe temporary base is available (#744) by @gaborbernat.. or .. as either name (#724) by @mansur-akhmadi and @gaborbernat.isolated_dirs() root when overlapping contexts close out of order (#729) by @gaborbernat.user-dirs.dirs file, including under a group-writable ~/.config. Create configured media directories with mode 0775 subject to the umask (#740) by @gaborbernat.0755 subject to the umask (#742) by @gaborbernat.HOME is unset, empty or relative (#730) by @gaborbernat.site_runtime_dir creates a missing XDG_RUNTIME_DIR with mode 0700 when ensure_exists=True. Find runtime files in valid fallbacks and in directories selected by root redirection or test isolation (#745) by @gaborbernat.Your coding agent can read these notes before it upgrades. Set up the MCP server β
Check Unix runtime directory parents, including sticky directories and symlink targets. Recheck the path after creating a missing XDG runtime directory (738) by gaborbernat.
Check symlinks and entries in shared parents when creating POSIX user directories. Shared sticky directories must belong to root or the caller. Support system-owned Android paths and group-writable container homes (741) by gaborbernat.
Check the parents of the temporary Unix runtime directory. A lookup accepts an existing group-writable fallback. File searches skip it until ensure_exists repairs its permissions. Raise an error if no safe temporary base is available (744) by gaborbernat.
Create deeply nested directories without reaching Python's recursion limit (733) by gaborbernat.
Ignore Windows UNC folder overrides with a missing server or share, or with . or .. as either name (724) by mansur-akhmadi and gaborbernat.
Keep the newest active isolated_dirs() root when overlapping contexts close out of order (729) by gaborbernat.
On macOS, validate the XDG runtime directory and its parents for both user and site paths. File placement and search use the native fallback when the override is unusable (745) by gaborbernat.
Read Unix media settings from a trusted user-dirs.dirs file, including under a group-writable ~/.config. Create configured media directories with mode 0775 subject to the umask (740) by gaborbernat.
Root can look up existing service-owned Unix site directories. Creating directories or placing files requires a root-owned path. Group-writable ancestors are allowed. New directories use mode 0755 subject to the umask (742) by gaborbernat.
Use root's password database home for Unix media and fonts when root redirection is active and HOME is unset, empty or relative (730) by gaborbernat.
Use the same Unix site runtime fallback for lookup and creation when the XDG override fails validation. With root redirection, site_runtime_dir creates a missing XDG_RUNTIME_DIR with mode 0700 when ensure_exists=True. Find runtime files in valid fallbacks and in directories selected by root redirection or test isolation (745) by gaborbernat.
Defer imports on Python 3.15 to reduce startup work (722) by gaborbernat.
Drop a backslash before the line break that ends an unquoted user-dirs.dirs value instead of keeping it in the folder name ( #721 ) by @gaborbernat .
user-dirs.dirs value instead of keeping it in the folder name (#721) by @gaborbernat.Drop a backslash before the line break that ends an unquoted user-dirs.dirs value instead of keeping it in the folder name (721) by gaborbernat.
Accept use_site_for_root in user_fonts_dir , user_fonts_path and the media directory and path functions, so they can return root's own directories as
use_site_for_root in user_fonts_dir, user_fonts_path and the media directory and path functions, so they can return root's own directories as the matching properties do (#686) by @abhishekcpp007 and @gaborbernat.WIN_PD_OVERRIDE_* value that names an extended or device drive without its root, such as \\?\D: or \\.\D:, instead of appending the app name to it as a drive-relative path (#702) by @h55n and @gaborbernat.user-dirs.dirs path as part of the directory name, instead of ignoring the entry (#712) by @liuyinchu and @gaborbernat.WIN_PD_OVERRIDE_* values, since it can end a folder name (#700) by @subotac and @gaborbernat.find_*_file and find_*_files skip a directory the user cannot search, and treat a name too long for the file system as not found, instead of raising on Python 3.13 and older (#703) by @darrenhuai and @gaborbernat.user-dirs.dirs path, as the shell does, and keep an escaped blank before # in the path instead of reading the rest as a comment (#716) by @Primeteumm and @gaborbernat.platformdirs no longer imports typing: the names it needs only for type annotations are imported under a module-level TYPE_CHECKING guard, so import platformdirs is faster (#714) by @hugovk and @gaborbernat..dist-info/sboms directory, written at build time by python-sbom (#696) by @gaborbernat.Accept use_site_for_root in ~platformdirs.user_fonts_dir, ~platformdirs.user_fonts_path and the media directory and path functions, so they can return root's own directories as the matching properties do (686) by abhishekcpp007 and gaborbernat.
Ignore a WIN_PD_OVERRIDE_* value that names an extended or device drive without its root, such as \\?\D: or \\.\D:, instead of appending the app name to it as a drive-relative path (702) by h55n and gaborbernat.
Keep a carriage return inside a user-dirs.dirs path as part of the directory name, instead of ignoring the entry (712) by liuyinchu and gaborbernat.
Keep trailing non-ASCII whitespace, such as a no-break space, in WIN_PD_OVERRIDE_* values, since it can end a folder name (700) by subotac and gaborbernat.
Make find_*_file and find_*_files skip a directory the user cannot search, and treat a name too long for the file system as not found, instead of raising on Python 3.13 and older (703) by darrenhuai and gaborbernat.
Remove the backslash before an escaped character in an unquoted user-dirs.dirs path, as the shell does, and keep an escaped blank before # in the path instead of reading the rest as a comment (716) by Primeteumm and gaborbernat.
Importing platformdirs no longer imports typing: the names it needs only for type annotations are imported under a module-level TYPE_CHECKING guard, so import platformdirs is faster (714) by hugovk and gaborbernat.
Every wheel now carries a PEP 770 CycloneDX SBOM in its .dist-info/sboms directory, written at build time by python-sbom (696) by gaborbernat.
Resolve the temporary user_runtime_dir fallback to /runtime-<uid> instead of //runtime-<uid> when the temporary directory is / ( #687 ) by @darrenhuai
user_runtime_dir fallback to /runtime-<uid> instead of //runtime-<uid> when the temporary directory is / (#687) by @darrenhuai and @gaborbernat.Resolve the temporary user_runtime_dir() fallback to /runtime-<uid> instead of //runtime-<uid> when the temporary directory is / ( PR #687 ) by @darrenhuai and @gaborbernat .
Resolve the temporary ~platformdirs.user_runtime_dir fallback to /runtime-<uid> instead of //runtime-<uid> when the temporary directory is / (687) by darrenhuai and gaborbernat.
π PyPI release π Full Changelog
Preserve trailing whitespace in absolute XDG directory values instead of resolving a different directory ( #679 ) by @mikegit123git and @gaborbernat .
Preserve trailing whitespace in absolute XDG directory values instead of resolving a different directory (679) by mikegit123git and gaborbernat.
Deduplicate equivalent XDG directory spellings across string and path iterators and file searches ( #677 ) by @AlvaroBalbin and @gaborbernat .
Deduplicate equivalent XDG directory spellings across string and path iterators and file searches (677) by AlvaroBalbin and gaborbernat.
Accept a keyword-only ensure_exists in the module-level media directory functions, such as user_documents_path , to create a directory set through XDG
ensure_exists in the module-level media directory functions, such as user_documents_path, to create a directory set through XDG_*_DIR or user-dirs.dirs (#656) by @darrenhuai and @gaborbernat.use_site_for_root, ignoring the invoking user's XDG_*_DIR, user-dirs.dirs and XDG_DATA_HOME, and create no inherited media directory under ensure_exists (#661) by @gaborbernat.ValueError from site_data_dir and site_config_dir under multipath=True when appname or version contains os.pathsep, rather than returning a string that splits into a directory outside the site base (#662) by @gaborbernat.user-dirs.dirs value with a long run of blanks in linear time, rather than in time quadratic in the run's length on every Unix media directory lookup (#663) by @gaborbernat.HOME as unset on Unix, macOS and iOS, taking the home from the password database or raising RuntimeError, rather than resolving user directories against the working directory (#664) by @gaborbernat.XDG_RUNTIME_DIR in user_runtime_dir when the value ends with / or /., which made the check follow the link (#665) by @gaborbernat.user_*_dir calls with use_site_for_root=True when the effective uid is 0, so a setuid-root process gets the site directories, and name and check the runtime directory by the effective uid (#666) by @gaborbernat.XDG_RUNTIME_DIR check of the Unix user_runtime_dir to the macOS one, so it no longer uses a directory that is a symlink, owned by another user or not mode 0700 (#667) by @gaborbernat.XDG_RUNTIME_DIR below a parent that another user can replace, such as their own entry in /tmp, instead of creating the runtime directory through it (#668) by @gaborbernat.ensure_exists and place_runtime_file create it before checking it, and find_runtime_file checks it again after a hit (#669) by @gaborbernat.PermissionError on macOS when ensure_exists would create the site cache through a /Library/Caches/$appname that is a symlink, not a directory, or owned by a user other than root and the current one (#670) by @gaborbernat.ensure_exists, raise FileExistsError when a configured media directory such as user_documents_dir is a regular file or a symlink to one, instead of returning the file's path. Dangling symlinks are still returned unchanged (#672) by @rupayon123 and @gaborbernat.Accept a keyword-only ensure_exists in the module-level media directory functions, such as ~platformdirs.user_documents_path, to create a directory set through XDG_*_DIR or user-dirs.dirs (656) by darrenhuai and gaborbernat.
Return the media and fonts directories under root's home for root with use_site_for_root, ignoring the invoking user's XDG_*_DIR, user-dirs.dirs and XDG_DATA_HOME, and create no inherited media directory under ensure_exists (661) by gaborbernat.
Raise ValueError from site_data_dir and site_config_dir under multipath=True when appname or version contains os.pathsep, rather than returning a string that splits into a directory outside the site base (662) by gaborbernat.
Parse an unquoted user-dirs.dirs value with a long run of blanks in linear time, rather than in time quadratic in the run's length on every Unix media directory lookup (663) by gaborbernat.
Treat a relative HOME as unset on Unix, macOS and iOS, taking the home from the password database or raising RuntimeError, rather than resolving user directories against the working directory (664) by gaborbernat.
Refuse a symlink as XDG_RUNTIME_DIR in ~platformdirs.user_runtime_dir when the value ends with / or /., which made the check follow the link (665) by gaborbernat.
Redirect user_*_dir calls with use_site_for_root=True when the effective uid is 0, so a setuid-root process gets the site directories, and name and check the runtime directory by the effective uid (666) by gaborbernat.
Apply the XDG_RUNTIME_DIR check of the Unix ~platformdirs.user_runtime_dir to the macOS one, so it no longer uses a directory that is a symlink, owned by another user or not mode 0700 (667) by gaborbernat.
Reject an XDG_RUNTIME_DIR below a parent that another user can replace, such as their own entry in /tmp, instead of creating the runtime directory through it (668) by gaborbernat.
Stop accepting a Unix runtime directory that another user creates between the owner check and its use: ensure_exists and ~platformdirs.unix.Unix.place_runtime_file create it before checking it, and ~platformdirs.api.PlatformDirsABC.find_runtime_file checks it again after a hit (669) by gaborbernat.
Raise PermissionError on macOS when ensure_exists would create the site cache through a /Library/Caches/$appname that is a symlink, not a directory, or owned by a user other than root and the current one (670) by gaborbernat.
With ensure_exists, raise FileExistsError when a configured media directory such as user_documents_dir is a regular file or a symlink to one, instead of returning the file's path. Dangling symlinks are still returned unchanged (672) by rupayon123 and gaborbernat.
Fall back to the default media directories when user-dirs.dirs exists but cannot be read, rather than raising PermissionError or IsADirectoryError ( #
user-dirs.dirs exists but cannot be read, rather than raising PermissionError or IsADirectoryError (#632) by @Debasishhh and @gaborbernat.USERPROFILE when HOME is empty, rather than raising RuntimeError (#635) by @pabszero and @gaborbernat.$HOME entries in user-dirs.dirs to /Documents instead of //Documents when the home directory is / (#636) by @darrenhuai and @gaborbernat.python -m platformdirs when the home directory is unknown, rather than stopping with RuntimeError (#638) by @tongwentao and @gaborbernat.FileNotFoundError from the place_*_file methods when the user directory is on a missing Windows drive or network share, rather than recursing until RecursionError (#639) by @nk-batman21 and @gaborbernat.iter_*_paths method in find_*_file and find_*_files, rather than the base class ones (#640) by @KennyMcSimpson and @gaborbernat.isolated_dirs paths under a relative root after the working directory changes, and yield the root as an absolute path (#643) by @0x5t4l1n and @gaborbernat.\\server, instead of treating the application name as the share (#647) by @RedCat888 and @gaborbernat./opt/homebrew from a macOS source comment. Homebrew replaces it with a placeholder when bottling on Apple Silicon but not on Linux, so formulae that bundle platformdirs could not share one bottle across both (#644) by @Moisan and @gaborbernat.Fall back to the default media directories when user-dirs.dirs exists but cannot be read, rather than raising PermissionError or IsADirectoryError (632) by Debasishhh and gaborbernat.
Resolve the Windows Projects directory from USERPROFILE when HOME is empty, rather than raising RuntimeError (635) by pabszero and gaborbernat.
Resolve $HOME entries in user-dirs.dirs to /Documents instead of //Documents when the home directory is / (636) by darrenhuai and gaborbernat.
Print the error and keep listing directories in python -m platformdirs when the home directory is unknown, rather than stopping with RuntimeError (638) by tongwentao and gaborbernat.
Raise FileNotFoundError from the place_*_file methods when the user directory is on a missing Windows drive or network share, rather than recursing until RecursionError (639) by nk-batman21 and gaborbernat.
Search the directories of a subclass's overridden iter_*_paths method in find_*_file and find_*_files, rather than the base class ones (640) by KennyMcSimpson and gaborbernat.
Keep isolated_dirs paths under a relative root after the working directory changes, and yield the root as an absolute path (643) by 0x5t4l1n and gaborbernat.
Ignore Windows folder overrides with a UNC path missing its server or share name, such as \\server, instead of treating the application name as the share (647) by RedCat888 and gaborbernat.
Remove the literal /opt/homebrew from a macOS source comment. Homebrew replaces it with a placeholder when bottling on Apple Silicon but not on Linux, so formulae that bundle platformdirs could not share one bottle across both (644) by Moisan and gaborbernat.
Releases now run on the shared tox-dev/github-workflows pipeline, with a locked release toolchain and generated GitHub Release notes ( #650 ) by @gabo
Releases now run on the shared tox-dev/github-workflows pipeline, with a locked release toolchain and generated GitHub Release notes (650) by gaborbernat.
Publish a GitHub Release with changelog notes, a PyPI link, and a version comparison after each PyPI release. #631 by @gaborbernat .
Publish a GitHub Release with changelog notes, a PyPI link, and a version comparison after each PyPI release. 631 - by gaborbernat.
Require a complete files path segment when locating Android app directories from sys.path. #621 by @shoaibulhaque and @gaborbernat.
<a name="release-4-13-4-fixed"></a>
files path segment when locating Android app directories from sys.path. #621 by @shoaibulhaque and @gaborbernat.RuntimeError when iOS cannot resolve the home directory, rather than returning paths rooted at a literal ~. #624 by @XXXXXQ-0206 and @gaborbernat.isolated_dirs when Unix root enables use_site_for_root. Restore root redirection when the context exits. #625 by @AryanRG and @gaborbernat.RuntimeError when the Windows Projects directory cannot resolve the home directory, rather than returning a path rooted at a literal ~. #627 by @XXXXXQ-0206.Require a complete files path segment when locating Android app directories from sys.path. 621 - by shoaibulhaque and gaborbernat.
Raise RuntimeError when iOS cannot resolve the home directory, rather than returning paths rooted at a literal ~. 624 - by XXXXXQ-0206 and gaborbernat.
Keep user directory strings, paths and iterators consistent inside isolated_dirs when Unix root enables use_site_for_root. Restore root redirection when the context exits. 625 - by AryanRG and gaborbernat.
Raise RuntimeError when the Windows Projects directory cannot resolve the home directory, rather than returning a path rooted at a literal ~. 627 - by XXXXXQ-0206.
π PyPI release π Full Changelog
Normalize user_fonts_dir when XDG_DATA_HOME ends with a separator. #619 by @blouirts123 and @gaborbernat.
<a name="release-4-13-2-fixed"></a>
user_fonts_dir when XDG_DATA_HOME ends with a separator. #619 by @blouirts123 and @gaborbernat.Normalize user_fonts_dir when XDG_DATA_HOME ends with a separator. 619 - by blouirts123 and gaborbernat.
Preserve literal backslashes before ordinary characters in double-quoted user-dirs.dirs paths instead of removing them. #614 by @xiehuanyi and @gaborb
<a name="release-4-13-1-fixed"></a>
user-dirs.dirs paths instead of removing them. #614 by @xiehuanyi and @gaborbernat.Preserve literal backslashes before ordinary characters in double-quoted user-dirs.dirs paths instead of removing them. 614 - by xiehuanyi and gaborbernat.
Avoid leaking the Windows known-folder path buffer when a lookup fails. 618 - by gaborbernat and repzakske.
Detect Homebrew Python for the MacOS site directories under python:-S, which leaves base_prefix on the Cellar keg, and for the python-freethreading fo
<a name="release-4-13-0-fixed"></a>
MacOS site directories under python:-S, which leaves base_prefix on the Cellar keg, and for the python-freethreading formula. #612 by @sricharanreddycheruku and @gaborbernat.Detect Homebrew Python for the MacOS site directories under -S , which leaves sys.base_prefix on the Cellar keg, and for the python-freethreading formula. PR #612 - by @sricharanreddycheruku and @gaborbernat .
Detect Homebrew Python for the ~platformdirs.macos.MacOS site directories under python:-S, which leaves sys.base_prefix on the Cellar keg, and for the python-freethreading formula. 612 - by sricharanreddycheruku and gaborbernat.
Keep site directories readable by other users when root calls place_config_file or another place_*_file method with use_site_for_root. #610 by @darren
<a name="release-4-12-4-fixed"></a>
place_config_file or another place_*_file method with use_site_for_root. #610 by @darrenhuai and @gaborbernat.user_runtime_dir warn and fall back from an unreachable XDG_RUNTIME_DIR under ensure_exists instead of raising. #611 by @harbinresearcher and @gaborbernat.Keep site directories readable by other users when root calls ~platformdirs.api.PlatformDirsABC.place_config_file or another place_*_file method with ~platformdirs.api.PlatformDirsABC.use_site_for_root. 610 - by darrenhuai and gaborbernat.
Make ~platformdirs.user_runtime_dir warn and fall back from an unreachable XDG_RUNTIME_DIR under ~platformdirs.api.PlatformDirsABC.ensure_exists instead of raising. 611 - by harbinresearcher and gaborbernat.
Place files from place_config_file and place_data_file in the first site directory for root on Unix with use_site_for_root=True and multipath=True, wh
<a name="release-4-12-3-fixed"></a>
place_config_file and place_data_file in the first site directory for root on Unix with use_site_for_root=True and multipath=True, where find_config_file and find_data_file look for them. #607 by @PDGGK and @gaborbernat.Place files from place_config_file and place_data_file in the first site directory for root on Unix with use_site_for_root=True and multipath=True, where find_config_file and find_data_file look for them. 607 - by PDGGK and gaborbernat.
Keep os.pathsep in site_applications_path under multipath=True on platforms with one applications directory. #604 by @9Kun and @gaborbernat.
<a name="release-4-12-2-fixed"></a>
os.pathsep in site_applications_path under multipath=True on platforms with one applications directory. #604 by @9Kun and @gaborbernat.Keep os.pathsep in site_applications_path under multipath=True on platforms with one applications directory. 604 - by 9Kun and gaborbernat.
Avoid PytestAssertRewriteWarning when importing platformdirs before invoking pytest. #601 #602 by @gaborbernat.
<a name="release-4-12-1-fixed"></a>
PytestAssertRewriteWarning when importing platformdirs before invoking pytest. #601 #602 by @gaborbernat.Avoid PytestAssertRewriteWarning when importing platformdirs before invoking pytest. 601 602 - by gaborbernat.
Add place_*_file methods that return a file path under a user directory and create its missing parents with mode 0o700. #585 by @gaborbernat.
<a name="release-4-12-0-added"></a>
place_*_file methods that return a file path under a user directory and create its missing parents with mode 0o700. #585 by @gaborbernat.find_<kind>_file and find_<kind>_files to look up an existing file across the user and site directories of each kind that has an iter_<kind>_paths method. #586 by @gaborbernat.isolated_dirs and the platformdirs_isolated pytest fixture to resolve every directory under one test root. #590 by @gaborbernat.RuntimeDirWarning when the Unix user_runtime_dir falls back from XDG_RUNTIME_DIR. #599 by @gaborbernat.user_templates_dir, user_publicshare_dir and user_bin_dir on Windows from their known folders. #587 by @gaborbernat.~/Library/Application Support for data. #600 by @gaborbernat.<a name="release-4-12-0-fixed"></a>
RuntimeError for a Unix or macOS directory under the home when no home resolves, and read the password database for an empty HOME. #589 by @gaborbernat.<a name="release-4-12-0-documentation"></a>
multipath. #591 by @gaborbernat.XDG_*_DIR variables. #592 by @gaborbernat.WIN_PD_OVERRIDE_COMMON_PROGRAMS variable. #593 by @gaborbernat./usr/local/share/applications as the Linux site_applications_dir default. #594 by @gaborbernat.user_runtime_dir defaults and describe the temporary directory fallback. #595 by @gaborbernat.AppData. #597 by @gaborbernat.user_fonts_dir. #598 by @gaborbernat.<a name="release-4-12-0-security"></a>
0700 under ensure_exists on POSIX platforms. #588 by @gaborbernat.XDG_RUNTIME_DIR or /run/user/<uid> that is not a private directory of the user, and reject a symlink or file as the runtime-<uid> fallback. #599 by @gaborbernat.Add place_*_file methods that return a file path under a user directory and create its missing parents with mode 0o700. 585 - by gaborbernat.
Add find_<kind>_file and find_<kind>_files to look up an existing file across the user and site directories of each kind that has an iter_<kind>_paths method. 586 - by gaborbernat.
Add platformdirs.testing.isolated_dirs and the platformdirs_isolated pytest fixture to resolve every directory under one test root. 590 - by gaborbernat.
Emit ~platformdirs.RuntimeDirWarning when the Unix ~platformdirs.user_runtime_dir falls back from XDG_RUNTIME_DIR. 599 - by gaborbernat.
Read user_templates_dir, user_publicshare_dir and user_bin_dir on Windows from their known folders. 587 - by gaborbernat.
Use the app container layout on iOS, such as ~/Library/Application Support for data. 600 - by gaborbernat.
Raise RuntimeError for a Unix or macOS directory under the home when no home resolves, and read the password database for an empty HOME. 589 - by gaborbernat.
Document that a Homebrew Python puts the Homebrew prefix first in the macOS shared directories, with or without multipath. 591 - by gaborbernat.
Document that the macOS media directories honor the XDG_*_DIR variables. 592 - by gaborbernat.
Document the WIN_PD_OVERRIDE_COMMON_PROGRAMS variable. 593 - by gaborbernat.
Document /usr/local/share/applications as the Linux site_applications_dir default. 594 - by gaborbernat.
Correct the BSD user_runtime_dir defaults and describe the temporary directory fallback. 595 - by gaborbernat.
Describe how platformdirs detects Android, finds the app folder and places the shared folders. 596 - by gaborbernat.
Document that Microsoft Store Python redirects only new files and folders under AppData. 597 - by gaborbernat.
Show how to load a font on Windows after copying it into user_fonts_dir. 598 - by gaborbernat.
Create missing user app directories and their parents with mode 0700 under ensure_exists on POSIX platforms. 588 - by gaborbernat.
Skip an XDG_RUNTIME_DIR or /run/user/<uid> that is not a private directory of the user, and reject a symlink or file as the runtime-<uid> fallback. 599 - by gaborbernat.
Fix the pyjnius lookup of the Android app folder and media directories, which always failed. #580 by @gaborbernat.
<a name="release-4-11-15-fixed"></a>
sys.getandroidapilevel when ANDROID_DATA and ANDROID_ROOT are unset. #581 by @gaborbernat.Movies and the five non-standard media folders, such as Desktop, into Documents. #583 by @gaborbernat.Fix the pyjnius lookup of the Android app folder and media directories, which always failed. 580 - by gaborbernat.
Detect Android from sys.getandroidapilevel when ANDROID_DATA and ANDROID_ROOT are unset. 581 - by gaborbernat.
Put Android shared-storage directories under the current user's /storage/emulated/<user id>, not user 0's. 582 - by gaborbernat.
Move Android videos to Movies and the five non-standard media folders, such as Desktop, into Documents. 583 - by gaborbernat.
Accept roaming in user_log_dir and user_log_path. #572 by @gaborbernat.
<a name="release-4-11-14-added"></a>
roaming in user_log_dir and user_log_path. #572 by @gaborbernat.<a name="release-4-11-14-fixed"></a>
ensure_exists, create a media directory such as user_documents_dir only when the user set it through an XDG_*_DIR variable or user-dirs.dirs, and return a dangling symlink there instead of raising FileExistsError. 4.11.13 also created the platform defaults, which filled headless home directories with folders such as ~/Templates and made a literal ~ directory when HOME was unset. #561 by @gaborbernat.$XDG_RUNTIME_DIR in user_runtime_dir when use_site_for_root redirects root. #562 by @gaborbernat./storage/emulated/0/Download from the Android user_downloads_dir fallback. #563 by @gaborbernat.WIN_PD_OVERRIDE_* values that lack a drive or a root. #564 by @gaborbernat.files. #565 by @gaborbernat.use_site_for_root on the next read. #567 by @gaborbernat.UnicodeDecodeError on user-dirs.dirs bytes the locale encoding cannot decode. #568 by @gaborbernat.# comment from unquoted user-dirs.dirs values. #569 by @gaborbernat.PUBLIC or LOCALAPPDATA, as unset. #571 by @gaborbernat.opt/python*/Frameworks layout. #573 by @gaborbernat.site_cache_path under multipath. #574 by @gaborbernat.RuntimeError in place of creating a literal ~ directory when ensure_exists finds no home. #578 by @gaborbernat.<a name="release-4-11-14-documentation"></a>
user_preference_dir path in the platform docs. #577 by @gaborbernat.user_state_dir and site_state_dir ignore the XDG_DATA_* variables. #579 by @gaborbernat.<a name="release-4-11-14-security"></a>
appname, appauthor or version that leaves the base directory when set after construction. #566 by @gaborbernat.runtime-<uid> temporary fallback with mode 0700 and reject one another user owns. #576 by @gaborbernat.Accept roaming in ~platformdirs.user_log_dir and ~platformdirs.user_log_path. 572 - by gaborbernat.
With ensure_exists, create a media directory such as user_documents_dir only when the user set it through an XDG_*_DIR variable or user-dirs.dirs, and return a dangling symlink there instead of raising FileExistsError. 4.11.13 also created the platform defaults, which filled headless home directories with folders such as ~/Templates and made a literal ~ directory when HOME was unset. 561 - by gaborbernat.
Ignore $XDG_RUNTIME_DIR in user_runtime_dir when use_site_for_root redirects root. 562 - by gaborbernat.
Return /storage/emulated/0/Download from the Android ~platformdirs.user_downloads_dir fallback. 563 - by gaborbernat.
Ignore WIN_PD_OVERRIDE_* values that lack a drive or a root. 564 - by gaborbernat.
Find the Android app folder for package names that start with files. 565 - by gaborbernat.
Apply a changed use_site_for_root on the next read. 567 - by gaborbernat.
Stop raising UnicodeDecodeError on user-dirs.dirs bytes the locale encoding cannot decode. 568 - by gaborbernat.
Drop a trailing # comment from unquoted user-dirs.dirs values. 569 - by gaborbernat.
Treat empty Windows folder variables, such as PUBLIC or LOCALAPPDATA, as unset. 571 - by gaborbernat.
Detect Homebrew Python on macOS by its opt/python*/Frameworks layout. 573 - by gaborbernat.
Keep colons in the Unix site_cache_path under multipath. 574 - by gaborbernat.
Return long Windows folder paths in place of 8.3 short names. 575 - by gaborbernat.
Raise RuntimeError in place of creating a literal ~ directory when ensure_exists finds no home. 578 - by gaborbernat.
Fix the Windows user_preference_dir path in the platform docs. 577 - by gaborbernat.
Document that the macOS user_state_dir and site_state_dir ignore the XDG_DATA_* variables. 579 - by gaborbernat.
Reject an appname, appauthor or version that leaves the base directory when set after construction. 566 - by gaborbernat.
Create the Unix runtime-<uid> temporary fallback with mode 0700 and reject one another user owns. 576 - by gaborbernat.
With ensure_exists, the media directories such as user_documents_dir are created on Unix, and on macOS when an XDG variable sets them. #560 by @gaborb
<a name="release-4-11-13-fixed"></a>
ensure_exists, the media directories such as user_documents_dir are created on Unix, and on macOS when an XDG variable sets them. #560 by @gaborbernat and @ekanshul.With ensure_exists, the media directories such as user_documents_dir are created on Unix, and on macOS when an XDG variable sets them. 560 - by gaborbernat and ekanshul.
Ignore relative paths in the XDG user directory environment variables, so XDG_DOCUMENTS_DIR=Documents no longer makes user_documents_dir and the other
<a name="release-4-11-12-fixed"></a>
XDG_DOCUMENTS_DIR=Documents no longer makes user_documents_dir and the other media directories return a path relative to the working directory. They now fall back to the platform default like the XDG Base Directory variables, and like the same keys read from user-dirs.dirs. #554 by @darrenhuai.<a name="release-4-11-12-documentation"></a>
Ignore relative paths in the XDG user directory environment variables, so XDG_DOCUMENTS_DIR=Documents no longer makes ~platformdirs.user_documents_dir and the other media directories return a path relative to the working directory. They now fall back to the platform default like the XDG Base Directory variables, and like the same keys read from user-dirs.dirs. 554 - by darrenhuai.
Copy nested directories in the versioned data migration recipe. 553 - by agammann.
Reject appname, appauthor and version values that leave the platform base directory (a .. segment, a leading separator, a drive or a UNC share) with V
<a name="release-4-11-11-security"></a>
appname, appauthor and version values that leave the platform base directory (a .. segment, a leading separator, a drive or a UNC share) with ValueError, so ensure_exists cannot create directories outside it. #552 by @Pitchfork-and-Torch and @gaborbernat.Reject appname, appauthor and version values that leave the platform base directory (a .. segment, a leading separator, a drive or a UNC share) with ValueError, so ensure_exists cannot create directories outside it. 552 - by Pitchfork-and-Torch and gaborbernat.
With ensure_exists, the site_*_dir and site_*_path properties and the iter_*_dirs iterators only create the site directories they return or yield, ins
<a name="release-4-11-10-fixed"></a>
ensure_exists, the site_*_dir and site_*_path properties and the iter_*_dirs iterators only create the site directories they return or yield, instead of every entry in the site list. #550 by @darrenhuai and @gaborbernat.With ensure_exists, the site_*_dir and site_*_path properties and the iter_*_dirs iterators only create the site directories they return or yield, instead of every entry in the site list. 550 - by darrenhuai and gaborbernat.
Accept multipath in site_cache_dir and site_cache_path. Without it, the function API could not return the Homebrew cache prefix that site_cache_dir ad
<a name="release-4-11-9-added"></a>
multipath in site_cache_dir and site_cache_path. Without it, the function API could not return the Homebrew cache prefix that site_cache_dir adds under multipath. #544 by @darrenhuai and @gaborbernat.<a name="release-4-11-9-fixed"></a>
user-dirs.dirs line by line like xdg-user-dir. The INI parser raised on a repeated key or a line without =, and returned trailing comments and backslash escapes inside user_documents_dir and the other media directories. The last valid assignment now wins, and platformdirs unescapes the quoted value and ignores text after the closing quote. #545 by @darrenhuai and @gaborbernat.PUBLIC before the home directory in user_publicshare_dir on Windows, so it no longer raises RuntimeError when PUBLIC is set and the home directory cannot be determined. #546 by @emme1t and @gaborbernat.RuntimeError from Android directories when the app folder cannot be found, instead of TypeError: expected str, bytes or os.PathLike object, not NoneType. #547 by @Str0k and @gaborbernat.Accept multipath in ~platformdirs.site_cache_dir and ~platformdirs.site_cache_path. Without it, the function API could not return the Homebrew cache prefix that ~platformdirs.macos.MacOS.site_cache_dir adds under multipath. 544 - by darrenhuai and gaborbernat.
Parse Unix user-dirs.dirs line by line like xdg-user-dir. The INI parser raised on a repeated key or a line without =, and returned trailing comments and backslash escapes inside ~platformdirs.user_documents_dir and the other media directories. The last valid assignment now wins, and platformdirs unescapes the quoted value and ignores text after the closing quote. 545 - by darrenhuai and gaborbernat.
Read PUBLIC before the home directory in ~platformdirs.user_publicshare_dir on Windows, so it no longer raises RuntimeError when PUBLIC is set and the home directory cannot be determined. 546 - by emme1t and gaborbernat.
Raise RuntimeError from ~platformdirs.android.Android directories when the app folder cannot be found, instead of TypeError: expected str, bytes or os.PathLike object, not NoneType. 547 - by Str0k and gaborbernat.
Make user_data_path, user_config_path, user_preference_path and user_applications_path return the first site entry when root is redirected by use_site
<a name="release-4-11-8-fixed"></a>
user_data_path, user_config_path, user_preference_path and user_applications_path return the first site entry when root is redirected by use_site_for_root under multipath, matching their site_*_path twins. They passed the whole joined list to Path, giving one unusable path such as /xdg/a/foo:/xdg/b/foo. #538 by @darrenhuai and @gaborbernat.$XDG_DATA_DIRS and $XDG_CONFIG_DIRS are skipped. #540 by @lakshayxi and @gaborbernat.user-dirs.dirs paths, including 100% complete, 100%% and %(XDG_DESKTOP_DIR)s. Continue to expand $HOME. #542 by @jackwalkerlabs and @gaborbernat.Make ~platformdirs.user_data_path, ~platformdirs.user_config_path, ~platformdirs.user_preference_path and ~platformdirs.user_applications_path return the first site entry when root is redirected by use_site_for_root under multipath, matching their site_*_path twins. They passed the whole joined list to ~pathlib.Path, giving one unusable path such as /xdg/a/foo:/xdg/b/foo. 538 - by darrenhuai and gaborbernat.
Ignore relative paths in XDG Base Directory environment variables and use the existing platform fallback. Relative entries in $XDG_DATA_DIRS and $XDG_CONFIG_DIRS are skipped. 540 - by lakshayxi and gaborbernat.
Preserve literal percent signs in Unix user-dirs.dirs paths, including 100% complete, 100%% and %(XDG_DESKTOP_DIR)s. Continue to expand $HOME. 542 - by jackwalkerlabs and gaborbernat.
Use the base Python installation to locate Homebrew site directories on macOS, preserving shared data, config, cache and state paths inside virtual environments. 543 - by jackwalkerlabs and gaborbernat.
π PyPI release π Full Changelog
Give user_bin_dir and user_bin_path the use_site_for_root argument. They took none, so neither could reach the Unix redirect of root to site_bin_dir.
<a name="release-4-11-6-added"></a>
user_bin_dir and user_bin_path the use_site_for_root argument. They took none, so neither could reach the Unix redirect of root to site_bin_dir. #537 by @darrenhuai and @gaborbernat.Give ~platformdirs.user_bin_dir and ~platformdirs.user_bin_path the use_site_for_root argument. They took none, so neither could reach the Unix redirect of root to ~platformdirs.site_bin_dir. 537 - by darrenhuai and gaborbernat.
Give user_preference_dir and user_preference_path the same arguments as user_config_dir. The functions were introduced in 4.10.0 without arguments, so
<a name="release-4-11-5-added"></a>
user_preference_dir and user_preference_path the same arguments as user_config_dir. The functions were introduced in 4.10.0 without arguments, so they could only return the unscoped base directory even though the property they wrap appends the app name and version. #491 #531 by @gaborbernat and @dylanpulver.user_applications_dir, user_applications_path, site_applications_dir and site_applications_path the app arguments. Android scopes both applications directories to the app, so without them the functions could only return the unscoped base directory there. On the two site functions they are keyword-only, keeping multipath first positional as it has been since 4.9.0; the two user functions take their boolean options keyword-only. #534 by @gaborbernat.<a name="release-4-11-5-fixed"></a>
site_applications_path return the first entry when multipath=True, matching site_data_path. On Unix and macOS it passed the whole $XDG_DATA_DIRS list to Path, giving one unusable path such as /first/applications:/second/applications. #532 by @tunglambk and @gaborbernat.<a name="release-4-11-5-documentation"></a>
use_site_for_root drops the user directory entirely, so the iterators are documented as yielding the most specific directory first rather than always yielding the user one. #533 by @gaborbernat.Give ~platformdirs.user_preference_dir and ~platformdirs.user_preference_path the same arguments as ~platformdirs.user_config_dir. The functions were introduced in 4.10.0 without arguments, so they could only return the unscoped base directory even though the property they wrap appends the app name and version. 491 531 - by gaborbernat and dylanpulver.
Give ~platformdirs.user_applications_dir, ~platformdirs.user_applications_path, ~platformdirs.site_applications_dir and ~platformdirs.site_applications_path the app arguments. Android scopes both applications directories to the app, so without them the functions could only return the unscoped base directory there. On the two site functions they are keyword-only, keeping multipath first positional as it has been since 4.9.0; the two user functions take their boolean options keyword-only. 534 - by gaborbernat.
Make ~platformdirs.site_applications_path return the first entry when multipath=True, matching ~platformdirs.site_data_path. On Unix and macOS it passed the whole $XDG_DATA_DIRS list to ~pathlib.Path, giving one unusable path such as /first/applications:/second/applications. 532 - by tunglambk and gaborbernat.
Correct the ordering note on the iterator methods. use_site_for_root drops the user directory entirely, so the iterators are documented as yielding the most specific directory first rather than always yielding the user one. 533 - by gaborbernat.
Stop the iter_*_dirs methods yielding the same directory twice when a site directory resolves to its user equivalent - covered only Unix with use_site
<a name="release-4-11-4-fixed"></a>
iter_*_dirs methods yielding the same directory twice when a site directory resolves to its user equivalent - covered only Unix with use_site_for_root. It also hit iter_runtime_dirs on Unix with $XDG_RUNTIME_DIR set, on Windows and macOS, and all six iterators on Android. #520 #524 by @darrenhuai and @gaborbernat.<a name="release-4-11-4-documentation"></a>
iter_config_paths yields the user directory first, so the config.update loop let the site defaults override the user's config instead of the other way round. #529 by @gaborbernat.Stop the iter_*_dirs methods yielding the same directory twice when a site directory resolves to its user equivalent - covered only Unix with use_site_for_root. It also hit ~platformdirs.PlatformDirs.iter_runtime_dirs on Unix with $XDG_RUNTIME_DIR set, on Windows and macOS, and all six iterators on Android. 520 524 - by darrenhuai and gaborbernat.
Fix the config merging example in the how-to guide. iter_config_paths yields the user directory first, so the config.update loop let the site defaults override the user's config instead of the other way round. 529 - by gaborbernat.
python -m platformdirs now lists user_desktop_dir, which was missing from the properties it prints. #523 by @darrenhuai and @gaborbernat.
<a name="release-4-11-3-added"></a>
python -m platformdirs now lists user_desktop_dir, which was missing from the properties it prints. #523 by @darrenhuai and @gaborbernat.<a name="release-4-11-3-fixed"></a>
site_data_dir, site_config_dir and site_applications_dir raising IndexError on Unix and macOS when $XDG_DATA_DIRS or $XDG_CONFIG_DIRS holds only separators and whitespace, such as ":". These values now fall back to the platform defaults, and each entry is stripped of surrounding whitespace. #523 by @darrenhuai and @gaborbernat.python -m platformdirs now lists ~platformdirs.user_desktop_dir, which was missing from the properties it prints. 523 - by darrenhuai and gaborbernat.
Stop ~platformdirs.site_data_dir, ~platformdirs.site_config_dir and ~platformdirs.site_applications_dir raising IndexError on Unix and macOS when $XDG_DATA_DIRS or $XDG_CONFIG_DIRS holds only separators and whitespace, such as ":". These values now fall back to the platform defaults, and each entry is stripped of surrounding whitespace. 523 - by darrenhuai and gaborbernat.
Stop iter_cache_dirs, iter_state_dirs, iter_log_dirs and iter_runtime_dirs yielding the same directory twice on Unix when use_site_for_root is active
<a name="release-4-11-2-fixed"></a>
iter_cache_dirs, iter_state_dirs, iter_log_dirs and iter_runtime_dirs yielding the same directory twice on Unix when use_site_for_root is active - fixed this for the config and data iterators only. On macOS, iter_cache_dirs now yields the Homebrew and /Library/Caches entries separately rather than one os.pathsep-joined string when multipath is set. #469 #520 by @viccie30 and @darrenhuai.Stop ~platformdirs.PlatformDirs.iter_cache_dirs, ~platformdirs.PlatformDirs.iter_state_dirs, ~platformdirs.PlatformDirs.iter_log_dirs and ~platformdirs.PlatformDirs.iter_runtime_dirs yielding the same directory twice on Unix when use_site_for_root is active - fixed this for the config and data iterators only. On macOS, ~platformdirs.PlatformDirs.iter_cache_dirs now yields the Homebrew and /Library/Caches entries separately rather than one os.pathsep-joined string when multipath is set. 469 520 - by viccie30 and darrenhuai.
Fix user_desktop_dir on Windows builds without ctypes. CSIDL_DESKTOPDIRECTORY appeared only in the ctypes lookup table, so the registry and environmen
<a name="release-4-11-1-fixed"></a>
user_desktop_dir on Windows builds without ctypes. CSIDL_DESKTOPDIRECTORY appeared only in the ctypes lookup table, so the registry and environment variable resolvers raised ValueError for it. #519 by @darrenhuai and @gaborbernat.Fix ~platformdirs.user_desktop_dir on Windows builds without ctypes. CSIDL_DESKTOPDIRECTORY appeared only in the ctypes lookup table, so the registry and environment variable resolvers raised ValueError for it. 519 - by darrenhuai and gaborbernat.
Declare support for Python 3.15 and run the test suite against it, currently in beta. #512 by @gaborbernat.
<a name="release-4-11-0-added"></a>
Declare support for Python 3.15 and run the test suite against it, currently in beta. 512 - by gaborbernat.
Stop leaking memory on repeated Windows folder lookups. get_win_folder_via_ctypes defined a fresh ctypes structure on every call, and each one registe
<a name="release-4-10-1-performance"></a>
get_win_folder_via_ctypes defined a fresh ctypes structure on every call, and each one registered a pointer type that was never released; the resolver is now built once and reused. #507 by @gaborbernat.Stop leaking memory on repeated Windows folder lookups. get_win_folder_via_ctypes defined a fresh ctypes structure on every call, and each one registered a pointer type that was never released; the resolver is now built once and reused. 507 - by gaborbernat.
Add user_publicshare_dir, user_templates_dir, user_fonts_dir, and user_preference_dir. #491 by @gaborbernat.
<a name="release-4-10-0-added"></a>
user_publicshare_dir, user_templates_dir, user_fonts_dir, and user_preference_dir. #491 by @gaborbernat.user_projects_dir backed by $XDG_PROJECTS_DIR. #490 by @gaborbernat.<a name="release-4-10-0-fixed"></a>
site_config_path on macOS when multipath is set. #488 by @lphuc2250gma.Add ~platformdirs.user_publicshare_dir, ~platformdirs.user_templates_dir, ~platformdirs.user_fonts_dir, and ~platformdirs.user_preference_dir. 491 - by gaborbernat.
Add ~platformdirs.user_projects_dir backed by $XDG_PROJECTS_DIR. 490 - by gaborbernat.
Return only the first path from ~platformdirs.site_config_path on macOS when multipath is set. 488 - by lphuc2250gma.
Fix macOS XDG variables leaking across user_config_dir, user_data_dir, and user_state_dir when only some are set. #473 by @Goddesen.
<a name="release-4-9-6-fixed"></a>
user_config_dir, user_data_dir, and user_state_dir when only some are set. #473 by @Goddesen.iter_config_dirs and iter_data_dirs when use_site_for_root is active. #469 by @viccie30.Fix macOS XDG variables leaking across ~platformdirs.user_config_dir, ~platformdirs.user_data_dir, and ~platformdirs.user_state_dir when only some are set. 473 - by Goddesen.
Avoid duplicate site directories in Unix ~platformdirs.PlatformDirs.iter_config_dirs and ~platformdirs.PlatformDirs.iter_data_dirs when use_site_for_root is active. 469 - by viccie30.
Respect XDG_CONFIG_HOME when reading the user-dirs configuration. #453 by @bysiber.
Respect XDG_CONFIG_HOME when reading the user-dirs configuration. 453 - by bysiber.
Create the directory in Android ~platformdirs.user_log_dir and ~platformdirs.user_runtime_dir when ensure_exists is set. 452 - by bysiber.
π PyPI release π Full Changelog
π PyPI release π Full Changelog
Add site_bin_dir. #443 by @gaborbernat.
<a name="release-4-9-0-added"></a>
site_bin_dir. #443 by @gaborbernat.site_applications_dir. #442 by @gaborbernat.<a name="release-4-9-0-fixed"></a>
Add site_bin_dir() . PR #443 - by @gaborbernat .
Add site_applications_dir() . PR #442 - by @gaborbernat .
Use the correct runtime directory path on OpenBSD. PR #440 - by @gaborbernat .
Add ~platformdirs.site_bin_dir. 443 - by gaborbernat.
Add ~platformdirs.site_applications_dir. 442 - by gaborbernat.
Use the correct runtime directory path on OpenBSD. 440 - by gaborbernat.
Add use_site_for_root to redirect user_*_dir to site_*_dir for root on Unix. #426 by @gaborbernat.
<a name="release-4-8-0-added"></a>
use_site_for_root to redirect user_*_dir to site_*_dir for root on Unix. #426 by @gaborbernat.site_state_dir for system-wide state. #425 by @gaborbernat.site_log_dir. #424 by @gaborbernat.user_applications_dir. #432 by @gaborbernat.user_bin_dir. #430 by @gaborbernat.PLATFORMDIRS_* environment variable overrides for Windows folder resolution. #427 by @gaborbernat.WIN_PD_OVERRIDE_* environment variable overrides for Windows folder resolution. #428 by @gaborbernat.<a name="release-4-8-0-fixed"></a>
iter_data_dirs and iter_config_dirs on macOS. #429 by @gaborbernat.Add use_site_for_root to redirect user_*_dir to site_*_dir for root on Unix. 426 - by gaborbernat.
Add ~platformdirs.site_state_dir for system-wide state. 425 - by gaborbernat.
Add ~platformdirs.site_log_dir. 424 - by gaborbernat.
Add ~platformdirs.user_applications_dir. 432 - by gaborbernat.
Add ~platformdirs.user_bin_dir. 430 - by gaborbernat.
Add PLATFORMDIRS_* environment variable overrides for Windows folder resolution. 427 - by gaborbernat.
Add WIN_PD_OVERRIDE_* environment variable overrides for Windows folder resolution. 428 - by gaborbernat.
Yield individual site directories from ~platformdirs.PlatformDirs.iter_data_dirs and ~platformdirs.PlatformDirs.iter_config_dirs on macOS. 429 - by gaborbernat.
Avoid FileNotFoundError on Windows in sandboxed environments. #422 by @gaborbernat.
<a name="release-4-7-1-fixed"></a>
FileNotFoundError on Windows in sandboxed environments. #422 by @gaborbernat.Avoid FileNotFoundError on Windows in sandboxed environments. PR #422 - by @gaborbernat .
Avoid FileNotFoundError on Windows in sandboxed environments. 422 - by gaborbernat.
Find relocated Windows Downloads folders and preserve long paths through SHGetKnownFolderPath. #380 by @moi15moi and @gaborbernat.
<a name="release-4-7-0-fixed"></a>
SHGetKnownFolderPath. #380 by @moi15moi and @gaborbernat.Find relocated Windows Downloads folders and preserve long paths through SHGetKnownFolderPath. 380 - by moi15moi and gaborbernat.
Fall back to a temp directory when the Unix runtime dir is not writable. 369 - by lengau and gaborbernat.
Honor XDG environment variables on macOS. #375 by @Czaki and @gaborbernat.
<a name="release-4-6-0-fixed"></a>
<a name="release-4-6-0-documentation"></a>
site_cache_dir documentation. #402 by @brianhelba.Honor XDG environment variables on macOS. 375 - by Czaki and gaborbernat.
Fix ~platformdirs.site_cache_dir documentation. 402 - by brianhelba.
Fix an outdated link and correct a function docstring. 398 - by joclement.
Fix no-ctypes fallback on Windows. #403 by @youknowone.
<a name="release-4-5-1-fixed"></a>
Add support for Python 3.14. #382 by @hugovk.
<a name="release-4-5-0-added"></a>
<a name="release-4-5-0-documentation"></a>
Add support for Python 3.14. 382 - by hugovk.
Drop support for Python 3.9. 389 - by gaborbernat.
Update Windows file paths in README. 385 - by ParadaCarleton.
Improve Homebrew path detection. #370 by @daeho-ro.
<a name="release-4-4-0-fixed"></a>
Add missing examples and fix example order in README. #355 by @gene1wood.
<a name="release-4-3-8-documentation"></a>
Add missing examples and fix example order in README. 355 - by gene1wood.
Drop support for EOL Python 3.8. #330 by @hugovk.
<a name="release-4-3-7-added"></a>
π PyPI release π Full Changelog
π PyPI release π Full Changelog
π PyPI release π Full Changelog
@cbm755 made their first contribution in #301
Fix multi-path returned from _path methods on macOS. #299 by @matthewhughes934 and @gaborbernat.
<a name="release-4-3-2-fixed"></a>
_path methods on macOS. #299 by @matthewhughes934 and @gaborbernat.Fix multi-path returned from _path methods on macOS. 299 - by matthewhughes934 and gaborbernat.
π PyPI release π Full Changelog
Make PlatformDirs usable as a mypy superclass without breaking other type checkers. #295 by @Avasam and @gaborbernat.
<a name="release-4-3-0-added"></a>
PlatformDirs usable as a mypy superclass without breaking other type checkers. #295 by @Avasam and @gaborbernat.Make ~platformdirs.PlatformDirs usable as a mypy superclass without breaking other type checkers. 295 - by Avasam and gaborbernat.
Add support for Python 3.13. 289 - by edgarrmondragon.
One column per quarter.