mcpField
P
python

python

github.com/dralgorhythmDevelopment12965 installsUpdated 15w ago
Repository

About python

A Python development skill covering project setup, typing, asynchronous code, error handling, and pytest. It is intended as a practical reference for developers building and testing Python projects.

Key features

  1. 01Project setup with uv
  2. 02Generic types and type hints
  3. 03Asynchronous programming patterns
  4. 04Error handling with typed results
  5. 05pytest testing and mocks
  6. 06Ruff and MyPy tooling

Use cases

  1. 01Starting a Python project with dependencies
  2. 02Structuring typed repositories and async code
  3. 03Testing services with pytest and mocks
  4. 04Linting and type-checking a codebase

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/dralgorhythm/claude-agentic-framework --skill python

After installing, type/pythonin Claude Code to confirm it loaded.

Details

From the project README

Python Development

Project Setup

# Create project with uv
uv init my-project
cd my-project

# Add dependencies
uv add litestar
uv add --dev pytest ruff mypy
pyproject.toml
[project]
name = "my-project"
version = "0.1.0"
requires-python = ">=3.13"
dependencies = ["litestar>=2.0"]

[tool.ruff]
line-length = 88
target-version = "py313"

[tool.mypy]
strict = true
python_version = "3.13"

Type Hints

from typing import TypeVar, Generic
from collections.abc import Sequence

T = TypeVar('T')

class Repository(Generic[T]):
    async def find_by_id(self, id: str) -> T | None:
        ...

    async def save(self, entity: T) -> T:
        ...

def process_items(items: Sequence[str]) -> list[str]:
    return [item.upper() for item in items]

Async Patterns

import asyncio
from collections.abc import AsyncIterator

async def fetch_all(urls: list[str]) -> list[Response]:
    async with aiohttp.ClientSession() as session:
        tasks = [fetch_one(session, url) for url in urls]
        return await asyncio.gather(*tasks)

async def stream_data() -> AsyncIterator[bytes]:
    async with aiofiles.open('large.csv', 'rb') as f:
        async for chunk in f:
            yield chunk

Error Handling

from dataclasses import dataclass
from typing import TypeVar, Generic

T = TypeVar('T')
E = TypeVar('E')

@dataclass
class Ok(Generic[T]):
    value: T

@dataclass
class Err(Generic[E]):
    error: E

Result = Ok[T] | Err[E]

def divide(a: int, b: int) -> Result[float, str]:
    if b == 0:
        return Err("Division by zero")
    return Ok(a / b)

Testing with pytest

import pytest
from unittest.mock import AsyncMock

@pytest.mark.asyncio
async def test_create_user():
    repo = AsyncMock()
    service = UserService(repo)

    user = await service.create("[email protected]")

    assert user.email == "[email protected]"
    repo.save.assert_called_once()

@pytest.fixture
def mock_database():
    with patch('app.database') as mock:
        yield mock

Tooling

# Ruff (linting + formatting)
ruff check --fix .
ruff format .

# MyPy (type checking)
mypy --strict .

# pytest
pytest -v --cov=src

Comments

Markdown supported