feat: export iterateDeps helper

README.md

@@ -4,7 +4,7 @@
 [![Maintainability](https://api.codeclimate.com/v1/badges/48b31cd38b905b729beb/maintainability)](https://codeclimate.com/github/semrel-extra/topo/maintainability)
 [![Test Coverage](https://api.codeclimate.com/v1/badges/48b31cd38b905b729beb/test_coverage)](https://codeclimate.com/github/semrel-extra/topo/test_coverage)
 
-Helper to resolve monorepo dependencies graph by package workspaces
+> Helpers to assist monorepo dependencies traversals
 
 ## Install
 ```shell
@@ -108,5 +108,25 @@ const cb = async (name: string) => {
 await traverseQueue({ queue, prev, cb })
 ```
 
+### `iterateDeps()`
+Walks through the package dependencies and applies the `cb()` for each.
+```ts
+const results: any[] = []
+const manifest = {
+  name: 'foo',
+  version: '0.0.0',
+  dependencies: {
+    bar: '1.0.0'
+  },
+  devDependencies: {
+    baz: '2.0.0'
+  }
+}
+
+iterateDeps(manifest, ({ name, version, scope, deps }) => {
+  results.push({ name, version, scope, deps })
+})
+```
+
 ## License
 [MIT](./LICENSE)

package.json

@@ -1,7 +1,7 @@
 {
   "name": "@semrel-extra/topo",
   "version": "1.13.1",
-  "description": "Helper to resolve monorepo dependencies graph",
+  "description": "Helpers to assist monorepo dependencies traversals",
   "publishConfig": {
     "access": "public"
   },

src/main/ts/topo.ts

@@ -251,7 +251,7 @@ export const traverseDeps = async ({
   await Promise.all(results)
 }
 
-const iterateDeps = (
+export const iterateDeps = (
   manifest: IPackageJson,
   cb: (ctx: IDepEntry & { deps: IPackageDeps }) => any,
   scopes = defaultScopes

src/test/ts/topo.ts

@@ -10,6 +10,7 @@ import {
   topo,
   traverseQueue,
   traverseDeps,
+  iterateDeps,
   ITopoOptions,
   IDepEntry,
   IPackageEntry,
@@ -408,4 +409,37 @@ test('`traversDeps` applies cb up to the deps tree', async () => {
   assert.equal(result, expected)
 })
 
+test('`iterateDeps` walks through the pkg deps', () => {
+  const results: any[] = []
+  const manifest = {
+    name: 'foo',
+    version: '0.0.0',
+    dependencies: {
+      bar: '1.0.0'
+    },
+    devDependencies: {
+      baz: '2.0.0'
+    }
+  }
+
+  iterateDeps(manifest, ({ name, version, scope, deps }) => {
+    results.push({ name, version, scope, deps })
+  })
+
+  assert.equal(results, [
+    {
+      name: 'bar',
+      version: '1.0.0',
+      scope: 'dependencies',
+      deps: manifest.dependencies
+    },
+    {
+      name: 'baz',
+      version: '2.0.0',
+      scope: 'devDependencies',
+      deps: manifest.devDependencies
+    }
+  ])
+})
+
 test.run()