Repository files navigation

Get cross-platform XDG Base Directories or their equivalents. Works with Linux, Windows (win32), or MacOS (darwin).

Please consider following this project's author,Jon Schlinkert, and consider starring the project to show your ❤️ and support.

Install withnpm:

$ npm install --save @folder/xdg

Add the following line of code to yourNode.js application:

constxdg=require('@folder/xdg');

The main export is a function that may be called with an options object:

constdirs=xdg(/* options */);console.log(dirs);/* This output is on MacOS, see examples for Linux and Windows below */console.log(dirs.config);// => '/Users/jonschlinkert/Library/Preferences'console.log(dirs.cache);// => '/Users/jonschlinkert/Library/Caches'console.log(dirs.data);// => '/Users/jonschlinkert/Library/Application Support'

Seeexample output by platform.

console.log(xdg.darwin());console.log(xdg.linux());console.log(xdg.win32());// or, if you want "expanded" paths (see the "expanded paths" example)console.log(xdg({expanded:true,platform:'darwin'}));console.log(xdg({expanded:true,platform:'linux'}));console.log(xdg({expanded:true,platform:'win32'}));

console.log(xdg());

{cache:'/Users/jonschlinkert/Library/Caches/xdg',config:'/Users/jonschlinkert/Library/Preferences/xdg',configdirs:['/Users/jonschlinkert/Library/Preferences/xdg','/etc/xdg'],data:'/Users/jonschlinkert/Library/Application Support/xdg',datadirs:['/Users/jonschlinkert/Library/Application Support/xdg','/usr/local/share/','/usr/share/'],runtime:'/var/folders/vd/53h736bj0_sg9gk04c89k0pr0000gq/T/xdg'}

{cache:'/Users/jonschlinkert/.cache/xdg',config:'/Users/jonschlinkert/.config/xdg',configdirs:['/Users/jonschlinkert/.config/xdg','/etc/xdg'],data:'/Users/jonschlinkert/.local/share/xdg',datadirs:['/Users/jonschlinkert/.local/share/xdg','/usr/local/share/','/usr/share/'],runtime:'/var/folders/vd/53h736bj0_sg9gk04c89k0pr0000gq/T/xdg'}

{cache:'/Users/jonschlinkert/AppData/Local/xdg/Cache',config:'/Users/jonschlinkert/AppData/Roaming/xdg/Config',configdirs:['/Users/jonschlinkert/AppData/Roaming/xdg/Config'],data:'/Users/jonschlinkert/AppData/Local/xdg/Data',datadirs:['/Users/jonschlinkert/AppData/Local/xdg/Data'],runtime:'/var/folders/vd/53h736bj0_sg9gk04c89k0pr0000gq/T/xdg'}

console.log(xdg({expanded:true,subdir:'FooBar'}));

{cwd:'/Users/jonschlinkert/dev/@folder/xdg',home:'/Users/jonschlinkert',temp:'/var/folders/vd/53h736bj0_sg9gk04c89k0pr0000gq/T',cache:{home:'/Users/jonschlinkert/Library/Caches/FooBar',logs:'/Users/jonschlinkert/Library/Caches/FooBar/Logs'},config:{home:'/Users/jonschlinkert/Library/Preferences/FooBar',dirs:['/Users/jonschlinkert/Library/Preferences/FooBar','/etc/FooBar']},data:{home:'/Users/jonschlinkert/Library/Application Support/FooBar',dirs:['/Users/jonschlinkert/Library/Application Support/FooBar','/usr/local/share/','/usr/share/']},runtime:{home:'/var/folders/vd/53h736bj0_sg9gk04c89k0pr0000gq/T/FooBar'}}

{cwd:'/Users/jonschlinkert/dev/@folder/xdg',home:'/Users/jonschlinkert',temp:'/var/folders/vd/53h736bj0_sg9gk04c89k0pr0000gq/T',cache:{home:'/Users/jonschlinkert/.cache/FooBar',logs:'/Users/jonschlinkert/.cache/FooBar/Logs'},config:{home:'/Users/jonschlinkert/.config/FooBar',dirs:['/Users/jonschlinkert/.config/FooBar','/etc/FooBar']},data:{home:'/Users/jonschlinkert/.local/share/FooBar',dirs:['/Users/jonschlinkert/.local/share/FooBar','/usr/local/share/','/usr/share/']},runtime:{home:'/var/folders/vd/53h736bj0_sg9gk04c89k0pr0000gq/T/FooBar'}}

