EDIT: Update python code guide and include linting, formatting and type checking

estebanx64 · estebanx64 · commit 7aeb66ad9cbe · 2025-06-01T21:37:30.000-05:00
diff --git a/content/guides/python/_index.md b/content/guides/python/_index.md
@@ -19,6 +19,7 @@ The Python language-specific guide teaches you how to containerize a Python appl
 
 - Containerize and run a Python application
 - Set up a local environment to develop a Python application using containers
+- Lint, format, typing and best practices
 - Configure a CI/CD pipeline for a containerized Python application using GitHub Actions
 - Deploy your containerized Python application locally to Kubernetes to test and debug your deployment
 
diff --git a/content/guides/python/configure-ci-cd.md b/content/guides/python/configure-ci-cd.md
@@ -5,8 +5,8 @@ weight: 40
 keywords: ci/cd, github actions, python, flask
 description: Learn how to configure CI/CD using GitHub Actions for your Python application.
 aliases:
-  - /language/python/configure-ci-cd/
-  - /guides/language/python/configure-ci-cd/
+   - /language/python/configure-ci-cd/
+   - /guides/language/python/configure-ci-cd/
 ---
 
 ## Prerequisites
@@ -75,9 +75,34 @@ to Docker Hub.
      push:
        branches:
          - main
+     pull_request:
+       branches:
+         - main
 
    jobs:
+     lint-test:
+       runs-on: ubuntu-latest
+       steps:
+         - uses: actions/checkout@v4
+         
+         - name: Set up Python
+           uses: actions/setup-python@v5
+           with:
+             python-version: '3.12'
+
+         - name: Install dependencies
+           run: |
+             python -m pip install --upgrade pip
+             pip install -r requirements.txt
+
+         - name: Run pre-commit hooks
+           run: pre-commit run --all-files
+
+         - name: Run pyright
+           run: pyright
+
      build:
+       needs: lint-test
        runs-on: ubuntu-latest
        steps:
          - name: Login to Docker Hub
@@ -120,7 +145,11 @@ Save the workflow file and run the job.
 
 ## Summary
 
-In this section, you learned how to set up a GitHub Actions workflow for your Python application.
+In this section, you learned how to set up a GitHub Actions workflow for your Python application that includes:
+
+- Running pre-commit hooks for linting and formatting
+- Static type checking with Pyright
+- Building and pushing Docker images
 
 Related information:
 
diff --git a/content/guides/python/containerize.md b/content/guides/python/containerize.md
@@ -58,7 +58,7 @@ This utility will walk you through creating the following files with sensible de
 Let's get started!
 
 ? What application platform does your project use? Python
-? What version of Python do you want to use? 3.11.4
+? What version of Python do you want to use? 3.12
 ? What port do you want your app to listen on? 8000
 ? What is the command to run your app? python3 -m uvicorn app:app --host=0.0.0.0 --port=8000
 ```
@@ -139,8 +139,8 @@ Create a file named `Dockerfile` with the following contents.
 
 # Want to help us make this template better? Share your feedback here: https://forms.gle/ybq9Krt8jtBL3iCk7
 
-ARG PYTHON_VERSION=3.11.4
-FROM python:${PYTHON_VERSION}-slim AS base
+ARG PYTHON_VERSION=3.12
+FROM python:${PYTHON_VERSION}-slim
 
 # Prevents Python from writing pyc files.
 ENV PYTHONDONTWRITEBYTECODE=1
@@ -181,7 +181,7 @@ COPY . .
 EXPOSE 8000
 
 # Run the application.
-CMD python3 -m uvicorn app:app --host=0.0.0.0 --port=8000
+CMD ["python3", "-m", "uvicorn", "app:app", "--host=0.0.0.0", "--port=8000"]
 ```
 
 Create a file named `compose.yaml` with the following contents.
diff --git a/content/guides/python/develop.md b/content/guides/python/develop.md
@@ -51,7 +51,7 @@ You'll need to clone a new repository to get a sample application that includes
    Let's get started!
 
    ? What application platform does your project use? Python
