pytest-dev/pytest

At a glance

Rank

#123 of 401

Top 31% · #27 of 56 Python repos

Checks passed

8 of 17

Full list below

Best set up for

Claude Code

Score 78.0

Needs most work for

Cursor

Biggest fix: Cursor rules (.cursor/rules) (+11.5 pts)

What to fix first

Showing fixes for Claude Code

1. 1
   AGENTS.md / CLAUDE.md

   Add an AGENTS.md covering project goals, layout, setup commands, and conventions. Aim for 800+ chars of real guidance (not boilerplate).
   +13.2 pts
2. 2
   Test suite

   Add a tests/ (or test/, __tests__/, spec/) directory with runnable tests. Document how to run them in AGENTS.md.
   +3.9 pts
3. 3
   Reproducible dev env

   Add a Makefile or devcontainer or Dockerfile so the agent can set up the project in one command.
   +3.6 pts

Score for each AI agent

Each agent weighs the checks by its own docs. Under each score are its top three. How each agent is scored →

Does pytest-dev/pytest have agent instructions?

An AGENTS.md (or CLAUDE.md) at the root tells AI coding agents how to build, test and work in the repo. A few agents also read a file of their own.

AGENTS.md / CLAUDE.md

✗None at the root (no AGENTS.md, CLAUDE.md, AGENT.md, .claude/CLAUDE.md or .claude/AGENTS.md)

Agent-specific files

None: no GEMINI.md, .cursor/rules, .openhands/setup.sh, .aider.conf.yml or .agents/skills

Repos that have one

29 of 56 Python repos · 221 of 401 repos on the leaderboard · See examples →

# AGENTS.md

Guidance for AI coding agents working in pytest-dev/pytest. The pytest framework makes it easy to write small tests, yet scales to support complex functional testing. Written mainly in Python.

## Where things are

- Dependencies are declared in `pyproject.toml`.
- Test files are spread through the tree, e.g. `testing/_py/test_local.py`.
- Lint and format rules are configured in `pyproject.toml`.
- Type checking is configured in `pyproject.toml`.
- CI is defined in `.github/workflows`; read it for the exact install, lint and test steps.
- Commit hooks are set up in `.pre-commit-config.yaml`; don't skip them.
- Test environments are defined in `tox.ini`.
- Follow the conventions in `CONTRIBUTING.rst`.

## Commands

<!-- Fill in the exact commands CI runs. -->
- Install: TODO
- Test: TODO
- Lint: TODO

How pytest-dev/pytest compares

vs leaderboard average

7.4 pts above

Average 66.8

vs Python average

3.2 pts above

Average 71.0

Stars among Python repos

#50 of 56

One fix for the most agents: AGENTS.md / CLAUDE.md would raise the score for all 9 agents, by up to 13.3 points.

Similar repos

Same language and host as this repo, closest in overall score.

• Textualize/textual75.6
  Python · 37.6k ★
• data-privacy-stack/presidio75.5
  Python · 11.7k ★
• crewAIInc/crewAI73.6
  Python · 60.5k ★
• ray-project/ray73.6
  Python · 44.2k ★
• Kludex/starlette72.1
  Python · 12.7k ★
• huggingface/diffusers72.0
  Python · 34.9k ★

Same topics, any language

Repos tagged with the same GitHub topics, most shared first.

• microsoft/playwright79.1
  TypeScript · test, testing
• vitest-dev/vitest62.6
  TypeScript · test
• jestjs/jest71.1
  TypeScript · testing
• storybookjs/storybook67.8
  TypeScript · testing
• stretchr/testify55.6
  Go · testing
• mockk/mockk54.1
  Kotlin · testing