sindresorhus/untildify

Convert a tilde path to an absolute path: ~/dev => /Users/sindresorhus/dev

untildify

Convert a tilde path to an absolute path: ~/dev → /Users/sindresorhus/dev

Install

npm install untildify

Usage

import untildify from 'untildify';

untildify('~/dev');
//=> '/Users/sindresorhus/dev'

Related

See tildify for the inverse.

untildify's Issues

Escape home dir

If the path contains $1 anywhere, the replacement is going to break.

https://developer.mozilla.org/en/docs/Web/JavaScript/Reference/Global_Objects/String/replace#Specifying_a_string_as_a_parameter

Use of const in strict mode

const os = require('os');

Cannot import without `esModuleInterop` flag set to true

To get this package to work with Typescript, the following must be set to true in the tsconfig.json

{
  "compilerOptions": {
    "esModuleInterop": true
  }
}

Without this, in the latest Typescript (5.1.0), it fails compilation with the message:

error TS2497: This module can only be referenced with ECMAScript imports/exports by turning on the 'esModuleInterop' flag and referencing its default export.

For libraries like https://github.com/aws/jsii they require that esModuleInterop be disabled so this library is unusable in that context.

For example, the following does not work:

import * as untildify from "untildify";

Neither does:

import untildify from "untildify";

Linux - user home instead of the root home

If you use untildify in a Node process started as a root, it expands to /root/. Is there a way to expand to a user's home instead?

One way I can think of is to use process.env.SUDO_USER

Support for ~+, ~-, ~n

• ~+ should expand to the output of process.cwd()
• ~- and ~n need access to the directory stack. Probably possible through undocumented API.

Docs:
https://www.gnu.org/software/bash/manual/html_node/Tilde-Expansion.html
http://zsh.sourceforge.net/Doc/Release/Expansion.html#Filename-Expansion

Expand ~user syntax

I think this module (and probably the inverse version as well) should supper the ~user syntax whereby ~username/my/path is expanded to /home/username/my/path. It's important to note, though, that the home directory can vary and has to be looked up in the passwd database.

There is a $40.00 open bounty on this issue. Add more on Issuehunt.

• Checkout the Issuehunt explorer to discover more funded issues.
• Need some help from other developers? Add your repositories on Issuehunt to raise funds.

Should '~' be resolved?

Right now, only ~/ gets resolved. In my shell, I can do echo ~ and it expands my home folder correctly.

Would you agree to changing this?