You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
This repository was archived by the owner on Apr 13, 2025. It is now read-only.
fix(install): update development installer for npm workspaces
* Fix/npm workspaces
- Remove npm run bootstrap
- Fix typos and grammar in README using <https://languagetool.org/>
- Change test/uninstall/index.ts ls 35 because of change in api calls
Signed-off-by: Tim_Tech_Dev <Tim_Tech_Dev@protonmail.com>
* Implemented Requested Changes
- Inline boolean in src/install/index
- Remove version check in src/install/dev
- Change `createDevInstall` test respectively
Signed-off-by: Tim_Tech_Dev <Tim_Tech_Dev@protonmail.com>
Copy file name to clipboardExpand all lines: README.md
+16-16Lines changed: 16 additions & 16 deletions
Original file line number
Diff line number
Diff line change
@@ -5,7 +5,7 @@
5
5
# nodecg-io-cli
6
6
<!-- prettier-ignore-end -->
7
7
8
-
This is the cli for [nodecg-io](https://github.com/codeoverflow-org/nodecg-io) that allows you to easily manage your nodecg-io installation and helps you with nodecg-io related development.
8
+
This is the CLI for [nodecg-io](https://github.com/codeoverflow-org/nodecg-io) that allows you to easily manage your nodecg-io installation and helps you with nodecg-io related development.
9
9
10
10
## Table of contents
11
11
@@ -21,46 +21,46 @@ This is the cli for [nodecg-io](https://github.com/codeoverflow-org/nodecg-io) t
21
21
22
22
## Commands
23
23
24
-
Here's a brief overview of the available commands. More indepth usage guides of these commands will be available in the [nodecg-io docs](https://nodecg.io) at some point.
24
+
Here's a brief overview of the available commands. More in-depth usage guides of these commands will be available in the [nodecg-io docs](https://nodecg.io) at some point.
25
25
26
26
### `nodecg-io install`
27
27
28
-
Installs nodecg-io to your current nodecg installation into a sub-directory called `nodecg-io`. Allows you to select which released version you want or if you wish to get a development install.
28
+
Installs nodecg-io to your current NodeCG installation into a subdirectory called `nodecg-io`. Allows you to select which released version you want or if you wish to get a development install.
29
29
30
30
A production install fetches tarballs of the needed packages from the official npm registry, unpacks them, creates a `package.json` with all packages in a npm v7 workspace configuration and installs dependencies that way.
31
31
32
-
A development install clones the official git repository (`master`), installs dependencies, bootstraps all packages using lerna and builds all packages.
32
+
A development install clones the official git repository (`master`), installs dependencies builds all packages.
33
33
34
-
Either way at the end of the installation it will automatically add the nodecg-io directory (and samples if dev install and selected) to the `bundles.paths` array of your nodecg configuration. If you don't have a nodecg configuration it will create one for you.
34
+
Either way at the end of the installation it will automatically add the nodecg-io directory (and samples if dev install and selected) to the `bundles.paths` array of your NodeCG configuration. If you don't have a NodeCG configuration it will create one for you.
35
35
36
-
If you later decide that you want to add or remove a service you can just re-run `nodecg-io install`. It saves your choices and makes them the default selected if you already have a installation so you can make changes to them. If you re-run the install command it will also pull the repo and rebuild if necessary in case of a development install and, in case of a production install, it will make any updates if some packages have a new patch version available. Updates of minor and major changes must be made explicitly by selecting the newer version when running the install command.
36
+
If you later decide that you want to add or remove a service you can just re-run `nodecg-io install`. It saves your choices and makes them the default selected if you already have an installation, so you can make changes to them. If you re-run the `install` command it will also pull the repo and rebuild if necessary. In case of a development install and, in case of a production install, it will make any updates if some packages have a new patch version available. Updates of minor and major changes must be made explicitly by selecting the newer version when running the `install` command.
37
37
38
38
### `nodecg-io uninstall`
39
39
40
-
Undos everything that `nodecg-io install` did. It removes the `nodecg-io` directory with your installation and removes nodecg-io from your nodecg configuration.
40
+
Undoes everything that `nodecg-io install` did. It removes the `nodecg-io` directory with your installation and removes nodecg-io from your NodeCG configuration.
41
41
42
42
### `nodecg-io generate`
43
43
44
-
Generates a new bundle in the `bundles/` directory in your nodecg installation.
45
-
Allows you to decide on language (typescript or javascript), whether you want a dashboard/graphic and which services you want to use.
44
+
Generates a new bundle in the `bundles/` directory in your NodeCG installation.
45
+
Allows you to decide on language (TypeScript or JavaScript), whether you want a dashboard/graphic and which services you want to use.
46
46
Uses your installed nodecg-io version and services, meaning you need to have the services that you want to use installed.
47
47
48
48
These generated bundles are only meant as a starting point, you may probably do more things like creating a git repository for your bundle,
49
-
add a license, or add other tools like linters.
49
+
add a licence, or add other tools like linters.
50
50
51
-
Also this command currently only works with installs of released versions and not with development installs. This is because all bundles using nodecg-io depend on `nodecg-io-core` and if you use typescript each used service as well. For development installs these are not published on npm and you would need some way of linking the packages locally.
51
+
Also, this command currently only works with installs of released versions and not with development installs. This is because all bundles using nodecg-io depend on `nodecg-io-core` and if you use typescript each used service as well. For development installs these are not published on npm, and you would need some way of linking the packages locally.
52
52
53
53
## A note about versioning
54
54
55
-
This cli follows and is versioned independently from the rest of nodecg-io like `nodecg-io-core` or the services.
55
+
This CLI follows and is versioned independently of the rest of nodecg-io like `nodecg-io-core` or the services.
56
56
57
-
The following table show which versions of the cli are compatible with which nodecg-io versions:
57
+
The following table show which versions of the CLI are compatible with which nodecg-io versions:
58
58
59
59
| CLI versions | nodecg-io versions |
60
60
| ------------ | ------------------ |
61
61
|`0.1`|`0.1`|
62
62
63
-
Currently they are the same but we will follow [semver2](https://semver.org/) using [semantic-release](https://semantic-release.gitbook.io/semantic-release/) and the versions will diverge at some point.
63
+
Currently, they are the same, but we will follow [semver2](https://semver.org/) using [semantic-release](https://semantic-release.gitbook.io/semantic-release/) and the versions will diverge at some point.
64
64
65
65
## Developer workflow
66
66
@@ -73,10 +73,10 @@ $ npm i
73
73
$ npm run build
74
74
```
75
75
76
-
Then link your current local install of the cli to your global `node_modules` directory (might require `sudo` on linux):
76
+
Then link your current local installation of the CLI to your global `node_modules` directory (might require `sudo` on linux):
77
77
78
78
```console
79
79
$ npm link
80
80
```
81
81
82
-
You can now use the `nodecg-io` command and it will use your local install. You DO NOT need to rerun the link command after you make changes to the cli, unless you move it another location. While developing you may want to start a TypeScript watcher by running `npm run watch` that will automatically update the JS files that are used while you make changes.
82
+
You can now use the `nodecg-io` command, and it will use your local install. You DO NOT need to rerun the link command after you make changes to the CLI, unless you move it another location. While developing you may want to start a TypeScript watcher by running `npm run watch` that will automatically update the JS files that are used while you make changes.
0 commit comments