env-paths

What is env-paths?

The env-paths npm package is used to generate paths for storing things like data, config, cache, etc., in a way that complies with the operating system's conventions. It is useful for developers who want to ensure their applications follow the best practices for file storage locations on different platforms.

What are env-paths's main functionalities?

Config Paths

Generates paths for storing configuration files. The 'config' property will provide a path that is suitable for the user's operating system.

{"config": require('env-paths')('MyApp').config}

Data Paths

Generates paths for storing data files. The 'data' property will give a path that is appropriate for the user's operating system.

{"data": require('env-paths')('MyApp').data}

Cache Paths

Generates paths for storing cache files. The 'cache' property will provide a path that is suitable for the user's operating system.

{"cache": require('env-paths')('MyApp').cache}

Log Paths

Generates paths for storing log files. The 'log' property will give a path that is appropriate for the user's operating system.

{"log": require('env-paths')('MyApp').log}

Temporary Paths

Generates paths for storing temporary files. The 'temp' property will provide a path that is suitable for the user's operating system.

{"temp": require('env-paths')('MyApp').temp}

Other packages similar to env-paths

appdata-path

Similar to env-paths, appdata-path is used to find the path to the user's app data directory. It is more focused on this single use case and does not provide the variety of paths that env-paths does.

osenv

osenv is another package that provides a way to get environment settings like paths for temporary files and user's home directory. It is similar to env-paths but has a broader scope, including network settings and shell paths.

userhome

userhome is a simple package to get the path to the user's home directory. It is much more limited in scope compared to env-paths, which provides paths for various types of application files.

README

env-paths

Get paths for storing things like data, config, cache, etc

Install

$ npm install --save env-paths

Usage

const envPaths = require('env-paths');
const paths = envPaths('MyApp');

paths.data;
//=> '/home/sindresorhus/.local/share/MyApp'

paths.config
//=> '/home/sindresorhus/.config/MyApp'

API

paths = envPaths(name)

name

Type: string

Name of your project. Used to generate the paths.

paths.data

Directory for data files.

paths.config

Directory for config files.

paths.cache

Directory for non-essential data files.

paths.log

Directory for log files.

paths.temp

Directory for temporary files.

License

MIT © Sindre Sorhus