Skip to content

Latest commit

 

History

History
89 lines (56 loc) · 5.29 KB

README.md

File metadata and controls

89 lines (56 loc) · 5.29 KB

Welcome to @atao/fse-cli

Github Version Github Version License: MIT NPM Version

A CLI for fs-extra.

Releases (0.0.x) will be the last ones to support LTS release 10 of Node.js. Moreover the releases 11 and 13 are also no more supported.

💡 Rational

Everyone needs simple file system operations like copy, remove, clean, ... that can be used from the terminal or via scripts.

There are many Npm packages that provide all or any of this:

This package just provides many of them from a unique CLI, without any pretention to be any kind of shell.

It is based on the API Node.js: fs-extra.

If an API is needed, use Node.js: fs-extra, not @atao60/fse-cli. If only because the latter embeds a npm-shrinkwrap.json expunged from dev dependencies.

The available CLI commands are fully functional and tested. However it's still a work in progress:

  • Not all fs-extra functions are mapped yet. Please, feel free to open an issue if there is something you would like supported.
  • More tests to come, even if they will only concern the CLI part without overlapping fs-extra's tests.

🏁 Quickstart

NPM

Each command is available:

  • either as a stand alone one, i.e. fse-<command> or fse-cli-<command>,
  • or as a sub command, i.e. fse <command> or fse-cli <command>.

The arguments and options of each command are those of Node.js: fs-extra as far as possible, see the manual.

Let's start with displaying the versions of both @atao60/fse-cli and fs-extra:

  • without installing the package:
npx @atao60/fse-cli version
  • otherwise after installing the package either in global mode:
npm install --global @atao60/fse-cli

fse version
  • or in a project:
npm install --save-dev @atao60/fse-cli # or `yarn add --dev @atao60/fse-cli`

fse version

🎹 Commands

For more details, see the manual.

🛠️ Development

See Contributing.

🛡️ License

See MIT.

Copyright © 2020-2021 Pierre Raoul.

📜 Credits

Indeed the API Node.js: fs-extra.

Furthermore node-fs-extra-cli was very useful to start this project.