NAME

    Dist::Zilla::PluginBundle::AVAR - Use Dist::Zilla like AVAR does

DESCRIPTION

    This is the plugin bundle that AVAR uses. Use it as:

        [@AVAR]
        ;; same as `name' earlier in the dist.ini (optional, detected from $dzil->name)
        dist = MyDist
        ;; If you're not avar (will be read from "git config github.user" or $ENV{GITHUB_USER} by default)
        github_user = imposter
        ;; Bugtracker github or rt, default is rt
        bugtracker = rt
        ;; custom homepage/repository, defaults to metacpan page and github repository lc($dist->name)
        homepage = http://example.com
        repository = http://git.example.com/repo.git
        ;; use various stuff or not
        no_AutoPrereq = 1 ; evil for this module
        use_MakeMaker = 0 ; If using e.g. MakeMaker::Awesome instead
        use_TestCompile = 0 ; I have my own compile tests here..
        ;; cpan:YOUR_CPAN_ID is the default authority, read from "dzil setup" entry for PAUSE
        ; authority = cpan:AVAR
        no_Authority = 0 ; If want to use the authority module (previously the default)
        ;; if you want to install your dist after release (set $ENV{PERL_CPANM_OPTS} if you need --sudo or --mirror etc.)
        ;; default is OFF
        install_command = cpanm .

    It's equivalent to:

        [@Filter]
        bundle = @Classic
        remove = PodVersion
        remove = PodCoverageTests
        
        [Git::NextVersion]
        [AutoPrereqs]
        [MetaJSON]
    
        [MetaNoIndex]
        ;; Only added if these directories exist
        directory = inc
        directory = t
        directory = xt
        directory = utils
        directory = example
        directory = examples
        
        [ReadmeFromPod]
    
        [MetaResources]
        ;; $github_user is 'avar' by default, $lc_dist is lc($dist)
        homepage   = http://search.cpan.org/dist/$dist/
        bugtracker.mailto = bug-$dist@rt.cpan.org
        bugtracker.web = https://rt.cpan.org/Public/Dist/Display.html?Name=$dist
        repository.web = http://github.com/$github_user/$lc_dist
        repository.url = git://github.com/$github_user/$lc_dist.git
        repository.type = git
        license    = http://dev.perl.org/licenses/
    
        [Authority]
        authority   = cpan:AVAR
        do_metadata = 1
        
        [NextRelease]
        format = %-2v %{yyyy-MM-dd HH:mm:ss}d
        
        [@Git]
        tag_format = %v
        version_regexp = '^(\d.*)$'
        first_version = '0.01'
    
        [InstallRelease]
        install_command = cpanm .

    If you'd like a minting profile (to create new modules with all the
    boilerplate) for this PluginBundle, check out:
    Dist::Zilla::MintingProfile::Author::Caelum.

SEE ALSO

      * Dist::Zilla

      * Dist::Zilla::PluginBundle::Git

      * Dist::Zilla::MintingProfile::Author::Caelum

AUTHOR

    Ævar Arnfjörð Bjarmason <avar@cpan.org>

LICENSE AND COPYRIGHT

    Copyright 2023 Ævar Arnfjörð Bjarmason <avar@cpan.org>

    This program is free software, you can redistribute it and/or modify it
    under the same terms as Perl itself.