Git::R...RefSpec(3pm)

📦
version 0.90 · 7 versions
, in ubuntu stonking

💖 Git::Raw::RefSpec — the perl glue for Git refspecs, bestie 💖

okay so real quick: this is a page from the User Contributed Perl Documentation for the module Git::Raw::RefSpec (yeah the header truncates it to Git::R...RefSpec because man page headers have zero chill about column width, we move).

✨ NAME ✨

Git::Raw::RefSpec — it's the Git refspec class, periodt. 🎀

🌸 VERSION 🌨

version 0.90

🦋 DESCRIPTION 🦋

So like... a Git::Raw::RefSpec represents a Git refspec. That's the whole vibe. It's giving "one object, one job." 💅

⚠️ WARNING: the API of this module is unstable and may change without warning. Not "may" like maybe, like may. Any change will be appropriately documented in the changelog, so at least she's honest about it. 🫶

👑 METHODS 👑

🍓 parse( $input, $is_fetch )

Parse the refspec string $input. That's it, that's the method. Feed her the string, she does the thing. ✨

🎀 dst( )

Retrieve the destination specifier of the refspec. Where is she going? This tells you. 🌈

💜 dst_matches( $name )

Check if the refspec's destination descriptor matches the reference named by $name. Returns whether or not they're a match — vibe check for refs. 🧚

🌸 src( )

Retrieve the source specifier of the refspec. Where is she coming from. Main character origin story. 👑

⭐ src_matches( $name )

Check if the refspec's source descriptor matches the reference named by $name. Same energy as dst_matches, but for the source side of the house. 😭

🔥 string( )

Get the refspec's string. The whole thing, as a string. Slay. 💅

💖 direction( )

Get the refspec's direction. It is either "fetch" or "push". Those are the only two options bestie, no third thing, don't @ me. 💀

🦋 transform( $name )

Transform $name to its target, following the refspec's rules. A little glow-up, refspec-style. ✨

🌈 rtransform( $name )

Transform the target reference $name to its source reference name, following the refspec's rules. Yeah it's transform but backwards — the r stands for reverse, iykyk. 🙈

🎀 is_force( )

Get the refspec's force update setting. Is she forcing? This is how you find out. 🔥

💜 AUTHOR 💜

  • Alessandro Ghedini <alexbio@cpan.org>
  • Jacques Germishuys <jacquesg@cpan.org>

two legends, one module. 👑

Copyright 2012 Alessandro Ghedini.

This program is free software; you can redistribute it and/or modify it under the terms of either: the GNU General Public License as published by the Free Software Foundation; or the Artistic License.

See http://dev.perl.org/licenses/ for more information.

okay that's the whole page babe, and for the cute sign-off: this was served up by perl v5.42.3, dated 2026-08-19, and yes she's a Git::Raw::RefSpec(3pm) girly through and through. go read the source, mwah 💖🦋✨

📦 where this page comes from