{"categories":[{"label":"Utilities","url":"https://skillfed.io/packages/category/utilities/4"}],"enrichment":{"capability":"Filters filesystem paths using gitignore-style pattern matching, allowing you to walk directories with include/exclude rules or test individual paths against patterns.","skillfed_tags":["path-filtering","gitignore-compatible"],"use_cases":["Build tools or linters that need to offer users a .gitignore-style configuration file to exclude or include paths.","Interactive scripts that need to quickly retrieve sets of files matching complex constraints without reimplementing gitignore logic.","Test runners or deployment tools that must respect .gitignore patterns to avoid processing excluded directories.","File synchronization or backup utilities that want to honor gitignore rules without calling out to Git itself."],"what_it_does":"py-walk is a Python library that interprets gitignore-style patterns to filter filesystem paths. It provides two main workflows: walking a directory tree and returning only paths that match or don't match a set of patterns, or creating a parser object to test individual paths against patterns on demand. The library aims for Git wildmatch compatibility and includes tests derived from Git's own test suite.\n\nYou pass patterns as text, a list, or a .gitignore file, optionally specifying a base directory. The walk function returns a generator of Path objects; you can also filter by file vs. directory mode, or combine ignore and match rules (with ignore taking precedence). It depends only on sly for parsing and supports Python 3.7 through 3.12.","worth_installing":"Yes, if you need gitignore-compatible pattern matching and can tolerate dormant maintenance. The library is lightweight, has no known vulnerabilities, and solves a specific problem well. However, if you expect active bug fixes or compatibility updates as Git evolves, consider whether the dormant status (657 days since last release) aligns with your project's needs."},"id":"py-walk","links":{"html":"https://skillfed.io/packages/py-walk","md":"https://skillfed.io/packages/py-walk.md","pypi":"https://pypi.org/project/py-walk/"},"maintenance":{"status":"dormant"},"meta":{"latest_release":"2024-10-26","license_spdx":null,"license_treatment":"permissive","name":"py-walk","python_support":"supports_current","summary":"Filter filesystem paths based on gitignore-like patterns"},"popularity":{"monthly_downloads":1410155,"position":3941,"tier":"top_5000"},"security":{"n_vulnerabilities":0},"version":"0.3.3"}