Hyperscan backend

Author: cpburnz

CHANGES.rst

@@ -3,12 +3,29 @@ Change History
 ==============
 
 
-0.12.2 (TBD)
+0.13.0 (TBD)
 -------------------
 
+Major changes:
+
+- `Issue #91`_: Dropped support of EoL Python 3.8.
+
+New features:
+
+- Added optional `hyperscan`_ backend for faster regex matching. It will automatically be used when installed. The backend can be controlled using the `backend` argument to `PathSpec()`, `PathSpec.from_lines()`, `GitIgnoreSpec()`, or `GitIgnoreSpec.from_lines()`.
+
+Bug fixes:
+
+- `Issue #98`_: UnboundLocalError in RegexPattern when initialized with pattern=None.
+
 Improvements:
 
-- Support Python 3.13, 3.14.
+- Mark Python 3.13 and 3.14 as supported.
+- No-op patterns are now filtered out when matching files, slightly improving performance.
+
+.. _`hyperscan`: https://pypi.org/project/hyperscan/
+.. _`Issue #91`: https://github.com/cpburnz/python-pathspec/issues/91
+.. _`Issue #98`: https://github.com/cpburnz/python-pathspec/issues/98
 
 
 0.12.1 (2023-12-10)
@@ -27,8 +44,7 @@ Bug fixes:
 
 Major changes:
 
-- Dropped support of EOL Python 3.7. See `Pull #82`_.
-
+- Dropped support of EoL Python 3.7. See `Pull #82`_.
 
 API changes:
 
@@ -182,7 +198,7 @@ Improvements:
 
 Major changes:
 
-- Dropped support of EOL Python 2.7, 3.5, 3.6. See `Issue #47`_.
+- Dropped support of EoL Python 2.7, 3.5, 3.6. See `Issue #47`_.
 - The *gitwildmatch* pattern `dir/*` is now handled the same as `dir/`. This means `dir/*` will now match all descendants rather than only direct children. See `Issue #19`_.
 - Added `pathspec.GitIgnoreSpec` class (see new features).
 - Changed build system to `pyproject.toml`_ and build backend to `setuptools.build_meta`_ which may have unforeseen consequences.

DEV.md

@@ -10,11 +10,6 @@ These are notes to myself for things to review before decommissioning EoL versio
 
 ### Python
 
-**Python 3.8:**
-
-- EoL as of 2024-10-07.
-- Cannot remove support until Hatchling stops supporting Python 3.8.
-
 **Python 3.9:**
 
 - Becomes EoL in 2025-10.
@@ -37,6 +32,10 @@ These are notes to myself for things to review before decommissioning EoL versio
 
 - Becomes EoL in 2029-10.
 
+**Python 3.14**
+
+- Becomes EoL in 2030-10.
+
 References:
 
 - [Status of Python Versions](https://devguide.python.org/versions/)
@@ -46,10 +45,6 @@ References:
 
 Review the following Linux distributions.
 
-**CentOS:**
-
-- TODO
-
 **Debian:**
 
 - Goal:
@@ -125,25 +120,25 @@ Review the following PyPI packages.
 
 [ansible-lint](https://pypi.org/project/ansible-lint/)
 
-- v25.6.1 (latest as of 2025-06-26) requires Python 3.10+.
+- v25.9.2 (latest as of 2025-10-20) requires Python 3.10+.
 - [ansible-lint on Wheelodex](https://www.wheelodex.org/projects/ansible-lint/).
 
 [black](https://pypi.org/project/black/)
 
-- v25.1.0 (latest as of 2025-06-26) requires Python 3.9+.
+- v25.9.0 (latest as of 2025-10-20) requires Python 3.9+.
 - [black on Wheelodex](https://www.wheelodex.org/projects/black/).
 
 [dvc](https://pypi.org/project/dvc/)
 
-- v3.60.1 (latest as of 2025-06-26) requires Python 3.9+.
+- v3.63.0 (latest as of 2025-10-20) requires Python 3.9+.
 - [dvc on Wheelodex](https://www.wheelodex.org/projects/dvc/).
 
 [hatchling](https://pypi.org/project/hatchling/)
 
-- v1.27.0 (latest as of 2025-06-26) requires Python 3.8+.
+- v1.27.0 (latest as of 2025-10-20) requires Python 3.8+, but next release will require Python 3.9+.
 - [hatchling on Wheelodex](https://www.wheelodex.org/projects/hatchling/).
 
 [yamllint](https://pypi.org/project/yamllint/)
 
-- v1.37.1 (latest as of 2025-06-26) requires Python 3.9+.
+- v1.37.1 (latest as of 2025-10-20) requires Python 3.9+.
 - [yamllint on Wheelodex](https://www.wheelodex.org/projects/yamllint/).

Makefile

@@ -170,12 +170,19 @@ Change History
 ==============
 
 
-0.12.2 (TBD)
+0.13.0 (TBD)
 -------------------
 
+Major changes:
+
+- `Issue #91`_: Dropped support of EOL Python 3.8.
+
 Improvements:
 
-- Support Python 3.13, 3.14.
+- Mark Python 3.13 and 3.14 as supported.
+
+
+.. _`Issue #91`: https://github.com/cpburnz/python-pathspec/issues/91
 
 
 0.12.1 (2023-12-10)

README-dist.rst

@@ -0,0 +1,42 @@
+
+from pathlib import (
+	Path)
+
+import pytest
+from pytest_benchmark.fixture import (
+	BenchmarkFixture)
+
+from pathspec.util import (
+	iter_tree_entries,
+	iter_tree_files)
+
+
+@pytest.mark.benchmark(group="iter_tree_entries", warmup=True)
+def bench_iter_tree_entries(benchmark: BenchmarkFixture, cpython_dir: Path):
+	benchmark(run_iter_tree_entries, cpython_dir)
+
+
+@pytest.mark.benchmark(group="iter_tree_files", warmup=True)
+def bench_iter_tree_files_v0(benchmark: BenchmarkFixture, cpython_dir: Path):
+	benchmark(run_iter_tree_files_v0, cpython_dir)
+
+
+@pytest.mark.benchmark(group="iter_tree_files", warmup=True)
+def bench_iter_tree_files_v1(benchmark: BenchmarkFixture, cpython_dir: Path):
+	benchmark(run_iter_tree_files_v1, cpython_dir)
+
+
+def run_iter_tree_entries(path: Path):
+	for _ in iter_tree_entries(path):
+		pass
+
+
+def run_iter_tree_files_v0(path: Path):
+	for entry in iter_tree_entries(path):
+		if not entry.is_dir():
+			pass
+
+
+def run_iter_tree_files_v1(path: Path):
+	for _ in iter_tree_files(path):
+		pass