1- Metadata-Version: 2.3
1+ Metadata-Version: 2.4
22Name: platformdirs
3- Version: 4.2.2
3+ Version: 4.4.0
44Summary: A small Python package for determining appropriate platform-specific dirs, e.g. a `user data dir`.
5+ Project-URL: Changelog, https://github.com/tox-dev/platformdirs/releases
56Project-URL: Documentation, https://platformdirs.readthedocs.io
6- Project-URL: Homepage, https://github.com/platformdirs /platformdirs
7- Project-URL: Source, https://github.com/platformdirs /platformdirs
8- Project-URL: Tracker, https://github.com/platformdirs /platformdirs/issues
7+ Project-URL: Homepage, https://github.com/tox-dev /platformdirs
8+ Project-URL: Source, https://github.com/tox-dev /platformdirs
9+ Project-URL: Tracker, https://github.com/tox-dev /platformdirs/issues
910Maintainer-email: Bernát Gábor <gaborjbernat@gmail.com>, Julian Berman <Julian@GrayVines.com>, Ofek Lev <oss@ofek.dev>, Ronny Pfannschmidt <opensource@ronnypfannschmidt.de>
1011License-Expression: MIT
1112License-File: LICENSE
@@ -16,35 +17,41 @@ Classifier: License :: OSI Approved :: MIT License
1617Classifier: Operating System :: OS Independent
1718Classifier: Programming Language :: Python
1819Classifier: Programming Language :: Python :: 3 :: Only
19- Classifier: Programming Language :: Python :: 3.8
2020Classifier: Programming Language :: Python :: 3.9
2121Classifier: Programming Language :: Python :: 3.10
2222Classifier: Programming Language :: Python :: 3.11
2323Classifier: Programming Language :: Python :: 3.12
24+ Classifier: Programming Language :: Python :: 3.13
2425Classifier: Programming Language :: Python :: Implementation :: CPython
2526Classifier: Programming Language :: Python :: Implementation :: PyPy
2627Classifier: Topic :: Software Development :: Libraries :: Python Modules
27- Requires-Python: >=3.8
28+ Requires-Python: >=3.9
2829Provides-Extra: docs
29- Requires-Dist: furo>=2023.9.10 ; extra == 'docs'
30- Requires-Dist: proselint>=0.13 ; extra == 'docs'
31- Requires-Dist: sphinx-autodoc-typehints>=1.25.2 ; extra == 'docs'
32- Requires-Dist: sphinx>=7.2.6 ; extra == 'docs'
30+ Requires-Dist: furo>=2024.8.6 ; extra == 'docs'
31+ Requires-Dist: proselint>=0.14 ; extra == 'docs'
32+ Requires-Dist: sphinx-autodoc-typehints>=3 ; extra == 'docs'
33+ Requires-Dist: sphinx>=8.1.3 ; extra == 'docs'
3334Provides-Extra: test
3435Requires-Dist: appdirs==1.4.4; extra == 'test'
3536Requires-Dist: covdefaults>=2.3; extra == 'test'
36- Requires-Dist: pytest-cov>=4.1 ; extra == 'test'
37- Requires-Dist: pytest-mock>=3.12 ; extra == 'test'
38- Requires-Dist: pytest>=7.4.3 ; extra == 'test'
37+ Requires-Dist: pytest-cov>=6 ; extra == 'test'
38+ Requires-Dist: pytest-mock>=3.14 ; extra == 'test'
39+ Requires-Dist: pytest>=8.3.4 ; extra == 'test'
3940Provides-Extra: type
40- Requires-Dist: mypy>=1.8 ; extra == 'type'
41+ Requires-Dist: mypy>=1.14.1 ; extra == 'type'
4142Description-Content-Type: text/x-rst
4243
4344The problem
4445===========
4546
46- .. image:: https://github.com/platformdirs/platformdirs/actions/workflows/check.yml/badge.svg
47+ .. image:: https://badge.fury.io/py/platformdirs.svg
48+ :target: https://badge.fury.io/py/platformdirs
49+ .. image:: https://img.shields.io/pypi/pyversions/platformdirs.svg
50+ :target: https://pypi.python.org/pypi/platformdirs/
51+ .. image:: https://github.com/tox-dev/platformdirs/actions/workflows/check.yaml/badge.svg
4752 :target: https://github.com/platformdirs/platformdirs/actions
53+ .. image:: https://static.pepy.tech/badge/platformdirs/month
54+ :target: https://pepy.tech/project/platformdirs
4855
4956When writing desktop application, finding the right location to store user data
5057and configuration varies per platform. Even for single-platform apps, there
@@ -107,10 +114,14 @@ On macOS:
107114 >>> appauthor = "Acme"
108115 >>> user_data_dir(appname, appauthor)
109116 '/Users/trentm/Library/Application Support/SuperApp'
110- >>> site_data_dir (appname, appauthor)
111- '/Library/Application Support/SuperApp'
117+ >>> user_config_dir (appname, appauthor)
118+ '/Users/trentm/ Library/Application Support/SuperApp'
112119 >>> user_cache_dir(appname, appauthor)
113120 '/Users/trentm/Library/Caches/SuperApp'
121+ >>> site_data_dir(appname, appauthor)
122+ '/Library/Application Support/SuperApp'
123+ >>> site_config_dir(appname, appauthor)
124+ '/Library/Application Support/SuperApp'
114125 >>> user_log_dir(appname, appauthor)
115126 '/Users/trentm/Library/Logs/SuperApp'
116127 >>> user_documents_dir()
@@ -139,8 +150,14 @@ On Windows:
139150 'C:\\Users\\trentm\\AppData\\Local\\Acme\\SuperApp'
140151 >>> user_data_dir(appname, appauthor, roaming=True)
141152 'C:\\Users\\trentm\\AppData\\Roaming\\Acme\\SuperApp'
153+ >>> user_config_dir(appname, appauthor)
154+ 'C:\\Users\\trentm\\AppData\\Local\\Acme\\SuperApp'
142155 >>> user_cache_dir(appname, appauthor)
143156 'C:\\Users\\trentm\\AppData\\Local\\Acme\\SuperApp\\Cache'
157+ >>> site_data_dir(appname, appauthor)
158+ 'C:\\ProgramData\\Acme\\SuperApp'
159+ >>> site_config_dir(appname, appauthor)
160+ 'C:\\ProgramData\\Acme\\SuperApp'
144161 >>> user_log_dir(appname, appauthor)
145162 'C:\\Users\\trentm\\AppData\\Local\\Acme\\SuperApp\\Logs'
146163 >>> user_documents_dir()
@@ -167,16 +184,21 @@ On Linux:
167184 >>> appauthor = "Acme"
168185 >>> user_data_dir(appname, appauthor)
169186 '/home/trentm/.local/share/SuperApp'
187+ >>> user_config_dir(appname)
188+ '/home/trentm/.config/SuperApp'
189+ >>> user_cache_dir(appname, appauthor)
190+ '/home/trentm/.cache/SuperApp'
170191 >>> site_data_dir(appname, appauthor)
171192 '/usr/local/share/SuperApp'
172193 >>> site_data_dir(appname, appauthor, multipath=True)
173194 '/usr/local/share/SuperApp:/usr/share/SuperApp'
174- >>> user_cache_dir(appname, appauthor)
175- '/home/trentm/.cache/SuperApp'
195+ >>> site_config_dir(appname)
196+ '/etc/xdg/SuperApp'
197+ >>> os.environ["XDG_CONFIG_DIRS"] = "/etc:/usr/local/etc"
198+ >>> site_config_dir(appname, multipath=True)
199+ '/etc/SuperApp:/usr/local/etc/SuperApp'
176200 >>> user_log_dir(appname, appauthor)
177201 '/home/trentm/.local/state/SuperApp/log'
178- >>> user_config_dir(appname)
179- '/home/trentm/.config/SuperApp'
180202 >>> user_documents_dir()
181203 '/home/trentm/Documents'
182204 >>> user_downloads_dir()
@@ -191,11 +213,6 @@ On Linux:
191213 '/home/trentm/Desktop'
192214 >>> user_runtime_dir(appname, appauthor)
193215 '/run/user/{os.getuid()}/SuperApp'
194- >>> site_config_dir(appname)
195- '/etc/xdg/SuperApp'
196- >>> os.environ["XDG_CONFIG_DIRS"] = "/etc:/usr/local/etc"
197- >>> site_config_dir(appname, multipath=True)
198- '/etc/SuperApp:/usr/local/etc/SuperApp'
199216
200217On Android::
201218
@@ -204,12 +221,16 @@ On Android::
204221 >>> appauthor = "Acme"
205222 >>> user_data_dir(appname, appauthor)
206223 '/data/data/com.myApp/files/SuperApp'
224+ >>> user_config_dir(appname)
225+ '/data/data/com.myApp/shared_prefs/SuperApp'
207226 >>> user_cache_dir(appname, appauthor)
208227 '/data/data/com.myApp/cache/SuperApp'
228+ >>> site_data_dir(appname, appauthor)
229+ '/data/data/com.myApp/files/SuperApp'
230+ >>> site_config_dir(appname)
231+ '/data/data/com.myApp/shared_prefs/SuperApp'
209232 >>> user_log_dir(appname, appauthor)
210233 '/data/data/com.myApp/cache/SuperApp/log'
211- >>> user_config_dir(appname)
212- '/data/data/com.myApp/shared_prefs/SuperApp'
213234 >>> user_documents_dir()
214235 '/storage/emulated/0/Documents'
215236 >>> user_downloads_dir()
@@ -241,8 +262,14 @@ apps also support ``XDG_*`` environment variables.
241262 >>> dirs = PlatformDirs("SuperApp", "Acme")
242263 >>> dirs.user_data_dir
243264 '/Users/trentm/Library/Application Support/SuperApp'
265+ >>> dirs.user_config_dir
266+ '/Users/trentm/Library/Application Support/SuperApp'
267+ >>> dirs.user_cache_dir
268+ '/Users/trentm/Library/Caches/SuperApp'
244269 >>> dirs.site_data_dir
245270 '/Library/Application Support/SuperApp'
271+ >>> dirs.site_config_dir
272+ '/Library/Application Support/SuperApp'
246273 >>> dirs.user_cache_dir
247274 '/Users/trentm/Library/Caches/SuperApp'
248275 >>> dirs.user_log_dir
@@ -273,10 +300,14 @@ dirs::
273300 >>> dirs = PlatformDirs("SuperApp", "Acme", version="1.0")
274301 >>> dirs.user_data_dir
275302 '/Users/trentm/Library/Application Support/SuperApp/1.0'
276- >>> dirs.site_data_dir
277- '/Library/Application Support/SuperApp/1.0'
303+ >>> dirs.user_config_dir
304+ '/Users/trentm/ Library/Application Support/SuperApp/1.0'
278305 >>> dirs.user_cache_dir
279306 '/Users/trentm/Library/Caches/SuperApp/1.0'
307+ >>> dirs.site_data_dir
308+ '/Library/Application Support/SuperApp/1.0'
309+ >>> dirs.site_config_dir
310+ '/Library/Application Support/SuperApp/1.0'
280311 >>> dirs.user_log_dir
281312 '/Users/trentm/Library/Logs/SuperApp/1.0'
282313 >>> dirs.user_documents_dir
0 commit comments