NAME

cpan-dependents - Recursively find all reverse dependencies for a distribution or module

SYNOPSIS

  # List dependent distributions for module JSON::Tiny
  $ cpan-dependents JSON::Tiny
  
  # Output count of distributions dependent on module JSON::Tiny
  $ cpan-dependents -c JSON::Tiny
  
  # List dependent distributions for distribution JSON-Tiny
  $ cpan-dependents -D JSON-Tiny
  
  # List dependent distributions for distribution JSON-Tiny,
  # including "recommends" dependencies
  $ cpan-dependents --with-recommends JSON-Tiny

DESCRIPTION

Command-line script to list or count the dependent distributions for a particular CPAN distribution or module, using App::CPAN::Dependents. The first non-option argument is used as the target module or distribution. Dependent distributions will be output line by line when complete, or the total number of distributions will be output with the --count option.

If neither --module nor --dist are specified as options, the target will be tried first as a module, then as a distribution if unsuccessful.

This script uses the MetaCPAN API, and must perform several requests recursively, so it may take a long time (sometimes minutes) to complete. If the script encounters HTTP errors (including when querying a nonexistent module or distribution) or is unable to connect, it will die.

This script will only find distributions that explicitly list prerequisites in metadata; dynamic_config will not be used. Also, it assumes distributions are "well-behaved" and thus declare all provided modules in the provides metadata, and only modules which they are authorized to provide. Any distributions that do not follow this behavior may lead to incorrect results.

OPTIONS

-M, --module

Interpret target as module name.

-D, --dist

Interpret target as distribution name.

-c, --count

Display total count of dependent distributions instead of the list of distribution names.

--with-recommends

Include recommends prerequisites when finding dependents.

--with-suggests

Include suggests prerequisites when finding dependents.

--with-develop

Include develop phase prerequisites when finding dependents.

-d, --debug

Print debugging output to STDERR as it is retrieved.

AUTHOR

Dan Book, dbook@cpan.org

COPYRIGHT AND LICENSE

Copyright 2015, Dan Book.

This library is free software; you may redistribute it and/or modify it under the terms of the Artistic License version 2.0.

SEE ALSO

App::CPAN::Dependents, CPAN::Meta::Spec