DistZilla from one newb to another

DistZilla is a powerful Perl tool to automate a lot of the drudgery that goes into getting a library of code ready to share on CPAN. Although DistZilla is very powerful, it has a steep learning curve and some sharp corners.

This talk is aimed at helping new DistZilla users get up to speed quickly.

Transcript

1. DistZilla! From one newb to another! ! ! Mark Allen! mrallen1@yahoo.com! @bytemeorg! http://byte-me.org! https://github.com/mrallen1! https://metacpan.org/author/MALLEN!
2. What is DistZilla?! !
3. What is DistZilla?! ! Automating CPAN releases!!
4. ExtUtils:MakeMaker! !
5. Module::Build! !
6. Module::Install! !
7. Module::Starter! !
8. TMTOWTDI! (of course)! ! Module::Release! ShipIt!
9. So, why DistZilla exactly?! !
11. But! DistZilla is a little complex! ! That's a feature, not a bug.!
12. DistZilla in 5 easy steps! !
13. DistZilla in 5 easy steps! !
14. DistZilla in 5 easy steps! ! OK, it's really not that bad.!
15. Step 1: Collect Underpants! Step 2: ?! Step 3: Profit!
16. Step 1: Collect Underpants! Step 2: ?! Step 3: Profit!
17. Step 1: Setup! $ cpanm Dist::Zilla # Time passes... $ dzil setup
18. Step 1: Setup! # ~/.dzil/config.ini [%User] name = Mark Allen email = mrallen1@yahoo.com [%Rights] license_class = Perl_5 copyright_holder = Mark Allen
19. Step 2: "Minting"! $ dzil new My-Thingy [DZ] making target dir /private/tmp/My-Thingy [DZ] writing files to /private/tmp/My-Thingy [DZ] dist minted in ./My-Thingy
20. Step 2: "Minting"! My-Thingy/ ├── dist.ini └── lib └── My └── Thingy.pm
21. Step 2: "Minting"! # My-Thingy/dist.ini name = My-Thingy author = Mark Allen <mrallen1@yahoo.com> license = Perl_5 copyright_holder = Mark Allen copyright_year = 2012 version = 0.001 [@Basic]
22. Step 2: "Minting"! # My-Thingy/dist.ini name = My-Thingy author = Mark Allen <mrallen1@yahoo.com> license = Perl_5 copyright_holder = Mark Allen copyright_year = 2012 version = 0.001 [@Basic] # <- What is that?!
23. Step 2: "Minting"! # My-Thingy/lib/My/Thingy.pm use strict; use warnings; package My::Thingy; 1;
24. Credit:  Flickr/sualk61  
25. Step 2: "Minting"! Other options:! •  Run git init •  Make a Github repo! •  "Better" initial module file(s)! •  sudo make-me-a-sandwich
26. Step 3: Pod munging! ! Eliminate boilerplate by using!
27. Credit:  Flickr/uwehermann  
28. Step 3: Pod munging! =head1 NAME My::Thingy - #Winning! =head1 VERSION 0.01
29. Step 3: Pod munging! =over =item * frobulate This attribute indicates whether anything should be frobulated =back =cut
30. Step 3: Pod munging! =over =item frobulate() If C<frobulate> is true, this method will perturb various internal states for maximum Brownian motion. =back =cut
31. Step 3: Pod munging! # ABSTRACT: #Winning! =attr frobulate =method frobulate()
32. Credit:  Flickr/arnolouise  
33. Step 4: dist.ini! # My-Thingy/dist.ini name = My-Thingy author = Mark Allen <mrallen1@yahoo.com> license = Perl_5 copyright_holder = Mark Allen copyright_year = 2012 version = 0.001 [@Basic] # <- What is that?!
34. Step 4: dist.ini! # My-Thingy/dist.ini name = My-Thingy author = Mark Allen <mrallen1@yahoo.com> license = Perl_5 copyright_holder = Mark Allen copyright_year = 2012 version = 0.001 [@Basic] # <- What is that?! •  GatherDir   •  PruneCru;   •  ManifestSkip   •  MetaYAML   •  License   •  Readme   •  ExtraTests   •  ExecDir   •  ShareDir   •  MakeMaker   •  Manifest   •  TestRelease   •  ConfirmRelease   •  UploadToCPAN  
35. Step 4: dist.ini! Useful plugins:! •  NextRelease (Changelog)! •  PkgVersion (Sets $VERSION)! •  ReadmeAnyFromPod! •  AutoPrereqs!
36. Step 4: dist.ini! More useful plugins:! •  AutoMetaResources! •  GitHub::Update! •  @Git! •  @Filter!
37. Step 4: dist.ini! Some guidelines:! •  Plugin order matters (sometimes)! •  Source code is your friend! •  Often web search is your best friend! •  Might have to play around to get it perfect!
38. Step 5: dzil commands! $ dzil authordeps | cpanm
39. Step 5: dzil commands! $ dzil test -or- $ prove -l[vr]
40. Step 5: dzil commands! $ dzil build
41. Step 5: dzil commands! $ dzil release
44. dist.ini Walkthrough! [NextRelease] format = %-9v %{yyyy-MM-dd}d [@Git] allow_dirty = README.md allow_dirty = dist.ini allow_dirty = Changes [@Filter] bundle = @Basic remove = Readme
45. dist.ini Walkthrough! [MetaJSON] [AutoMetaResources] bugtracker.rt = 1 repository.github = user:mrallen1;lcdist:Net-CronIO homepage = https://metacpan.org/dist/%{dist} [ReadmeFromPod] [ReadmeAnyFromPod] type = markdown filename = README.md location = root [PkgVersion] [PodWeaver] [AutoPrereqs]
46. DistZilla Resources! •  http://tinyurl.com/dziltalk
 links to everything you've seen! •  http://dzil.org! !
47. DistZilla Resources! https://github.com/mrallen1/Net-CronIO! ! Clone and experiment. Start with 'post-minting' tag and explore.!
48. Thank You!! !