René's URL Explorer Experiment

Title: Add function reference to AGENTS.md with auto-generated docs/functions.txt by Copilot · Pull Request #1624 · usethis-python/usethis-python · GitHub

Open Graph Title: Add function reference to AGENTS.md with auto-generated docs/functions.txt by Copilot · Pull Request #1624 · usethis-python/usethis-python

X Title: Add function reference to AGENTS.md with auto-generated docs/functions.txt by Copilot · Pull Request #1624 · usethis-python/usethis-python

Description: Agents were reimplementing logic (especially dependency reads) that already exists as mature, tested functions—e.g. hand-rolling pyproject.toml parsing instead of calling get_dep_groups(). Changes hooks/export-functions.py — New generic hook (modelled after hooks/export-module-tree.py) that accepts --output-file, --source-root, and --strict. It recursively discovers all .py files under the source root, scans module-level public functions (not class methods), and writes a flat bullet list in source order with no hardcoded sections or headers. With --strict, it exits non-zero if any public function lacks a docstring. .pre-commit-config.yaml — Adds the export-functions hook alongside export-module-tree with --source-root=src/usethis --strict, so docs/functions.txt is kept up to date automatically on every prek run. docs/functions.txt — Auto-generated (not hand-written) comprehensive flat reference of all 191 public module-level functions across the usethis package, with full dotted module names (e.g. usethis._deps). AGENTS.md — Embeds docs/functions.txt via the existing pattern (enforced by the check-doc-sync hook), and adds an explicit "ALWAYS check the Function Reference" instruction to the general guidelines. Docstrings added to all 112 previously undocumented public module-level functions across 50+ source files so the package complies with --strict mode and every public function appears in the generated reference. 📱 Kick off Copilot coding agent tasks wherever you are with GitHub Mobile, available on iOS and Android.

Open Graph Description: Agents were reimplementing logic (especially dependency reads) that already exists as mature, tested functions—e.g. hand-rolling pyproject.toml parsing instead of calling get_dep_groups(). Changes ...

X Description: Agents were reimplementing logic (especially dependency reads) that already exists as mature, tested functions—e.g. hand-rolling pyproject.toml parsing instead of calling get_dep_groups(). Changes ...

Opengraph URL: https://github.com/usethis-python/usethis-python/pull/1624

X: @github

direct link

Domain: github.com

Links:

Viewport: width=device-width