gitignore_parser

gitignore_parser

A spec-compliant gitignore parser for Python

Installation

pip install gitignore_parser

Usage

Suppose /home/michael/project/.gitignore contains the following:

__pycache__/
*.py[cod]

Then:

>>> from gitignore_parser import parse_gitignore
>>> matches = parse_gitignore('/home/michael/project/.gitignore')
>>> matches('/home/michael/project/main.py')
False
>>> matches('/home/michael/project/main.pyc')
True
>>> matches('/home/michael/project/dir/main.pyc')
True
>>> matches('/home/michael/project/__pycache__')
True

Alternatively, you can use the parse_gitignore_str function:

>>> from gitignore_parser import parse_gitignore_str
>>> matches = parse_gitignore_str(
    '__pycache__/\n*.py[cod]', base_dir='/home/michael/project')
>>> matches('/home/michael/project/main.py')
False
>>> matches('/home/michael/project/main.pyc')
True

Motivation

I couldn’t find a good library for doing the above on PyPI. There are several other libraries, but they don’t seem to support all features, be it the square brackets in *.py[cod] or top-level paths /....

Contributing

I’m very open to merging PRs. But before you start working on one, please read through my guidelines for PRs. It will save us both time and unnecessary effort.

Attribution

The implementation is based on https://github.com/snark/ignorance/ by Steve Cook.