github.com/adrg/xdg

Changelog

• Updated xdg.SearchRuntimeFile to also look in the operating system's temporary directory for runtime files.
  This covers unlikely cases in which runtime files cannot be written relative to the base runtime directory either because it does not exist or it is not accessible, so xdg.RuntimeFile suggests the operating system's temporary directory as a suitable fallback location.

Internal

• Improved package testing.

Changelog

• Updated logic of xdg.RuntimeFile: due to the special nature of the runtime directory, the function no longer attempts to create it if it does not exist. If that's the case, the function uses the operating system's temporary directory as a fallback. The function still creates subdirectories relative to the base runtime directory or its fallback.

  Justification: the creation of the runtime directory is not in the scope of this package as it has special requirements defined by the XDG Base Directory Specification. Relevant excerpt:

  The lifetime of the directory MUST be bound to the user being logged in. It MUST be created when the user first logs in and if the user fully logs out the directory MUST be removed. If the user logs in more than once they should get pointed to the same directory, and it is mandatory that the directory continues to exist from their first login to their last logout on the system, and not removed in between. Files in the directory MUST not survive reboot or a full logout/login cycle.

  Also, on Linux, the parent directories of the default user runtime directory are owned by the root user so they cannot be created by a regular user. pam_systemd is usually responsible for creating the runtime directory (/run/user/$UID).

Changelog

• Added support for the non-standard XDG_BIN_HOME base directory.
  See XDG base directories README section for more details.
• Added more config and data search locations on macOS.
  • Added ~/.config at the end of the list of default locations for XDG_CONFIG_DIRS.
  • Added ~/.local/share at the end of the list of default locations for XDG_DATA_DIRS.
• Added more application search locations on Windows:
  • %ProgramFiles%
  • %ProgramFiles%\Common Files
  • %LOCALAPPDATA%\Programs
  • %LOCALAPPDATA%\Programs\Common

Internal

• Updated golang.org/x/sys dependency to the latest version.
• Improved package testing.

Changelog

• user-dirs.dirs config file is now parsed on Unix-like operating systems (except for macOS and Plan 9).
  See XDG user directories README section for more details.
• Updated golang.org/x/sys dependency to the latest version.

Internal

• Moved all path related functionality in internal pathutil package.
• Added internal userdirs package:
  • Moved xdg.UserDirectories to userdirs.Directories.
  • Added parsing functions for user-dirs.dirs config file.
• Improved package testing.