osappdirs

nimony/lib/std/private/osappdirs.nim

• proc getHomeDir(): string

  Returns the home directory of the current user.

  This proc is wrapped by the expandTilde proc_ for the convenience of processing paths coming from user configuration files.

  See also:

  • getDataDir proc_
  • getConfigDir proc_
  • getTempDir proc_
  • expandTilde proc_
  • getCurrentDir proc_
  • setCurrentDir proc_
• proc getDataDir(): string

  Returns the data directory of the current user for applications.

  On non-Windows OSs, this proc conforms to the XDG Base Directory spec. Thus, this proc returns the value of the XDG_DATA_HOME environment variable if it is set, otherwise it returns the default configuration directory ("~/.local/share" or "~/Library/Application Support" on macOS).

  See also:

  • getHomeDir proc_
  • getConfigDir proc_
  • getTempDir proc_
  • expandTilde proc_
  • getCurrentDir proc_
  • setCurrentDir proc_
• proc getConfigDir(): string

  Returns the config directory of the current user for applications.

  On non-Windows OSs, this proc conforms to the XDG Base Directory spec. Thus, this proc returns the value of the XDG_CONFIG_HOME environment variable if it is set, otherwise it returns the default configuration directory ("~/.config/").

  An OS-dependent trailing slash is always present at the end of the returned string: \\ on Windows and / on all other OSs.

  See also:

  • getHomeDir proc_
  • getDataDir proc_
  • getTempDir proc_
  • expandTilde proc_
  • getCurrentDir proc_
  • setCurrentDir proc_
• proc getCacheDir(): string

  Returns the cache directory of the current user for applications.

  This makes use of the following environment variables:

  • On Windows: getEnv("LOCALAPPDATA")

  • On macOS: getEnv("XDG_CACHE_HOME", getEnv("HOME") / "Library/Caches")

  • On other platforms: getEnv("XDG_CACHE_HOME", getEnv("HOME") / ".cache")

  See also:

  • getHomeDir proc_
  • getTempDir proc_
  • getConfigDir proc_
  • getDataDir proc_
• proc getCacheDir(app: string): string

  Returns the cache directory for an application app.

  • On Windows, this uses: getCacheDir() / app / "cache"
  • On other platforms, this uses: getCacheDir() / app
• proc getTempDir(): string

  Returns the temporary directory of the current user for applications to save temporary files in.

  On Windows, it calls GetTempPath. On Posix based platforms, it will check TMPDIR, TEMP, TMP and TEMPDIR environment variables in order. On all platforms, /tmp will be returned if the procs fails.

  You can override this implementation by adding -d:tempDir=mytempname to your compiler invocation.

  Note: This proc does not check whether the returned path exists.

  See also:

  • getHomeDir proc_
  • getConfigDir proc_
  • expandTilde proc_
  • getCurrentDir proc_
  • setCurrentDir proc_