README.md

My Python code samples

For talks, presentations, workshops, demos.

Setup

Option 1

python3 -m venv .venv
source .venv/bin/activate
pip install pip --upgrade
pip install -e ".[dev]"

Option 2

Install uv.

Run

uv sync
uv venv

Commands

Test with

uv run pytest --doctest-modules src --cov src --cov-report=html

Or without coverage

uv run pytest --doctest-modules src

Cases

• doctest

  • src/clock_angle
  • src/_pieces/calculator.py

• mutation tests with mutmut

  • src/clock_angle
  • tests/clock_angle/test_clock_angle.py

• venv and differences between conda env and venv

  • src/about_venv/venv.md

• presentations:

  • Renaming on steroids with AI code assistants
  • Local coding with LLMs

GitHub Pages

This repository deploys .presentations/local-coding-with-llm to GitHub Pages using .github/workflows/gh-pages.yml.

After enabling Settings → Pages → Build and deployment → GitHub Actions, the presentation will be available at:

https://<your-github-username>.github.io/<your-repository-name>/