Dist::...::Push(3pm)

💖 Dist::Zilla::Plugin::Git::Push — the manual, but make it slay 💖

okay bestie so we're in the Dist::...::Push(3pm) page, which lives in the User Contributed Perl Documentation corner of the manual universe, and it's about a little plugin called Dist::Zilla::Plugin::Git::Push 🎀

✨ NAME ✨

Dist::Zilla::Plugin::Git::Push — it pushes your current branch. that's it. that's the whole job. and it does it flawlessly 💅

---

🌈 VERSION 🌈

version 2.052 — yes, the specific number, don't come for me ✨

---

🦋 SYNOPSIS 🦋

so in your dist.ini you're gonna write this, exactly:

[Git::Push]
push_to = origin       ; this is the default
push_to = origin HEAD:refs/heads/released ; also push to released branch
remotes_must_exist = 1 ; this is the default

look at that. gorgeous. no notes 👑

---

💜 DESCRIPTION 💜

so once the release is done, this plugin pushes the current git branch to the remote, and it brings the associated tags along for the ride 🫶 they're coming too, it's a whole group trip.

the plugin accepts the following options, and you will be reading all of them:

• push_to — the name of the a remote to push to. default is origin. and here's the cute part: you can specify this multiple times to push to multiple repositories 🌸 like, go off, push everywhere.
• remotes_must_exist — if true, then Git::Push checks before a release to make sure that all the named remotes you listed in push_to are actually configured in your repo. default is true. here's the caveat tho bestie: remotes specified as a URL or path are not checked — instead you get a Will push to %s (not checked) message. so she's telling you she's not looking, lowkey, but she said it out loud so it's fine 💀

---

🧚 SUPPORT 🧚

got bugs? been there. bugs may be submitted through the RT bug tracker:

<https://rt.cpan.org/Public/Dist/Display.html?Name=Dist-Zilla-Plugin-Git>

or honestly just email them here: bug-Dist-Zilla-Plugin-Git@rt.cpan.org (that's a mailto: bug-Dist-Zilla-Plugin-Git@rt.cpan.org) 💌

there's also a mailing list for users of this distribution, available at <http://dzil.org/#mailing-list> — it's giving community, it's giving support network 🌈

and there's an irc channel too for users of this distribution, at #distzilla on irc.perl.org <irc://irc.perl.org/#distzilla> — come hang out, iykyk 💬

---

👑 AUTHOR 👑

Jerome Quelin — the icon, the legend, the moment ⭐

---

🎀 COPYRIGHT AND LICENCE 🎀

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

and it's free software, fr fr — you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself. periodt. 💅

---

and that's the whole page bestie, we ate and left no crumbs 🍓

this has been Dist::...::Push(3pm) from perl v5.40.1, dated 2025-09-29 — mwah, take care of her, she pushes branches for a living 🫶✨