Learning UI

Simple Calculator

CI/CD Learning Studio

A compact, hands-on map of the repo. Track your progress, run the quickstart, and move through the learning path in order.

6 Guides
4 Stages
~70 Minutes
Calculator Robot

4-Stage Learning Path

Progressive
  1. 1

    Developer Flow

    Run the calculator locally and get comfortable with tests.

  2. 2

    Pre-commit Hooks

    Automate formatting and checks before every commit.

  3. 3

    CI/CD Workflows

    Understand how the pipelines run in GitHub Actions.

  4. 4

    Advanced Features

    Explore reporting, caching, and quality gates.

Guide Checklist

0/6 complete

Quick Start

Terminal
# Option A: Using pip
pip install -r requirements.txt
python -m src.calculator
pytest

# Option B: Using uv (faster) âš¡
uv sync --dev
uv run python -m src.calculator
uv run pytest

Developer Flow

Slide Show
Pre-commit hooks

Step 1

Pre-commit Hooks

Catch issues before code leaves your laptop.

Local guardrails Fast feedback
Lint checks

Step 2

Lint

Keep style and quality consistent across the team.

Static analysis Code health
Security tests

Step 3

Security Tests

Scan for known issues before anything ships.

Dependency scan Policy checks
Unit tests

Step 4

Unit Tests

Validate the core calculator behavior quickly.

Fast checks High signal
Build container image

Step 5

Build Image

Package the app so it runs the same everywhere.

Artifacts Reproducible
Deploy preview

Step 6

Deploy to PR

Spin up a preview environment for reviewers.

Preview URL Collaborate
Integration tests

Step 7

Integration Tests

Verify the full pipeline with real dependencies.

End-to-end Confidence

Repo Map

Where to Look
  • guides/ Step-by-step learning path.
  • src/ Core Python calculator logic.
  • tests/ Pytest suite and examples.
  • docs/ Deep dives and architecture.

Scan the Repo

QR
QR code for the repository

Open on your phone

Point your camera to jump straight to the GitHub repo.