Skip to content

chore(deps): update dependency platformdirs to v4.14.8 - #40

Open
renovate[bot] wants to merge 1 commit into
mainfrom
renovate/platformdirs-4.x
Open

renovate[bot] wants to merge 1 commit into
mainfrom
renovate/platformdirs-4.x

Conversation

@renovate

@renovate renovate Bot commented Nov 20, 2026

Copy link
Copy Markdown
Contributor

Note

This PR body was truncated due to platform limits.

This PR contains the following updates:

Package Change Age Confidence
platformdirs (changelog) ==4.5.0 → ==4.14.8 age confidence

Release Notes

tox-dev/platformdirs (platformdirs)

v4.14.8

Compare Source

Bug fixes
  • 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.

Performance
New Contributors

🐍 PyPI release

📜 Full Changelog

v4.14.7

Compare Source

Bug fixes
  • 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.

🐍 PyPI release

📜 Full Changelog

v4.14.6

Compare Source

Bug fixes
  • 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 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.

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

Packaging
New Contributors

🐍 PyPI release

📜 Full Changelog

v4.14.5

Compare Source

Bug fixes

🐍 PyPI release

📜 Full Changelog

v4.14.4

Compare Source

🐍 PyPI release

📜 Full Changelog

v4.14.3

Compare Source

Bug fixes
New Contributors

PyPI release

Full Changelog

v4.14.2

Compare Source

Bug fixes
New Contributors

PyPI release

Full Changelog

v4.14.0

Compare Source

Features
  • 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_*_DIR or user-dirs.dirs (#​656) by @​darrenhuai and @​gaborbernat.

Bug fixes
  • 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 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 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 place_runtime_file create it before checking it, and 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.
New Contributors

PyPI release

Full Changelog

v4.13.7

Compare Source

Bug fixes
  • 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.

Documentation
  • 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.
New Contributors

PyPI release

Full Changelog

v4.13.6

Compare Source

Packaging
  • Releases now run on the shared tox-dev/github-workflows pipeline, with a locked release toolchain and generated GitHub Release notes (#​650) by @​gaborbernat.

🐍 PyPI release

📜 Full Changelog

v4.13.5

Compare Source

Packaging
  • Publish a GitHub Release with changelog notes, a PyPI link, and a version comparison after each PyPI release. #​631 by @​gaborbernat.

🐍 PyPI release

📜 Full Changelog

v4.13.4

Compare Source

Bug fixes
  • 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.
New Contributors

🐍 PyPI release

📜 Full Changelog

v4.13.3

Compare Source

🐍 PyPI release

📜 Full Changelog

v4.13.2

Compare Source

Bug fixes
New Contributors

🐍 PyPI release

📜 Full Changelog

v4.13.1

Compare Source

Bug fixes
New Contributors

🐍 PyPI release

📜 Full Changelog

v4.13.0

Compare Source

Bug fixes
New Contributors

🐍 PyPI release

📜 Full Changelog

v4.12.4

Compare Source

Bug fixes
New Contributors

🐍 PyPI release

📜 Full Changelog

v4.12.3

Compare Source

Bug fixes
  • 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.
New Contributors

🐍 PyPI release

📜 Full Changelog

v4.12.2

Compare Source

Bug fixes
  • Keep os.pathsep in site_applications_path under multipath=True on platforms with one applications directory. #​604 by @​9Kun and @​gaborbernat.
New Contributors

🐍 PyPI release

📜 Full Changelog

v4.12.1

Compare Source

Bug fixes

🐍 PyPI release

📜 Full Changelog

v4.12.0

Compare Source

Features
  • 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 isolated_dirs and the platformdirs_isolated pytest fixture to resolve every directory under one test root. #​590 by @​gaborbernat.
  • Emit RuntimeDirWarning when the Unix 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.

Bug fixes
  • 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.

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

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

🐍 PyPI release

📜 Full Changelog

v4.11.15

Compare Source

Bug fixes
  • 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.

🐍 PyPI release

📜 Full Changelog

v4.11.14

Compare Source

Features

Bug fixes
  • 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 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.

Documentation

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

🐍 PyPI release

📜 Full Changelog

v4.11.13

Compare Source

Bug fixes
  • 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.

🐍 PyPI release

📜 Full Changelog

v4.11.12

Compare Source

Bug fixes
  • Ignore relative paths in the XDG user directory environment variables, so 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.

Documentation
New Contributors

🐍 PyPI release

📜 Full Changelog

v4.11.11

Compare Source

Security
  • 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.
New Contributors

🐍 PyPI release

📜 Full Changelog

v4.11.10

Compare Source

Bug fixes
  • 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.

🐍 PyPI release

📜 Full Changelog

v4.11.9

Compare Source

Features
  • 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 adds under multipath. #​544 by @​darrenhuai and @​gaborbernat.

Bug fixes
  • 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 user_documents_dir and the other media directories. The last valid assignment now wins, and platformdirs unesc

[!IMPORTANT]
✂ PR body was truncated to here.


Configuration

📅 Schedule: (UTC)

  • Branch creation
    • At any time (no schedule defined)
  • Automerge
    • At any time (no schedule defined)

🚦 Automerge: Disabled by config. Please merge this manually once you are satisfied.

♻ Rebasing: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.

🔕 Ignore: Close this PR and you won't be reminded about this update again.


  • If you want to rebase/retry this PR, check this box

This PR was generated by Mend Renovate. View the repository job log.

@renovate
renovate Bot force-pushed the renovate/platformdirs-4.x branch from e2b183d to 662ff5d Compare November 20, 2026 13:28
@renovate
renovate Bot force-pushed the renovate/platformdirs-4.x branch from 662ff5d to 4308661 Compare November 20, 2026 13:57

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

0 participants