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

📦
version 0.90 · 7 versions
, in ubuntu stonking

💖 NAME 💖

okay bestie, so Git::Raw::PathSpec — it's the Git pathspec class from the Git::Raw family. that's the whole name. short, sweet, iconic. we're in the Git::Raw::PathSpec manual page, and this is your girl explaining it, no cap. 💅

✨ VERSION ✨

we're on version 0.90 — periodt. 🎀

🌸 DESCRIPTION 🌸

so a Git::Raw::PathSpec represents a Git pathspec. that's it, that's the vibe. it's the object that holds your pathspec so you can throw it at repos and indexes and trees and diffs and see what hits. 🦋

⚠️ WARNING, bestie, listen up: the API of this module is unstable and may change without warning. like, any change will be appropriately documented in the changelog, so it's not chaos chaos, but still — do not build your whole personality around it. 😭

🌈 METHODS 🌈

💜 new( @paths )

compile a brand new pathspec, fresh out the box. ✨

  • @paths — the list of paths to match.
lowkey the docs also call this list @match in the description, even though the signature says @paths. both are floating around in there, iykyk. 🙈

🧚 match( $object [, \%options] )

match the pathspec against $object. 💥 and $object can be any of these cuties, dependent on what you're matching against:

  • Git::Raw::Repository — matches against the working directory 🫶
  • Git::Raw::Index — matches against the index 🎀
  • Git::Raw::Tree — matches against the tree 🌸
  • Git::Raw::Diff — matches against the diff 💫

it returns a Git::Raw::PathSpec::MatchList object, and that's a whole other bestie to go meet.

the valid fields for %options are:

  • "flags" — the flags for the matches, bestie. the valid values include:
    • "ignore_case" — forces the match to ignore case. otherwise the match will use the native case sensitivity of the platform's filesystem. 👑
    • "use_case" — forces a case sensitive match. otherwise the match will use the native case sensitivity of the platform's filesystem. 🔥
    • "no_glob" — disables glob patterns and just uses simple string comparison for matching. no wildcards, just vibes. ✨
    • "no_match_error" — "math" should return an error code if no matches were found. 💀
    • "find_failures" — record patterns that did not match. 👀
    • "failures_only" — only determine if there were patterns that did not match. that's the whole job. 🎯

👑 AUTHOR 👑

the icons who made this:

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

give them their flowers. 💐

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. 📜

aaaaand that's a wrap, bestie!! 🌈✨ this page was brought to you by Git::R...thSpec from the User Contributed Perl Documentation, running on perl v5.42.3, dated 2026-08-19. slay, go match some paths, and remember: unstable API means stay flexible. 🫶💖 periodt.

📦 where this page comes from