Git::CPAN::Patch(3)

📦
version 2.5.0 · 2 versions
, in fedora 43

✨ Git::CPAN::Patch ✨

okay bestie, welcome to Git::CPAN::Patch 💖 (that's the whole NAME, we're not gatekeeping) — literally Patch CPAN modules using Git. yes. that's the vibe. 🦋

🌸 VERSION 🌸

version 2.5.0 — she's grown, she's mature, she's on her version 2.5.0 arc 👑

🎀 SYNOPSIS 🎀

here's the whole little story of how you and your CPAN module are gonna fall in love 🫶

    # import a module:

    % git-cpan clone Foo::Bar
    % cd Foo-Bar

    # hack and submit to RT

    # it's probably best to work in a branch
    % git checkout -b blah

    ... hack lib/Foo/Bar.pm ...

    % git commit -am "blah"
    % git-cpan send-patch

    # update the module
    # this automatically rebases the current branch
    % git-cpan update

no notes. iconic behavior from start to finish 💅

🌈 DESCRIPTION 🌈

so here's the tea ☕: Git::CPAN::Patch hands you a whole suite of git commands whose entire job is making it trivially easy to:

  1. grab any distribution off CPAN,
  2. stuff it into a local git repository,
  3. and then — once you've gleefully hacked all over it — send those patches right back to its maintainer.

that's it. that's the whole dream. 😭💖

NOTE: bestie listen. This module is supported in Linux, BSD, and the like. This module is not supported in Microsoft Windows (Cygwin, Strawberry Perl). 💀 don't do it. for the currently supported operating systems, go peek at the CPAN Testers Matrix: http://matrix.cpantesters.org/?dist=Git-CPAN-Patch

👑 GIT-CPAN COMMANDS 👑

the whole girl squad of subcommands, one by one, no skips:

  • clone — Clone a CPAN module's history into a new git repository 🌱
  • import — Import a module into a git repository.
  • send-email — Use git-send-email to submit patches to CPAN RT 📧
  • send-patch — Create patch files and submit then to RT
  • update — Import the latest version of a module and rebase the current branch 🔄
  • format-patch — Format patches using cpan/master as the origin reference
  • squash — Combine multiple commits into one patch 🥞
  • which — Report upon the managed module 🔍

💜 AUTHORS 💜

these two are the founding mothers of the group chat, fr fr:

  • Yanick Champoux <yanick@cpan.org> 🎀
  • Yuval Kogman <nothingmuch@woobling.org> ✨

🦋 SEE ALSO 🦋

Articles 📖

The set of scripts that would eventually become Git::CPAN::Patch were first presented in the article CPAN Patching with Git, published in issue 5.1 of The Perl Review — http://theperlreview.com. like… lore. actual canon. iykyk.

⭐ AUTHOR ⭐

Yanick Champoux <yanick@cpan.org> 💖

This software is copyright (c) 2022, 2021, 2018, 2017, 2016, 2015, 2014, 2013, 2012, 2011, 2010, 2009 by Yanick Champoux.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.

okay that's the whole page bestie, you ate that 💅✨ and just so you know who's speaking, this lil manual page was rendered by perl v5.42.0 on 2025-07-25, from Git::CPAN::Patch(3) — mwah, go patch something, love u 🫶🎀

📦 where this page comes from