Skip to content

feat: use docgen as an external tool (no vendored library in project src) - #64

Merged
jmjava merged 2 commits into
mainfrom
cursor/external-docgen-install-afb7
Aug 2, 2026
Merged

feat: use docgen as an external tool (no vendored library in project src)#64
jmjava merged 2 commits into
mainfrom
cursor/external-docgen-install-afb7

Conversation

@jmjava

@jmjava jmjava commented Aug 1, 2026

Copy link
Copy Markdown
Owner

Summary

Makes the intended consumer model explicit and usable from the wizard:

  1. External install — consumers keep only a demo bundle; install docgen via pip/pipx/uv (not vendored into project src/).
  2. In-GUI upgrade — wizard Tool tab shows the installed version and can pip install --upgrade a git ref, optionally rewriting requirements-docgen.txt.

Changes

Piece What
docgen --version Prints installed version + recommended pip install line
docgen init Writes requirements-docgen.txt + bundle README.md
install_spec.py Canonical pip specs, pin helpers, safe update_docgen_install
Wizard Tool tab GET /api/tool, POST /api/tool/update (canonical GitHub URL only; restart required)
README / AGENTS Document external-tool + GUI update flow

Consumer flow

cd your-project/docs/demos
pip install -r requirements-docgen.txt
docgen wizard
# → Tool tab → enter ref (main or SHA) → Update docgen → restart wizard

Test plan

  • pytest tests/ (full suite)
  • Unit: ref validation rejects shell metacharacters
  • Unit: mocked pip update rewrites requirements pin
  • Unit: wizard /api/tool + /api/tool/update
Open in Web Open in Cursor 

cursoragent and others added 2 commits August 1, 2026 13:43
Document pip/pipx/uv installs, add docgen --version, and have init write
requirements-docgen.txt plus a bundle README so consumers keep only the
demo bundle in-repo instead of copying documentation-generator source.

Co-authored-by: John Menke <jmjava@gmail.com>
Add GET /api/tool and POST /api/tool/update so maintainers can pip-upgrade
the external docgen package from the GUI (canonical git URL only), rewrite
requirements-docgen.txt, and be prompted to restart the wizard.

Co-authored-by: John Menke <jmjava@gmail.com>
@jmjava
jmjava marked this pull request as ready for review August 2, 2026 02:14
@cursor

cursor Bot commented Aug 2, 2026

Copy link
Copy Markdown
Contributor

Bugbot is not enabled for your account, so this pull request was not reviewed.

Enable Bugbot in the Cursor dashboard to get automatic reviews on future PRs.

@jmjava
jmjava merged commit 4757d51 into main Aug 2, 2026
5 checks passed
@jmjava
jmjava deleted the cursor/external-docgen-install-afb7 branch August 2, 2026 02:14
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants