Convenient access to XDG Base Directory Specification variables
xdgspec
is a simple Python package to provide convenient access to the
variables defined in the XDG Base Directory
Specification.
xdgspec
do?With xdgspec
you can:
from xdgspec import XDGDirectory
print(XDGDirectory("XDG_CONFIG_HOME").path)
print(XDGDirectory("XDG_CACHE_HOME").path)
print(XDGDirectory("XDG_DATA_HOME").path)
# ...
from xdgspec import XDGDirectory
with XDGDirectory("XDG_CONFIG_HOME") as path:
print("{} is now definitely existing".format(path))
from xdgspec import XDGPackageDirectory
with XDGPackageDirectory("XDG_CONFIG_HOME","mypackage") as path:
# path = ~/.config/mypackage
print("{} is now definitely existing".format(path))
from xdgspec import XDGDirectories
# variable content
print(XDGDirectories("XDG_CONFIG_DIRS").paths)
# generator of actually existing, unique directories
print(list(XDGDirectories("XDG_CONFIG_DIRS").existing_paths))
The xdgspec
package is best installed via pip
. Run from anywhere:
python3 -m pip install --user xdgspec
This downloads and installs the package from the Python Package Index.
You may also install xdgspec
from the repository root:
python3 -m pip install --user .
Documentation of the xdgspec
package can be found here on
GitLab.