Starting a development session is easy, just run yarn nodemon
once all dependencies are installed. You can create an alias to the absolute path to ./bin/run
so you can easily run the CLI in development to test. In Linux, if you use bash
, you can add to the end of ~/.bashrc
the following line:
alias YOUR_CLI_NAME-test="ABSOLUTE_PATH_TO_YOUR_CLI_FOLDER/bin/run"
After restarting the active terminals you'll be able to run YOUR_CLI_NAME-test
and you'll be running the dev version of your CLI.
In MacOS you can add to the end of ~/.bash_profile
(if you use bash
) the same line presented above - maybe you'll have to restart the computer for the new alias to take effect.
$ npm install -g @tiagonapoli/oclif-dev-cli
$ oclif-dev COMMAND
running command...
$ oclif-dev (-v|--version|version)
@tiagonapoli/oclif-dev-cli/0.0.4 linux-x64 node-v12.13.0
$ oclif-dev --help [COMMAND]
USAGE
$ oclif-dev COMMAND
...
oclif-dev changelog:get-tag
oclif-dev changelog:init
oclif-dev help [COMMAND]
oclif-dev manifest [PATH]
oclif-dev pack
oclif-dev pack:deb
oclif-dev pack:macos
oclif-dev pack:win
oclif-dev publish
oclif-dev publish:deb
oclif-dev publish:macos
oclif-dev publish:win
oclif-dev readme
Outputs the content of a tag to stdout
USAGE
$ oclif-dev changelog:get-tag
OPTIONS
-p, --path=path [default: ./CHANGELOG.md] path to changelog
-t, --tag=tag (required) desired tag
See code: src/commands/changelog/get-tag.ts
Initializes a changelog on the current directory
USAGE
$ oclif-dev changelog:init
See code: src/commands/changelog/init.ts
display help for oclif-dev
USAGE
$ oclif-dev help [COMMAND]
ARGUMENTS
COMMAND command to show help for
OPTIONS
--all see all commands in CLI
See code: @oclif/plugin-help
generates plugin manifest json
USAGE
$ oclif-dev manifest [PATH]
ARGUMENTS
PATH [default: .] path to plugin
See code: src/commands/manifest.ts
packages oclif cli into tarballs
USAGE
$ oclif-dev pack
OPTIONS
-r, --root=root (required) [default: .] path to oclif CLI root
-t, --targets=targets comma-separated targets to pack (e.g.: linux-arm,win32-x64)
--[no-]xz also build xz
DESCRIPTION
This can be used to create oclif CLIs that use the system node or that come preloaded with a node binary.
See code: src/commands/pack/index.ts
pack CLI into debian package
USAGE
$ oclif-dev pack:deb
OPTIONS
-r, --root=root (required) [default: .] path to oclif CLI root
See code: src/commands/pack/deb.ts
pack CLI into MacOS .pkg
USAGE
$ oclif-dev pack:macos
OPTIONS
-r, --root=root (required) [default: .] path to oclif CLI root
See code: src/commands/pack/macos.ts
create windows installer from oclif CLI
USAGE
$ oclif-dev pack:win
OPTIONS
-r, --root=root (required) [default: .] path to oclif CLI root
See code: src/commands/pack/win.ts
publish an oclif CLI to S3
USAGE
$ oclif-dev publish
OPTIONS
-r, --root=root (required) [default: .] path to oclif CLI root
DESCRIPTION
"aws-sdk" will need to be installed as a devDependency to publish.
See code: src/commands/publish/index.ts
publish deb package built with pack:deb
USAGE
$ oclif-dev publish:deb
OPTIONS
-r, --root=root (required) [default: .] path to oclif CLI root
See code: src/commands/publish/deb.ts
publish macos installers built with pack:macos
USAGE
$ oclif-dev publish:macos
OPTIONS
-r, --root=root (required) [default: .] path to oclif CLI root
See code: src/commands/publish/macos.ts
publish windows installers built with pack:win
USAGE
$ oclif-dev publish:win
OPTIONS
-r, --root=root (required) [default: .] path to oclif CLI root
See code: src/commands/publish/win.ts
adds commands to README.md in current directory
USAGE
$ oclif-dev readme
OPTIONS
--dir=dir (required) [default: docs] output directory for multi docs
--multi create a different markdown page for each topic
--spaceSep output space separated commands on docs
DESCRIPTION
The readme must have any of the following tags inside of it for it to be replaced or else it will do nothing:
# Usage
<!-- usage -->
# Commands
<!-- commands -->
Customize the code URL prefix by setting oclif.repositoryPrefix in package.json.
See code: src/commands/readme.ts