rm-up

Delete files or empty directories and their empty parents from bottom to up.

• Synopsis
• Safety
• Details
• API
• rm-up
  • Table of contents
    • Interfaces
    • Functions
  • Functions
    • default
• Interfaces
• Interface: Options
  • Hierarchy
  • Table of contents
    • Properties
  • Properties
    • cwd
    • deleteInitial
    • dry
    • force
    • relative
    • stop
    • verbose
• Related

Synopsis

import rmUp from "rm-up";

await rmUp("generated/template/db/ddl");

await rmUp(["generated/lib/math", "generated/util/helper"], { cwd: "/path/to/project", stop: "." });

Safety

rm-up deletes only files below the options.stop to prevent unintentional delete operations. If the options.stop is not provided rm-up deletes empty directories up to root.

For example:

• await rmUp("/root/a/b/c", { stop: "root/x" }); // nothing would be deleted.
• await rmUp("/root/a/b/c", { stop: "root/a" }); // "b" and "c" deleted if empty.

Details

rmUp function deletes files or empty directories and their empty parents from bottom to up. First deletes given files or directories, then checks whether their parent directories are empty and deletes them if empty. Then checks parent's parents and so on.

It's direction is reverse of rm -rf or deltree command.

Ignores system junk files such as .DS_Store and Thumbs.db.

For CLI, please see rm-up-cli.

Why do I need this?

It is most useful when you create a file in a deep path programmatically and want to delete whole created tree, but not sure if other files are added somewhere between by others.

For example you created "generated/template/db/ddl/create.sql" in your project "/path/to/project" and want to delete whole created tree.

Example 1

await rmUp("generated/template/db/ddl/create.sql", { cwd: "/path/to/project" });

project                      project                        project
└─generated/                 └─generated/
  └─template/                  └─template/
    └─db/           --▶          └─db/            --▶
      └─ddl/                       └─ddl/
        └─create.sql                 └─create.sql

create.sql file would be deleted, ddl become empty and deleted, db become empty and deleted, so template and generated directories are deleted likewise.

Example 2

Same options for a little different directory tree:

await rmUp("generated/template/db/ddl/create.sql", { cwd: "/path/to/project" });

project                      project                        project
└─generated/                 └─generated/                   ├─generated/
  ├─assets/                    ├─assets/                    └─assets/
  └─template/        --▶       └─template/        --▶
    └─db/                        └─db/
      └─ddl/                       └─ddl/
        └─create.sql                 └─create.sql

create.sql file would be deleted, ddl become empty and deleted, db become empty and deleted, template become empty and deleted, but this time generated directory not become empty because of assets and not deleted.

API

rm-up

rm-up

Table of contents

Interfaces

• Options

Functions

• default

Functions

default

▸ default(paths: string | string[], __namedParameters?: Options): Promise<_string_[]>

Delete files or empty directories and their empty parents up to stop path excluding stop path.

Parameters:

• paths: string | string[]

are the list of directories to be deleted with their empty parents. All paths must be under the same root. (e.g. you can not mix C: and D: in Windows)

• __namedParameters: Options

Returns: Promise<_string_[]>

Defined in: main.ts:29

Interfaces

rm-up / Options

Interface: Options

Options

Hierarchy

• Options

Table of contents

Properties

• cwd
• deleteInitial
• dry
• force
• relative
• stop
• verbose

Properties

cwd

• Optional cwd: undefined | string

Current working directory to be used with relative input paths.

Defined in: main.ts:8

deleteInitial

• Optional deleteInitial: undefined | boolean

Delete target path (bottom directory) even it is non-empty directory. For example even if c directory of a/b/c has some files in it, c will be deleted.

Defined in: main.ts:14

dry

• Optional dry: undefined | boolean

Dry run without deleting any files.

Defined in: main.ts:16

force

• Optional force: undefined | boolean

If true, no error is thrown if input path is not a directory or does not exists. CWD is used by default.

Defined in: main.ts:12

relative

• Optional relative: undefined | boolean

If true returns paths are relative to cwd, otherwise absolute paths.

Defined in: main.ts:20

stop

• Optional stop: undefined | string

Path to stop searching empty directories up. Stop directory is not included (not deleted).

Defined in: main.ts:10

verbose

• Optional verbose: undefined | boolean

If true returns all deleted directories and files. Otherwise returns only paths which delete command is executed agains.

Defined in: main.ts:18

Related

• rm-up-cli: CLI for this API.