time-to-botec/squiggle/node_modules/@stdlib/fs/resolve-parent-path/README.md

Resolve Parent Path

Resolve a path by walking parent directories.

Usage

var resolveParentPath = require( '@stdlib/fs/resolve-parent-path' );

resolveParentPath( path[, options], clbk )

Asynchronously resolves a path by walking parent directories.

resolveParentPath( 'package.json', onPath );

function onPath( error, path ) {
    if ( error ) {
        throw error;
    }
    console.log( path );
    // => '...'
}

The function accepts the following options:

• dir: base directory from which to begin walking. May be either an absolute path or a path relative to the current working directory.

By default, the function begins walking from the current working directory. To specify an alternative directory, set the dir option.

var opts = {
    'dir': __dirname
};
resolveParentPath( 'package.json', opts, onPath );

function onPath( error, path ) {
    if ( error ) {
        throw error;
    }
    console.log( path );
    // => '...'
}

resolveParentPath.sync( path[, options] )

Synchronously resolves a path by walking parent directories.

var path = resolveParentPath.sync( 'package.json' );
// returns '...'

The function accepts the same options as resolveParentPath().

Notes

• If unable to resolve a path, both functions return null.
• This implementation is not similar in functionality to core path.resolve. The latter performs string manipulation to generate a full path. This implementation walks parent directories to perform a search, thereby touching the file system. Accordingly, this implementation resolves a real absolute file path and is intended for use when a target's location in a parent directory is unknown relative to a child directory; e.g., when wanting to find a package root from deep within a package directory.

Examples

var resolveParentPath = require( '@stdlib/fs/resolve-parent-path' );

var opts = {
    'dir': __dirname
};

/* Sync */

var out = resolveParentPath.sync( 'package.json', opts );
// returns '...'

out = resolveParentPath.sync( 'non_existent_basename' );
// returns null

/* Async */

resolveParentPath( 'package.json', opts, onPath );
resolveParentPath( './../non_existent_path', onPath );

function onPath( error, path ) {
    if ( error ) {
        throw error;
    }
    console.log( path );
}

---

CLI

Usage

Usage: resolve-parent-path [options] <path>

Options:

  -h,    --help                Print this message.
  -V,    --version             Print the package version.
         --dir dir             Base search directory.

Examples

$ resolve-parent-path package.json