Skip to content

chore(deps): update dependency platformdirs to v4.13.5 - #77

Merged
laurigates merged 1 commit into
masterfrom
renovate/platformdirs-4.x
Oct 28, 2026
Merged

laurigates merged 1 commit into
masterfrom
renovate/platformdirs-4.x

Conversation

@fvh-renovate-bot

@fvh-renovate-bot fvh-renovate-bot Bot commented Oct 27, 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.1.0 → ==4.13.5 age confidence

Release Notes

tox-dev/platformdirs (platformdirs)

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 unescapes the quoted value and ignores text after the closing quote. #​545 by @​darrenhuai and @​gaborbernat.
  • Read 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.
  • Raise 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.
New Contributors

🐍 PyPI release

📜 Full Changelog

v4.11.8

Compare Source

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

🐍 PyPI release

📜 Full Changelog

v4.11.7

Compare Source

🐍 PyPI release

📜 Full Changelog

v4.11.6

Compare Source

Features
  • 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. #​537 by @​darrenhuai and @​gaborbernat.

🐍 PyPI release

📜 Full Changelog

v4.11.5

Compare Source

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

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

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

🐍 PyPI release

📜 Full Changelog

v4.11.4

Compare Source

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

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

🐍 PyPI release

📜 Full Changelog

v4.11.3

Compare Source

Features

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

🐍 PyPI release

📜 Full Changelog

v4.11.2

Compare Source

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

🐍 PyPI release

📜 Full Changelog

v4.11.1

Compare Source

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

🐍 PyPI release

📜 Full Changelog

v4.11.0

Compare Source

Features
  • Declare support for Python 3.15 and run the test suite against it, currently in beta. #​512 by @​gaborbernat.

🐍 PyPI release

📜 Full Changelog

v4.10.1

Compare Source

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

🐍 PyPI release

📜 Full Changelog

v4.10.0

Compare Source

Features

Bug fixes
New Contributors

🐍 PyPI release

📜 Full Changelog

v4.9.6

Compare Source

Bug fixes
  • Fix macOS XDG variables leaking across user_config_dir, user_data_dir, and user_state_dir when only some are set. #​473 by @​Goddesen.
  • Avoid duplicate site directories in Unix iter_config_dirs and iter_data_dirs when use_site_for_root is active. #​469 by @​viccie30.
New Contributors

🐍 PyPI release

📜 Full Changelog

v4.9.4

Compare Source

Bug fixes
  • Respect XDG_CONFIG_HOME when reading the user-dirs configuration. #​453 by @​bysiber.
  • Create the directory in Android user_log_dir and user_runtime_dir when ensure_exists is set. #​452 by @​bysiber.

🐍 PyPI release

📜 Full Changelog

v4.9.2

Compare Source

🐍 PyPI release

📜 Full Changelog

v4.9.1

Compare Source

🐍 PyPI release

📜 Full Changelog

v4.9.0

Compare Source

Features

Bug fixes

🐍 PyPI release

📜 Full Changelog

v4.8.0

Compare Source

Features

Bug fixes
  • Yield individual site directories from iter_data_dirs and iter_config_dirs on macOS. #​429 by @​gaborbernat.

🐍 PyPI release

📜 Full Changelog

v4.7.1

Compare Source

Bug fixes

🐍 PyPI release

📜 Full Changelog

v4.7.0

Compare Source

Bug fixes
New Contributors

🐍 PyPI release

📜 Full Changelog

v4.6.0

Compare Source

Bug fixes

Documentation
New Contributors

🐍 PyPI release

📜 Full Changelog

v4.5.1

Compare Source

Bug fixes

🐍 PyPI release

📜 Full Changelog

v4.5.0

Compare Source

Features

Documentation
New Contributors

🐍 PyPI release

📜 Full Changelog

v4.4.0

Compare Source

Bug fixes
New Contributors

🐍 PyPI release

📜 Full Changelog

v4.3.8

Compare Source

Documentation
New Contributors

🐍 PyPI release

📜 Full Changelog

v4.3.7

Compare Source

Features

🐍 PyPI release

📜 Full Changelog

v4.3.6

Compare Source

🐍 PyPI release

📜 Full Changelog

v4.3.5

Compare Source

🐍 PyPI release

📜 Full Changelog

v4.3.4

Compare Source

🐍 PyPI release

📜 Full Changelog

v4.3.3

Compare Source

New Contributors

🐍 PyPI release

📜 Full Changelog

v4.3.2

Compare Source

Bug fixes
New Contributors

🐍 PyPI release

📜 Full Changelog

v4.3.1

Compare Source

🐍 PyPI release

📜 Full Changelog

v4.3.0

Compare Source

Features

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


Configuration

📅 Schedule: (in timezone Europe/Helsinki)

  • 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 has been generated by Mend Renovate CLI.

@fvh-renovate-bot fvh-renovate-bot Bot added the dependencies Pull requests that update a dependency file label Oct 27, 2026
@laurigates
laurigates merged commit 170afde into master Oct 28, 2026
4 checks passed
@laurigates
laurigates deleted the renovate/platformdirs-4.x branch October 28, 2026 07:43
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

dependencies Pull requests that update a dependency file

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant