NAME

this-dist - Return name of Perl distribution associated with the current directory

VERSION

This document describes version 0.011 of this-dist (from Perl distribution App-ThisDist), released on 2021-06-22.

SYNOPSIS

 % pwd
 /home/budi/perl-Foo-Bar

 % this-dist
 Foo-Bar

 # See how distribution is guessed
 % DEBUG=1 this-dist
 this-dist: Guessed dist=App-PPIUtils from dist.ini
 Foo-Bar

 # Will exit with code 1 and print error message to stderr when dist cannot be guessed
 % cd /
 % this-dist
 this-dist: No perl distribution name can be associated with current directory '/'

 # Don't show error message when guessing is failed (just exit with code 1)
 % this-dist -q
 % _

 # Also try to extract version
 % this-dist -V
 Foo-Bar 1.23

Some other examples:

 # Show MetaCPAN distribution page in browser (but see this-dist-on-metacpan script)
 % firefox metacpan.org/release/`this-dist`

DESCRIPTION

This script tries these methods when guessing Perl distribution name associated with current directory:

  • Distribution metadata {MYMETA,META}.{json,yml}

  • Makefile.PL, Makefile, Build.PL

  • Name in dist.ini (Dist::Zilla configuration file), if the file is available

  • CPAN::Info::FromURL against URLs in .git/config (git repository configuration file), if the file is available

  • CPAN::Dist::FromRepoName against current directory name

HOMEPAGE

Please visit the project's homepage at https://metacpan.org/release/App-ThisDist.

SOURCE

Source repository is at https://github.com/perlancar/perl-App-ThisDist.

BUGS

Please report any bugs or feature requests on the bugtracker website https://rt.cpan.org/Public/Dist/Display.html?Name=App-ThisDist

When submitting a bug or request, please include a test-file or a patch to an existing test-file that illustrates the bug or desired feature.

SEE ALSO

this-mod

this-dist-on-metacpan

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.