Name: tessl-labs/python-project-structure
Rating: 91.8 (1 reviews)
Author: tessl-labs

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

1.03x

Quality

87%

Does it follow best practices?

Impact

99%

1.03x

Average score across 5 eval scenarios

Securityby

Passed

No known issues

Evaluation results

100%

Set Up a New Python Web Service for a Pet Adoption Platform

Criteria

Without context

With context

pyproject.toml with build-system

100%

requires-python >= 3.11

100%

No setup.py created

100%

Dependency groups separated

100%

Ruff configured in pyproject.toml

100%

Mypy configured with strict

100%

.gitignore includes venv

100%

.gitignore includes __pycache__ and .env

100%

__init__.py in all packages

100%

Config uses pydantic-settings BaseSettings

100%

Routes separated by resource

100%

App factory pattern in main.py

100%

Type hints on function signatures

100%

tests/ with conftest.py

100%

Database logic separated

100%

Custom errors with handler registration

100%

98%

-2%

Build a Notification Microservice with Full Test Coverage

Criteria

Without context

With context

pyproject.toml with build-system

100%

requires-python

100%

Separate dev and test groups

100%

Ruff configured

100%

Mypy strict

100%

pytest configured in pyproject.toml

100%

.gitignore comprehensive

100%

__init__.py in all packages

100%

App factory pattern

100%

Config from environment

100%

Routes with APIRouter

100%

Type hints everywhere

100%

87%

conftest.py with fixtures

100%

Multiple test files

100%

tests/ has __init__.py

100%

No setup.py

100%

Pydantic models with Literal types

100%

12%

Build a Python CLI Tool for Log Analysis

Criteria

Without context

With context

pyproject.toml with build-system

100%

[project.scripts] entry point

100%

requires-python >= 3.11

100%

Dependency groups

87%

100%

Ruff configured

100%

Mypy strict

100%

Proper package with __init__.py

100%

py.typed marker

100%

.gitignore with venv and pycache

80%

100%

Type hints on all functions

100%

Tests directory with conftest.py

100%

No setup.py

100%

Separate modules for concerns

100%

pytest configured in pyproject.toml

100%

Data models defined

100%

Create a Reusable Python Library for Data Validation

Criteria

Without context

With context

src layout used

100%

py.typed marker

100%

pyproject.toml with build-system

100%

requires-python

100%

Dependency groups

100%

Ruff configured

100%

Mypy strict

100%

__init__.py with public API

100%

__init__.py in all directories

100%

.gitignore comprehensive

100%

Type hints on all functions

100%

tests/ with conftest and test files

100%

No setup.py

100%

Custom exceptions defined

100%

pytest configured

100%

Restructure a Single-File Flask App into a Proper Project

Criteria

Without context

With context

pyproject.toml with build-system

100%

requires-python

50%

100%

Dependency groups separated

100%

Ruff configured

100%

Mypy strict

100%

.gitignore with venv

100%

.gitignore with pycache and .env

100%

Flask app factory

100%

Config from environment (BaseSettings)

100%

__init__.py everywhere

100%

Routes use Blueprints

100%

Database logic in db.py

100%

Custom errors with handler

100%

Type hints on functions

100%

tests/ with conftest.py and __init__.py

100%

No setup.py

100%

No hardcoded config

75%

100%

Evaluated: 16 days ago
Agent: Claude Code
Model: Claude Sonnet 4.6

Table of Contents

Set Up a New Python Web Service for a Pet Adoption Platform Build a Notification Microservice with Full Test Coverage Build a Python CLI Tool for Log Analysis Create a Reusable Python Library for Data Validation Restructure a Single-File Flask App into a Proper Project