# time-machine

> Travel through time in your tests.

- **URL**: https://www.freshcrate.ai/projects/time-machine
- **Author**: pypi
- **Category**: Frameworks
- **Latest version**: `main@2026-06-01` (2026-06-01)
- **License**: Unknown
- **Source**: https://github.com/adamchainz/time-machine
- **Homepage**: https://pypi.org/project/time-machine/
- **Language**: Python
- **GitHub**: 965 stars, 47 forks
- **Registry**: pypi (`time-machine`)
- **Tags**: `date`, `datetime`, `mock`, `pypi`, `test`, `testing`, `tests`, `time`, `warp`

## Description

============
time-machine
============

.. image:: https://img.shields.io/readthedocs/time-machine?style=for-the-badge
   :target: https://time-machine.readthedocs.io/en/latest/

.. image:: https://img.shields.io/github/actions/workflow/status/adamchainz/time-machine/main.yml.svg?branch=main&style=for-the-badge
   :target: https://github.com/adamchainz/time-machine/actions?workflow=CI

.. image:: https://img.shields.io/badge/Coverage-100%25-success?style=for-the-badge
   :target: https://github.com/adamchainz/time-machine/actions?workflow=CI

.. image:: https://img.shields.io/pypi/v/time-machine.svg?style=for-the-badge
   :target: https://pypi.org/project/time-machine/

.. image:: https://img.shields.io/badge/code%20style-black-000000.svg?style=for-the-badge
   :target: https://github.com/psf/black

.. image:: https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit&logoColor=white&style=for-the-badge
   :target: https://github.com/pre-commit/pre-commit
   :alt: pre-commit

----

.. figure:: https://raw.githubusercontent.com/adamchainz/time-machine/main/docs/_static/logo.svg
  :alt: time-machine logo
  :align: center

Documentation
=============

Please see https://time-machine.readthedocs.io/.

## Recent releases

| Version | Date | Urgency | Changes |
| --- | --- | --- | --- |
| `main@2026-06-01` | 2026-06-01 | High | Latest activity on main branch |
| `3.2.0` | 2026-04-21 | Low | Imported from PyPI (3.2.0) |
| `3.1.0` | 2025-11-21 | Low | Tag 3.1.0 |
| `3.0.0` | 2025-11-18 | Low | Tag 3.0.0 |
| `2.19.0` | 2025-08-19 | Low | Tag 2.19.0 |
| `2.18.0` | 2025-08-18 | Low | Tag 2.18.0 |
| `2.17.0` | 2025-08-05 | Low | Tag 2.17.0 |
| `2.16.0` | 2024-10-08 | Low | Tag 2.16.0 |
| `2.15.0` | 2024-08-06 | Low | Tag 2.15.0 |
| `2.14.2` | 2024-06-29 | Low | Tag 2.14.2 |

## Citation

- HTML: https://www.freshcrate.ai/projects/time-machine
- Markdown: https://www.freshcrate.ai/projects/time-machine.md
- Dependencies JSON: https://www.freshcrate.ai/api/projects/time-machine/deps

_Generated by freshcrate.ai. Indexes pypi releases for AI-agent ecosystem packages._