---
id: types-vobject
version: "0.9.9.20260518"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# types-vobject — Typing stubs for vobject

License: permissive · Maintenance: active · Downloads: 124.1K/mo

## 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 above — 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

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

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 124.1K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

type stubs vobject, vobject type hints, mypy vobject typing, pyright vobject annotations, icalendar vcard type checking, vobject static type checking, type-stubs, static-analysis

[View on SkillFed](https://skillfed.io/packages/types-vobject) · [View on PyPI](https://pypi.org/project/types-vobject/)