---
id: types-freezegun
version: "1.1.10"
license: Apache-2.0 license
license_treatment: permissive
maintenance: active
---

# types-freezegun — Typing stubs for freezegun

License: permissive · Maintenance: active · Downloads: 2.9M/mo

## What it is and what it does

This is a PEP 561 type stub package that provides type information for the freezegun time-mocking library. It allows static type checkers like mypy, PyCharm, and pytype to understand and validate the types used in freezegun code without needing runtime execution. The stubs are sourced from the typeshed project, a centralized repository of type definitions for the Python ecosystem.

However, this package is largely obsolete: freezegun has shipped with its own type annotations since version 1.2.1, making separate stubs unnecessary for modern installations. The package has not been updated since 2022-06-09, and the description explicitly recommends uninstalling it if you use freezegun 1.2.1 or newer.

Use it for:

- Type-checking legacy projects that depend on freezegun versions older than 1.2.1 without built-in type support.
- Providing type hints in environments where freezegun's bundled stubs are unavailable or not recognized by the type checker.
- Validating freezegun usage in codebases that require strict type checking before freezegun added native type annotations.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Provides type stubs for the freezegun time-mocking library, enabling type checkers like mypy and PyCharm to validate code that uses freezegun.

No, unless you are locked into freezegun < 1.2.1. For any modern freezegun installation (1.2.1+), uninstall this package and rely on freezegun's built-in type stubs instead. The package has not been updated since 2022-06-09 and the project itself recommends against using it with current freezegun versions.

## Install

pip install types-freezegun
uv add types-freezegun
poetry add types-freezegun

## Installing types-freezegun

Before you install: Low install friction with no runtime dependencies. However, the package is outdated: freezegun has included its own type annotations since version 1.2.1, making this stub package unnecessary for modern freezegun installations. Last release was 2022-06-09, significantly in the past.

License in practice: Licensed under Apache-2.0, a permissive open-source license with no significant restrictions on use or redistribution.

Quickstart:

pip install types-freezegun

# Then use freezegun normally; type checkers will resolve types automatically
import freezegun
with freezegun.freeze_time():
    pass

Only needed if using freezegun < 1.2.1; freezegun 1.2.1+ includes its own type stubs, making this package redundant.

Verify before relying:

- Whether this stub package is still maintained or if typeshed updates are being backported to PyPI
- Compatibility with the latest freezegun versions and whether the stubs remain accurate
- Current status of freezegun's bundled type annotations and how they compare to these stubs

## Package facts

- License: Apache-2.0 license (permissive)
- Python support: unspecified
- Install friction: low
- Maintenance: active
- Downloads: 2.9M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

freezegun type stubs, type checking freezegun, mypy freezegun types, freezegun type hints, PEP 561 type stubs, freezegun typing support, type-stubs, deprecated

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