NAME
this-dist - Return name of Perl distribution associated with the current directory
VERSION
This document describes version 0.006 of this-dist (from Perl distribution App-ThisDist), released on 2020-10-11.
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
% _Some recipes:
# Show metacpan distribution page in browser (requires L<lcpan> from L<App::lcpan>)
% lcpan metacpan-dist `this-dist`DESCRIPTION
This script tries these methods when guessing Perl distribution name associated with current directory:
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
FAQ
Where is this-mod?
For now you can use dist2mod:
% this-dist | dist2modHOMEPAGE
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.
AUTHOR
perlancar <perlancar@cpan.org>
COPYRIGHT AND LICENSE
This software is copyright (c) 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.