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.3-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | b0490b15a822a385771393ca12e9d3406c0b3cf4f55a91a971ed9facf347cb03 |
|
MD5 | 9e6e5ab4949eb9c34a20680268342076 |
|
BLAKE2b-256 | 283000fdec5740d0e6e82a05892d9caf7a062cdae4b05c9f440596b0e92da4e9 |