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.23Some 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
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.