-   ? What version of Python do you want to use? 3.11.4
+   ? What version of Python do you want to use? 3.12
    ? What port do you want your app to listen on? 8001
    ? What is the command to run your app? python3 -m uvicorn app:app --host=0.0.0.0 --port=8001
    ```
@@ -132,8 +132,8 @@ You'll need to clone a new repository to get a sample application that includes
 
    # Want to help us make this template better? Share your feedback here: https://   forms.gle/ybq9Krt8jtBL3iCk7
 
-   ARG PYTHON_VERSION=3.11.4
-   FROM python:${PYTHON_VERSION}-slim as base
+   ARG PYTHON_VERSION=3.12
+   FROM python:${PYTHON_VERSION}-slim
 
    # Prevents Python from writing pyc files.
    ENV PYTHONDONTWRITEBYTECODE=1
@@ -174,7 +174,7 @@ You'll need to clone a new repository to get a sample application that includes
    EXPOSE 8001
 
    # Run the application.
-   CMD python3 -m uvicorn app:app --host=0.0.0.0 --port=8001
+   CMD ["python3", "-m", "uvicorn", "app:app", "--host=0.0.0.0", "--port=8001"]
    ```
 
    Create a file named `compose.yaml` with the following contents.
diff --git a/content/guides/python/lint-format-typing.md b/content/guides/python/lint-format-typing.md
@@ -0,0 +1,122 @@
+---
+title: Linting, Formatting and Type Checking for Python
+linkTitle: Linting and Typing
+weight: 25
+keywords: python, linting, formatting, type checking, ruff, pyright
+description: Learn how to set up linting, formatting and type checking for your Python application.
+aliases:
+  - /language/python/lint-format-typing/
+---
+
+## Prerequisites
+
+Complete [Develop your app](develop.md).
+
+## Overview
+
+In this section, you'll learn how to set up code quality tools for your Python application. This includes:
+
+- Linting and formatting with Ruff
+- Static type checking with Pyright
+- Automating checks with pre-commit hooks
+
+## Linting and Formatting with Ruff
+
+Ruff is an extremely fast Python linter and formatter written in Rust. It replaces multiple tools like flake8, isort, and black with a single unified tool.
+
+Create a `pyproject.toml` file:
+
+```toml
+[tool.ruff]
+target-version = "py312"
+
+[tool.ruff.lint]
+select = [
+    "E",  # pycodestyle errors
+    "W",  # pycodestyle warnings
+    "F",  # pyflakes
+    "I",  # isort
+    "B",  # flake8-bugbear
+    "C4",  # flake8-comprehensions
+    "UP",  # pyupgrade
+    "ARG001", # unused arguments in functions
+]
+ignore = [
+    "E501",  # line too long, handled by black
+    "B008",  # do not perform function calls in argument defaults
+    "W191",  # indentation contains tabs
+    "B904",  # Allow raising exceptions without from e, for HTTPException
+]
+```
+
+### Using Ruff
+
+Run these commands to check and format your code:
+
+```bash
+# Check for errors
+ruff check .
+
+# Automatically fix fixable errors
+ruff check --fix .
+
+# Format code
+ruff format .
+```
+
+## Type Checking with Pyright
+
+Pyright is a fast static type checker for Python that works well with modern Python features.
+
+Add `Pyright` configuration in `pyproject.toml`:
+
+```toml
+[tool.pyright]
+typeCheckingMode = "strict"
+pythonVersion = "3.12"
+exclude = [".venv"]
+```
+
+### Running Pyright
+
+To check your code for type errors:
+
+```bash
+pyright
+```
+
+## Setting up pre-commit hooks
+
+Pre-commit hooks automatically run checks before each commit. in `.pre-commit-config.yaml` sets up Ruff:
+
+```yaml
+: https: https://github.com/charliermarsh/ruff-pre-commit
+  rev: v0.2.2
+  hooks:
+    - id: ruff
+      args: [--fix]
+    - id: ruff-format
+```
+
+To install and use:
+
+```bash
+pre-commit install
+git commit -m "Test commit"  # Automatically runs checks
+```
+
+## Summary
+
+In this section, you learned how to:
+
+- Configure and use Ruff for linting and formatting
+- Set up Pyright for static type checking
+- Automate checks with pre-commit hooks
+
+These tools help maintain code quality and catch errors early in development.
+
+## Next Steps
+
+- [Configure CI/CD](configure-ci-cd.md) to run these checks automatically
+- Customize linting rules to match your team's style preferences
+- Explore advanced type checking features
