@teambit/harmony.content.cli-reference 1.95.29 → 1.95.30
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/cli-reference.json +255 -104
- package/cli-reference.mdx +118 -124
- package/dist/cli-reference.json +255 -104
- package/dist/cli-reference.mdx.js +62 -83
- package/dist/cli-reference.mdx.js.map +1 -1
- package/package-tar/teambit-harmony.content.cli-reference-1.95.30.tgz +0 -0
- package/package.json +2 -2
- package/{preview-1655177322725.js → preview-1655263660719.js} +2 -2
- package/package-tar/teambit-harmony.content.cli-reference-1.95.29.tgz +0 -0
package/cli-reference.mdx
CHANGED
|
@@ -27,7 +27,7 @@ all flags support glob patterns and {PARENT} {FILE_NAME} annotations
|
|
|
27
27
|
## app
|
|
28
28
|
|
|
29
29
|
**Workspace only**: yes
|
|
30
|
-
**Description**:
|
|
30
|
+
**Description**: Manages apps
|
|
31
31
|
|
|
32
32
|
`bit app <sub-command>`
|
|
33
33
|
|
|
@@ -35,7 +35,7 @@ all flags support glob patterns and {PARENT} {FILE_NAME} annotations
|
|
|
35
35
|
|
|
36
36
|
**Usage**: `app list`
|
|
37
37
|
|
|
38
|
-
**Description**: list all registered
|
|
38
|
+
**Description**: list all registered apps
|
|
39
39
|
|
|
40
40
|
| **Option** | **Option alias** | **Description** |
|
|
41
41
|
| ---------- | :--------------: | ---------------------------------------- |
|
|
@@ -289,9 +289,9 @@ The following gets removed by this command:
|
|
|
289
289
|
## compile
|
|
290
290
|
|
|
291
291
|
**Workspace only**: yes
|
|
292
|
-
**Description**: compile components in the
|
|
292
|
+
**Description**: compile components in the workspace
|
|
293
293
|
|
|
294
|
-
`bit compile [component...]`
|
|
294
|
+
`bit compile [component-names...]`
|
|
295
295
|
|
|
296
296
|
| **Option** | **Option alias** | **Description** |
|
|
297
297
|
| ------------------- | :--------------: | ------------------------------------------------------------- |
|
|
@@ -361,9 +361,9 @@ https://bit.dev/docs/config/bit-config
|
|
|
361
361
|
## create
|
|
362
362
|
|
|
363
363
|
**Workspace only**: yes
|
|
364
|
-
**Description**: create a new component
|
|
364
|
+
**Description**: create a new component (source files and config) using a template.
|
|
365
365
|
|
|
366
|
-
`bit create <
|
|
366
|
+
`bit create <template-name> <component-names...>`
|
|
367
367
|
|
|
368
368
|
| **Option** | **Option alias** | **Description** |
|
|
369
369
|
| ---------------------- | :--------------: | ----------------------------------------------------------------------------------- |
|
|
@@ -485,7 +485,7 @@ to validate the pattern before running this command, run `bit pattern <pattern>`
|
|
|
485
485
|
|
|
486
486
|
**Alias**: `env`
|
|
487
487
|
**Workspace only**: yes
|
|
488
|
-
**Description**: list all components envs
|
|
488
|
+
**Description**: list all components maintained by the workspace and their corresponding envs
|
|
489
489
|
|
|
490
490
|
`bit envs`
|
|
491
491
|
|
|
@@ -497,24 +497,21 @@ to validate the pattern before running this command, run `bit pattern <pattern>`
|
|
|
497
497
|
|
|
498
498
|
### envs get
|
|
499
499
|
|
|
500
|
-
**Usage**: `envs get <name>`
|
|
500
|
+
**Usage**: `envs get <component-name>`
|
|
501
501
|
|
|
502
|
-
**Description**: show component's env
|
|
502
|
+
**Description**: show information about a component's env
|
|
503
503
|
|
|
504
504
|
### envs set
|
|
505
505
|
|
|
506
|
-
**Usage**: `envs set <pattern> <env>`
|
|
506
|
+
**Usage**: `envs set <component-pattern> <env>`
|
|
507
507
|
|
|
508
|
-
**Description**:
|
|
509
|
-
you can use a `<pattern>` for multiple component ids, such as `bit env set "org.scope/utils/**"`. use comma to separate patterns and "!" to exclude. e.g. "ui/\*\*, !ui/button"
|
|
510
|
-
always wrap the pattern with quotes to avoid collision with shell commands.
|
|
511
|
-
to validate the pattern before running this command, run `bit pattern <pattern>`.
|
|
508
|
+
**Description**: Sets one or more components with a development environment (env)
|
|
512
509
|
|
|
513
510
|
### envs unset
|
|
514
511
|
|
|
515
|
-
**Usage**: `envs unset <pattern>`
|
|
512
|
+
**Usage**: `envs unset <component-pattern>`
|
|
516
513
|
|
|
517
|
-
**Description**:
|
|
514
|
+
**Description**: un-sets an env from components that were previously set by "bit env set" or by a component template
|
|
518
515
|
keep in mind that this doesn't remove envs that are set in the variants.
|
|
519
516
|
in only removes envs that appear in the .bitmap file, which were previously configured via "bit env set".
|
|
520
517
|
the purpose of this command is to remove the specific settings and let the the variants in workspace.jsonc to control the env.
|
|
@@ -524,7 +521,7 @@ to validate the pattern before running this command, run `bit pattern <pattern>`
|
|
|
524
521
|
|
|
525
522
|
### envs replace
|
|
526
523
|
|
|
527
|
-
**Usage**: `envs replace <
|
|
524
|
+
**Usage**: `envs replace <current-env> <new-env>`
|
|
528
525
|
|
|
529
526
|
**Description**: replace an existing env with another env for all components using the old env
|
|
530
527
|
|
|
@@ -534,19 +531,19 @@ to validate the pattern before running this command, run `bit pattern <pattern>`
|
|
|
534
531
|
|
|
535
532
|
**Alias**: `e`
|
|
536
533
|
**Workspace only**: yes
|
|
537
|
-
**Description**:
|
|
534
|
+
**Description**: export components from the workspace to remote scopes
|
|
538
535
|
bit export => export all staged components to their current scope, if checked out to a lane, export the lane as well
|
|
539
536
|
`bit export [id...]` => export the given ids to their current scope
|
|
540
537
|
|
|
541
538
|
https://bit.dev/docs/components/exporting-components
|
|
542
539
|
you can use a pattern for multiple ids, such as bit export remote-scope "utils/\*". (wrap the pattern with quotes to avoid collision with shell commands)
|
|
543
540
|
|
|
544
|
-
`bit export [remote] [
|
|
541
|
+
`bit export [remote] [component-names...]`
|
|
545
542
|
|
|
546
543
|
| **Option** | **Option alias** | **Description** |
|
|
547
544
|
| ---------------------------- | :--------------: | --------------------------------------------------------------------------------------------------------------------------------------- |
|
|
548
|
-
| `--eject` | `-e` |
|
|
549
|
-
| `--all` | `-a` | export all components
|
|
545
|
+
| `--eject` | `-e` | replace the exported components with their corresponding packages (to use these components without further maintaining them) |
|
|
546
|
+
| `--all` | `-a` | export all components, including non-staged |
|
|
550
547
|
| `--include-dependencies` | `-d` | LEGACY ONLY. include the component's dependencies as part of the export to the remote scope |
|
|
551
548
|
| `--set-current-scope` | `-s` | LEGACY ONLY. ensure the component's remote scope is set according to the target location |
|
|
552
549
|
| `--rewire` | `-r` | LEGACY ONLY. when exporting to a different or new scope, replace import/require statements in the source code to match the new scope |
|
|
@@ -562,17 +559,15 @@ you can use a pattern for multiple ids, such as bit export remote-scope "utils/\
|
|
|
562
559
|
## fork
|
|
563
560
|
|
|
564
561
|
**Workspace only**: no
|
|
565
|
-
**Description**: EXPERIMENTAL. create a new component out of an existing one
|
|
566
|
-
note that [target-name] is the name only without the scope.
|
|
567
|
-
to set the default-scope, please use --scope flag
|
|
562
|
+
**Description**: EXPERIMENTAL. create a new component out of an existing one (copies source files and config)
|
|
568
563
|
|
|
569
|
-
`bit fork <source-id> [target-name]`
|
|
564
|
+
`bit fork <source-component-id> [target-component-name]`
|
|
570
565
|
|
|
571
|
-
| **Option** | **Option alias** | **Description**
|
|
572
|
-
| ------------------ | :--------------: |
|
|
573
|
-
| `--scope <string>` | `-s` | default scope for the
|
|
574
|
-
| `--path <string>` | `-p` | relative path in the workspace. by default the path is `<scope>/<namespace>/<name>`
|
|
575
|
-
| `--refactor` | `-r` |
|
|
566
|
+
| **Option** | **Option alias** | **Description** |
|
|
567
|
+
| ------------------ | :--------------: | --------------------------------------------------------------------------------------------------------- |
|
|
568
|
+
| `--scope <string>` | `-s` | default scope for the new component |
|
|
569
|
+
| `--path <string>` | `-p` | relative path in the workspace for the new component. by default the path is `<scope>/<namespace>/<name>` |
|
|
570
|
+
| `--refactor` | `-r` | update the import/require statements in all dependent components (in the same workspace) |
|
|
576
571
|
|
|
577
572
|
---
|
|
578
573
|
|
|
@@ -633,28 +628,28 @@ to set the default-scope, please use --scope flag
|
|
|
633
628
|
## import
|
|
634
629
|
|
|
635
630
|
**Workspace only**: yes
|
|
636
|
-
**Description**: import components
|
|
631
|
+
**Description**: import components from remote scopes to the local workspace
|
|
637
632
|
https://bit.dev/docs/components/importing-components
|
|
638
633
|
you can use a pattern for multiple ids, such as bit import "utils/\*". (wrap the pattern with quotes to avoid collision with shell commands)
|
|
639
634
|
|
|
640
|
-
`bit import [ids...]`
|
|
635
|
+
`bit import [component-ids...]`
|
|
641
636
|
|
|
642
|
-
| **Option** | **Option alias** | **Description**
|
|
643
|
-
| -------------------------------- | :--------------: |
|
|
644
|
-
| `--path <path>` | `-p` | import components into a specific directory
|
|
645
|
-
| `--objects` | `-o` | import components objects
|
|
646
|
-
| `--display-dependencies` | `-d` | display the imported dependencies
|
|
647
|
-
| `--override` | `-O` | override local changes
|
|
648
|
-
| `--verbose` | `-v` |
|
|
649
|
-
| `--json` | `-j` | return the output as JSON
|
|
650
|
-
| `--conf` | | write the configuration file (component.json) of the component
|
|
651
|
-
| `--skip-npm-install` | | DEPRECATED. use "--skip-dependency-installation" instead
|
|
652
|
-
| `--skip-dependency-installation` | | do not install packages of the imported components
|
|
653
|
-
| `--merge [strategy]` | `-m` | merge local changes with the imported version. strategy should be "theirs", "ours" or "manual"
|
|
654
|
-
| `--dependencies` | | EXPERIMENTAL. import all dependencies and write them to the workspace
|
|
655
|
-
| `--dependents` | | EXPERIMENTAL. import component dependents to allow auto-tag updating them upon tag
|
|
656
|
-
| `--save-in-lane` | | EXPERIMENTAL. when checked out to a lane and the component is not on the remote-lane, save it in the lane (default to save on main)
|
|
657
|
-
| `--all-history` | | relevant for fetching all components objects. avoid optimizations, fetch all history versions, always
|
|
637
|
+
| **Option** | **Option alias** | **Description** |
|
|
638
|
+
| -------------------------------- | :--------------: | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
|
|
639
|
+
| `--path <path>` | `-p` | import components into a specific directory (a relative path in the workspace) |
|
|
640
|
+
| `--objects` | `-o` | import components objects to the local scope without checkout (without writing them to the file system). This is a default behavior for import with no id argument |
|
|
641
|
+
| `--display-dependencies` | `-d` | display the imported dependencies |
|
|
642
|
+
| `--override` | `-O` | override local changes |
|
|
643
|
+
| `--verbose` | `-v` | show verbose output for inspection |
|
|
644
|
+
| `--json` | `-j` | return the output as JSON |
|
|
645
|
+
| `--conf` | | write the configuration file (component.json) of the component |
|
|
646
|
+
| `--skip-npm-install` | | DEPRECATED. use "--skip-dependency-installation" instead |
|
|
647
|
+
| `--skip-dependency-installation` | | do not install packages of the imported components |
|
|
648
|
+
| `--merge [strategy]` | `-m` | merge local changes with the imported version. strategy should be "theirs", "ours" or "manual" |
|
|
649
|
+
| `--dependencies` | | EXPERIMENTAL. import all dependencies and write them to the workspace |
|
|
650
|
+
| `--dependents` | | EXPERIMENTAL. import component dependents to allow auto-tag updating them upon tag |
|
|
651
|
+
| `--save-in-lane` | | EXPERIMENTAL. when checked out to a lane and the component is not on the remote-lane, save it in the lane (default to save on main) |
|
|
652
|
+
| `--all-history` | | relevant for fetching all components objects. avoid optimizations, fetch all history versions, always |
|
|
658
653
|
|
|
659
654
|
---
|
|
660
655
|
|
|
@@ -686,7 +681,8 @@ https://bit.dev/docs/workspace/creating-workspaces#initialize-a-workspace-on-an-
|
|
|
686
681
|
|
|
687
682
|
**Alias**: `in`
|
|
688
683
|
**Workspace only**: yes
|
|
689
|
-
**Description**:
|
|
684
|
+
**Description**: installs workspace dependencies
|
|
685
|
+
when no package is specified, all workspace dependencies are installed and all workspace components are imported.
|
|
690
686
|
|
|
691
687
|
`bit install [packages...]`
|
|
692
688
|
|
|
@@ -842,18 +838,18 @@ move files or directories of component(s)
|
|
|
842
838
|
## new
|
|
843
839
|
|
|
844
840
|
**Workspace only**: yes
|
|
845
|
-
**Description**:
|
|
841
|
+
**Description**: create a new workspace from a template
|
|
846
842
|
|
|
847
|
-
`bit new <
|
|
843
|
+
`bit new <template-name> <workspace-name>`
|
|
848
844
|
|
|
849
|
-
| **Option**
|
|
850
|
-
|
|
|
851
|
-
| `--aspect <
|
|
852
|
-
| `--default-scope <
|
|
853
|
-
| `--standalone`
|
|
854
|
-
| `--skip-git`
|
|
855
|
-
| `--empty`
|
|
856
|
-
| `--load-from <
|
|
845
|
+
| **Option** | **Option alias** | **Description** |
|
|
846
|
+
| -------------------------------- | :--------------: | --------------------------------------------------------------------------------------------------------------- |
|
|
847
|
+
| `--aspect <aspect-id>` | `-a` | aspect-id of the template. mandatory for non-core aspects. helpful for core aspects in case of a name collision |
|
|
848
|
+
| `--default-scope <scope-name>` | `-d` | set defaultScope in the new workspace.jsonc |
|
|
849
|
+
| `--standalone` | | DEPRECATED. use --skip-git instead |
|
|
850
|
+
| `--skip-git` | `-s` | skip generation of Git repository |
|
|
851
|
+
| `--empty` | `-e` | empty workspace with no components (relevant for templates that add components by default) |
|
|
852
|
+
| `--load-from <path-to-template>` | | path to the workspace containing the template. helpful during a development of a workspace-template |
|
|
857
853
|
|
|
858
854
|
---
|
|
859
855
|
|
|
@@ -981,9 +977,9 @@ to assign a default-scope to this component, please use "--scope" flag
|
|
|
981
977
|
|
|
982
978
|
**Alias**: `c`
|
|
983
979
|
**Workspace only**: yes
|
|
984
|
-
**Description**: run an
|
|
980
|
+
**Description**: run an app (independent of bit's dev server)
|
|
985
981
|
|
|
986
|
-
`bit run <app>`
|
|
982
|
+
`bit run <app-name>`
|
|
987
983
|
|
|
988
984
|
| **Option** | **Option alias** | **Description** |
|
|
989
985
|
| -------------- | :--------------: | -------------------------------------------------------------------------- |
|
|
@@ -1012,17 +1008,16 @@ to validate the pattern before running this command, run `bit pattern <pattern>`
|
|
|
1012
1008
|
## scope
|
|
1013
1009
|
|
|
1014
1010
|
**Workspace only**: yes
|
|
1015
|
-
**Description**: EXPERIMENTAL. manage scope-name
|
|
1011
|
+
**Description**: EXPERIMENTAL. manage the scope-name for components
|
|
1016
1012
|
|
|
1017
1013
|
`bit scope <sub-command>`
|
|
1018
1014
|
|
|
1019
1015
|
### scope set
|
|
1020
1016
|
|
|
1021
|
-
**Usage**: `scope set <scope-name> [pattern]`
|
|
1017
|
+
**Usage**: `scope set <scope-name> [component-pattern]`
|
|
1022
1018
|
|
|
1023
|
-
**Description**:
|
|
1024
|
-
set
|
|
1025
|
-
if "pattern" is provided, the default-scope will be set to the new components matching the criteria.
|
|
1019
|
+
**Description**: Sets components with a default-scope. If no component is specified, sets the workspace with a default scope
|
|
1020
|
+
default scopes for components are set in the bitmap file. the default scope for a workspace is set in the workspace.jsonc. a component is set with a scope (as oppose to default scope) only once it is versioned.'
|
|
1026
1021
|
|
|
1027
1022
|
you can use a `<pattern>` for multiple component ids, such as `bit scope set scope-name "org.scope/utils/**"`. use comma to separate patterns and "!" to exclude. e.g. "ui/\*\*, !ui/button"
|
|
1028
1023
|
always wrap the pattern with quotes to avoid collision with shell commands.
|
|
@@ -1030,9 +1025,9 @@ to validate the pattern before running this command, run `bit pattern <pattern>`
|
|
|
1030
1025
|
|
|
1031
1026
|
### scope rename
|
|
1032
1027
|
|
|
1033
|
-
**Usage**: `scope rename <
|
|
1028
|
+
**Usage**: `scope rename <current-scope-name> <new-scope-name>`
|
|
1034
1029
|
|
|
1035
|
-
**Description**:
|
|
1030
|
+
**Description**: Renames the scope name for all components with the specified 'current scope name'
|
|
1036
1031
|
|
|
1037
1032
|
| **Option** | **Option alias** | **Description** |
|
|
1038
1033
|
| ------------ | :--------------: | ---------------------------------------------------------------------------------------------- |
|
|
@@ -1082,16 +1077,16 @@ to validate the pattern before running this command, run `bit pattern <pattern>`
|
|
|
1082
1077
|
## show
|
|
1083
1078
|
|
|
1084
1079
|
**Workspace only**: yes
|
|
1085
|
-
**Description**:
|
|
1080
|
+
**Description**: display the component's essential information
|
|
1086
1081
|
|
|
1087
|
-
`bit show <
|
|
1082
|
+
`bit show <component-name>`
|
|
1088
1083
|
|
|
1089
|
-
| **Option** | **Option alias** | **Description**
|
|
1090
|
-
| ----------- | :--------------: |
|
|
1091
|
-
| `--json` | `-j` | return the component data in json format
|
|
1092
|
-
| `--legacy` | `-l` | use the legacy bit show.
|
|
1093
|
-
| `--remote` | `-r` | show a remote component
|
|
1094
|
-
| `--compare` | `-c` | compare current file system component to latest tagged component [default=latest]. only works in legacy. |
|
|
1084
|
+
| **Option** | **Option alias** | **Description** |
|
|
1085
|
+
| ----------- | :--------------: | ------------------------------------------------------------------------------------------------------------ |
|
|
1086
|
+
| `--json` | `-j` | return the component data in a json format |
|
|
1087
|
+
| `--legacy` | `-l` | use the legacy bit show. |
|
|
1088
|
+
| `--remote` | `-r` | show a remote component |
|
|
1089
|
+
| `--compare` | `-c` | compare current file system component to the latest tagged component [default=latest]. only works in legacy. |
|
|
1095
1090
|
|
|
1096
1091
|
---
|
|
1097
1092
|
|
|
@@ -1099,18 +1094,18 @@ to validate the pattern before running this command, run `bit pattern <pattern>`
|
|
|
1099
1094
|
|
|
1100
1095
|
**Alias**: `c`
|
|
1101
1096
|
**Workspace only**: yes
|
|
1102
|
-
**Description**:
|
|
1097
|
+
**Description**: run the ui/development server
|
|
1103
1098
|
|
|
1104
1099
|
`bit start [type] [pattern]`
|
|
1105
1100
|
|
|
1106
|
-
| **Option**
|
|
1107
|
-
|
|
|
1108
|
-
| `--dev`
|
|
1109
|
-
| `--port [number]`
|
|
1110
|
-
| `--rebuild`
|
|
1111
|
-
| `--verbose`
|
|
1112
|
-
| `--no-browser`
|
|
1113
|
-
| `--skip-compilation`
|
|
1101
|
+
| **Option** | **Option alias** | **Description** |
|
|
1102
|
+
| ---------------------- | :--------------: | --------------------------------------------------------- |
|
|
1103
|
+
| `--dev` | `-d` | start UI server in dev mode. |
|
|
1104
|
+
| `--port [port-number]` | `-p` | port of the UI server. |
|
|
1105
|
+
| `--rebuild` | `-r` | rebuild the UI |
|
|
1106
|
+
| `--verbose` | `-v` | show verbose output for inspection and prints stack trace |
|
|
1107
|
+
| `--no-browser` | | do not automatically open browser when ready |
|
|
1108
|
+
| `--skip-compilation` | | skip the auto-compilation before starting the web-server |
|
|
1114
1109
|
|
|
1115
1110
|
---
|
|
1116
1111
|
|
|
@@ -1118,8 +1113,7 @@ to validate the pattern before running this command, run `bit pattern <pattern>`
|
|
|
1118
1113
|
|
|
1119
1114
|
**Alias**: `s`
|
|
1120
1115
|
**Workspace only**: yes
|
|
1121
|
-
**Description**:
|
|
1122
|
-
https://bit.dev/docs/workspace/workspace-status
|
|
1116
|
+
**Description**: present the current status of components in the workspace, and notifies when issues are detected
|
|
1123
1117
|
|
|
1124
1118
|
`bit status`
|
|
1125
1119
|
|
|
@@ -1134,35 +1128,35 @@ https://bit.dev/docs/workspace/workspace-status
|
|
|
1134
1128
|
|
|
1135
1129
|
**Alias**: `t`
|
|
1136
1130
|
**Workspace only**: yes
|
|
1137
|
-
**Description**:
|
|
1131
|
+
**Description**: create an immutable and exportable component snapshot, tagged with a release version.
|
|
1138
1132
|
if no ids are provided, it will tag all new and modified components.
|
|
1139
1133
|
if component ids are entered, you can specify a version per id using "@" sign, e.g. bit tag foo@1.0.0 bar@minor baz@major
|
|
1140
1134
|
https://bit.dev/components/tags
|
|
1141
1135
|
you can use a pattern for multiple ids, such as bit tag "utils/\*". (wrap the pattern with quotes to avoid collision with shell commands)
|
|
1142
1136
|
|
|
1143
|
-
`bit tag [
|
|
1144
|
-
|
|
1145
|
-
| **Option** | **Option alias** | **Description**
|
|
1146
|
-
| ---------------------------- | :--------------: |
|
|
1147
|
-
| `--message <message>` | `-m` | log message describing
|
|
1148
|
-
| `--unmodified` | | include unmodified components (by default, only new and modified components are tagged)
|
|
1149
|
-
| `--editor [editor]` | | EXPERIMENTAL. open an editor to
|
|
1150
|
-
| `--ver <version>` | `-v` | tag with the given version
|
|
1151
|
-
| `--increment <level>` | `-l` | options are: [major, premajor, minor, preminor, patch, prepatch, prerelease], default to patch
|
|
1152
|
-
| `--prerelease-id <id>` | | prerelease identifier (e.g. "dev" to get "1.0.0-dev.1")
|
|
1153
|
-
| `--patch` | `-p` | syntactic sugar for "--increment patch"
|
|
1154
|
-
| `--minor` | | syntactic sugar for "--increment minor"
|
|
1155
|
-
| `--major` | | syntactic sugar for "--increment major"
|
|
1156
|
-
| `--snapped` | | EXPERIMENTAL. tag components that their head is a snap (not a tag)
|
|
1157
|
-
| `--pre-release [identifier]` | | DEPRECATED. use "-l prerelease" (and --prerelease-id) instead
|
|
1158
|
-
| `--skip-tests` | | skip running component tests during tag process
|
|
1159
|
-
| `--skip-auto-tag` | | skip auto tagging dependents
|
|
1160
|
-
| `--soft` | | do not persist. only keep note of the changes to be made
|
|
1161
|
-
| `--persist` | | persist the changes generated by --soft tag
|
|
1162
|
-
| `--disable-tag-pipeline` | | skip the tag pipeline to avoid publishing the components
|
|
1163
|
-
| `--force-deploy` | | run the tag pipeline although the build failed
|
|
1164
|
-
| `--increment-by <number>` | | (default to 1) increment semver flag (patch/minor/major) by. e.g. incrementing patch by 2: 0.0.1 -> 0.0.3.
|
|
1165
|
-
| `--ignore-issues [issues]` | `-i` | ignore component issues (shown in "bit status" as "issues found"), issues to ignore:
|
|
1137
|
+
`bit tag [component-names...]`
|
|
1138
|
+
|
|
1139
|
+
| **Option** | **Option alias** | **Description** |
|
|
1140
|
+
| ---------------------------- | :--------------: | ------------------------------------------------------------------------------------------------------------------------------ |
|
|
1141
|
+
| `--message <message>` | `-m` | a log message describing latest changes |
|
|
1142
|
+
| `--unmodified` | | include unmodified components (by default, only new and modified components are tagged) |
|
|
1143
|
+
| `--editor [editor]` | | EXPERIMENTAL. open an editor to write a tag message for each component. optionally, specify the editor-name (defaults to vim). |
|
|
1144
|
+
| `--ver <version>` | `-v` | tag with the given version |
|
|
1145
|
+
| `--increment <level>` | `-l` | options are: [major, premajor, minor, preminor, patch, prepatch, prerelease], default to patch |
|
|
1146
|
+
| `--prerelease-id <id>` | | prerelease identifier (e.g. "dev" to get "1.0.0-dev.1") |
|
|
1147
|
+
| `--patch` | `-p` | syntactic sugar for "--increment patch" |
|
|
1148
|
+
| `--minor` | | syntactic sugar for "--increment minor" |
|
|
1149
|
+
| `--major` | | syntactic sugar for "--increment major" |
|
|
1150
|
+
| `--snapped` | | EXPERIMENTAL. tag components that their head is a snap (not a tag) |
|
|
1151
|
+
| `--pre-release [identifier]` | | DEPRECATED. use "-l prerelease" (and --prerelease-id) instead |
|
|
1152
|
+
| `--skip-tests` | | skip running component tests during tag process |
|
|
1153
|
+
| `--skip-auto-tag` | | skip auto tagging dependents |
|
|
1154
|
+
| `--soft` | | do not persist. only keep note of the changes to be made |
|
|
1155
|
+
| `--persist` | | persist the changes generated by --soft tag |
|
|
1156
|
+
| `--disable-tag-pipeline` | | skip the tag pipeline to avoid publishing the components |
|
|
1157
|
+
| `--force-deploy` | | run the tag pipeline although the build failed |
|
|
1158
|
+
| `--increment-by <number>` | | (default to 1) increment semver flag (patch/minor/major) by. e.g. incrementing patch by 2: 0.0.1 -> 0.0.3. |
|
|
1159
|
+
| `--ignore-issues [issues]` | `-i` | ignore component issues (shown in "bit status" as "issues found"), issues to ignore: |
|
|
1166
1160
|
|
|
1167
1161
|
[MissingPackagesDependenciesOnFs, MissingComponents, UntrackedDependencies, ResolveErrors, RelativeComponents, RelativeComponentsAuthored, ParseErrors, MissingLinks, MissingDists, LegacyInsideHarmony, MissingDependenciesOnFs, MissingCustomModuleResolutionLinks, ImportNonMainFiles, CustomModuleResolutionUsed, MultipleEnvs, MissingLinksFromNodeModulesToSrc, CircularDependencies]
|
|
1168
1162
|
to ignore multiple issues, separate them by a comma and wrap with quotes. to ignore all issues, specify "\*".|
|
|
@@ -1193,19 +1187,19 @@ list components templates when inside bit-workspace (for bit-create), otherwise,
|
|
|
1193
1187
|
|
|
1194
1188
|
**Alias**: `at`
|
|
1195
1189
|
**Workspace only**: yes
|
|
1196
|
-
**Description**: test
|
|
1190
|
+
**Description**: test components in the workspace
|
|
1197
1191
|
|
|
1198
|
-
`bit test [pattern]`
|
|
1192
|
+
`bit test [component-pattern]`
|
|
1199
1193
|
|
|
1200
|
-
| **Option**
|
|
1201
|
-
|
|
|
1202
|
-
| `--watch`
|
|
1203
|
-
| `--debug`
|
|
1204
|
-
| `--all`
|
|
1205
|
-
| `--junit <filepath>`
|
|
1206
|
-
| `--coverage`
|
|
1207
|
-
| `--env <id>`
|
|
1208
|
-
| `--scope <scope>`
|
|
1194
|
+
| **Option** | **Option alias** | **Description** |
|
|
1195
|
+
| ---------------------- | :--------------: | -------------------------------------------------------------------- |
|
|
1196
|
+
| `--watch` | `-w` | start the tester in watch mode. |
|
|
1197
|
+
| `--debug` | `-d` | start the tester in debug mode. |
|
|
1198
|
+
| `--all` | `-a` | test all components, not only new and modified |
|
|
1199
|
+
| `--junit <filepath>` | | write tests results as JUnit XML format into the specified file path |
|
|
1200
|
+
| `--coverage` | | show code coverage data |
|
|
1201
|
+
| `--env <id>` | `-e` | test only the given env |
|
|
1202
|
+
| `--scope <scope-name>` | `-s` | name of the scope to test |
|
|
1209
1203
|
|
|
1210
1204
|
---
|
|
1211
1205
|
|
|
@@ -1272,9 +1266,9 @@ you can use a pattern for multiple ids, such as bit untag "utils/\*". (wrap the
|
|
|
1272
1266
|
## use
|
|
1273
1267
|
|
|
1274
1268
|
**Workspace only**: yes
|
|
1275
|
-
**Description**: set
|
|
1269
|
+
**Description**: set aspects in the workspace/scope config to make them loadable by the workspace/scope
|
|
1276
1270
|
|
|
1277
|
-
`bit use [ids...]`
|
|
1271
|
+
`bit use [component-ids...]`
|
|
1278
1272
|
|
|
1279
1273
|
---
|
|
1280
1274
|
|