NAME

App::lcpan::Manual::Cookbook - App::lcpan cookbook

VERSION

version 1.065.000

DESCRIPTION

Items relevant to CPAN authors are tagged with [author].

QUERYING AUTHORS

Listing recent authors

TODO.

Sampling some random authors (1.063+)

 % lcpan authors    --random --result-limit 100
 % lcpan authors -l --random --result-limit 100

QUERYING DEPENDENCIES

Checking if you currently specify a dependency to a "non-existing" (unindexed) module in one of your distributions [author] [item-dep-1]

 % lcpan deps-unindexed --dist-author YOUR-CPAN-ID

This requires you installing App::lcpan::CmdBundle::deps.

A "non-existing" module simply means that the module (the dependency) is not currently listed in 02packages.details.txt.gz. The dependency could be mispelled. Or the module has been purged from CPAN, either accidentally or deliberately. Or PAUSE index was momentarily incomplete or corrupt (this happens from time to time). In this case, if you happen to maintain the module yourself, you can request a PAUSE reindex ("pause reindex" if using pause).

Checking if your distribution depends on a non-core Perl module [author]

 % lcpan deps YOUR-DIST --exclude-core

Checking if your distribution depends on a "non-existing" (unindexed) module [author]

 % lcpan deps YOUR-DIST --exclude-indexed

See also: [item-dep-1].

Checking if your distribution specifies a circular dependency

TODO.

Finding out if there is any broken prerequisites specified by one of your distributions [author]

To find out which prerequisites that your distributions specify but are currently not indexed (i.e. probably cannot be installed by users):

 % lcpan author-deps YOUR-CPAN-ID --broken --dont-uniquify

Listing distributions of other CPAN authors that depend on one of your modules [author]

    % lcpan author-rdeps YOUR-CPAN-ID --user-author-isnt YOUR-CPAN-ID

Listing distributions of other CPAN authors that recently depend on one of your modules [author]

    # Show dependencies that were added in the last 2 weeks
    % lcpan author-rdeps YOUR-CPAN-ID --user-author-isnt YOUR-CPAN-ID --added-since '2 weeks ago'

    # Show dependencies that were updated in the last 2 weeks
    % lcpan author-rdeps YOUR-CPAN-ID --user-author-isnt YOUR-CPAN-ID --updated-since '2 weeks ago'

    # Show dependencies that were not present before your last 'lcpan update'
    % lcpan author-rdeps YOUR-CPAN-ID --user-author-isnt YOUR-CPAN-ID --added-in-last-update

Showing what other distributions you will have to download and install when you install a module

TODO.

QUERYING DISTRIBUTIONS

Listing recent distributions

TODO

Sampling some random distributions (1.063+)

 % lcpan dists    --random --result-limit 100
 % lcpan dists -l --random --result-limit 100

QUERYING MENTIONS

Finding out who (which script's or module's POD) mentions your module [author]

 % lcpan mentions-for-mod YOUR-MODULE

Finding out who (which script's or module's POD) mentions your script [author]

 % lcpan mentions-for-script YOUR-SCRIPT

QUERYING MODULES

Comparing version of installed modules vs local CPAN versions

 % lcpan ver-cmp-installed
 % lcpan ver-cmp-installed --older-than-db                ;# outdated modules (modules that need to be updated)
 % lcpan ver-cmp-installed --older-than-db --exclude-core ;# noncore outdated modules (noncore modules that need to be updated)

The ver-cmp-installed subcommand is distributed in App::lcpan::CmdBundle::ver.

This can also be done using tools like cpan-outdated (from App::cpanoutdated) or cpan-outdated-coro (from App::cpanoutdated::coro).

To update outdated modules:

 % lcpan-ver-cmp-installed --older-than-db | td select module | lcpanm -n

td is provided by App::td.

Listing recent modules

    # Show modules that were added in the last 2 weeks
    % lcpan mods -l --added-since '2 weeks ago'

    # Show modules that were updated in the last 2 weeks
    % lcpan mods -l --updated-since '2 weeks ago'

    # Show modules that were not present before the last 'lcpan update'
    % lcpan mods -l --added-in-last-index-update

There's also lcpan whatsnew.

Sampling some random modules (1.063+)

 % lcpan mods    --random --result-limit 100
 % lcpan mods -l --random --result-limit 100

You like Sub::Exporter and wonder what other modules might be similar or related to it:

    % lcpan related-mods Sub::Exporter

The related-mods subcommand uses the degree of being mentioned together as a proxy for relatedness. If you want to see in which POD documents the module and related module are being mentioned together, you can add `--with-content-paths` option.

QUERYING RELEASES

Listing recent releases

TODO.

Sampling some random releases (1.063+)

 % lcpan rels    --random --result-limit 100
 % lcpan rels -l --random --result-limit 100

AUTHOR

perlancar <perlancar@cpan.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 2021, 2020 by perlancar@cpan.org.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.