Telestion Client CLI

npm: @wuespace/telestion-client-cli


The command line interface for developing _Project-Specific Clients_ (PSCs) with the Telestion Client ecosystem.

This package is included in PSCs bootstrapped using the Telestion Client CLI by default.

Installation

Simply install the command line interface globally in your workspace:

``shell
npm install --global @wuespace/telestion-client-cli
`

Or, add it as a development dependency to your PSC project:

`shell
npm install @wuespace/telestion-client-cli
`

After installation, check out the options of the cli:

`shell
tc-cli --help
`

For a full reference, check out the help pages for each command or take a look at the _PSC Dev Manual_ in our documentation.

You can find the latest versions (in PDF format) in the Documentation Repo Releases.

Package structure

The package internally uses yargs to build an interactive command line
and does all the argument parsing.

The main executable is located in the bin folder.
All commands are defined in src/commands and must export some predefined variables.
Utility and library functions are exported at src/lib that maybe used in the commands.

Overall, the folder structure, therefore, looks like this:

`
.
├── bin
│ └── cli.js (the CLI executable)
├── src
│ ├── commands (the CLI commands)
│ │ ├── build.js
│ │ ├── docs.js
│ │ └── [...]
│ ├── lib (library functions for CLI commands)
│ │ ├── build
│ │ │ ├── custom-webpack-loader
│ │ │ │ └── electron-main-import-plugins.js (custom webpack loader for compiling the Electron main thread)
│ │ │ ├── static
│ │ │ │ └── electron-main.js (the Electron Main Thread file used when building Electron Apps from PSCs)
│ │ │ └── [...]
│ │ ├── [...]
│ │ ├── async-exec.js
│ │ └── [...]
│ └── api.js (publicly exposed JS APIs of the CLI, undocumented except in code!)
├── CHANGELOG.md (DO NOT TOUCH! auto-generated changelog for the package)
├── LICENSE
├── package.json
├── README.md (you're here :P)
└── tsconfig.json
``

Contributing

If you want to contribute to this package, please take a look at the Telestion Client monorepo that manages this package, among other Telestion Client packages.

Contributors

Thank you to all contributors of this repository:


Made with contributors-img.

About

This is part of Telestion, a project by WüSpace e.V..