xdgpspconf 0.0.dev0

xdgpspconf - XDG Platform Suited Project configuration

XDG Platform Suited Project CONFiguration

Gist

Source Code Repository

Repository

Documentation

Badges

Description

Handle platform suited xdg-base to

• Read configuration from standard locations.

  • supported formats:

    • yaml

    • toml

    • conf (ini)

• Locate standard data directories

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 all possible data-locations (existing and prospective)

Note

• XDG_CONFIG_HOME, XDG_CONFIG_DIRS are supported for configuration locations

• XDG_DATA_HOME, XDG_DATA_DIRS are supported for data locations

Warning

• XDG_STATE_HOME, XDG_CACHE_HOME are NOT currently supported, and should be added in future.