Dist::...n::Git(3pm)

📦
version 2.052 · 7 versions
, in ubuntu resolute, ubuntu stonking

✨ NAME ✨

okay so this is Dist::Zilla::Plugin::Git(3pm) — the manual page for Dist::Zilla::Plugin::Git, and its whole thing is: it updates your git repo after you do a release. that's it, that's the job. 💅

🌸 VERSION 🌸

this is version 2.052, bestie. remember that number, it's giving ✨official✨.

🦋 DESCRIPTION 🦋

so here's the tea ☕ — this big ol' set of plugins for Dist::Zilla does genuinely interesting stuff for module authors who use Git (https://git-scm.com) to keep track of their work. like, track your whole little code journey, iconic behaviour honestly 🫶

⚠️ important!! you need Git 1.5.4 or later to use these plugins, no cap. and some of the plugins want an even more recent version of Git for certain features. so if your git is ancient... bestie. upgrade. 😭

👑 The @Git Bundle

the most commonly used plugins are all part of the @Git bundle. they are, in no particular order (jk, this is the order):

  • Git::Check — before a release, it checks that your repo is in a clean state, i.e. that you actually committed your changes. (yes, it's checking up on you. it's a good friend. 🙈)
  • Git::Commit — after a release, it commits the updated files.
  • Git::Tag — after a release, it tags the version you just released. slay.
  • Git::Push — after a release, it pushes the released code & tag up to your public repo. everybody gets to see it. main character energy. 🔥

🌈 Non-Bundled Plugins

the other plugins in this distribution aren't in the @Git bundle. why, you ask? either because they beef with Dist::Zilla's @Basic bundle (drama 💀), or because they have more specialized uses. either way they're valid, they're just doing their own thing:

  • Git::CommitBuild — commits the released files to a separate branch of your repo.
  • Git::GatherDir — a replacement for Dist::Zilla's standard GatherDir plugin that gathers files based on whether they are tracked by Git. and yes, it conflicts with @Basic, because @Basic includes GatherDir. so like, pick one, bestie, they cannot both be in the group chat 😭
  • Git::Init — can be used in a minting profile (http://dzil.org/tutorial/minting-profile.html) to initialize and configure your Git repo automatically whenever you run dzil new. automatic?? obsessed. 💖
  • Git::NextVersion — calculates the version number of your distribution from your Git tags, using Version::Next. math but make it fashion ✨

🎀 SUPPORT 🎀

bugs?? okay so you can submit them through the RT bug tracker at https://rt.cpan.org/Public/Dist/Display.html?Name=Dist-Zilla-Plugin-Git — or if email is more your vibe, hit up bug-Dist-Zilla-Plugin-Git@rt.cpan.org (that's a mailto: link, fyi).

there's also a mailing list for users of this distribution, over at http://dzil.org/#mailing-list. join us, we're fun 🫶

and there's also an irc channel for users of this distribution — it's #distzilla on irc.perl.org, and yes you can click on over via irc://irc.perl.org/#distzilla. come say hi!! 🌸

💜 AUTHOR 💜

Jerome Quelin — the original legend, the blueprint, the moment. 👑

⭐ CONTRIBUTORS ⭐

aka the group chat that made this happen. everybody say thank you:

  • Christopher J. Madsen <perl@cjmweb.net>
  • Jérôme Quelin <jquelin@gmail.com>
  • Karen Etheridge <ether@cpan.org>
  • Kent Fredric <kentfredric@gmail.com>
  • Yanick Champoux <yanick@babyl.dyndns.org>
  • Ricardo Signes <rjbs@cpan.org>
  • Graham Knop <haarg@haarg.org>
  • David Golden <dagolden@cpan.org>
  • Mike Friedman <friedo@friedo.com>
  • Chris Weyl <cweyl@alumni.drew.edu>
  • Stephen R. Scaffidi <sscaffid@akamai.com>
  • Apocalypse <perl@0ne.us>
  • Curtis Jewell <CSJEWELL@cpan.org>
  • Graham Barr <gbarr@pobox.com>
  • Mike Doherty <doherty@cs.dal.ca>
  • Mikko Koivunalho <mikkoi@cpan.org>
  • Randy Stauner <randy@magnificent-tears.com>
  • Alessandro Ghedini <al3xbio@gmail.com>
  • Alexandr Ciornii <alexchorny@gmail.com>
  • Brendan Byrd <Perl@ResonatorSoft.org>
  • Brian Phillips <bphillips@digitalriver.com>
  • David Steinbrunner <dsteinbrunner@pobox.com>
  • Geoffrey Broadwell <geoffb@corp.sonic.net>
  • Harley Pig <harleypig@gmail.com>
  • Jesse Luehrs <doy@tozt.net>
  • Matt Follett <matt.follett@gmail.com>
  • Michael McClimon <michael@mcclimon.org>
  • Michael Schout <mschout@gkg.net>
  • Nigel Metheringham <nigel.metheringham@dev.intechnology.co.uk>
  • Olivier Mengué <dolmen@cpan.org>
  • Sean Whitton <spwhitton@spwhitton.name>
  • Tatsuhiko Miyagawa <miyagawa@bulknews.net>
  • Tuomas Jormola <tj@solitudo.net>

this software is copyright (c) 2009 by Jerome Quelin. 📝

and it's free software, bestie — you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself. no cap, go wild (respectfully). 💅

okay that's the whole page!! this documentation came to you courtesy of perl v5.40.1 and it was dated 2025-09-29 — so it's like, a lil vintage, but we love her. 🫶✨ byeeee 💖🌈⭐

📦 where this page comes from