Skip to content

Fix prompt artifacts, README link, and requires-python - #804

Merged
stephengruppetta merged 1 commit into
realpython:cursor-vs-copilot-pythonfrom
realpython-bot:fix-metadata-and-prompts
Aug 11, 2026
Merged

Fix prompt artifacts, README link, and requires-python#804
stephengruppetta merged 1 commit into
realpython:cursor-vs-copilot-pythonfrom
realpython-bot:fix-metadata-and-prompts

Conversation

@realpython-bot

Copy link
Copy Markdown
Contributor

Hi @brianMutea — like #803, this targets your cursor-vs-copilot-python branch rather than master, so merging it folds the fixes straight into #802. Four files, docs and metadata only — no changes to the sample code.

1. Stray citation artifacts in prompts.md

Five occurrences of :contentReference[oaicite:N]{index=N} (lines 21, 40, 51, 65, 75), left over from pasted assistant output. They'd render as visible junk. Copilot's reviewer flagged these too.

2. README pointed at a URL that would 404

-https://realpython.com/cursor-vs-github-copilot-python/
+https://realpython.com/cursor-vs-copilot/

The live CMS post is 2234, slug cursor-vs-copilot — which also matches the Slug custom field on the Trello card. Title updated to the published one ("Cursor vs Copilot: Which AI Editor Is Better for Python?") at the same time.

3. requires-python was unsatisfiable

Both packages declared >=3.9 while pinning pytest==9.0.3, which requires >=3.10. That isn't cosmetic — resolution fails outright:

Because the requested Python version (>=3.9) does not satisfy Python>=3.10 and pytest==9.0.3 depends on Python>=3.10 […] your project's requirements are unsatisfiable

So anyone following the README hit a wall on first install. Raised the floor to >=3.10; uv run pytest now resolves and runs in both packages. (The source itself is genuinely 3.9-compatible — it was only the test pin that broke the claim.)

Verified after the change

  • cursor/: 16 passed · github-copilot/: 13 passed
  • ruff format --check and ruff check clean under the pinned 0.14.1

Not included — one for @stephengruppetta to decide

The folder is cursor-vs-copilot-python/ while the article slug is cursor-vs-copilot. The repo README says subfolders are "named after the article slug", and 6 of 8 folders I sampled match theirs exactly. But naming isn't consistent everywhere — tutorial-drafts uses articles/cursor-vs-windsurf while that article's slug is cursor-vs-windsurf-python — so I've left it alone rather than rename unilaterally. It's a one-line git mv if wanted.

🤖 Prepared by RPBot on behalf of @stephengruppetta

- prompts.md: remove 5 stray `:contentReference[oaicite:N]{index=N}`
  citation artifacts left over from pasted assistant output
- README.md: point at the real article URL (CMS post 2234, slug
  `cursor-vs-copilot`) instead of `cursor-vs-github-copilot-python`,
  which would 404, and match the published title
- pyproject.toml (both packages): requires-python >=3.9 -> >=3.10.
  The pinned pytest==9.0.3 needs >=3.10, so dependency resolution
  failed outright on the declared floor

Verified: both suites pass (16 + 13), ruff 0.14.1 format/check clean.
@stephengruppetta
stephengruppetta merged commit fc70d8f into realpython:cursor-vs-copilot-python Aug 11, 2026
1 check passed
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