{cwd:'/Users/jonschlinkert/dev/@folder/xdg',home:'/Users/jonschlinkert',temp:'/var/folders/vd/53h736bj0_sg9gk04c89k0pr0000gq/T',cache:{home:'/Users/jonschlinkert/AppData/Local/FooBar/Cache',logs:'/Users/jonschlinkert/AppData/Local/FooBar/Cache/Logs'},config:{home:'/Users/jonschlinkert/AppData/Roaming/FooBar/Config',dirs:['/Users/jonschlinkert/AppData/Roaming/FooBar/Config']},data:{home:'/Users/jonschlinkert/AppData/Local/FooBar/Data',dirs:['/Users/jonschlinkert/AppData/Local/FooBar/Data']},runtime:{home:'/var/folders/vd/53h736bj0_sg9gk04c89k0pr0000gq/T/FooBar'}}

Aside from the main export,xdg(), several platform-specific methods are exposed to simplify getting paths for specific platforms. Note that you can accomplish the same thing by passing the platform on the options to the main export, e.g.{ platform: 'linux' }.

The main export, and each method, returns an object with the following properties (see theXDG Base Directories docs below for more details on how each property is set):

• cache
• config
• configdirs
• data
• datadirs
• runtime

Get the XDG Base Directory paths for Linux, or equivalent paths for Windows or MaxOS.

Params

• options{Object}
• returns{Object}: Returns an object of paths for the current platform.

Get XDG equivalent paths for MacOS. Used by the main export whenprocess.platform isdarwin. Aliased asxdg.macos().

Params

• options{Object}
• returns{Object}: Returns an object of paths.

Example

constdirs=xdg.darwin();// orconstdirs=xdg.macos();

Get XDG equivalent paths for Linux. Used by the main export whenprocess.platform islinux.

• returns{Object}: Returns an object of paths.
• returns{Object}: Returns an object of paths.

Example

constdirs=xdg.linux();

Get XDG equivalent paths for MacOS. Used by the main export whenprocess.platform iswin32. Aliased asxdg.windows().

Params

• options{Object}
• returns{Object}: Returns an object of paths.

Example

constdirs=xdg.win32();// orconstdirs=xdg.windows();

This documentation is from the Arch LinuxXDG Base Directory docs.

• XDG_CONFIG_HOME

  • Where user-specific configurations should be written (analogous to/etc).
  • Should default to$HOME/.config.

• XDG_CACHE_HOME

  • Where user-specific non-essential (cached) data should be written (analogous to/var/cache).
  • Should default to$HOME/.cache.

• XDG_DATA_HOME

  • Where user-specific data files should be written (analogous to/usr/share).
  • Should default to$HOME/.local/share.

• XDG_RUNTIME_DIR

  • Used for non-essential, user-specific data files such as sockets, named pipes, etc.
  • Not required to have a default value; warnings should be issued if not set or equivalents provided.
  • Must be owned by the user with an access mode of0700.
  • Filesystem fully featured by standards of OS.
  • Must be on the local filesystem.
  • May be subject to periodic cleanup.
  • Modified every 6 hours or set sticky bit if persistence is desired.
  • Can only exist for the duration of the user's login.
  • Should not store large files as it may be mounted as a tmpfs.

• XDG_DATA_DIRS

  • List of directories seperated by: (analogous toPATH).
  • Should default to/usr/local/share:/usr/share.

• XDG_CONFIG_DIRS

  • List of directories seperated by: (analogous toPATH).
  • Should default to/etc/xdg.

$ npm install&& npmtest

$ npm install -g verbose/verb#dev verb-generate-readme&& verb

You might also be interested in these projects:

• expand-tilde: Bash-like tilde expansion for node.js. Expands a leading tilde in a file path to the…more |homepage
• global-modules: The directory used by npm for globally installed npm modules. |homepage
• global-paths: Returns an array of unique "global" directories based on the user's platform and environment. The…more | [homepage](https://github.com/jonschlinkert/global-paths "Returns an array of unique "global" directories based on the user's platform and environment. The resulting paths can be used for doing lookups for generators or other globally installed npm packages. Node.js / JavaScript.")
• normalize-path: Normalize slashes in a file path to be posix/unix-like forward slashes. Also condenses repeat slashes…more |homepage

Jon Schlinkert

• GitHub Profile
• Twitter Profile
• LinkedIn Profile

Copyright © 2023,Jon Schlinkert.Released under the MIT License.

This file was generated byverb-generate-readme, v0.8.0, on July 24, 2023.