filepaths-to-tree

This module provides functions for creating and manipulating a plain object tree built from POSIX and win32 style paths. There are no classes, only functions that manipulate a POJO representing a tree structure.

Functions

Make(paths, cb) ⇒ Object

Make creates a new tree object from an array of POSIX or win32 style paths.

Insert(root, path, value) ⇒ Object

Insert inserts the given path into the root object and assigns the value to the end node.

Remove(root, path) ⇒ Object

Remove removes the given path from the root object. Also removes any branches that are made empty during this process.

Find(root, path) ⇒ Object

Find returns the tree branch, end node value, or undefined from the given path in the tree.

SplitPath(path) ⇒ Array.<string>

SplitPath returns an array of strings representing a path's structure split by forward or back slashes.

Typedefs

MakeCallback ⇒ any

Make(paths, cb) ⇒ Object

Make creates a new tree object from an array of POSIX or win32 style paths.

Returns: Object -

The resulting tree.

Example

// returns { a: { b: { c: 'a/b/c', d: 'a\\b\\d', e: 'a\\b/e' } }, b: { c: { a: 'b/c\\a' } } }
Make(['a/b/c', 'a\\b\\d', 'a\\b/e', 'b/c\\a'], p => p)

Insert(root, path, value) ⇒ Object

Insert inserts the given path into the root object and assigns the value to the end node.

Returns: Object -

The root tree object.

Example

// returns { my: { mixed: { path: 'something' } } }
Insert({}, '/my\\mixed/path', 'something')

Remove(root, path) ⇒ Object

Remove removes the given path from the root object. Also removes any branches that are made empty during this process.

Returns: Object -

The root tree object.

Example

// returns { a: { '1': 'a/1', '2': 'a/2' }, b: { '1': 'b\\1' } }
let t = Make(['a/1', 'a/2', 'b\\1'])
// returns { a: { '2': 'a/2' }, b: { '1': 'b\\1' } }
Remove(t, 'a/1')
// returns { a: { '2': 'a/2' } }
Remove(t, 'b/1')

Find(root, path) ⇒ Object

Find returns the tree branch, end node value, or undefined from the given path in the tree.

Returns: Object -

The tree branch, end value, or undefined.

SplitPath(path) ⇒ Array.<string>

SplitPath returns an array of strings representing a path's structure split by forward or back slashes.

Returns: Array.<string> -

An array of paths separated by / or \.

MakeCallback ⇒ any

Returns: any -

The value to assign to the given entry.

© 2022 Ketchetwahmeegwun T. Southall