Automates Build and Release

Start with your dist

My-Basic-Dist

lib/My/Basic/Dist.pm
t/dist.t

Dist information

name                = My-Basic-Dist
abstract            = A basic dist to try Dist::Zilla
author              = Doug Bell <preaction@cpan.org>
license             = Perl_5
copyright_holder    = Doug Bell <preaction@cpan.org>
copyright_year      = 2015

version             = 0.001

[@Basic]

Dist::Zilla::PluginBundle::Basic

Dzil docs on new dists

$ cd My-Basic-Dist
$ dzil build
[DZ] beginning to build My-Basic-Dist
[DZ] writing My-Basic-Dist in My-Basic-Dist-0.001
[DZ] building archive with Archive::Tar::Wrapper
[DZ] writing archive to My-Basic-Dist-0.001.tar.gz

$ dzil test
[DZ] building distribution under .build/RlLpqtqrdY for installation
[DZ] beginning to build My-Basic-Dist
[DZ] writing My-Basic-Dist in .build/RlLpqtqrdY
Checking if your kit is complete...
Looks good
Generating a Unix-style Makefile
Writing Makefile for My::Basic::Dist
Writing MYMETA.yml and MYMETA.json
cp lib/My/Basic/Dist.pm blib/lib/My/Basic/Dist.pm
PERL_DL_NONLAZY=1 "/usr2/local/perlbrew/perls/perl-5.16.3/bin/perl" "-MExtUtils::Command::MM" "-MTest::Harness" "-e" "undef *Test::Harness::Switches; test_harness(0, 'blib/lib', 'blib/arch')" t/*.t
t/dist.t .. ok
All tests successful.
Files=1, Tests=1,  0 wallclock secs ( 0.02 usr  0.04 sys +  0.01 cusr  0.03
csys =  0.10 CPU)
Result: PASS
[DZ] all's well; removing .build/RlLpqtqrdY

Configure PAUSE Account

$ cat ~/.pause
user PREACTION
password ********

Build

$ dzil release
[DZ] beginning to build My-Basic-Dist
[DZ] writing My-Basic-Dist in My-Basic-Dist-0.001
[DZ] building archive with Archive::Tar::Wrapper
[DZ] writing archive to My-Basic-Dist-0.001.tar.gz

Test

[@Basic/TestRelease] Extracting /home/nbkyslo/presentations/Introduction-to-Dist-Zilla-master/My-Basic-Dist/My-Basic-Dist-0.001.tar.gz to .build/5LUeKfVBIC
Checking if your kit is complete...
Looks good
Generating a Unix-style Makefile
Writing Makefile for My::Basic::Dist
Writing MYMETA.yml and MYMETA.json
cp lib/My/Basic/Dist.pm blib/lib/My/Basic/Dist.pm
PERL_DL_NONLAZY=1 "/usr2/local/perlbrew/perls/perl-5.16.3/bin/perl" "-MExtUtils::Command::MM" "-MTest::Harness" "-e" "undef *Test::Harness::Switches; test_harness(0, 'blib/lib', 'blib/arch')" t/*.t
t/dist.t .. ok
All tests successful.
Files=1, Tests=1,  0 wallclock secs ( 0.02 usr  0.03 sys +  0.02 cusr  0.02 csys =  0.09 CPU)
Result: PASS
[@Basic/TestRelease] all's well; removing .build/5LUeKfVBIC

Release

*** Preparing to release My-Basic-Dist-0.001.tar.gz with @Basic/UploadToCPAN ***

Do you want to continue the release process? [y/N]: y
[@Basic/UploadToCPAN] registering upload with PAUSE web server
[@Basic/UploadToCPAN] POSTing upload for My-Basic-Dist-0.001.tar.gz to https://pause.perl.org/pause/authenquery
[@Basic/UploadToCPAN] PAUSE add message sent ok [200]

Plugin Config

[Prereqs]
perl = 5.010
strict = 0
warnings = 0

Docs on configuring Prereqs

Test Requirements

[Prereqs / TestRequires]
Test::More = 0

$ dzil listdeps
ExtUtils::MakeMaker
strict
Test::More
warnings

$ dzil authordeps
Dist::Zilla::Plugin::Prereqs
Dist::Zilla::PluginBundle::Basic

dzil listdeps | cpanm

dzil listdeps --missing | cpanm

Before

package My::Versioned::Dist;

use strict;
use warnings;


1;

=head1 NAME

My::Versioned::Dist - A dist with version modifications

After!

package My::Versioned::Dist;
{ $My::Versioned::Dist::VERSION = '0.001'; }

use strict;
use warnings;


1;

=head1 NAME

My::Versioned::Dist - A dist with version modifications

=head1 VERSION

version 0.001

Introduction to Dist::Zilla