util.home

Expands the ~ home directory in a path

Path strings that use the ~, ~/ or ~\ at the front of the string will be expanded to use the home directory of the user. The home directory is dependent on the architecture. For Linux/OSX the environment variable HOME is used. On the Windows operating system it uses USERPROFILE.

This module uses typescript and has a type definition file supplied with the package. It will also accept a Buffer or string.

This module was inspired by the expand-home-dir package.

Installation

This module uses yarn to manage dependencies and run scripts for development.

To install as an application dependency:

$ yarn add --dev util.home

To build the app and run all tests:

$ yarn run all

Usage

Windows

let expand = require('util.home').expandHomeDirectory;
 
// With USERPROFILE = 'C:\Users\foo'
let dir = expand('~/Documents');
console.log(dir);  // dir = 'C:\Users\foo\Documents'

Linux/OSX

let expand = require('util.home').expandHomeDirectory;
 
// With HOME = '/home/foo`'
let dir = expand('~/documents');
console.log(dir);  // dir = '/home/foo/documents'