Wondering what’s next for npm?Check out our public roadmap! »

    dependents-cli

    1.0.0 • Public • Published

    dependents-cli NPM version NPM monthly downloads NPM total downloads

    CLI for listing an npm module's dependent projects and their download stats.

    You might also be interested in module-dependents.

    Install

    Install globally with npm

    $ npm install --global dependents-cli

    Usage

    Once installed globally, there will be a dependents command that can be run from the command line.

    To see all the dependents for a module, specify the module name after the dependents command like this:

    $ dependents base

    This will output a JavaScript array containing each dependent as an object with name and dependency version properties. The dependency version property key will be the specified module name with -version after it. So base-version for the command specified above.

    Example output from running $ dependents base:

    image

    Formatting

    Use the --format option to format the results as a table (this is the default).

    Run the following command to the dependents formatted as a table:

    $ dependents base --format

    image

    You can also include the download counts when using formatting:

    $ dependents base --downloads --format

    image

    If you need to use the results as a JSON object, use the --format command with json after it:

    $ dependents base --format json
    [
      { "name": "base-app", "base-version": "^0.11.1" },
      { "name": "base-reporter", "base-version": "^0.11.0" },
      { "name": "benchmarked", "base-version": "^0.8.1" },
      { "name": "boilerplate", "base-version": "^0.11.1" },
      { "name": "expand-files", "base-version": "^0.11.1" },
      { "name": "expand-target", "base-version": "^0.11.1" },
      { "name": "npm-api", "base-version": "^0.8.1" },
      { "name": "saffronapp", "base-version": "file:packages/base" },
      { "name": "scaffold", "base-version": "^0.11.1" },
      { "name": "templates", "base-version": "^0.11.1" },
      { "name": "verbiage", "base-version": "^0.8.1" },
      { "name": "vinyl-collection", "base-version": "^0.11.0" },
      { "name": "vinyl-item", "base-version": "^0.8.1" }
    ]

    This can be output to a json file using the bash > character:

    $ dependents base --format json > base-dependents.json

    Use this with the --downloads option to be able to use the json data and do your own sorting and filtering if necessary.

    $ dependents base --format json --downloads > base-dependents.json

    Downloads

    To include the download counts of each of the dependents, use the --downloads option. This will add a downloads object to each dependent with the total and last30 (last 30 days) download counts:

    $ dependents base --downloads --format json
    [
      { "name": "templates", "base-version": "^0.11.1", "downloads": { "total": 124383, "last30": 14517 } },
      { "name": "benchmarked", "base-version": "^0.8.1", "downloads": { "total": 528830, "last30": 5301 } },
      { "name": "vinyl-item", "base-version": "^0.8.1", "downloads": { "total": 6045, "last30": 5019 } },
      { "name": "expand-target", "base-version": "^0.11.1", "downloads": { "total": 4341, "last30": 577 } },
      { "name": "scaffold", "base-version": "^0.11.1", "downloads": { "total": 4212, "last30": 532 } },
      { "name": "boilerplate", "base-version": "^0.11.1", "downloads": { "total": 8845, "last30": 478 } },
      { "name": "base-app", "base-version": "^0.11.1", "downloads": { "total": 1091, "last30": 471 } },
      { "name": "expand-files", "base-version": "^0.11.1", "downloads": { "total": 7235, "last30": 399 } },
      { "name": "npm-api", "base-version": "^0.8.1", "downloads": { "total": 629, "last30": 52 } },
      { "name": "base-reporter", "base-version": "^0.11.0", "downloads": { "total": 103, "last30": 16 } },
      { "name": "vinyl-collection", "base-version": "^0.11.0", "downloads": { "total": 101, "last30": 15 } },
      { "name": "verbiage", "base-version": "^0.8.1", "downloads": { "total": 77, "last30": 7 } },
      { "name": "saffronapp", "base-version": "file:packages/base", "downloads": { "total": 112, "last30": 5 } }
    ]

    When using the --downloads option, the list is sorted by the downloads.last30 property so the most used dependents will be found at the top.

    About

    Related projects

    Contributing

    Pull requests and stars are always welcome. For bugs and feature requests, please create an issue.

    Contributors

    Commits Contributor
    18 doowb
    1 panva

    Building docs

    (This project's readme.md is generated by verb, please don't edit the readme directly. Any changes to the readme must be made in the .verb.md readme template.)

    To generate the readme, run the following command:

    $ npm install -g verbose/verb#dev verb-generate-readme && verb

    Running tests

    Running and reviewing unit tests is a great way to get familiarized with a library and its API. You can install dependencies and run tests with the following command:

    $ npm install && npm test

    Author

    Brian Woodward

    License

    Copyright © 2017, Brian Woodward. Released under the MIT License.


    This file was generated by verb-generate-readme, v0.6.0, on June 21, 2017.

    Install

    npm i dependents-cli

    DownloadsWeekly Downloads

    7

    Version

    1.0.0

    License

    MIT

    Last publish

    Collaborators

    • avatar
    • avatar