Repository navigation
chore(deps): update dependency platformdirs to v4.14.8 - #40
Open
renovate[bot] wants to merge 1 commit into
Open
renovate[bot] wants to merge 1 commit into
renovate[bot] wants to merge 1 commit into
Conversation
renovate
Bot
force-pushed
the
renovate/platformdirs-4.x
branch
from
November 20, 2026 13:28
e2b183d to
662ff5d
Compare
renovate
Bot
force-pushed
the
renovate/platformdirs-4.x
branch
from
November 20, 2026 13:57
662ff5d to
4308661
Compare
This branch has not been deployed
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Note
This PR body was truncated due to platform limits.
This PR contains the following updates:
==4.5.0→==4.14.8Release Notes
tox-dev/platformdirs (platformdirs)
v4.14.8Compare Source
Bug fixes
ensure_existsrepairs 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.dirsfile, including under a group-writable~/.config. Create configured media directories with mode0775subject to the umask (#740) by @gaborbernat.0755subject to the umask (#742) by @gaborbernat.HOMEis unset, empty or relative (#730) by @gaborbernat.site_runtime_dircreates a missingXDG_RUNTIME_DIRwith mode0700whenensure_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.7Compare Source
Bug fixes
user-dirs.dirsvalue instead of keeping it in the folder name (#721) by @gaborbernat.🐍 PyPI release
📜 Full Changelog
v4.14.6Compare Source
Bug fixes
use_site_for_rootinuser_fonts_dir,user_fonts_pathand 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.dirspath 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_*_fileandfind_*_filesskip 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.dirspath, 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
platformdirsno longer importstyping: the names it needs only for type annotations are imported under a module-levelTYPE_CHECKINGguard, soimport platformdirsis faster (#714) by @hugovk and @gaborbernat.Packaging
.dist-info/sbomsdirectory, written at build time by python-sbom (#696) by @gaborbernat.New Contributors
🐍 PyPI release
📜 Full Changelog
v4.14.5Compare Source
Bug fixes
user_runtime_dirfallback to/runtime-<uid>instead of//runtime-<uid>when the temporary directory is/(#687) by @darrenhuai and @gaborbernat.🐍 PyPI release
📜 Full Changelog
v4.14.4Compare Source
🐍 PyPI release
📜 Full Changelog
v4.14.3Compare Source
Bug fixes
New Contributors
PyPI release
Full Changelog
v4.14.2Compare Source
Bug fixes
New Contributors
PyPI release
Full Changelog
v4.14.0Compare Source
Features
ensure_existsin the module-level media directory functions, such asuser_documents_path, to create a directory set throughXDG_*_DIRoruser-dirs.dirs(#656) by @darrenhuai and @gaborbernat.Bug fixes
use_site_for_root, ignoring the invoking user'sXDG_*_DIR,user-dirs.dirsandXDG_DATA_HOME, and create no inherited media directory underensure_exists(#661) by @gaborbernat.ValueErrorfromsite_data_dirandsite_config_dirundermultipath=Truewhenappnameorversioncontainsos.pathsep, rather than returning a string that splits into a directory outside the site base (#662) by @gaborbernat.user-dirs.dirsvalue 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.HOMEas unset on Unix, macOS and iOS, taking the home from the password database or raisingRuntimeError, rather than resolving user directories against the working directory (#664) by @gaborbernat.XDG_RUNTIME_DIRinuser_runtime_dirwhen the value ends with/or/., which made the check follow the link (#665) by @gaborbernat.user_*_dircalls withuse_site_for_root=Truewhen 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_DIRcheck of the Unixuser_runtime_dirto the macOS one, so it no longer uses a directory that is a symlink, owned by another user or not mode0700(#667) by @gaborbernat.XDG_RUNTIME_DIRbelow 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_existsandplace_runtime_filecreate it before checking it, andfind_runtime_filechecks it again after a hit (#669) by @gaborbernat.PermissionErroron macOS whenensure_existswould create the site cache through a/Library/Caches/$appnamethat is a symlink, not a directory, or owned by a user other than root and the current one (#670) by @gaborbernat.ensure_exists, raiseFileExistsErrorwhen a configured media directory such asuser_documents_diris 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.7Compare Source
Bug fixes
user-dirs.dirsexists but cannot be read, rather than raisingPermissionErrororIsADirectoryError(#632) by @Debasishhh and @gaborbernat.USERPROFILEwhenHOMEis empty, rather than raisingRuntimeError(#635) by @pabszero and @gaborbernat.$HOMEentries inuser-dirs.dirsto/Documentsinstead of//Documentswhen the home directory is/(#636) by @darrenhuai and @gaborbernat.python -m platformdirswhen the home directory is unknown, rather than stopping withRuntimeError(#638) by @tongwentao and @gaborbernat.FileNotFoundErrorfrom theplace_*_filemethods when the user directory is on a missing Windows drive or network share, rather than recursing untilRecursionError(#639) by @nk-batman21 and @gaborbernat.iter_*_pathsmethod infind_*_fileandfind_*_files, rather than the base class ones (#640) by @KennyMcSimpson and @gaborbernat.isolated_dirspaths 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.Documentation
/opt/homebrewfrom 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.6Compare Source
Packaging
🐍 PyPI release
📜 Full Changelog
v4.13.5Compare Source
Packaging
🐍 PyPI release
📜 Full Changelog
v4.13.4Compare Source
Bug fixes
filespath segment when locating Android app directories fromsys.path. #621 by @shoaibulhaque and @gaborbernat.RuntimeErrorwhen iOS cannot resolve the home directory, rather than returning paths rooted at a literal~. #624 by @XXXXXQ-0206 and @gaborbernat.isolated_dirswhen Unix root enablesuse_site_for_root. Restore root redirection when the context exits. #625 by @AryanRG and @gaborbernat.RuntimeErrorwhen 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.3Compare Source
🐍 PyPI release
📜 Full Changelog
v4.13.2Compare Source
Bug fixes
user_fonts_dirwhenXDG_DATA_HOMEends with a separator. #619 by @blouirts123 and @gaborbernat.New Contributors
🐍 PyPI release
📜 Full Changelog
v4.13.1Compare Source
Bug fixes
user-dirs.dirspaths instead of removing them. #614 by @xiehuanyi and @gaborbernat.New Contributors
🐍 PyPI release
📜 Full Changelog
v4.13.0Compare Source
Bug fixes
MacOSsite directories underpython:-S, which leavesbase_prefixon theCellarkeg, and for thepython-freethreadingformula. #612 by @sricharanreddycheruku and @gaborbernat.New Contributors
🐍 PyPI release
📜 Full Changelog
v4.12.4Compare Source
Bug fixes
place_config_fileor anotherplace_*_filemethod withuse_site_for_root. #610 by @darrenhuai and @gaborbernat.user_runtime_dirwarn and fall back from an unreachableXDG_RUNTIME_DIRunderensure_existsinstead of raising. #611 by @harbinresearcher and @gaborbernat.New Contributors
🐍 PyPI release
📜 Full Changelog
v4.12.3Compare Source
Bug fixes
place_config_fileandplace_data_filein the first site directory for root on Unix withuse_site_for_root=Trueandmultipath=True, wherefind_config_fileandfind_data_filelook for them. #607 by @PDGGK and @gaborbernat.New Contributors
🐍 PyPI release
📜 Full Changelog
v4.12.2Compare Source
Bug fixes
os.pathsepinsite_applications_pathundermultipath=Trueon platforms with one applications directory. #604 by @9Kun and @gaborbernat.New Contributors
🐍 PyPI release
📜 Full Changelog
v4.12.1Compare Source
Bug fixes
PytestAssertRewriteWarningwhen importingplatformdirsbefore invoking pytest. #601 #602 by @gaborbernat.🐍 PyPI release
📜 Full Changelog
v4.12.0Compare Source
Features
place_*_filemethods that return a file path under a user directory and create its missing parents with mode0o700. #585 by @gaborbernat.find_<kind>_fileandfind_<kind>_filesto look up an existing file across the user and site directories of each kind that has aniter_<kind>_pathsmethod. #586 by @gaborbernat.isolated_dirsand theplatformdirs_isolatedpytest fixture to resolve every directory under one test root. #590 by @gaborbernat.RuntimeDirWarningwhen the Unixuser_runtime_dirfalls back fromXDG_RUNTIME_DIR. #599 by @gaborbernat.user_templates_dir,user_publicshare_diranduser_bin_diron Windows from their known folders. #587 by @gaborbernat.~/Library/Application Supportfor data. #600 by @gaborbernat.Bug fixes
RuntimeErrorfor a Unix or macOS directory under the home when no home resolves, and read the password database for an emptyHOME. #589 by @gaborbernat.Documentation
multipath. #591 by @gaborbernat.XDG_*_DIRvariables. #592 by @gaborbernat.WIN_PD_OVERRIDE_COMMON_PROGRAMSvariable. #593 by @gaborbernat./usr/local/share/applicationsas the Linuxsite_applications_dirdefault. #594 by @gaborbernat.user_runtime_dirdefaults and describe the temporary directory fallback. #595 by @gaborbernat.AppData. #597 by @gaborbernat.user_fonts_dir. #598 by @gaborbernat.Security
0700underensure_existson POSIX platforms. #588 by @gaborbernat.XDG_RUNTIME_DIRor/run/user/<uid>that is not a private directory of the user, and reject a symlink or file as theruntime-<uid>fallback. #599 by @gaborbernat.🐍 PyPI release
📜 Full Changelog
v4.11.15Compare Source
Bug fixes
sys.getandroidapilevelwhenANDROID_DATAandANDROID_ROOTare unset. #581 by @gaborbernat.Moviesand the five non-standard media folders, such asDesktop, intoDocuments. #583 by @gaborbernat.🐍 PyPI release
📜 Full Changelog
v4.11.14Compare Source
Features
roaminginuser_log_diranduser_log_path. #572 by @gaborbernat.Bug fixes
ensure_exists, create a media directory such asuser_documents_dironly when the user set it through anXDG_*_DIRvariable oruser-dirs.dirs, and return a dangling symlink there instead of raisingFileExistsError. 4.11.13 also created the platform defaults, which filled headless home directories with folders such as~/Templatesand made a literal~directory whenHOMEwas unset. #561 by @gaborbernat.$XDG_RUNTIME_DIRinuser_runtime_dirwhenuse_site_for_rootredirects root. #562 by @gaborbernat./storage/emulated/0/Downloadfrom the Androiduser_downloads_dirfallback. #563 by @gaborbernat.WIN_PD_OVERRIDE_*values that lack a drive or a root. #564 by @gaborbernat.files. #565 by @gaborbernat.use_site_for_rooton the next read. #567 by @gaborbernat.UnicodeDecodeErroronuser-dirs.dirsbytes the locale encoding cannot decode. #568 by @gaborbernat.# commentfrom unquoteduser-dirs.dirsvalues. #569 by @gaborbernat.PUBLICorLOCALAPPDATA, as unset. #571 by @gaborbernat.opt/python*/Frameworkslayout. #573 by @gaborbernat.site_cache_pathundermultipath. #574 by @gaborbernat.RuntimeErrorin place of creating a literal~directory whenensure_existsfinds no home. #578 by @gaborbernat.Documentation
user_preference_dirpath in the platform docs. #577 by @gaborbernat.user_state_dirandsite_state_dirignore theXDG_DATA_*variables. #579 by @gaborbernat.Security
appname,appauthororversionthat leaves the base directory when set after construction. #566 by @gaborbernat.runtime-<uid>temporary fallback with mode0700and reject one another user owns. #576 by @gaborbernat.🐍 PyPI release
📜 Full Changelog
v4.11.13Compare Source
Bug fixes
ensure_exists, the media directories such asuser_documents_dirare created on Unix, and on macOS when an XDG variable sets them. #560 by @gaborbernat and @ekanshul.🐍 PyPI release
📜 Full Changelog
v4.11.12Compare Source
Bug fixes
XDG_DOCUMENTS_DIR=Documentsno longer makesuser_documents_dirand 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 fromuser-dirs.dirs. #554 by @darrenhuai.Documentation
New Contributors
🐍 PyPI release
📜 Full Changelog
v4.11.11Compare Source
Security
appname,appauthorandversionvalues that leave the platform base directory (a..segment, a leading separator, a drive or a UNC share) withValueError, soensure_existscannot create directories outside it. #552 by @Pitchfork-and-Torch and @gaborbernat.New Contributors
🐍 PyPI release
📜 Full Changelog
v4.11.10Compare Source
Bug fixes
ensure_exists, thesite_*_dirandsite_*_pathproperties and theiter_*_dirsiterators 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.9Compare Source
Features
multipathinsite_cache_dirandsite_cache_path. Without it, the function API could not return the Homebrew cache prefix thatsite_cache_diradds undermultipath. #544 by @darrenhuai and @gaborbernat.Bug fixes
user-dirs.dirsline by line likexdg-user-dir. The INI parser raised on a repeated key or a line without=, and returned trailing comments and backslash escapes insideuser_documents_dirand the other media directories. The last valid assignment now wins, and platformdirs unescConfiguration
📅 Schedule: (UTC)
🚦 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.
This PR was generated by Mend Renovate. View the repository job log.