https://github.com/heusalagroup/create-command
NPM package creator for CLI commands
https://github.com/heusalagroup/create-command
Last synced: 3 months ago
JSON representation
NPM package creator for CLI commands
- Host: GitHub
- URL: https://github.com/heusalagroup/create-command
- Owner: heusalagroup
- License: mit
- Created: 2022-03-04T14:05:40.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2023-08-17T06:33:21.000Z (about 2 years ago)
- Last Synced: 2025-03-03T10:46:34.570Z (7 months ago)
- Language: JavaScript
- Size: 425 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
**Join our [Discord](https://discord.gg/UBTrHxA78f) to discuss about our software!**
# @heusalagroup/create-command
A command-line tool that makes it easy to create lightweight, zero-dependency
Node.js command line projects with TypeScript. For more information on our style
of Node.js projects, check out [HG.fi](https://hg.fi/).
### Usage
To create a minimal command line project, run either of the following commands:
```shell
npm init @heusalagroup/command ./foo-command
```
...or..
```shell
npm install -g @heusalagroup/command
create-command ./foo-command
```
This command also accepts any argument from the `npm init` command. For example,
you can call it with `--yes` to answer "yes" to every question:
```shell
create-command ./foo-command --yes
```
To increase the log level for debugging, set the `LOG_LEVEL` environment
variable:
```shell
LOG_LEVEL=DEBUG npm init @heusalagroup/command ./foo-command
```
## Development
### Fetching source code
To get started with development, clone the repository locally and install the
git submodules:
```bash
git clone git@github.com:heusalagroup/create-command.git create-command
cd create-command
git submodule update --init --recursive
```
### Listing state of git modules
To see the state of the git modules, run this command:
```bash
./scripts/get-all-branches.sh
```
If you see states like this, run the `set-branch-main.sh` script:
```bash
$ ./scripts/get-all-branches.sh
main .
(HEAD detached at 34566e9) src/fi/hg/core
(HEAD detached at 898988b) src/fi/hg/create
```
When everything is correct, you should see this:
```bash
$ ./scripts/get-all-branches.sh
main .
main src/fi/hg/core
main src/fi/hg/create
```
Unless you want to use a different branch, of course.
### Changing all git modules to the `main` branch
To switch all git modules to `main`, run this script:
```bash
./scripts/set-branch-main.sh
```
### Updating git modules to the latest version
To update all git modules to the latest version, run this script:
```bash
./scripts/pull-all.sh
```
#### Building the project
This script will build a standalone version of the project and output it
to `./dist/create-command.js`. It will be zero dep after that, meaning that only
Node.js is required to run it, along with `./create.config.json` and the files
in `./templates`.
```shell
npm run build
```
### Testing locally
You can install your own locally changed version globally:
```shell
npm install -g .
```
Then use it to kickstart a command line project:
```shell
create-command ./foo-command
```
## Development with GitHub Using SSH
To use SSH when working with submodules in this repository, you will need to
configure your Git settings as follows:
```
git config --global url."git@github.com:heusalagroup/".insteadOf "https://github.com/heusalagroup/"
```
This configuration is necessary because the repository uses HTTPS links for
read-only access. However, you may prefer to use SSH when pushing and pulling
changes.
### License
Copyright (c) 2022 Heusala Group. All rights reserved. Licensed under the MIT
License (the "[License](./LICENSE)").