@lerna/global-options - npm Package Compare versions

Comparing version 3.0.0-beta.13 to 3.0.0-rc.0

CHANGELOG.md

@@ -6,2 +6,19 @@ # Change Log
 
+<a name="3.0.0-rc.0"></a>
+# [3.0.0-rc.0](https://github.com/lerna/lerna/compare/v3.0.0-beta.21...v3.0.0-rc.0) (2018-07-27)
+
+
+### Bug Fixes
+
+* **cli:** Pass global defaults into option factory instead of yargs.config() ([cf4008a](https://github.com/lerna/lerna/commit/cf4008a)), closes [#1449](https://github.com/lerna/lerna/issues/1449)
+
+
+### Features
+
+* **cli:** Upgrade to Yargs 12 ([7899ab8](https://github.com/lerna/lerna/commit/7899ab8))
+
+
+
+
+
 <a name="3.0.0-beta.13"></a>
@@ -8,0 +25,0 @@ # [3.0.0-beta.13](https://github.com/lerna/lerna/compare/v3.0.0-beta.12...v3.0.0-beta.13) (2018-03-31)

index.js

@@ -5,7 +5,7 @@ "use strict";
 
-function globalOptions(yargs) {
+function globalOptions(yargs, { ci = false, loglevel = "info", progress = true }) {
   // the global options applicable to _every_ command
   const opts = {
     loglevel: {
-      defaultDescription: "info",
+      default: loglevel,
       describe: "What level of logs to report.",
@@ -15,2 +15,3 @@ type: "string",
     concurrency: {
+      defaultDescription: "4",
       describe: "How many processes to use when lerna parallelizes tasks.",
@@ -23,18 +24,15 @@ type: "number",
       type: "boolean",
-      default: undefined,
     },
     progress: {
-      defaultDescription: "true",
+      default: !ci && progress,
       describe: "Enable progress bars. Pass --no-progress to disable. (Always off in CI)",
       type: "boolean",
-      default: undefined,
     },
     sort: {
-      defaultDescription: "true",
+      default: true,
       describe: "Sort packages topologically (all dependencies before dependents).",
       type: "boolean",
-      default: undefined,
     },
     "max-buffer": {
-      describe: "Set max-buffer(bytes) for Command execution",
+      describe: "Set max-buffer (in bytes) for subcommand execution",
       type: "number",
@@ -52,3 +50,3 @@ requiresArg: true,
     .option("ci", {
-      // set in core/cli via .config()
+      default: ci,
       hidden: true,
@@ -55,0 +53,0 @@ type: "boolean",

package.json

 {
   "name": "@lerna/global-options",
-  "version": "3.0.0-beta.13",
+  "version": "3.0.0-rc.0",
   "description": "Global options applicable to _every_ lerna sub-command",
@@ -32,3 +32,3 @@ "keywords": [
   },
-  "gitHead": "4cae54bce76bf156e71a2881418104c442f97c62"
+  "gitHead": "1ab24c152d3ff5c2b9453bcaafeb4b5e432b2410"
 }

README.md

@@ -5,4 +5,39 @@ # `@lerna/global-options`
 
-## Usage
+## Options
 
-TODO
+### `--concurrency`
+
+How many threads to use when Lerna parallelizes the tasks (defaults to `4`)
+
+```sh
+$ lerna publish --concurrency 1
+```
+
+### `--loglevel <silent|error|warn|success|info|verbose|silly>`
+
+What level of logs to report. On failure, all logs are written to lerna-debug.log in the current working directory.
+
+Any logs of a higher level than the setting are shown. The default is "info".
+
+### `--max-buffer <bytes>`
+
+Set a max buffer length for each underlying process call. Useful for example
+when someone wants to import a repo with a larger amount of commits while
+running `lerna import`. In that case the built-in buffer length might not
+be sufficient.
+
+### `--no-sort`
+
+By default, all tasks execute on packages in topologically sorted order as to respect the dependency relationships of the packages in question. Cycles are broken on a best-effort basis in a way not guaranteed to be consistent across Lerna invocations.
+
+Topological sorting can cause concurrency bottlenecks if there are a small number of packages with many dependents or if some packages take a disproportionately long time to execute. The `--no-sort` option disables sorting, instead executing tasks in an arbitrary order with maximum concurrency.
+
+This option can also help if you run multiple "watch" commands. Since `lerna run` will execute commands in topologically sorted order, it can end up waiting for a command before moving on. This will block execution when you run "watch" commands, since they typically never end. An example of a "watch" command is [running `babel` with the `--watch` CLI flag](https://babeljs.io/docs/usage/cli/#babel-compile-files).
+
+### `--reject-cycles`
+
+Fail immediately if a cycle is found (in `bootstrap`, `exec`, `publish` or `run`).
+
+```sh
+$ lerna bootstrap --reject-cycles
+```

New alerts

License Policy Violation

License

This package is not allowed per your license policy. Review the package's license to ensure compliance.

Found 1 instance in 1 package

Fixed alerts

License Policy Violation

License

This package is not allowed per your license policy. Review the package's license to ensure compliance.

Found 1 instance in 1 package

Improved metrics

Total package byte prevSize

6337

increased by109.7%

Number of package files

5

increased by25%

Number of lines in readme file

43

increased by437.5%

Worsened metrics

Lines of code

47

decreased by-4.08%

No dependency changes