type-hints

name	Type Hints
description	Python type hints, type checking, and static analysis with mypy
version	2.1.0
sasmp_version	1.3.0
bonded_agent	07-best-practices
bond_type	PRIMARY_BOND
retry_strategy	exponential_backoff
observability	{"logging":true,"metrics":"type_coverage_percent"}

Python Type Hints Skill

Overview

Master Python type hints for better code quality, IDE support, and static type checking with mypy.

Topics Covered

Basic Type Hints

• Variable annotations
• Function signatures
• Return types
• Optional types
• Union types

Advanced Typing

• Generic types
• TypeVar and ParamSpec
• Protocol and structural typing
• Literal types
• TypedDict

Type Checking

• mypy configuration
• Strict mode settings
• Type ignore comments
• Stub files (.pyi)
• Type coverage

Runtime Types

• typing_extensions
• Pydantic validation
• Runtime type checking
• Dataclasses with types
• attrs integration

Best Practices

• Gradual typing strategy
• Third-party type stubs
• CI type checking
• Documentation with types
• Type-driven development

Prerequisites

• Python fundamentals
• OOP concepts

Learning Outcomes

• Write type-annotated code
• Configure mypy properly
• Use generic types
• Implement protocols