@procedures/lib 0.2.3 → 0.3.0

package/CHANGELOG.md

@@ -1,5 +1,57 @@
 # @procedures/lib
 
+## 0.3.0
+
+### Minor Changes
+
+- 4d3ff39: `lib.graph` (roadmap R44) gives the dependency graph of the workspace packages. The nodes are the packages, and the edges are the dependencies with a `workspace:` specifier. The procedure finds the cycles, and gives the build levels of a graph without a cycle. It reads through `fs.readdir` and `fs.read.json`, and changes nothing.
+
+### Patch Changes
+
+- Updated dependencies [ddea529]
+- Updated dependencies [b2a3e3a]
+- Updated dependencies [a8c47f1]
+- Updated dependencies [381ce3a]
+- Updated dependencies [0c627f8]
+- Updated dependencies [ae7f05f]
+- Updated dependencies [7873940]
+- Updated dependencies [a70d445]
+- Updated dependencies [f23c7ad]
+- Updated dependencies [3c40d2d]
+- Updated dependencies [bc70357]
+- Updated dependencies [4cad9ab]
+- Updated dependencies [07cc998]
+- Updated dependencies [a6b01a9]
+- Updated dependencies [c799cdd]
+- Updated dependencies [540f8d9]
+- Updated dependencies [b6daaec]
+- Updated dependencies [5b9264e]
+- Updated dependencies [956e88b]
+- Updated dependencies [ff62281]
+- Updated dependencies [6e4de6c]
+- Updated dependencies [14d85fe]
+- Updated dependencies [d81d0ed]
+- Updated dependencies [aa67cc7]
+- Updated dependencies [061fa22]
+- Updated dependencies [cfb9d69]
+- Updated dependencies [43f7de5]
+- Updated dependencies [b07bb50]
+- Updated dependencies [4a3bfa1]
+- Updated dependencies [bd0b626]
+- Updated dependencies [95b660d]
+- Updated dependencies [a6be873]
+- Updated dependencies [fb30718]
+- Updated dependencies [c5528e4]
+- Updated dependencies [fee5d9c]
+- Updated dependencies [21f7743]
+- Updated dependencies [31a0b46]
+  - @procedures/client@0.3.0
+  - @procedures/fs@0.3.0
+  - @procedures/git@0.3.0
+  - @procedures/pnpm@0.3.0
+  - @procedures/shell@0.3.0
+  - @procedures/dag@0.3.0
+
 ## 0.2.3
 
 ### Patch Changes

package/README.md

@@ -14,6 +14,7 @@ npm install @procedures/lib
 | `lib.new` | Make a package from the template |
 | `lib.audit` | Compare each package with the template |
 | `lib.rename` | Rename a package in each file of the workspace |
+| `lib.graph` | Give the dependency graph of the workspace packages, with its cycles |
 | `ecosystem.procedures` | List the procedures of the packages |
 | `dag.traverse` | Start a procedure for each package, in the order of their dependencies |
 | `core.catch` | Start a deferred call, and give the error to a handler call |
@@ -70,6 +71,20 @@ The output also has `flagNotices`: the procedure flags whose short form is also
 
 Input: `oldName`, `newName`, `rootPath` and `dryRun`. The procedure changes the package name, the dependencies, the imports and the dynamic imports in the workspace. The output lists each change and gives a summary.
 
+## `lib.graph`
+
+Input: `rootPath`. The procedure reads the `package.json` of each folder in `packages/` through `fs.readdir` and `fs.read.json`. It changes nothing.
+
+- `nodes` has one item for each package: `name`, `folder`, `version` and `private`.
+- `edges` has one item for each dependency with a `workspace:` specifier: `from`, `to`, `kind` and `spec`. The kinds are `dependencies`, `devDependencies`, `peerDependencies` and `optionalDependencies`.
+- `cycles` lists each cycle as the names of its packages. A package that depends on itself is also a cycle. `acyclic` is true when the list is empty.
+- `levels` is the build order of a graph without a cycle. The packages of level 0 depend on no workspace package. Each package of a level depends only on packages of lower levels.
+- `warnings` lists the folders that the procedure cannot read, and each `workspace:` dependency on a name that is not in the workspace.
+
+```sh
+node packages/mark/dist/cli.js lib graph
+```
+
 ## `ecosystem.procedures`
 
 Input: `rootPath`, `namespace` and `includeMetadata`. The output lists the procedures of the packages that have a `client.procedures` field.