Metadata-Version: 2.4
Name: fabricatio-checkpoint
Version: 0.3.2
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Typing :: Typed
Requires-Dist: fabricatio-core
Requires-Dist: typer>=0.15.2 ; extra == 'cli'
Provides-Extra: cli
Summary: An extension of fabricatio
Author-email: Whth <zettainspector@foxmail.com>
License-Expression: MIT
Requires-Python: >=3.12, <3.15
Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
Project-URL: Homepage, https://github.com/Whth/fabricatio
Project-URL: Issues, https://github.com/Whth/fabricatio/issues
Project-URL: Repository, https://github.com/Whth/fabricatio

# `fabricatio-checkpoint`

[MIT](https://img.shields.io/badge/license-MIT-blue.svg)
![Python Versions](https://img.shields.io/pypi/pyversions/fabricatio-checkpoint)
[![PyPI Version](https://img.shields.io/pypi/v/fabricatio-checkpoint)](https://pypi.org/project/fabricatio-checkpoint/)
[![PyPI Downloads](https://static.pepy.tech/badge/fabricatio-checkpoint/week)](https://pepy.tech/projects/fabricatio-checkpoint)
[![PyPI Downloads](https://static.pepy.tech/badge/fabricatio-checkpoint)](https://pepy.tech/projects/fabricatio-checkpoint)
[![Bindings: PyO3](https://img.shields.io/badge/bindings-pyo3-green)](https://github.com/PyO3/pyo3)
[![Build Tool: uv + maturin](https://img.shields.io/badge/built%20with-uv%20%2B%20maturin-orange)](https://github.com/astral-sh/uv)

An extension of fabricatio.

---

## 📦 Installation

This package is part of the `fabricatio` monorepo and can be installed as an optional dependency using either pip or uv:

```bash
pip install fabricatio[checkpoint]
# or
uv pip install fabricatio[checkpoint]
```

For a full installation that includes this package and all other components of `fabricatio`:

```bash
pip install fabricatio[full]
# or
uv pip install fabricatio[full]
```

## 🔍 Overview

Provides version control and checkpointing capabilities for fabricatio workflows, allowing users to save, rollback, and
manage states of their worktrees using a git-like shadow repository system. It enables seamless state management during
complex AI-driven processes, supporting both individual file rollbacks and full worktree resets to maintain workflow
consistency and enable experimentation.

## 🧩 Key Features

- **Checkpoint Saving**: Save current worktree state with custom messages to preserve progress at any point
- **Selective Rollback**: Rollback individual files to previous checkpoints without affecting other files
- **Full Reset**: Reset entire worktree to any saved checkpoint state for complete state restoration
- **Diff Tracking**: Retrieve file differences between checkpoints to understand changes over time
- **Shadow Repository Management**: Automatic handling of git-like shadow repositories with configurable caching
- **Workflow Integration**: Seamless integration with fabricatio agents for reliable state management in AI workflows

## 🔗 Dependencies

Core dependencies:

- `fabricatio-core` - Core interfaces and utilities

No additional dependencies required.

## 📄 License

MIT – see [LICENSE](../../LICENSE)


