CtrlK
BlogDocsLog inGet started
Tessl Logo

tessl-labs/python-project-structure

Python project structure — pyproject.toml, src layout, __init__.py, .gitignore, dependency groups, type hints, py.typed, test structure, entry points, ruff/mypy configuration

91

1.03x
Quality

87%

Does it follow best practices?

Impact

99%

1.03x

Average score across 5 eval scenarios

SecuritybySnyk

Passed

No known issues

Overview
Quality
Evals
Security
Files

test-structure.jsonverifiers/

{
  "instruction": "Put tests in tests/ directory with conftest.py, __init__.py, and proper naming conventions",
  "relevant_when": "Agent creates tests for a Python project",
  "context": "Tests live in a top-level tests/ directory. The directory must have __init__.py for pytest discovery. Shared fixtures go in conftest.py. Test files must be named test_*.py and test functions must be named test_*. Test structure should mirror source structure.",
  "sources": [
    {
      "type": "file",
      "filename": "skills/python-project-structure/SKILL.md",
      "tile": "tessl-labs/python-project-structure@0.2.0"
    }
  ],
  "checklist": [
    {
      "name": "tests-directory",
      "rule": "Tests are in a tests/ directory at the project root, not mixed with source code",
      "relevant_when": "Agent creates tests for a Python project"
    },
    {
      "name": "conftest-py",
      "rule": "tests/conftest.py exists with shared fixtures (e.g., test client, database setup)",
      "relevant_when": "Agent creates a test suite for a Python web application"
    },
    {
      "name": "tests-init-py",
      "rule": "tests/ directory has an __init__.py file",
      "relevant_when": "Agent creates a tests/ directory"
    },
    {
      "name": "test-naming",
      "rule": "Test files are named test_*.py and test functions are named test_*",
      "relevant_when": "Agent creates pytest test files"
    }
  ]
}

tile.json