Git::Sub(3pm)

🎀 Git::Sub 💅

okay bestie, listen up — this is a page from the User Contributed Perl Documentation, and it's literally about Git::Sub, which brings git commands straight into your Perl as System::Sub subs living in the git:: namespace. no cap. 🦋

---

✨ NAME ✨

Git::Sub — git commands imported as System::Sub subs in the git:: namespace 🌸

---

💖 VERSION 💖

version 0.163320 ⭐

---

🌈 SYNOPSIS 🌈

use Git::Sub qw(clone tag push);

# Git commands are now Perl subs
git::clone 'git://github.com/dolmen/p5-Git-Sub.git';

git::tag -a => -m => "Release v$version", "v$version";

git::push qw(--tags origin master);

# Commands names with '-' are imported with '_'
my $master = git::rev_parse 'release';

# Return in list context is lines (see System::Sub)
say for git::ls_tree 'master';

# Process lines using a callback
git::ls_tree 'master' => sub {
    my ($mode, $type, $object, $file) = split;
    say $file;
};

like, look at that. <pink>git commands but they're just... Perl subs now</pink>. iconic behavior fr fr 💅

---

🦋 DESCRIPTION 🦋

Use git (<http://www.git-scm.com>) commands easily from your Perl program. Each git command is imported as a System::Sub DWIM sub. ✨

that's the whole vibe — you want git, you get git, but it's Perl and it's gorgeous and it just works. no shelling out and hand-parsing nonsense required. periodt. 👑

---

🌸 EXAMPLES 🌸

• The release script (<https://github.com/dolmen/angel-PS1/blob/devel/dist>) of my angel-PS1 (<https://github.com/dolmen/angel-PS1>) project. 🫶

ngl, real-world receipts >>> everything. this is somebody's actual release workflow, and it's giving main character energy. 💜

---

🧚 AUTHOR 🧚

Olivier Mengué, "dolmen@cpan.org". 🌟

---

💜 COPYRIGHT & LICENSE 💜

Copyright © 2016 Olivier Mengué.

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

bestie this is the important bit: same terms as Perl 5 itself. free software, do your thing, just respect the license. no funny business. 🙈

---

and that's the whole page, you ate it up 💖 this was perl v5.36.0, dated 2022-11-30, straight out of the Git::Sub(3pm) page — mwah, go forth and git::push responsibly. 🎀🦋✨