Variables defined by the XDG Base Directory Specification
xdg is a tiny Python module which provides the variables defined by the XDG
Base Directory Specification, to save you from duplicating the same
snippet of logic in every Python utility you write that deals with user cache,
configuration, or data files. It has no external dependencies.
pip install xdg
In Python projects using Poetry or Pipenv for dependency management, add
xdg as a dependency with
poetry add xdg or
pipenv install xdg.
xdg is only a single file you may prefer to just copy
src/xdg/__init__.py from the source distribution into your project.
from xdg import (XDG_CACHE_HOME, XDG_CONFIG_DIRS, XDG_CONFIG_HOME, XDG_DATA_DIRS, XDG_DATA_HOME, XDG_RUNTIME_DIR)
objects containing the value of the environment variable of the same
name, or the default defined in the specification if the environment variable is
unset or empty.
XDG_DATA_DIRS are lists of
containing the value of the environment variable of the same name split on
colons, or the default defined in the specification if the environment variable
is unset or empty.
XDG_RUNTIME_DIR is a
pathlib.Path object containing the value of the
environment variable of the same name, or
None if the environment variable is
Copyright © 2016-2019 Scott Stevenson.
xdg is distributed under the terms of the ISC licence.
Release history Release notifications
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
|Filename, size||File type||Python version||Upload date||Hashes|
|Filename, size xdg-4.0.1-py3-none-any.whl (4.2 kB)||File type Wheel||Python version py3||Upload date||Hashes View hashes|
|Filename, size xdg-4.0.1.tar.gz (3.8 kB)||File type Source||Python version None||Upload date||Hashes View hashes|