o fi@sdZddlZddlmZddlmZmZgdZdededefd d Z dedeedeefd d Z defd dZ deefddZ defddZ deefddZdefddZdeefddZdefddZe Ze Ze ZeZeZeZdS)aXDG Base Directory Specification variables. xdg_cache_home(), xdg_config_home(), xdg_data_home(), and xdg_state_home() return pathlib.Path objects containing the value of the environment variable named XDG_CACHE_HOME, XDG_CONFIG_HOME, XDG_DATA_HOME, and XDG_STATE_HOME respectively, or the default defined in the specification if the environment variable is unset, empty, or contains a relative path rather than absolute path. xdg_config_dirs() and xdg_data_dirs() return a list of pathlib.Path objects containing the value, split on colons, of the environment variable named XDG_CONFIG_DIRS and XDG_DATA_DIRS respectively, or the default defined in the specification if the environment variable is unset or empty. Relative paths are ignored, as per the specification. xdg_runtime_dir() returns a pathlib.Path object containing the value of the XDG_RUNTIME_DIR environment variable, or None if the environment variable is not set, or contains a relative path rather than absolute path. NPath)ListOptional) xdg_cache_homexdg_config_dirsxdg_config_home xdg_data_dirs xdg_data_homexdg_runtime_dirxdg_state_homeXDG_CACHE_HOMEXDG_CONFIG_DIRSXDG_CONFIG_HOME XDG_DATA_DIRS XDG_DATA_HOMEXDG_RUNTIME_DIRvariabledefaultreturncCs(tj|}|rtj|rt|S|S)aRead an environment variable as a path. The environment variable with the specified name is read, and its value returned as a path. If the environment variable is not set, is set to the empty string, or is set to a relative rather than absolute path, the default value is returned. Parameters ---------- variable : str Name of the environment variable. default : Path Default value. Returns ------- Path Value from environment or default. )osenvirongetpathisabsr)rrvaluer@/home/ubuntu/.local/lib/python3.10/site-packages/xdg/__init__.py_path_from_env=s rcCs0tj|}|rdd|dD}|r|S|S)a<Read an environment variable as a list of paths. The environment variable with the specified name is read, and its value split on colons and returned as a list of paths. If the environment variable is not set, or set to the empty string, the default value is returned. Relative paths are ignored, as per the specification. Parameters ---------- variable : str Name of the environment variable. default : List[Path] Default value. Returns ------- List[Path] Value from environment or default. cSs g|] }tj|rt|qSr)rrrr.0rrrr rs  z#_paths_from_env..:)rrrsplit)rrrpathsrrr_paths_from_envYs r%cCtdtdS)z.Return a Path corresponding to XDG_CACHE_HOME.r z.cacherrhomerrrrrzrcCstdtdgS)z8Return a list of Paths corresponding to XDG_CONFIG_DIRS.rz/etc/xdg)r%rrrrrrsrcCr&)z/Return a Path corresponding to XDG_CONFIG_HOME.rz.configr'rrrrrr)rcCstdddddDS)z6Return a list of Paths corresponding to XDG_DATA_DIRS.rcSsg|]}t|qSrrrrrrr!sz!xdg_data_dirs..z/usr/local/share/:/usr/share/r")r%r#rrrrr sr cCtdtddS)z-Return a Path corresponding to XDG_DATA_HOME.r.localsharer'rrrrr r cCs&td}|rtj|rt|SdS)zReturn a Path corresponding to XDG_RUNTIME_DIR. If the XDG_RUNTIME_DIR environment variable is not set, None will be returned as per the specification. rN)rgetenvrrr)rrrrr s r cCr*)z.Return a Path corresponding to XDG_STATE_HOME.XDG_STATE_HOMEr+stater'rrrrr r-r )__doc__rpathlibrtypingrr__all__strrr%rrrr r r r r rrrrrrrrrs( !