gripsack (python frontend)

Typed module DSL for gripsack. Modules written against this package evaluate to IR (JSON) that the grip core consumes. Fully annotated — ships py.typed (PEP 561), so pyright gives you autocomplete, inline errors, and refactors.

from gripsack import module, github_release, symlink, tracked_copy, dep

helix = module(
    "helix",
    fetch=github_release(
        repo="helix-editor/helix",
        asset="helix-{version}-x86_64-linux.tar.xz",
    ),
    install={"bin/hx": symlink("~/.local/bin/hx")},
    config={"config.toml": tracked_copy("~/.config/helix/config.toml")},
    depends=[dep("git")],
)

API overview

area	exports
modules	`module`, `Module`
fetchers	`github_release`, `tarball`, `git`, `file_fetch`, `plugin_fetch`
destinations	`symlink`, `tracked_copy`, `merge`, `template`
dependencies	`dep(module, edge="runtime")`
activation	`service`, `fonts`, `desktop_entry`, `custom_hook`
steps	`step`, `fetch_step`, `build_step`, `shell_step`
verify	`verify_binary`, `verify_file`, `verify_shell`
graph	`emit_ir`, `clear_graph`, `current_facts`

Modules are data: evaluation emits IR; the Rust core only ever consumes IR. Every module captures a source span so core errors point back at the exact line of your code.

API is pre-alpha and will change with the IR schema (plan).

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

gripsack-0.9.0.tar.gz (27.7 kB view details)

Uploaded Aug 25, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

gripsack-0.9.0-py3-none-any.whl (23.4 kB view details)

Uploaded Aug 25, 2026 Python 3

File details

Details for the file gripsack-0.9.0.tar.gz.

File metadata

Download URL: gripsack-0.9.0.tar.gz
Upload date: Aug 25, 2026
Size: 27.7 kB
Tags: Source
Uploaded using Trusted Publishing? No
Uploaded via: uv/0.12.5 {"installer":{"name":"uv","version":"0.12.5","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for gripsack-0.9.0.tar.gz
Algorithm	Hash digest
SHA256	`a3bd2cbf94b56f2eff5c75be3d684d87bb5961273a6347dd2a16a0806a1ebe2b`
MD5	`075037a27925b82580d05d47159de525`
BLAKE2b-256	`528ff22671899ff54c7443c97b05455a2c9e8603b3b6b7cb3562a057b3212e79`

See more details on using hashes here.

File details

Details for the file gripsack-0.9.0-py3-none-any.whl.

File metadata

Download URL: gripsack-0.9.0-py3-none-any.whl
Upload date: Aug 25, 2026
Size: 23.4 kB
Tags: Python 3
Uploaded using Trusted Publishing? No
Uploaded via: uv/0.12.5 {"installer":{"name":"uv","version":"0.12.5","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for gripsack-0.9.0-py3-none-any.whl
Algorithm	Hash digest
SHA256	`9436f02c311b938c295e14303841a5d019af45b9c1a229fa7485a6af0740a167`
MD5	`8591affb5d99eee52de26e7d72e85170`
BLAKE2b-256	`8290d1b5c7ba2d67ce8528e89302ae8536eaeb17ddc479eb61b5a5f39ae01066`