@anaconda/desktop-bridge-payload-win32-arm64 0.1.21 → 0.1.22
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/THIRD_PARTY_NOTICES +17 -17
- package/manifest.json +7 -7
- package/package.json +1 -1
- package/python/BUILD +1 -1
- package/python/DLLs/_asyncio.pyd +0 -0
- package/python/DLLs/_bz2.pyd +0 -0
- package/python/DLLs/_ctypes.pyd +0 -0
- package/python/DLLs/_ctypes_test.pyd +0 -0
- package/python/DLLs/_decimal.pyd +0 -0
- package/python/DLLs/_elementtree.pyd +0 -0
- package/python/DLLs/_hashlib.pyd +0 -0
- package/python/DLLs/_lzma.pyd +0 -0
- package/python/DLLs/_msi.pyd +0 -0
- package/python/DLLs/_multiprocessing.pyd +0 -0
- package/python/DLLs/_overlapped.pyd +0 -0
- package/python/DLLs/_queue.pyd +0 -0
- package/python/DLLs/_socket.pyd +0 -0
- package/python/DLLs/_sqlite3.pyd +0 -0
- package/python/DLLs/_ssl.pyd +0 -0
- package/python/DLLs/_testbuffer.pyd +0 -0
- package/python/DLLs/_testcapi.pyd +0 -0
- package/python/DLLs/_testconsole.pyd +0 -0
- package/python/DLLs/_testimportmultiple.pyd +0 -0
- package/python/DLLs/_testinternalcapi.pyd +0 -0
- package/python/DLLs/_testmultiphase.pyd +0 -0
- package/python/DLLs/_uuid.pyd +0 -0
- package/python/DLLs/_zoneinfo.pyd +0 -0
- package/python/DLLs/libcrypto-3-arm64.dll +0 -0
- package/python/DLLs/libffi-8.dll +0 -0
- package/python/DLLs/libssl-3-arm64.dll +0 -0
- package/python/DLLs/pyexpat.pyd +0 -0
- package/python/DLLs/select.pyd +0 -0
- package/python/DLLs/sqlite3.dll +0 -0
- package/python/DLLs/unicodedata.pyd +0 -0
- package/python/DLLs/winsound.pyd +0 -0
- package/python/Lib/site-packages/_ruamel_yaml.cp311-win_arm64.pyd +0 -0
- package/python/Lib/site-packages/anaconda_anon_usage-0.8.1.dist-info/RECORD +1 -1
- package/python/Lib/site-packages/anaconda_auth-0.15.3.dist-info/RECORD +1 -1
- package/python/Lib/site-packages/anaconda_cli_base-0.9.1.dist-info/RECORD +1 -1
- package/python/Lib/site-packages/anaconda_desktop_bridge/__main__.py +8 -0
- package/python/Lib/site-packages/anaconda_desktop_bridge/__pycache__/__main__.cpython-311.pyc +0 -0
- package/python/Lib/site-packages/anaconda_desktop_bridge/__pycache__/errors.cpython-311.pyc +0 -0
- package/python/Lib/site-packages/anaconda_desktop_bridge/__pycache__/telemetry.cpython-311.pyc +0 -0
- package/python/Lib/site-packages/anaconda_desktop_bridge/conda/__init__.py +2 -0
- package/python/Lib/site-packages/anaconda_desktop_bridge/conda/__pycache__/__init__.cpython-311.pyc +0 -0
- package/python/Lib/site-packages/anaconda_desktop_bridge/conda/__pycache__/auth_handler.cpython-311.pyc +0 -0
- package/python/Lib/site-packages/anaconda_desktop_bridge/conda/__pycache__/auth_plugin.cpython-311.pyc +0 -0
- package/python/Lib/site-packages/anaconda_desktop_bridge/conda/__pycache__/lock.cpython-311.pyc +0 -0
- package/python/Lib/site-packages/anaconda_desktop_bridge/conda/__pycache__/repo_credentials.cpython-311.pyc +0 -0
- package/python/Lib/site-packages/anaconda_desktop_bridge/conda/auth_handler.py +219 -0
- package/python/Lib/site-packages/anaconda_desktop_bridge/conda/auth_plugin.py +50 -0
- package/python/Lib/site-packages/anaconda_desktop_bridge/conda/lock.py +26 -1
- package/python/Lib/site-packages/anaconda_desktop_bridge/conda/operations/__pycache__/channels.cpython-311.pyc +0 -0
- package/python/Lib/site-packages/anaconda_desktop_bridge/conda/operations/__pycache__/repodata.cpython-311.pyc +0 -0
- package/python/Lib/site-packages/anaconda_desktop_bridge/conda/operations/channels.py +196 -4
- package/python/Lib/site-packages/anaconda_desktop_bridge/conda/operations/repodata.py +8 -1
- package/python/Lib/site-packages/anaconda_desktop_bridge/conda/repo_credentials.py +224 -0
- package/python/Lib/site-packages/anaconda_desktop_bridge/conda/transactions/__pycache__/transaction.cpython-311.pyc +0 -0
- package/python/Lib/site-packages/anaconda_desktop_bridge/conda/transactions/transaction.py +23 -0
- package/python/Lib/site-packages/anaconda_desktop_bridge/errors.py +24 -0
- package/python/Lib/site-packages/anaconda_desktop_bridge/features/__pycache__/conda_tools.cpython-311.pyc +0 -0
- package/python/Lib/site-packages/anaconda_desktop_bridge/features/conda_tools.py +8 -0
- package/python/Lib/site-packages/anaconda_desktop_bridge/models/__pycache__/conda_tools.cpython-311.pyc +0 -0
- package/python/Lib/site-packages/anaconda_desktop_bridge/models/conda_tools.py +46 -1
- package/python/Lib/site-packages/anaconda_desktop_bridge/telemetry.py +2 -20
- package/python/Lib/site-packages/anaconda_desktop_bridge-0.1.0.dist-info/METADATA +75 -5
- package/python/Lib/site-packages/anaconda_desktop_bridge-0.1.0.dist-info/RECORD +16 -13
- package/python/Lib/site-packages/anaconda_desktop_bridge-0.1.0.dist-info/uv_cache.json +1 -1
- package/python/Lib/site-packages/archspec-0.2.7.dist-info/RECORD +1 -1
- package/python/Lib/site-packages/cffi-2.1.1.dist-info/RECORD +1 -1
- package/python/Lib/site-packages/charset_normalizer-3.5.2.dist-info/RECORD +1 -1
- package/python/Lib/site-packages/conda-26.1.1.dist-info/RECORD +1 -1
- package/python/Lib/site-packages/conda_package_handling-2.6.0.dist-info/RECORD +1 -1
- package/python/Lib/site-packages/distro-1.9.0.dist-info/RECORD +1 -1
- package/python/Lib/site-packages/httpx-0.28.1.dist-info/RECORD +1 -1
- package/python/Lib/site-packages/idna-3.20.dist-info/RECORD +1 -1
- package/python/Lib/site-packages/jsonpatch-1.47.dist-info/RECORD +2 -2
- package/python/Lib/site-packages/keyring-25.7.0.dist-info/RECORD +1 -1
- package/python/Lib/site-packages/markdown_it_py-4.3.0.dist-info/RECORD +1 -1
- package/python/Lib/site-packages/menuinst/platforms/win_utils/winshortcut.cp311-win_arm64.pyd +0 -0
- package/python/Lib/site-packages/menuinst-2.5.1.dist-info/RECORD +2 -2
- package/python/Lib/site-packages/platformdirs/__init__.py +155 -128
- package/python/Lib/site-packages/platformdirs/__main__.py +10 -10
- package/python/Lib/site-packages/platformdirs/__pycache__/__init__.cpython-311.pyc +0 -0
- package/python/Lib/site-packages/platformdirs/__pycache__/__main__.cpython-311.pyc +0 -0
- package/python/Lib/site-packages/platformdirs/__pycache__/_android.cpython-311.pyc +0 -0
- package/python/Lib/site-packages/platformdirs/__pycache__/_runtime.cpython-311.pyc +0 -0
- package/python/Lib/site-packages/platformdirs/__pycache__/_xdg.cpython-311.pyc +0 -0
- package/python/Lib/site-packages/platformdirs/__pycache__/android.cpython-311.pyc +0 -0
- package/python/Lib/site-packages/platformdirs/__pycache__/api.cpython-311.pyc +0 -0
- package/python/Lib/site-packages/platformdirs/__pycache__/ios.cpython-311.pyc +0 -0
- package/python/Lib/site-packages/platformdirs/__pycache__/macos.cpython-311.pyc +0 -0
- package/python/Lib/site-packages/platformdirs/__pycache__/pytest_plugin.cpython-311.pyc +0 -0
- package/python/Lib/site-packages/platformdirs/__pycache__/testing.cpython-311.pyc +0 -0
- package/python/Lib/site-packages/platformdirs/__pycache__/unix.cpython-311.pyc +0 -0
- package/python/Lib/site-packages/platformdirs/__pycache__/version.cpython-311.pyc +0 -0
- package/python/Lib/site-packages/platformdirs/__pycache__/windows.cpython-311.pyc +0 -0
- package/python/Lib/site-packages/platformdirs/_android.py +67 -0
- package/python/Lib/site-packages/platformdirs/_runtime.py +65 -0
- package/python/Lib/site-packages/platformdirs/_xdg.py +50 -47
- package/python/Lib/site-packages/platformdirs/android.py +64 -112
- package/python/Lib/site-packages/platformdirs/api.py +384 -293
- package/python/Lib/site-packages/platformdirs/ios.py +40 -40
- package/python/Lib/site-packages/platformdirs/macos.py +95 -72
- package/python/Lib/site-packages/platformdirs/pytest_plugin.py +5 -4
- package/python/Lib/site-packages/platformdirs/testing.py +23 -21
- package/python/Lib/site-packages/platformdirs/unix.py +158 -169
- package/python/Lib/site-packages/platformdirs/version.py +2 -2
- package/python/Lib/site-packages/platformdirs/windows.py +135 -121
- package/python/Lib/site-packages/{platformdirs-4.14.5.dist-info → platformdirs-4.14.7.dist-info}/METADATA +1 -1
- package/python/Lib/site-packages/platformdirs-4.14.7.dist-info/RECORD +23 -0
- package/python/Lib/site-packages/{pydantic_settings-2.16.2.dist-info → platformdirs-4.14.7.dist-info}/WHEEL +1 -1
- package/python/Lib/site-packages/platformdirs-4.14.7.dist-info/sboms/platformdirs.cdx.json +14820 -0
- package/python/Lib/site-packages/pycosat-0.6.6.dist-info/RECORD +1 -1
- package/python/Lib/site-packages/pycosat.cp311-win_arm64.pyd +0 -0
- package/python/Lib/site-packages/pydantic_settings/__pycache__/version.cpython-311.pyc +0 -0
- package/python/Lib/site-packages/pydantic_settings/sources/providers/__pycache__/cli.cpython-311.pyc +0 -0
- package/python/Lib/site-packages/pydantic_settings/sources/providers/__pycache__/nested_secrets.cpython-311.pyc +0 -0
- package/python/Lib/site-packages/pydantic_settings/sources/providers/__pycache__/secrets.cpython-311.pyc +0 -0
- package/python/Lib/site-packages/pydantic_settings/sources/providers/cli.py +13 -16
- package/python/Lib/site-packages/pydantic_settings/sources/providers/nested_secrets.py +32 -18
- package/python/Lib/site-packages/pydantic_settings/sources/providers/secrets.py +20 -1
- package/python/Lib/site-packages/pydantic_settings/version.py +1 -1
- package/python/Lib/site-packages/{pydantic_settings-2.16.2.dist-info → pydantic_settings-2.16.3.dist-info}/METADATA +1 -1
- package/python/Lib/site-packages/{pydantic_settings-2.16.2.dist-info → pydantic_settings-2.16.3.dist-info}/RECORD +10 -10
- package/python/Lib/site-packages/pygments-2.21.0.dist-info/RECORD +1 -1
- package/python/Lib/site-packages/python_dotenv-1.2.4.dist-info/RECORD +1 -1
- package/python/Lib/site-packages/ruamel_yaml_clib-0.2.15.dist-info/RECORD +1 -1
- package/python/Lib/site-packages/semver/__about__.py +1 -1
- package/python/Lib/site-packages/semver/__pycache__/__about__.cpython-311.pyc +0 -0
- package/python/Lib/site-packages/semver/__pycache__/version.cpython-311.pyc +0 -0
- package/python/Lib/site-packages/semver/version.py +16 -5
- package/python/Lib/site-packages/{semver-3.1.1.dist-info → semver-3.1.2.dist-info}/METADATA +1 -1
- package/python/Lib/site-packages/semver-3.1.2.dist-info/RECORD +17 -0
- package/python/Lib/site-packages/sentry_sdk/__pycache__/_types.cpython-311.pyc +0 -0
- package/python/Lib/site-packages/sentry_sdk/__pycache__/client.cpython-311.pyc +0 -0
- package/python/Lib/site-packages/sentry_sdk/__pycache__/consts.cpython-311.pyc +0 -0
- package/python/Lib/site-packages/sentry_sdk/__pycache__/traces.cpython-311.pyc +0 -0
- package/python/Lib/site-packages/sentry_sdk/__pycache__/utils.cpython-311.pyc +0 -0
- package/python/Lib/site-packages/sentry_sdk/_types.py +27 -3
- package/python/Lib/site-packages/sentry_sdk/client.py +1 -1
- package/python/Lib/site-packages/sentry_sdk/consts.py +7 -1
- package/python/Lib/site-packages/sentry_sdk/crons/__pycache__/decorator.cpython-311.pyc +0 -0
- package/python/Lib/site-packages/sentry_sdk/crons/__pycache__/utils.cpython-311.pyc +0 -0
- package/python/Lib/site-packages/sentry_sdk/crons/decorator.py +2 -0
- package/python/Lib/site-packages/sentry_sdk/crons/utils.py +26 -0
- package/python/Lib/site-packages/sentry_sdk/integrations/__pycache__/arq.cpython-311.pyc +0 -0
- package/python/Lib/site-packages/sentry_sdk/integrations/__pycache__/gql.cpython-311.pyc +0 -0
- package/python/Lib/site-packages/sentry_sdk/integrations/__pycache__/huggingface_hub.cpython-311.pyc +0 -0
- package/python/Lib/site-packages/sentry_sdk/integrations/__pycache__/starlette.cpython-311.pyc +0 -0
- package/python/Lib/site-packages/sentry_sdk/integrations/__pycache__/trytond.cpython-311.pyc +0 -0
- package/python/Lib/site-packages/sentry_sdk/integrations/arq.py +9 -16
- package/python/Lib/site-packages/sentry_sdk/integrations/boto3/__init__.py +2 -0
- package/python/Lib/site-packages/sentry_sdk/integrations/boto3/__pycache__/__init__.cpython-311.pyc +0 -0
- package/python/Lib/site-packages/sentry_sdk/integrations/boto3/__pycache__/_client.cpython-311.pyc +0 -0
- package/python/Lib/site-packages/sentry_sdk/integrations/boto3/__pycache__/_instrumentation.cpython-311.pyc +0 -0
- package/python/Lib/site-packages/sentry_sdk/integrations/boto3/_client.py +13 -15
- package/python/Lib/site-packages/sentry_sdk/integrations/boto3/_instrumentation.py +11 -13
- package/python/Lib/site-packages/sentry_sdk/integrations/boto3/_services/__pycache__/base.cpython-311.pyc +0 -0
- package/python/Lib/site-packages/sentry_sdk/integrations/boto3/_services/__pycache__/bedrock.cpython-311.pyc +0 -0
- package/python/Lib/site-packages/sentry_sdk/integrations/boto3/_services/base.py +16 -7
- package/python/Lib/site-packages/sentry_sdk/integrations/boto3/_services/bedrock.py +771 -0
- package/python/Lib/site-packages/sentry_sdk/integrations/celery/__init__.py +3 -2
- package/python/Lib/site-packages/sentry_sdk/integrations/celery/__pycache__/__init__.cpython-311.pyc +0 -0
- package/python/Lib/site-packages/sentry_sdk/integrations/django/__init__.py +1 -1
- package/python/Lib/site-packages/sentry_sdk/integrations/django/__pycache__/__init__.cpython-311.pyc +0 -0
- package/python/Lib/site-packages/sentry_sdk/integrations/django/__pycache__/signals_handlers.cpython-311.pyc +0 -0
- package/python/Lib/site-packages/sentry_sdk/integrations/django/signals_handlers.py +1 -1
- package/python/Lib/site-packages/sentry_sdk/integrations/gql.py +28 -3
- package/python/Lib/site-packages/sentry_sdk/integrations/huggingface_hub.py +1 -1
- package/python/Lib/site-packages/sentry_sdk/integrations/openai_agents/__init__.py +1 -1
- package/python/Lib/site-packages/sentry_sdk/integrations/openai_agents/__pycache__/__init__.cpython-311.pyc +0 -0
- package/python/Lib/site-packages/sentry_sdk/integrations/starlette.py +2 -2
- package/python/Lib/site-packages/sentry_sdk/integrations/trytond.py +1 -1
- package/python/Lib/site-packages/sentry_sdk/profiler/__pycache__/continuous_profiler.cpython-311.pyc +0 -0
- package/python/Lib/site-packages/sentry_sdk/profiler/__pycache__/transaction_profiler.cpython-311.pyc +0 -0
- package/python/Lib/site-packages/sentry_sdk/profiler/continuous_profiler.py +0 -3
- package/python/Lib/site-packages/sentry_sdk/profiler/transaction_profiler.py +1 -1
- package/python/Lib/site-packages/sentry_sdk/traces.py +1 -1
- package/python/Lib/site-packages/sentry_sdk/utils.py +17 -4
- package/python/Lib/site-packages/{sentry_sdk-2.74.0.dist-info → sentry_sdk-2.75.0.dist-info}/METADATA +1 -1
- package/python/Lib/site-packages/{sentry_sdk-2.74.0.dist-info → sentry_sdk-2.75.0.dist-info}/RECORD +31 -31
- package/python/Lib/site-packages/tqdm-4.70.1.dist-info/RECORD +1 -1
- package/python/Lib/site-packages/typer-0.29.1.dist-info/RECORD +1 -1
- package/python/Lib/venv/scripts/nt/python.exe +0 -0
- package/python/Lib/venv/scripts/nt/pythonw.exe +0 -0
- package/python/Scripts/conda.exe +0 -0
- package/python/libs/_asyncio.lib +0 -0
- package/python/libs/_bz2.lib +0 -0
- package/python/libs/_ctypes.lib +0 -0
- package/python/libs/_ctypes_test.lib +0 -0
- package/python/libs/_decimal.lib +0 -0
- package/python/libs/_elementtree.lib +0 -0
- package/python/libs/_hashlib.lib +0 -0
- package/python/libs/_lzma.lib +0 -0
- package/python/libs/_msi.lib +0 -0
- package/python/libs/_multiprocessing.lib +0 -0
- package/python/libs/_overlapped.lib +0 -0
- package/python/libs/_queue.lib +0 -0
- package/python/libs/_socket.lib +0 -0
- package/python/libs/_sqlite3.lib +0 -0
- package/python/libs/_ssl.lib +0 -0
- package/python/libs/_testbuffer.lib +0 -0
- package/python/libs/_testcapi.lib +0 -0
- package/python/libs/_testconsole.lib +0 -0
- package/python/libs/_testimportmultiple.lib +0 -0
- package/python/libs/_testinternalcapi.lib +0 -0
- package/python/libs/_testmultiphase.lib +0 -0
- package/python/libs/_tkinter.lib +0 -0
- package/python/libs/_uuid.lib +0 -0
- package/python/libs/_zoneinfo.lib +0 -0
- package/python/libs/pyexpat.lib +0 -0
- package/python/libs/python3.lib +0 -0
- package/python/libs/python311.lib +0 -0
- package/python/libs/select.lib +0 -0
- package/python/libs/sqlite3.lib +0 -0
- package/python/libs/unicodedata.lib +0 -0
- package/python/libs/winsound.lib +0 -0
- package/python/python.exe +0 -0
- package/python/python3.dll +0 -0
- package/python/python311.dll +0 -0
- package/python/pythonw.exe +0 -0
- package/python/Lib/site-packages/platformdirs-4.14.5.dist-info/RECORD +0 -20
- package/python/Lib/site-packages/semver-3.1.1.dist-info/RECORD +0 -17
- package/python/Lib/site-packages/sentry_sdk/integrations/boto3/_services/__pycache__/registry.cpython-311.pyc +0 -0
- package/python/Lib/site-packages/sentry_sdk/integrations/boto3/_services/registry.py +0 -22
- /package/python/Lib/site-packages/{platformdirs-4.14.5.dist-info → platformdirs-4.14.7.dist-info}/INSTALLER +0 -0
- /package/python/Lib/site-packages/{platformdirs-4.14.5.dist-info → platformdirs-4.14.7.dist-info}/REQUESTED +0 -0
- /package/python/Lib/site-packages/{platformdirs-4.14.5.dist-info → platformdirs-4.14.7.dist-info}/entry_points.txt +0 -0
- /package/python/Lib/site-packages/{platformdirs-4.14.5.dist-info → platformdirs-4.14.7.dist-info}/licenses/LICENSE +0 -0
- /package/python/Lib/site-packages/{pydantic_settings-2.16.2.dist-info → pydantic_settings-2.16.3.dist-info}/INSTALLER +0 -0
- /package/python/Lib/site-packages/{pydantic_settings-2.16.2.dist-info → pydantic_settings-2.16.3.dist-info}/REQUESTED +0 -0
- /package/python/Lib/site-packages/{platformdirs-4.14.5.dist-info → pydantic_settings-2.16.3.dist-info}/WHEEL +0 -0
- /package/python/Lib/site-packages/{pydantic_settings-2.16.2.dist-info → pydantic_settings-2.16.3.dist-info}/licenses/LICENSE +0 -0
- /package/python/Lib/site-packages/{semver-3.1.1.dist-info → semver-3.1.2.dist-info}/INSTALLER +0 -0
- /package/python/Lib/site-packages/{semver-3.1.1.dist-info → semver-3.1.2.dist-info}/REQUESTED +0 -0
- /package/python/Lib/site-packages/{semver-3.1.1.dist-info → semver-3.1.2.dist-info}/WHEEL +0 -0
- /package/python/Lib/site-packages/{semver-3.1.1.dist-info → semver-3.1.2.dist-info}/entry_points.txt +0 -0
- /package/python/Lib/site-packages/{semver-3.1.1.dist-info → semver-3.1.2.dist-info}/licenses/LICENSE.txt +0 -0
- /package/python/Lib/site-packages/{semver-3.1.1.dist-info → semver-3.1.2.dist-info}/top_level.txt +0 -0
- /package/python/Lib/site-packages/{sentry_sdk-2.74.0.dist-info → sentry_sdk-2.75.0.dist-info}/INSTALLER +0 -0
- /package/python/Lib/site-packages/{sentry_sdk-2.74.0.dist-info → sentry_sdk-2.75.0.dist-info}/REQUESTED +0 -0
- /package/python/Lib/site-packages/{sentry_sdk-2.74.0.dist-info → sentry_sdk-2.75.0.dist-info}/WHEEL +0 -0
- /package/python/Lib/site-packages/{sentry_sdk-2.74.0.dist-info → sentry_sdk-2.75.0.dist-info}/entry_points.txt +0 -0
- /package/python/Lib/site-packages/{sentry_sdk-2.74.0.dist-info → sentry_sdk-2.75.0.dist-info}/licenses/LICENSE +0 -0
- /package/python/Lib/site-packages/{sentry_sdk-2.74.0.dist-info → sentry_sdk-2.75.0.dist-info}/top_level.txt +0 -0
|
@@ -13,24 +13,24 @@ from __future__ import annotations
|
|
|
13
13
|
|
|
14
14
|
import os
|
|
15
15
|
import sys
|
|
16
|
-
from typing import TYPE_CHECKING
|
|
17
16
|
|
|
18
17
|
from .api import PlatformDirsABC, RuntimeDirWarning
|
|
19
18
|
from .version import __version__
|
|
20
19
|
from .version import __version_tuple__ as __version_info__
|
|
21
20
|
|
|
21
|
+
TYPE_CHECKING = False
|
|
22
22
|
if TYPE_CHECKING:
|
|
23
23
|
from pathlib import Path
|
|
24
24
|
from typing import Literal
|
|
25
25
|
|
|
26
26
|
if sys.platform == "win32":
|
|
27
|
-
from
|
|
27
|
+
from .windows import Windows as _Result
|
|
28
28
|
elif sys.platform == "darwin":
|
|
29
|
-
from
|
|
29
|
+
from .macos import MacOS as _Result
|
|
30
30
|
elif sys.platform == "ios":
|
|
31
|
-
from
|
|
31
|
+
from .ios import IOS as _Result # ruff:ignore[constant-imported-as-non-constant] # PEP 8 acronym
|
|
32
32
|
else:
|
|
33
|
-
from
|
|
33
|
+
from .unix import Unix as _Result
|
|
34
34
|
|
|
35
35
|
|
|
36
36
|
def _set_platform_dir_class() -> type[PlatformDirsABC]:
|
|
@@ -41,10 +41,10 @@ def _set_platform_dir_class() -> type[PlatformDirsABC]:
|
|
|
41
41
|
if os.getenv("SHELL") or os.getenv("PREFIX"):
|
|
42
42
|
return _Result
|
|
43
43
|
|
|
44
|
-
from
|
|
44
|
+
from ._android import android_folder # ruff:ignore[import-outside-top-level] # Android-only lookup
|
|
45
45
|
|
|
46
|
-
if
|
|
47
|
-
from
|
|
46
|
+
if android_folder() is not None:
|
|
47
|
+
from .android import Android # ruff:ignore[import-outside-top-level] # Android-only module
|
|
48
48
|
|
|
49
49
|
return Android # return to avoid redefinition of a result
|
|
50
50
|
|
|
@@ -53,19 +53,20 @@ def _set_platform_dir_class() -> type[PlatformDirsABC]:
|
|
|
53
53
|
|
|
54
54
|
if TYPE_CHECKING:
|
|
55
55
|
# Work around mypy issue: https://github.com/python/mypy/issues/10962
|
|
56
|
+
#: Currently active platform
|
|
56
57
|
PlatformDirs = _Result
|
|
57
58
|
else:
|
|
58
59
|
PlatformDirs = _set_platform_dir_class() #: Currently active platform
|
|
59
60
|
AppDirs = PlatformDirs #: Backwards compatibility with appdirs
|
|
60
61
|
|
|
61
62
|
|
|
62
|
-
def user_data_dir( # ruff:ignore[too-many-arguments, too-many-positional-arguments]
|
|
63
|
+
def user_data_dir( # ruff:ignore[too-many-arguments, too-many-positional-arguments] # preserve released API
|
|
63
64
|
appname: str | None = None,
|
|
64
65
|
appauthor: str | Literal[False] | None = None,
|
|
65
66
|
version: str | None = None,
|
|
66
|
-
roaming: bool = False, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
|
|
67
|
-
ensure_exists: bool = False, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
|
|
68
|
-
use_site_for_root: bool = False, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
|
|
67
|
+
roaming: bool = False, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument] # preserve positional API
|
|
68
|
+
ensure_exists: bool = False, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument] # preserve positional API
|
|
69
|
+
use_site_for_root: bool = False, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument] # preserve positional API
|
|
69
70
|
) -> str:
|
|
70
71
|
""":param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`.
|
|
71
72
|
:param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`.
|
|
@@ -91,8 +92,8 @@ def site_data_dir(
|
|
|
91
92
|
appname: str | None = None,
|
|
92
93
|
appauthor: str | Literal[False] | None = None,
|
|
93
94
|
version: str | None = None,
|
|
94
|
-
multipath: bool = False, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
|
|
95
|
-
ensure_exists: bool = False, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
|
|
95
|
+
multipath: bool = False, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument] # preserve positional API
|
|
96
|
+
ensure_exists: bool = False, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument] # preserve positional API
|
|
96
97
|
) -> str:
|
|
97
98
|
""":param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`.
|
|
98
99
|
:param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`.
|
|
@@ -112,13 +113,13 @@ def site_data_dir(
|
|
|
112
113
|
).site_data_dir
|
|
113
114
|
|
|
114
115
|
|
|
115
|
-
def user_config_dir( # ruff:ignore[too-many-arguments, too-many-positional-arguments]
|
|
116
|
+
def user_config_dir( # ruff:ignore[too-many-arguments, too-many-positional-arguments] # preserve released API
|
|
116
117
|
appname: str | None = None,
|
|
117
118
|
appauthor: str | Literal[False] | None = None,
|
|
118
119
|
version: str | None = None,
|
|
119
|
-
roaming: bool = False, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
|
|
120
|
-
ensure_exists: bool = False, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
|
|
121
|
-
use_site_for_root: bool = False, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
|
|
120
|
+
roaming: bool = False, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument] # preserve positional API
|
|
121
|
+
ensure_exists: bool = False, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument] # preserve positional API
|
|
122
|
+
use_site_for_root: bool = False, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument] # preserve positional API
|
|
122
123
|
) -> str:
|
|
123
124
|
""":param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`.
|
|
124
125
|
:param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`.
|
|
@@ -144,8 +145,8 @@ def site_config_dir(
|
|
|
144
145
|
appname: str | None = None,
|
|
145
146
|
appauthor: str | Literal[False] | None = None,
|
|
146
147
|
version: str | None = None,
|
|
147
|
-
multipath: bool = False, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
|
|
148
|
-
ensure_exists: bool = False, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
|
|
148
|
+
multipath: bool = False, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument] # preserve positional API
|
|
149
|
+
ensure_exists: bool = False, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument] # preserve positional API
|
|
149
150
|
) -> str:
|
|
150
151
|
""":param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`.
|
|
151
152
|
:param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`.
|
|
@@ -165,13 +166,13 @@ def site_config_dir(
|
|
|
165
166
|
).site_config_dir
|
|
166
167
|
|
|
167
168
|
|
|
168
|
-
def user_cache_dir( # ruff:ignore[too-many-arguments, too-many-positional-arguments]
|
|
169
|
+
def user_cache_dir( # ruff:ignore[too-many-arguments, too-many-positional-arguments] # preserve released API
|
|
169
170
|
appname: str | None = None,
|
|
170
171
|
appauthor: str | Literal[False] | None = None,
|
|
171
172
|
version: str | None = None,
|
|
172
|
-
opinion: bool = True, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
|
|
173
|
-
ensure_exists: bool = False, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
|
|
174
|
-
use_site_for_root: bool = False, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
|
|
173
|
+
opinion: bool = True, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument] # preserve positional API
|
|
174
|
+
ensure_exists: bool = False, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument] # preserve positional API
|
|
175
|
+
use_site_for_root: bool = False, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument] # preserve positional API
|
|
175
176
|
) -> str:
|
|
176
177
|
""":param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`.
|
|
177
178
|
:param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`.
|
|
@@ -193,12 +194,12 @@ def user_cache_dir( # ruff:ignore[too-many-arguments, too-many-positional-argum
|
|
|
193
194
|
).user_cache_dir
|
|
194
195
|
|
|
195
196
|
|
|
196
|
-
def site_cache_dir( # ruff:ignore[too-many-arguments]
|
|
197
|
+
def site_cache_dir( # ruff:ignore[too-many-arguments] # preserve released API
|
|
197
198
|
appname: str | None = None,
|
|
198
199
|
appauthor: str | Literal[False] | None = None,
|
|
199
200
|
version: str | None = None,
|
|
200
|
-
opinion: bool = True, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
|
|
201
|
-
ensure_exists: bool = False, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
|
|
201
|
+
opinion: bool = True, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument] # preserve positional API
|
|
202
|
+
ensure_exists: bool = False, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument] # preserve positional API
|
|
202
203
|
*,
|
|
203
204
|
multipath: bool = False,
|
|
204
205
|
) -> str:
|
|
@@ -222,13 +223,13 @@ def site_cache_dir( # ruff:ignore[too-many-arguments]
|
|
|
222
223
|
).site_cache_dir
|
|
223
224
|
|
|
224
225
|
|
|
225
|
-
def user_state_dir( # ruff:ignore[too-many-arguments, too-many-positional-arguments]
|
|
226
|
+
def user_state_dir( # ruff:ignore[too-many-arguments, too-many-positional-arguments] # preserve released API
|
|
226
227
|
appname: str | None = None,
|
|
227
228
|
appauthor: str | Literal[False] | None = None,
|
|
228
229
|
version: str | None = None,
|
|
229
|
-
roaming: bool = False, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
|
|
230
|
-
ensure_exists: bool = False, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
|
|
231
|
-
use_site_for_root: bool = False, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
|
|
230
|
+
roaming: bool = False, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument] # preserve positional API
|
|
231
|
+
ensure_exists: bool = False, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument] # preserve positional API
|
|
232
|
+
use_site_for_root: bool = False, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument] # preserve positional API
|
|
232
233
|
) -> str:
|
|
233
234
|
""":param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`.
|
|
234
235
|
:param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`.
|
|
@@ -254,7 +255,7 @@ def site_state_dir(
|
|
|
254
255
|
appname: str | None = None,
|
|
255
256
|
appauthor: str | Literal[False] | None = None,
|
|
256
257
|
version: str | None = None,
|
|
257
|
-
ensure_exists: bool = False, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
|
|
258
|
+
ensure_exists: bool = False, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument] # preserve positional API
|
|
258
259
|
) -> str:
|
|
259
260
|
""":param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`.
|
|
260
261
|
:param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`.
|
|
@@ -272,13 +273,13 @@ def site_state_dir(
|
|
|
272
273
|
).site_state_dir
|
|
273
274
|
|
|
274
275
|
|
|
275
|
-
def user_log_dir( # ruff:ignore[too-many-arguments, too-many-positional-arguments]
|
|
276
|
+
def user_log_dir( # ruff:ignore[too-many-arguments, too-many-positional-arguments] # preserve released API
|
|
276
277
|
appname: str | None = None,
|
|
277
278
|
appauthor: str | Literal[False] | None = None,
|
|
278
279
|
version: str | None = None,
|
|
279
|
-
opinion: bool = True, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
|
|
280
|
-
ensure_exists: bool = False, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
|
|
281
|
-
use_site_for_root: bool = False, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
|
|
280
|
+
opinion: bool = True, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument] # preserve positional API
|
|
281
|
+
ensure_exists: bool = False, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument] # preserve positional API
|
|
282
|
+
use_site_for_root: bool = False, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument] # preserve positional API
|
|
282
283
|
*,
|
|
283
284
|
roaming: bool = False,
|
|
284
285
|
) -> str:
|
|
@@ -308,8 +309,8 @@ def site_log_dir(
|
|
|
308
309
|
appname: str | None = None,
|
|
309
310
|
appauthor: str | Literal[False] | None = None,
|
|
310
311
|
version: str | None = None,
|
|
311
|
-
opinion: bool = True, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
|
|
312
|
-
ensure_exists: bool = False, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
|
|
312
|
+
opinion: bool = True, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument] # preserve positional API
|
|
313
|
+
ensure_exists: bool = False, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument] # preserve positional API
|
|
313
314
|
) -> str:
|
|
314
315
|
""":param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`.
|
|
315
316
|
:param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`.
|
|
@@ -329,93 +330,106 @@ def site_log_dir(
|
|
|
329
330
|
).site_log_dir
|
|
330
331
|
|
|
331
332
|
|
|
332
|
-
def user_documents_dir(*, ensure_exists: bool = False) -> str:
|
|
333
|
+
def user_documents_dir(*, ensure_exists: bool = False, use_site_for_root: bool = False) -> str:
|
|
333
334
|
""":param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`.
|
|
335
|
+
:param use_site_for_root: See `use_site_for_root <platformdirs.api.PlatformDirsABC.use_site_for_root>`.
|
|
334
336
|
|
|
335
337
|
:returns: documents directory tied to the user
|
|
336
338
|
|
|
337
339
|
"""
|
|
338
|
-
return PlatformDirs(ensure_exists=ensure_exists).user_documents_dir
|
|
340
|
+
return PlatformDirs(ensure_exists=ensure_exists, use_site_for_root=use_site_for_root).user_documents_dir
|
|
339
341
|
|
|
340
342
|
|
|
341
|
-
def user_downloads_dir(*, ensure_exists: bool = False) -> str:
|
|
343
|
+
def user_downloads_dir(*, ensure_exists: bool = False, use_site_for_root: bool = False) -> str:
|
|
342
344
|
""":param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`.
|
|
345
|
+
:param use_site_for_root: See `use_site_for_root <platformdirs.api.PlatformDirsABC.use_site_for_root>`.
|
|
343
346
|
|
|
344
347
|
:returns: downloads directory tied to the user
|
|
345
348
|
|
|
346
349
|
"""
|
|
347
|
-
return PlatformDirs(ensure_exists=ensure_exists).user_downloads_dir
|
|
350
|
+
return PlatformDirs(ensure_exists=ensure_exists, use_site_for_root=use_site_for_root).user_downloads_dir
|
|
348
351
|
|
|
349
352
|
|
|
350
|
-
def user_pictures_dir(*, ensure_exists: bool = False) -> str:
|
|
353
|
+
def user_pictures_dir(*, ensure_exists: bool = False, use_site_for_root: bool = False) -> str:
|
|
351
354
|
""":param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`.
|
|
355
|
+
:param use_site_for_root: See `use_site_for_root <platformdirs.api.PlatformDirsABC.use_site_for_root>`.
|
|
352
356
|
|
|
353
357
|
:returns: pictures directory tied to the user
|
|
354
358
|
|
|
355
359
|
"""
|
|
356
|
-
return PlatformDirs(ensure_exists=ensure_exists).user_pictures_dir
|
|
360
|
+
return PlatformDirs(ensure_exists=ensure_exists, use_site_for_root=use_site_for_root).user_pictures_dir
|
|
357
361
|
|
|
358
362
|
|
|
359
|
-
def user_videos_dir(*, ensure_exists: bool = False) -> str:
|
|
363
|
+
def user_videos_dir(*, ensure_exists: bool = False, use_site_for_root: bool = False) -> str:
|
|
360
364
|
""":param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`.
|
|
365
|
+
:param use_site_for_root: See `use_site_for_root <platformdirs.api.PlatformDirsABC.use_site_for_root>`.
|
|
361
366
|
|
|
362
367
|
:returns: videos directory tied to the user
|
|
363
368
|
|
|
364
369
|
"""
|
|
365
|
-
return PlatformDirs(ensure_exists=ensure_exists).user_videos_dir
|
|
370
|
+
return PlatformDirs(ensure_exists=ensure_exists, use_site_for_root=use_site_for_root).user_videos_dir
|
|
366
371
|
|
|
367
372
|
|
|
368
|
-
def user_music_dir(*, ensure_exists: bool = False) -> str:
|
|
373
|
+
def user_music_dir(*, ensure_exists: bool = False, use_site_for_root: bool = False) -> str:
|
|
369
374
|
""":param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`.
|
|
375
|
+
:param use_site_for_root: See `use_site_for_root <platformdirs.api.PlatformDirsABC.use_site_for_root>`.
|
|
370
376
|
|
|
371
377
|
:returns: music directory tied to the user
|
|
372
378
|
|
|
373
379
|
"""
|
|
374
|
-
return PlatformDirs(ensure_exists=ensure_exists).user_music_dir
|
|
380
|
+
return PlatformDirs(ensure_exists=ensure_exists, use_site_for_root=use_site_for_root).user_music_dir
|
|
375
381
|
|
|
376
382
|
|
|
377
|
-
def user_desktop_dir(*, ensure_exists: bool = False) -> str:
|
|
383
|
+
def user_desktop_dir(*, ensure_exists: bool = False, use_site_for_root: bool = False) -> str:
|
|
378
384
|
""":param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`.
|
|
385
|
+
:param use_site_for_root: See `use_site_for_root <platformdirs.api.PlatformDirsABC.use_site_for_root>`.
|
|
379
386
|
|
|
380
387
|
:returns: desktop directory tied to the user
|
|
381
388
|
|
|
382
389
|
"""
|
|
383
|
-
return PlatformDirs(ensure_exists=ensure_exists).user_desktop_dir
|
|
390
|
+
return PlatformDirs(ensure_exists=ensure_exists, use_site_for_root=use_site_for_root).user_desktop_dir
|
|
384
391
|
|
|
385
392
|
|
|
386
|
-
def user_projects_dir(*, ensure_exists: bool = False) -> str:
|
|
393
|
+
def user_projects_dir(*, ensure_exists: bool = False, use_site_for_root: bool = False) -> str:
|
|
387
394
|
""":param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`.
|
|
395
|
+
:param use_site_for_root: See `use_site_for_root <platformdirs.api.PlatformDirsABC.use_site_for_root>`.
|
|
388
396
|
|
|
389
397
|
:returns: projects directory tied to the user
|
|
390
398
|
|
|
391
399
|
"""
|
|
392
|
-
return PlatformDirs(ensure_exists=ensure_exists).user_projects_dir
|
|
400
|
+
return PlatformDirs(ensure_exists=ensure_exists, use_site_for_root=use_site_for_root).user_projects_dir
|
|
393
401
|
|
|
394
402
|
|
|
395
|
-
def user_publicshare_dir(*, ensure_exists: bool = False) -> str:
|
|
403
|
+
def user_publicshare_dir(*, ensure_exists: bool = False, use_site_for_root: bool = False) -> str:
|
|
396
404
|
""":param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`.
|
|
405
|
+
:param use_site_for_root: See `use_site_for_root <platformdirs.api.PlatformDirsABC.use_site_for_root>`.
|
|
397
406
|
|
|
398
407
|
:returns: public share directory tied to the user
|
|
399
408
|
|
|
400
409
|
"""
|
|
401
|
-
return PlatformDirs(ensure_exists=ensure_exists).user_publicshare_dir
|
|
410
|
+
return PlatformDirs(ensure_exists=ensure_exists, use_site_for_root=use_site_for_root).user_publicshare_dir
|
|
402
411
|
|
|
403
412
|
|
|
404
|
-
def user_templates_dir(*, ensure_exists: bool = False) -> str:
|
|
413
|
+
def user_templates_dir(*, ensure_exists: bool = False, use_site_for_root: bool = False) -> str:
|
|
405
414
|
""":param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`.
|
|
415
|
+
:param use_site_for_root: See `use_site_for_root <platformdirs.api.PlatformDirsABC.use_site_for_root>`.
|
|
406
416
|
|
|
407
417
|
:returns: templates directory tied to the user
|
|
408
418
|
|
|
409
419
|
"""
|
|
410
|
-
return PlatformDirs(ensure_exists=ensure_exists).user_templates_dir
|
|
420
|
+
return PlatformDirs(ensure_exists=ensure_exists, use_site_for_root=use_site_for_root).user_templates_dir
|
|
421
|
+
|
|
411
422
|
|
|
423
|
+
def user_fonts_dir(*, use_site_for_root: bool = False) -> str:
|
|
424
|
+
""":param use_site_for_root: See `use_site_for_root <platformdirs.api.PlatformDirsABC.use_site_for_root>`.
|
|
425
|
+
|
|
426
|
+
:returns: fonts directory tied to the user
|
|
412
427
|
|
|
413
|
-
|
|
414
|
-
|
|
415
|
-
return PlatformDirs().user_fonts_dir
|
|
428
|
+
"""
|
|
429
|
+
return PlatformDirs(use_site_for_root=use_site_for_root).user_fonts_dir
|
|
416
430
|
|
|
417
431
|
|
|
418
|
-
def user_preference_dir( # ruff:ignore[too-many-arguments]
|
|
432
|
+
def user_preference_dir( # ruff:ignore[too-many-arguments] # preserve released API
|
|
419
433
|
appname: str | None = None,
|
|
420
434
|
appauthor: str | Literal[False] | None = None,
|
|
421
435
|
version: str | None = None,
|
|
@@ -485,8 +499,8 @@ def user_applications_dir(
|
|
|
485
499
|
|
|
486
500
|
|
|
487
501
|
def site_applications_dir(
|
|
488
|
-
multipath: bool = False, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
|
|
489
|
-
ensure_exists: bool = False, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
|
|
502
|
+
multipath: bool = False, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument] # preserve positional API
|
|
503
|
+
ensure_exists: bool = False, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument] # preserve positional API
|
|
490
504
|
*,
|
|
491
505
|
appname: str | None = None,
|
|
492
506
|
appauthor: str | Literal[False] | None = None,
|
|
@@ -510,13 +524,13 @@ def site_applications_dir(
|
|
|
510
524
|
).site_applications_dir
|
|
511
525
|
|
|
512
526
|
|
|
513
|
-
def user_runtime_dir( # ruff:ignore[too-many-arguments, too-many-positional-arguments]
|
|
527
|
+
def user_runtime_dir( # ruff:ignore[too-many-arguments, too-many-positional-arguments] # preserve released API
|
|
514
528
|
appname: str | None = None,
|
|
515
529
|
appauthor: str | Literal[False] | None = None,
|
|
516
530
|
version: str | None = None,
|
|
517
|
-
opinion: bool = True, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
|
|
518
|
-
ensure_exists: bool = False, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
|
|
519
|
-
use_site_for_root: bool = False, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
|
|
531
|
+
opinion: bool = True, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument] # preserve positional API
|
|
532
|
+
ensure_exists: bool = False, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument] # preserve positional API
|
|
533
|
+
use_site_for_root: bool = False, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument] # preserve positional API
|
|
520
534
|
) -> str:
|
|
521
535
|
""":param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`.
|
|
522
536
|
:param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`.
|
|
@@ -542,8 +556,8 @@ def site_runtime_dir(
|
|
|
542
556
|
appname: str | None = None,
|
|
543
557
|
appauthor: str | Literal[False] | None = None,
|
|
544
558
|
version: str | None = None,
|
|
545
|
-
opinion: bool = True, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
|
|
546
|
-
ensure_exists: bool = False, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
|
|
559
|
+
opinion: bool = True, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument] # preserve positional API
|
|
560
|
+
ensure_exists: bool = False, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument] # preserve positional API
|
|
547
561
|
) -> str:
|
|
548
562
|
""":param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`.
|
|
549
563
|
:param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`.
|
|
@@ -563,13 +577,13 @@ def site_runtime_dir(
|
|
|
563
577
|
).site_runtime_dir
|
|
564
578
|
|
|
565
579
|
|
|
566
|
-
def user_data_path( # ruff:ignore[too-many-arguments, too-many-positional-arguments]
|
|
580
|
+
def user_data_path( # ruff:ignore[too-many-arguments, too-many-positional-arguments] # preserve released API
|
|
567
581
|
appname: str | None = None,
|
|
568
582
|
appauthor: str | Literal[False] | None = None,
|
|
569
583
|
version: str | None = None,
|
|
570
|
-
roaming: bool = False, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
|
|
571
|
-
ensure_exists: bool = False, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
|
|
572
|
-
use_site_for_root: bool = False, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
|
|
584
|
+
roaming: bool = False, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument] # preserve positional API
|
|
585
|
+
ensure_exists: bool = False, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument] # preserve positional API
|
|
586
|
+
use_site_for_root: bool = False, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument] # preserve positional API
|
|
573
587
|
) -> Path:
|
|
574
588
|
""":param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`.
|
|
575
589
|
:param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`.
|
|
@@ -595,8 +609,8 @@ def site_data_path(
|
|
|
595
609
|
appname: str | None = None,
|
|
596
610
|
appauthor: str | Literal[False] | None = None,
|
|
597
611
|
version: str | None = None,
|
|
598
|
-
multipath: bool = False, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
|
|
599
|
-
ensure_exists: bool = False, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
|
|
612
|
+
multipath: bool = False, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument] # preserve positional API
|
|
613
|
+
ensure_exists: bool = False, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument] # preserve positional API
|
|
600
614
|
) -> Path:
|
|
601
615
|
""":param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`.
|
|
602
616
|
:param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`.
|
|
@@ -616,13 +630,13 @@ def site_data_path(
|
|
|
616
630
|
).site_data_path
|
|
617
631
|
|
|
618
632
|
|
|
619
|
-
def user_config_path( # ruff:ignore[too-many-arguments, too-many-positional-arguments]
|
|
633
|
+
def user_config_path( # ruff:ignore[too-many-arguments, too-many-positional-arguments] # preserve released API
|
|
620
634
|
appname: str | None = None,
|
|
621
635
|
appauthor: str | Literal[False] | None = None,
|
|
622
636
|
version: str | None = None,
|
|
623
|
-
roaming: bool = False, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
|
|
624
|
-
ensure_exists: bool = False, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
|
|
625
|
-
use_site_for_root: bool = False, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
|
|
637
|
+
roaming: bool = False, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument] # preserve positional API
|
|
638
|
+
ensure_exists: bool = False, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument] # preserve positional API
|
|
639
|
+
use_site_for_root: bool = False, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument] # preserve positional API
|
|
626
640
|
) -> Path:
|
|
627
641
|
""":param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`.
|
|
628
642
|
:param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`.
|
|
@@ -648,8 +662,8 @@ def site_config_path(
|
|
|
648
662
|
appname: str | None = None,
|
|
649
663
|
appauthor: str | Literal[False] | None = None,
|
|
650
664
|
version: str | None = None,
|
|
651
|
-
multipath: bool = False, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
|
|
652
|
-
ensure_exists: bool = False, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
|
|
665
|
+
multipath: bool = False, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument] # preserve positional API
|
|
666
|
+
ensure_exists: bool = False, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument] # preserve positional API
|
|
653
667
|
) -> Path:
|
|
654
668
|
""":param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`.
|
|
655
669
|
:param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`.
|
|
@@ -669,12 +683,12 @@ def site_config_path(
|
|
|
669
683
|
).site_config_path
|
|
670
684
|
|
|
671
685
|
|
|
672
|
-
def site_cache_path( # ruff:ignore[too-many-arguments]
|
|
686
|
+
def site_cache_path( # ruff:ignore[too-many-arguments] # preserve released API
|
|
673
687
|
appname: str | None = None,
|
|
674
688
|
appauthor: str | Literal[False] | None = None,
|
|
675
689
|
version: str | None = None,
|
|
676
|
-
opinion: bool = True, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
|
|
677
|
-
ensure_exists: bool = False, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
|
|
690
|
+
opinion: bool = True, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument] # preserve positional API
|
|
691
|
+
ensure_exists: bool = False, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument] # preserve positional API
|
|
678
692
|
*,
|
|
679
693
|
multipath: bool = False,
|
|
680
694
|
) -> Path:
|
|
@@ -698,13 +712,13 @@ def site_cache_path( # ruff:ignore[too-many-arguments]
|
|
|
698
712
|
).site_cache_path
|
|
699
713
|
|
|
700
714
|
|
|
701
|
-
def user_cache_path( # ruff:ignore[too-many-arguments, too-many-positional-arguments]
|
|
715
|
+
def user_cache_path( # ruff:ignore[too-many-arguments, too-many-positional-arguments] # preserve released API
|
|
702
716
|
appname: str | None = None,
|
|
703
717
|
appauthor: str | Literal[False] | None = None,
|
|
704
718
|
version: str | None = None,
|
|
705
|
-
opinion: bool = True, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
|
|
706
|
-
ensure_exists: bool = False, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
|
|
707
|
-
use_site_for_root: bool = False, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
|
|
719
|
+
opinion: bool = True, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument] # preserve positional API
|
|
720
|
+
ensure_exists: bool = False, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument] # preserve positional API
|
|
721
|
+
use_site_for_root: bool = False, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument] # preserve positional API
|
|
708
722
|
) -> Path:
|
|
709
723
|
""":param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`.
|
|
710
724
|
:param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`.
|
|
@@ -726,13 +740,13 @@ def user_cache_path( # ruff:ignore[too-many-arguments, too-many-positional-argu
|
|
|
726
740
|
).user_cache_path
|
|
727
741
|
|
|
728
742
|
|
|
729
|
-
def user_state_path( # ruff:ignore[too-many-arguments, too-many-positional-arguments]
|
|
743
|
+
def user_state_path( # ruff:ignore[too-many-arguments, too-many-positional-arguments] # preserve released API
|
|
730
744
|
appname: str | None = None,
|
|
731
745
|
appauthor: str | Literal[False] | None = None,
|
|
732
746
|
version: str | None = None,
|
|
733
|
-
roaming: bool = False, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
|
|
734
|
-
ensure_exists: bool = False, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
|
|
735
|
-
use_site_for_root: bool = False, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
|
|
747
|
+
roaming: bool = False, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument] # preserve positional API
|
|
748
|
+
ensure_exists: bool = False, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument] # preserve positional API
|
|
749
|
+
use_site_for_root: bool = False, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument] # preserve positional API
|
|
736
750
|
) -> Path:
|
|
737
751
|
""":param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`.
|
|
738
752
|
:param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`.
|
|
@@ -758,7 +772,7 @@ def site_state_path(
|
|
|
758
772
|
appname: str | None = None,
|
|
759
773
|
appauthor: str | Literal[False] | None = None,
|
|
760
774
|
version: str | None = None,
|
|
761
|
-
ensure_exists: bool = False, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
|
|
775
|
+
ensure_exists: bool = False, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument] # preserve positional API
|
|
762
776
|
) -> Path:
|
|
763
777
|
""":param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`.
|
|
764
778
|
:param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`.
|
|
@@ -776,13 +790,13 @@ def site_state_path(
|
|
|
776
790
|
).site_state_path
|
|
777
791
|
|
|
778
792
|
|
|
779
|
-
def user_log_path( # ruff:ignore[too-many-arguments, too-many-positional-arguments]
|
|
793
|
+
def user_log_path( # ruff:ignore[too-many-arguments, too-many-positional-arguments] # preserve released API
|
|
780
794
|
appname: str | None = None,
|
|
781
795
|
appauthor: str | Literal[False] | None = None,
|
|
782
796
|
version: str | None = None,
|
|
783
|
-
opinion: bool = True, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
|
|
784
|
-
ensure_exists: bool = False, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
|
|
785
|
-
use_site_for_root: bool = False, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
|
|
797
|
+
opinion: bool = True, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument] # preserve positional API
|
|
798
|
+
ensure_exists: bool = False, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument] # preserve positional API
|
|
799
|
+
use_site_for_root: bool = False, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument] # preserve positional API
|
|
786
800
|
*,
|
|
787
801
|
roaming: bool = False,
|
|
788
802
|
) -> Path:
|
|
@@ -812,8 +826,8 @@ def site_log_path(
|
|
|
812
826
|
appname: str | None = None,
|
|
813
827
|
appauthor: str | Literal[False] | None = None,
|
|
814
828
|
version: str | None = None,
|
|
815
|
-
opinion: bool = True, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
|
|
816
|
-
ensure_exists: bool = False, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
|
|
829
|
+
opinion: bool = True, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument] # preserve positional API
|
|
830
|
+
ensure_exists: bool = False, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument] # preserve positional API
|
|
817
831
|
) -> Path:
|
|
818
832
|
""":param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`.
|
|
819
833
|
:param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`.
|
|
@@ -833,93 +847,106 @@ def site_log_path(
|
|
|
833
847
|
).site_log_path
|
|
834
848
|
|
|
835
849
|
|
|
836
|
-
def user_documents_path(*, ensure_exists: bool = False) -> Path:
|
|
850
|
+
def user_documents_path(*, ensure_exists: bool = False, use_site_for_root: bool = False) -> Path:
|
|
837
851
|
""":param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`.
|
|
852
|
+
:param use_site_for_root: See `use_site_for_root <platformdirs.api.PlatformDirsABC.use_site_for_root>`.
|
|
838
853
|
|
|
839
854
|
:returns: documents path tied to the user
|
|
840
855
|
|
|
841
856
|
"""
|
|
842
|
-
return PlatformDirs(ensure_exists=ensure_exists).user_documents_path
|
|
857
|
+
return PlatformDirs(ensure_exists=ensure_exists, use_site_for_root=use_site_for_root).user_documents_path
|
|
843
858
|
|
|
844
859
|
|
|
845
|
-
def user_downloads_path(*, ensure_exists: bool = False) -> Path:
|
|
860
|
+
def user_downloads_path(*, ensure_exists: bool = False, use_site_for_root: bool = False) -> Path:
|
|
846
861
|
""":param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`.
|
|
862
|
+
:param use_site_for_root: See `use_site_for_root <platformdirs.api.PlatformDirsABC.use_site_for_root>`.
|
|
847
863
|
|
|
848
864
|
:returns: downloads path tied to the user
|
|
849
865
|
|
|
850
866
|
"""
|
|
851
|
-
return PlatformDirs(ensure_exists=ensure_exists).user_downloads_path
|
|
867
|
+
return PlatformDirs(ensure_exists=ensure_exists, use_site_for_root=use_site_for_root).user_downloads_path
|
|
852
868
|
|
|
853
869
|
|
|
854
|
-
def user_pictures_path(*, ensure_exists: bool = False) -> Path:
|
|
870
|
+
def user_pictures_path(*, ensure_exists: bool = False, use_site_for_root: bool = False) -> Path:
|
|
855
871
|
""":param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`.
|
|
872
|
+
:param use_site_for_root: See `use_site_for_root <platformdirs.api.PlatformDirsABC.use_site_for_root>`.
|
|
856
873
|
|
|
857
874
|
:returns: pictures path tied to the user
|
|
858
875
|
|
|
859
876
|
"""
|
|
860
|
-
return PlatformDirs(ensure_exists=ensure_exists).user_pictures_path
|
|
877
|
+
return PlatformDirs(ensure_exists=ensure_exists, use_site_for_root=use_site_for_root).user_pictures_path
|
|
861
878
|
|
|
862
879
|
|
|
863
|
-
def user_videos_path(*, ensure_exists: bool = False) -> Path:
|
|
880
|
+
def user_videos_path(*, ensure_exists: bool = False, use_site_for_root: bool = False) -> Path:
|
|
864
881
|
""":param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`.
|
|
882
|
+
:param use_site_for_root: See `use_site_for_root <platformdirs.api.PlatformDirsABC.use_site_for_root>`.
|
|
865
883
|
|
|
866
884
|
:returns: videos path tied to the user
|
|
867
885
|
|
|
868
886
|
"""
|
|
869
|
-
return PlatformDirs(ensure_exists=ensure_exists).user_videos_path
|
|
887
|
+
return PlatformDirs(ensure_exists=ensure_exists, use_site_for_root=use_site_for_root).user_videos_path
|
|
870
888
|
|
|
871
889
|
|
|
872
|
-
def user_music_path(*, ensure_exists: bool = False) -> Path:
|
|
890
|
+
def user_music_path(*, ensure_exists: bool = False, use_site_for_root: bool = False) -> Path:
|
|
873
891
|
""":param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`.
|
|
892
|
+
:param use_site_for_root: See `use_site_for_root <platformdirs.api.PlatformDirsABC.use_site_for_root>`.
|
|
874
893
|
|
|
875
894
|
:returns: music path tied to the user
|
|
876
895
|
|
|
877
896
|
"""
|
|
878
|
-
return PlatformDirs(ensure_exists=ensure_exists).user_music_path
|
|
897
|
+
return PlatformDirs(ensure_exists=ensure_exists, use_site_for_root=use_site_for_root).user_music_path
|
|
879
898
|
|
|
880
899
|
|
|
881
|
-
def user_desktop_path(*, ensure_exists: bool = False) -> Path:
|
|
900
|
+
def user_desktop_path(*, ensure_exists: bool = False, use_site_for_root: bool = False) -> Path:
|
|
882
901
|
""":param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`.
|
|
902
|
+
:param use_site_for_root: See `use_site_for_root <platformdirs.api.PlatformDirsABC.use_site_for_root>`.
|
|
883
903
|
|
|
884
904
|
:returns: desktop path tied to the user
|
|
885
905
|
|
|
886
906
|
"""
|
|
887
|
-
return PlatformDirs(ensure_exists=ensure_exists).user_desktop_path
|
|
907
|
+
return PlatformDirs(ensure_exists=ensure_exists, use_site_for_root=use_site_for_root).user_desktop_path
|
|
888
908
|
|
|
889
909
|
|
|
890
|
-
def user_projects_path(*, ensure_exists: bool = False) -> Path:
|
|
910
|
+
def user_projects_path(*, ensure_exists: bool = False, use_site_for_root: bool = False) -> Path:
|
|
891
911
|
""":param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`.
|
|
912
|
+
:param use_site_for_root: See `use_site_for_root <platformdirs.api.PlatformDirsABC.use_site_for_root>`.
|
|
892
913
|
|
|
893
914
|
:returns: projects path tied to the user
|
|
894
915
|
|
|
895
916
|
"""
|
|
896
|
-
return PlatformDirs(ensure_exists=ensure_exists).user_projects_path
|
|
917
|
+
return PlatformDirs(ensure_exists=ensure_exists, use_site_for_root=use_site_for_root).user_projects_path
|
|
897
918
|
|
|
898
919
|
|
|
899
|
-
def user_publicshare_path(*, ensure_exists: bool = False) -> Path:
|
|
920
|
+
def user_publicshare_path(*, ensure_exists: bool = False, use_site_for_root: bool = False) -> Path:
|
|
900
921
|
""":param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`.
|
|
922
|
+
:param use_site_for_root: See `use_site_for_root <platformdirs.api.PlatformDirsABC.use_site_for_root>`.
|
|
901
923
|
|
|
902
924
|
:returns: public share path tied to the user
|
|
903
925
|
|
|
904
926
|
"""
|
|
905
|
-
return PlatformDirs(ensure_exists=ensure_exists).user_publicshare_path
|
|
927
|
+
return PlatformDirs(ensure_exists=ensure_exists, use_site_for_root=use_site_for_root).user_publicshare_path
|
|
906
928
|
|
|
907
929
|
|
|
908
|
-
def user_templates_path(*, ensure_exists: bool = False) -> Path:
|
|
930
|
+
def user_templates_path(*, ensure_exists: bool = False, use_site_for_root: bool = False) -> Path:
|
|
909
931
|
""":param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`.
|
|
932
|
+
:param use_site_for_root: See `use_site_for_root <platformdirs.api.PlatformDirsABC.use_site_for_root>`.
|
|
910
933
|
|
|
911
934
|
:returns: templates path tied to the user
|
|
912
935
|
|
|
913
936
|
"""
|
|
914
|
-
return PlatformDirs(ensure_exists=ensure_exists).user_templates_path
|
|
937
|
+
return PlatformDirs(ensure_exists=ensure_exists, use_site_for_root=use_site_for_root).user_templates_path
|
|
938
|
+
|
|
915
939
|
|
|
940
|
+
def user_fonts_path(*, use_site_for_root: bool = False) -> Path:
|
|
941
|
+
""":param use_site_for_root: See `use_site_for_root <platformdirs.api.PlatformDirsABC.use_site_for_root>`.
|
|
942
|
+
|
|
943
|
+
:returns: fonts path tied to the user
|
|
916
944
|
|
|
917
|
-
|
|
918
|
-
|
|
919
|
-
return PlatformDirs().user_fonts_path
|
|
945
|
+
"""
|
|
946
|
+
return PlatformDirs(use_site_for_root=use_site_for_root).user_fonts_path
|
|
920
947
|
|
|
921
948
|
|
|
922
|
-
def user_preference_path( # ruff:ignore[too-many-arguments]
|
|
949
|
+
def user_preference_path( # ruff:ignore[too-many-arguments] # preserve released API
|
|
923
950
|
appname: str | None = None,
|
|
924
951
|
appauthor: str | Literal[False] | None = None,
|
|
925
952
|
version: str | None = None,
|
|
@@ -989,8 +1016,8 @@ def user_applications_path(
|
|
|
989
1016
|
|
|
990
1017
|
|
|
991
1018
|
def site_applications_path(
|
|
992
|
-
multipath: bool = False, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
|
|
993
|
-
ensure_exists: bool = False, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
|
|
1019
|
+
multipath: bool = False, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument] # preserve positional API
|
|
1020
|
+
ensure_exists: bool = False, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument] # preserve positional API
|
|
994
1021
|
*,
|
|
995
1022
|
appname: str | None = None,
|
|
996
1023
|
appauthor: str | Literal[False] | None = None,
|
|
@@ -1014,13 +1041,13 @@ def site_applications_path(
|
|
|
1014
1041
|
).site_applications_path
|
|
1015
1042
|
|
|
1016
1043
|
|
|
1017
|
-
def user_runtime_path( # ruff:ignore[too-many-arguments, too-many-positional-arguments]
|
|
1044
|
+
def user_runtime_path( # ruff:ignore[too-many-arguments, too-many-positional-arguments] # preserve released API
|
|
1018
1045
|
appname: str | None = None,
|
|
1019
1046
|
appauthor: str | Literal[False] | None = None,
|
|
1020
1047
|
version: str | None = None,
|
|
1021
|
-
opinion: bool = True, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
|
|
1022
|
-
ensure_exists: bool = False, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
|
|
1023
|
-
use_site_for_root: bool = False, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
|
|
1048
|
+
opinion: bool = True, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument] # preserve positional API
|
|
1049
|
+
ensure_exists: bool = False, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument] # preserve positional API
|
|
1050
|
+
use_site_for_root: bool = False, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument] # preserve positional API
|
|
1024
1051
|
) -> Path:
|
|
1025
1052
|
""":param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`.
|
|
1026
1053
|
:param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`.
|
|
@@ -1046,8 +1073,8 @@ def site_runtime_path(
|
|
|
1046
1073
|
appname: str | None = None,
|
|
1047
1074
|
appauthor: str | Literal[False] | None = None,
|
|
1048
1075
|
version: str | None = None,
|
|
1049
|
-
opinion: bool = True, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
|
|
1050
|
-
ensure_exists: bool = False, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
|
|
1076
|
+
opinion: bool = True, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument] # preserve positional API
|
|
1077
|
+
ensure_exists: bool = False, # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument] # preserve positional API
|
|
1051
1078
|
) -> Path:
|
|
1052
1079
|
""":param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`.
|
|
1053
1080
|
:param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`.
|