swarmauri_gitfilter_file 0.3.0.dev31

Filesystem git filter for Peagen

---

Swarmauri Git Filter File

Filesystem backed git filter for Peagen.

FileFilter combines the FileStorageAdapter storage backend with the GitFilterBase helpers from swarmauri_base. The filter stores git-cleaned objects beneath a local directory, deduplicating each payload by its SHA-256 digest and retrieving the bytes on smudge.

Installation

Install the package with your preferred Python packaging tool:

pip install swarmauri_gitfilter_file

poetry add swarmauri_gitfilter_file

uv pip install swarmauri_gitfilter_file

Usage

FileFilter.from_uri accepts file:// URIs and resolves them to the directory where objects will be stored. You can also instantiate FileFilter directly by passing an output_dir.

import tempfile
from pathlib import Path

from swarmauri_gitfilter_file import FileFilter

with tempfile.TemporaryDirectory() as tmpdir:
    uri = Path(tmpdir).as_uri()
    filt = FileFilter.from_uri(uri)
    oid = filt.clean(b"hello")
    assert oid.startswith("sha256:")
    assert filt.smudge(oid) == b"hello"

The returned object identifier includes the sha256: prefix, matching the digest used to deduplicate objects on disk.

Want to help?

If you want to contribute to swarmauri-sdk, read up on our guidelines for contributing that will help you get started.