Skip to main content

Occy Strap

Occy Strap is a Docker/OCI container image manipulation toolkit that lets you work with container images without requiring Docker to be installed. It follows a flexible input -> filter -> output pipeline: download images from registries, local Docker/Podman daemons, or tarballs; transform them with filters (normalize timestamps for reproducible builds, exclude files, search for content); and export them to tarballs, directories, OCI runtime bundles, or push them to a registry. A persistent filtering registry proxy supports batch builds and pull-through caching.

It will mostly be of interest to people building container images in CI, mirroring images into airgapped environments, or wanting reproducible image builds.

Installation

pip install occystrap

See docs/installation.md for details and verification steps.

Usage

# Download from registry to tarball
occystrap process registry://docker.io/library/busybox:latest tar://busybox.tar

# Download from registry to directory
occystrap process registry://docker.io/library/busybox:latest dir://busybox

# Export from local Docker to tarball with timestamp normalization
occystrap process docker://myimage:v1 tar://output.tar -f normalize-timestamps

# Search for files in an image
occystrap search registry://docker.io/library/busybox:latest "bin/*sh"

# Inspect image metadata
occystrap info registry://docker.io/library/busybox:latest

# Validate an image end to end
occystrap check registry://docker.io/library/busybox:latest

See the command reference for all commands, URI schemes, filters, authentication, compression, verification, the layer cache, the registry proxy, and the legacy command mappings.

Documentation

In the docs/ directory:

Project reference files:

This project includes Claude Code skills in .claude/skills/ covering documentation updates, testing discipline, and PR preparation.

License

Apache License 2.0. See LICENSE.

Metadata

Release files for occystrap 0.4.18

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for occystrap 0.4.18
File Size Uploaded Provenance Actions
occystrap-0.4.18.tar.gz 307.8 kB With provenance Details for occystrap-0.4.18.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for occystrap 0.4.18
File Interpreter ABI Platform Actions
occystrap-0.4.18-py3-none-any.whl Python 3 none any Details for occystrap-0.4.18-py3-none-any.whl

Total release size: 428.9 kB

Release files / occystrap-0.4.18.tar.gz

Download URL occystrap-0.4.18.tar.gz
Size 307.8 kB
Tags Source
SHA-256 checksum
How to use checksums
1f17e53f66cf8e31033b1fec9a26b802e7fef33b71c49899f8b20b2471705e33
BLAKE2b-256 checksum
How to use checksums
fc42c2d1708894b0b42be31714bcb077023debd6cd755592b7c8f10aa1e6f9c5
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 2, 2026.

Transparency log

Release files / occystrap-0.4.18-py3-none-any.whl

Download URL occystrap-0.4.18-py3-none-any.whl
Size 121.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
9932590bb29a9c8dcb9dcf164624f6262d27c470a5f148a64250789b79221ad5
BLAKE2b-256 checksum
How to use checksums
101eec8e7d718f80ee6efd80fbf9a2af37b223fd671079ad2ebfd541593765cc
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 2, 2026.

Transparency log

Security for occystrap 0.4.18

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for occystrap-0.4.18.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 2, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page