fix: use os.walk to build custom components on Python 3.10 and 3.11 - #6760

All Submissions:

• Have you followed the guidelines stated in CONTRIBUTING.md file?
• Have you checked to ensure there aren't any other open Pull Requests for the desired change?

Type of change

• Bug fix (non-breaking change which fixes an issue)

Changes To Core Features:

• Have you added an explanation of what your changes do and why you'd like us to include them?
• Have you written new tests for your core changes, as applicable?
• Have you successfully ran tests with your changes locally?

What

reflex component build crashes on Python 3.10 and 3.11 with:

AttributeError: 'PosixPath' object has no attribute 'walk'

_make_pyi_files in reflex/custom_components/custom_components.py generates the
.pyi stubs for a custom component by walking its source tree. That loop used
pathlib.Path.walk(), which was only added in Python 3.12. Since the project
supports requires-python = ">=3.10,<4.0", every custom-component author on 3.10
or 3.11 hits a hard crash when building their component.

Why / root cause

Path.walk() does not exist before Python 3.12, and there is no version guard or
fallback around the call. The sibling helper _walk_files in
packages/reflex-base/src/reflex_base/utils/pyi_generator.py already avoids
Path.walk() for exactly this reason (its comment notes it can only be used once
the floor is 3.12), so this second call site had regressed relative to the rest
of the codebase.

Fix

Switch the walk to os.walk() (os is already imported in the module) and read
the directory basename via Path(dir).name for the __pycache__ skip.
PyiGenerator.scan_all normalizes its targets with Path(...), so the directory
strings that os.walk yields work unchanged. This mirrors the existing
_walk_files approach and keeps the behavior identical on 3.12+.

Tests

Added tests/units/custom_components/test_custom_components.py. It deletes
Path.walk via monkeypatch to reproduce the 3.10/3.11 environment on any
interpreter (so the guard also holds on 3.12+, where a naive test would silently
pass), then asserts _make_pyi_files recurses into component directories,
skips __pycache__, and skips top-level dotdirs, without raising.

• Fails before the fix with the reported AttributeError; passes after.
• uv run pytest tests/units -> 6617 passed, 18 skipped (no regressions).
• uv run ruff check . / uv run ruff format --check clean;
  uv run pyright reflex tests -> 0 errors.

Towncrier / CHANGELOG fragment

Committed news/6714.bugfix.md (placeholder number 6714) to satisfy the
CHANGELOG CI gate (.github/workflows/changelog.yml), which requires a towncrier
fragment for any change under reflex/. Verified locally:
uv run towncrier check --config pyproject.toml --dir . --compare-with origin/main
-> exit 0.

ACTION AFTER OPENING THE PR: rename news/6714.bugfix.md to
news/<real-PR-number>.bugfix.md and amend/commit. 6714 was the plausible next
number at draft time (latest activity was #6711-#6713), but the true PR number
is only known once the PR exists. Note news/6710.bugfix.md already exists in the
tree, so if the real PR lands on a number already taken by another fragment,
pick the actual PR number regardless.

Greptile Summary

This PR restores custom-component builds on Python 3.10 and 3.11. The main changes are:

• Delegates recursive stub generation to PyiGenerator.scan_all().
• Excludes hidden and cache directories from top-level scan targets.
• Adds a compatibility test that removes Path.walk().
• Adds a changelog fragment for the fix.

Confidence Score: 5/5

This looks safe to merge.

• The updated code removes the unsupported Path.walk() call.
• The existing scanner handles recursive traversal for the collected targets.
• The new test covers the reported compatibility failure and target filtering.
• No blocking issue remains in the changed code.

_{Reviews (3): Last reviewed commit: "fix: delegate custom component stub trav..." | Re-trigger Greptile}

Context used:

• Context used - CLAUDE.md (source)
• Context used - AGENTS.md (source)