view release on metacpan or  search on metacpan

lib/Parse/Gitignore.pod  view on Meta::CPAN

    }

Check whether a file matches a .gitignore.

=head2 read_gitignore

    $pg->read_gitignore ('.gitignore');

Read a F<.gitignore> file. Because different directories in the same
git repository may feature their own F<.gitignore> files, the
information is accumulated in C<$pg> along with the specific directory
of the gitignore file relative to the top directory of the repository,
for example

    $pg->read_gitignore ("$top/.gitignore");
    $pg->read_gitignore ("$top/src/.gitignore");

If the suggested F<.gitignore> does not actually exist, a warning is
printed and processing continues. If the argument is a directory, the
module assumes that you intended to read a file called F<.gitignore>
in that directory.

=head2 excludesfile

    $pg->excludesfile ('/home/user/.gitignore');

Read an excludesfile which is applied to all directories where .git is
found.

=head1 DEPENDENCIES

=over

=item L<Carp>

Used to report errors.

=item L<File::Slurper/read_lines>

Used to read the gitignore file.

=item L<File::Spec>

Used to disambiguate file path names.

=back

=head1 SEE ALSO

=over

=item L<C<man gitignore>|https://git-scm.com/docs/gitignore>

=item L<C<man git-check-ignore>|https://git-scm.com/docs/git-check-ignore>

=back

=head1 HISTORY

I wrote this because I wanted to have a way to ignore generated files
for a desktop file search application.

Version 1.0 changes the way that subdirectories are dealt with. The
older versions turned out to have a problem whereby files in
subdirectories were not picked up correctly.



=head1 AUTHOR

Ben Bullock, <benkasminbullock@gmail.com>

=head1 COPYRIGHT & LICENCE

This package and associated files are copyright (C) 
2016-2024
Ben Bullock.

You can use, copy, modify and redistribute this package and associated
files under the Perl Artistic Licence or the GNU General Public
Licence.