types-icalendar

What it is and what it does

types-icalendar is a type stub package that bridges the gap between the icalendar library and Python's static type checkers. It provides type annotations for icalendar 6.3.2, allowing mypy, pyright, and other type checkers to understand and validate code that uses icalendar's API for parsing and generating iCalendar format data. The package is maintained as part of the typeshed project, the canonical repository for type stubs in the Python ecosystem.

This package is most useful when working with icalendar 6.3.2 or earlier versions that lack built-in type annotations. It depends on two other type stub packages (types-python-dateutil and types-pytz) to provide complete type information for icalendar's date and timezone handling. The package is actively maintained and carries no known security vulnerabilities.

Use it for:

• Enable mypy or pyright type checking in projects using icalendar 6.3.2 for calendar event parsing and generation.
• Validate iCalendar data processing pipelines with static type analysis before runtime.
• Integrate icalendar into a strictly typed codebase where type safety is enforced across all dependencies.
• Catch type-related bugs in calendar integration code during development rather than at runtime.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Provides type stubs for the icalendar package, enabling static type checkers like mypy and pyright to validate code that uses icalendar for iCalendar format handling.

Yes, if you use icalendar 6.3.2 and rely on static type checking. Install friction is minimal and the package is actively maintained with no vulnerabilities. However, if you are already using icalendar 7.0.0 or later, uninstall this package—the library now includes its own type annotations, making this stub package redundant.

Install

types-icalendar on PyPI

pip install types-icalendar

uv add types-icalendar

poetry add types-icalendar

Installing types-icalendar

Before you install

Low install friction with only two type-stub runtime dependencies (types-python-dateutil and types-pytz). Actively maintained as of 2026-08-14 with no known vulnerabilities.

License in practice

Licensed under Apache-2.0 (permissive), allowing use in most projects without significant legal constraints.

Quickstart

pip install types-icalendar

# In your code with mypy or pyright enabled:
import icalendar

cal = icalendar.Calendar()
# Type checker now understands icalendar's API

Requires Python 3.10 or later. Note: icalendar 7.0.0+ includes its own type annotations, so this package is redundant for those versions.

Verify before relying

• Whether mypy 2.2.0 and pyright 1.1.411 remain the latest tested versions or if newer type checker versions have been validated since the package's last release.

Package facts

Evidence: types_icalendar-6.3.2.20260712-py3-none-any.whl

Tags

More Software Development packages