types-vobject

What it is and what it does

types-vobject is a type stub package that adds type annotations for the vobject library, which handles iCalendar and vCard data formats. It's part of the typeshed project and allows static type checkers to understand and validate code that uses vobject, catching type errors before runtime.

The package contains no runtime code—it exists solely to provide type information. It has been tested with mypy 2.1.0 and pyright 1.1.409, and targets vobject version ~0.9.9. Installation adds zero runtime dependencies, making it a lightweight addition to development environments where type checking is already in use.

Use it for:

• Enable mypy or pyright to type-check code that reads or writes iCalendar (.ics) files using vobject.
• Catch type errors in vCard parsing and generation workflows before deployment.
• Improve IDE autocomplete and inline documentation when working with vobject in editors that support type hints.
• Validate data transformation pipelines that convert between calendar and contact formats.

Worth the install?

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

Provides type stubs for the vobject package, enabling type checkers like mypy and pyright to validate code that uses vobject for working with iCalendar and vCard data.

Yes, if you use vobject and run a static type checker. The stubs are actively maintained, have no runtime overhead, and integrate seamlessly into existing type-checking workflows. Skip it if you don't use type checking or work with vobject versions outside ~0.9.9.

Install

types-vobject on PyPI

pip install types-vobject

uv add types-vobject

poetry add types-vobject

Installing types-vobject

Before you install

Low install friction with no runtime dependencies. Actively maintained as part of typeshed with recent releases; last commit was 2026-08-14.

License in practice

Licensed under Apache-2.0 (permissive), allowing free use, modification, and distribution with minimal restrictions.

Quickstart

pip install types-vobject

# In your Python file with type checking enabled:
import vobject

vcal = vobject.readOne(ical_string)

Requires Python 3.10 or later. Type stubs are only useful when running a type checker (mypy, pyright, etc.) over your code.

Verify before relying

• Whether these stubs provide complete coverage of vobject's public API surface.
• Compatibility with vobject versions other than ~0.9.9.

Package facts

Evidence: types_vobject-0.9.9.20260518-py3-none-any.whl

Tags

More Software Development packages