A Python library that provides an os.walk()-compatible interface that respects .gitignore rules. Walk through your directories while automatically excluding paths matched by .gitignore patterns.
Using uv:
uv pip install gitwalkfrom gitwalk import gitwalk as walk
# Walk through directory respecting .gitignore rules
for dirpath, dirnames, filenames in walk("./my_project"):
print(f"Directory: {dirpath}")
print(f"Subdirectories: {dirnames}")
print(f"Files: {filenames}")- Same interface as
os.walk() - Respects
.gitignorepatterns - Supports both topdown and bottom-up traversal
- Handles error callbacks
- Follows symbolic links (optional)
uv pip install -e ".[test]"
pytest