xdgpspconf - XDG Platform Suited Project configuration
Project description
XDG Platform Suited Project CONFiguration
Gist
Source Code Repository
Badges
Description
- Handle platform suited xdg-base to
- Read configuration from standard locations.
- supported formats:
yaml
toml
conf (ini)
Write configuration to most general, writable xdg-location
- Locate standard directories:
xdg_cache
xdg_config
xdg_data
xdg_state
XDG Specification
View xdg specifications here.
What does it do
Reads standard Windows/POSIX locations, current folder and optionally all ancestors and custom locations for xdg-configuration
- Platform-specific locations:
Windows Locations: Environment Variable %LOCALAPPDATA%\<PROJECT> or %USERPROFILE%\AppData\Local\<PROJECT>
POSIX [Linux/MacOS] Locations: Environment Variable $XDG_CONFIG_HOME/<PROJECT> or $HOME/.config/<PROJECT>
Environment-declared variable: %<PROJECT>RC% for Windows or $<PROJECT> for POSIX
Custom configuration path: supplied in function
Relative path: $PWD/.<PROJECT>rc
Ancestors: Any of the parents, till project root or mountpoint, that contains __init__.py, where,
project root is the directory that contains setup.cfg or setup.py
mountpoint is checked using pathlib.Path.drive on windows or pathlib.Path.is_mount() on POSIX
Lists possible xdg-locations (existing and prospective)
XDG_CACHE_HOME is supported for cache locations
XDG_CONFIG_HOME, XDG_CONFIG_DIRS are supported for configuration locations
XDG_DATA_HOME, XDG_DATA_DIRS are supported for data locations
XDG_STATE_HOME, XDG_STATE_DIRS are supported for state locations
TODO
- Implementation for following variables:
XDG_RUNTIME_DIR
Other XDG specifications.
Arbitrarily defined XDG_.* environment variables
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for xdgpspconf-0.1.2-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 957ccc31dd510f32aab6df23fc22db6fceb10c29902c0b2adb600e1fc1e82b31 |
|
MD5 | a57e425eac1520fb68495001756ef4ab |
|
BLAKE2b-256 | c07a3f5439e390eab1f39c2c49fb8710f07aa8e23123a0a655cc9ab8b6c0718f |