Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/julienvincent/cli-core
CLI building tool for creating very simple cli applications
https://github.com/julienvincent/cli-core
Last synced: 17 days ago
JSON representation
CLI building tool for creating very simple cli applications
- Host: GitHub
- URL: https://github.com/julienvincent/cli-core
- Owner: julienvincent
- Created: 2016-04-18T10:51:44.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2016-09-25T14:28:58.000Z (over 8 years ago)
- Last Synced: 2024-12-06T22:26:27.466Z (about 1 month ago)
- Language: JavaScript
- Homepage:
- Size: 13.7 KB
- Stars: 0
- Watchers: 2
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: readme.md
Awesome Lists containing this project
README
## cli-core
A tool for building very simple cli's
This is the internal core of ambient-cli that I have pulled out into its own library. The reason for writing my own cli instead of using one of the
many out there like vorpal is that they were either too heavy or too simple for what I wanted - this one is a little in between.#### Example
`demo.js`
```javascript
import { define, command, option, flags, init } from 'cli-core'define(
command(
"say-hello",
"This command just says hi",
() => {
if (option('french')) return "Bonjour!"
return "Hi!"
}
)
)flags([
'--french', 'Say hello in french'
])init()
``````
$ node demo.js
$
Simple-cli help textAvailable commands:
- say-hello This command just says hi
Available flags:
--french Say hello in french
``````
$ node demo.js say-hello
$ Hi!
``````
$ node demo.js say-hello --french
$ Bonjour!
```## API Reference
### `define(...commands)`
Define a collection of commands that `cli-core` has access to. Accepts a sequence of `command`
### `command(name, man, action, ...commands)`
Create a command to be available through the terminal
###### `name` [string]
The name of the command.
+ To make a wildcard command, prefix your command name with `:` eg `:name`. A wildcard command should be defined last in sequence.
+ To create command aliases, use a `|` between commands eg: `list|ls`
+ If the command name ends with a `]`, then it will absorb all subsequent command arguments - and pass them as a parameter to `action`.
for example - if a command `absorb]` was defined and was used like so: `cli absorb a b c d` - then the arguments `a b c d` will be passed
into the absorb commands action.###### `man` [string]
The commands manual - a description of the command. This is used in `cli-core`'s `help` menu
###### `action` [function]
A function to be run for it's specific command. This functions output can be injected into nested commands.
+ returning `[string]` will pass the string to `console` if there are no other commands in the sequence.
+ returning `[object]` will do the following with its properties:
+ `object.payload` - data to be injected into the following command in sequence
+ `object.action` [function | string] - an action to be run if this command is the last in its sequence. If `action` is a function, it will be run, else it will be passed to `console`Accepts `payload` [object]
+ `payload.name` - The inputted value of the command run. Useful for wildcard commands.
+ `payload.data` - Any data that the previous command in the sequence might want to pass down
+ `payload.args` - An array of command line arguments following the last command that did not match any defined commands.###### `...commands`
A sequence of nested commands to be run next
### `option(name)`
Accepts a string `name` and returns that option/flags value or `null` if it was not in sequence.
### `prompt(label, cb)`
Start an interactive prompt. It accepts `label` and `cb`. The majority of the code for this feature was take from
[prompt-sync](https://github.com/0x00A/prompt-sync) with the history module included.+ `label` The prompt text. If none is provided, will default to `~/cwd` + current git branch and commit status (x or nothing)
+ `cb` Will be called on exit and will provide an error as the first argument if any, and the input form the user as the second argumentif `exit` is written, the prompt will exit without firing the cb
### `setHelpText(text)`
Set the description text that appears when running any help commands.
### `help()`
Displays the help listing for available commands and flags
### `getUnusedArgs()`
Get all arguments that are not defined as commands and have not been used in the current sequence via `option()`. Returns [array]
### `init()`
Begin constructing the command sequence based on command line arguments. This should be run after defining all commands you want your cli to use