feat(stdlib): add functools module bindings

[github-actions]

🤖 This is an automated pull request from Repo Assist, an AI assistant for this repository.

Summary

Adds Fable.Python.Functools, binding Python's [functools]((docs.python.org/redacted) standard library module — one of the most frequently used Python stdlib modules in functional-style code.

New bindings

F# member	Python API	Notes
functools.reduce(func, iterable)	functools.reduce(fn, it)	fold-left, no seed
functools.reduce(func, iterable, initializer)	functools.reduce(fn, it, init)	fold-left with seed
functools.lruCache(maxsize, func)	functools.lru_cache(maxsize=N)(fn)	LRU memoisation
functools.cache(func)	functools.cache(fn)	unbounded memo (Python 3.9+)

Tests

Six tests in test/TestFunctools.fs cover all bindings:

• reduce — sum without seed, product without seed, integer fold with seed, string fold with seed
• lruCache — verifies memoisation (only 2 calls for 3 invocations)
• cache — same memoisation check for unbounded variant

Notes on partial

Python's functools.partial pre-fills positional arguments on multi-arg functions. In Fable, F# lambdas compile to curried Python callables, so partial(f, x) applied to a curried function would return the intermediate closure — not the final result. Binding partial in a type-safe way would require additional design work (e.g. wrapping via System.Func tupled signatures). It has been left out intentionally to avoid misleading type signatures; it can be added in a follow-up once the right pattern is established.

Trade-offs

• Only reduce, lruCache, and cache are bound; partial, wraps, total_ordering, and singledispatch are left for follow-up.
• lruCache combines the two-step lru_cache(maxsize=N)(fn) call into one F# call using [<Emit>].
• No breaking changes; pure addition.

---

Closes none — proactive improvement surfaced from the Future Work backlog.

Note

🔒 Integrity filter blocked 10 items

The following items were blocked because they don't meet the GitHub integrity level.

• How does it generate the python source from AST? #5 list_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
• Roadmap #15 list_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
• Create Pyi parser #22 list_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
• string format specifier '{i:X4}' not working #36 list_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
• Support for Attributes? #48 list_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
• Pandas binding #65 list_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
• typeshed: generate bindings automatically ~ python glutinum? #115 list_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
• auto pip installation of dependencies during compilation of scripts #117 list_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
• allow TextIOWrapper to be enumerated #131 list_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
• support for asynchronous context managers #134 list_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".

To allow these resources, lower min-integrity in your GitHub frontmatter:

tools:
  github:
    min-integrity: approved  # merged | approved | unapproved | none

Generated by Repo Assist · ● 2.3M · ◷