caf

Caf (content addressable files) is a CLI utility that allows you to:

  • Create random files using caf gen
  • Verify the generated files have not been tampered with caf verify

That's it. Generate files with random content and verify the files haven't changed. The caf gen command gives control over both the number of files to create as well as the size of the files created. It even lets you specify the distribution of file sizes (more on that in a bit).

Caf is also designed in a way that allows for parallel file generation as well as parallel file validation. It can seamlessly scale up to billions of files.

For example, create a set of random files up to 10MB (the default file size is 4k):

$ caf gen --max-disk-usage 10MB

You can then verify the files are all there:

$ caf verify

Both commands take --jobs to spread their work over worker threads. Generation splits a single large file across threads, and verification splits the store across them. The results are identical at any value, so it only changes how long the command takes:

$ caf gen --max-files 1 --file-size 4GB --jobs 8
$ caf verify --jobs 8

The --help output of the caf gen command contains many more examples.

Project links

Data verified by PyPI on Aug 24, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for jamesls from gravatar.com jamesls

Credits

Author: James Saryerwinnie

GitHub Statistics

Data verified by PyPI on Aug 24, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License expression

Apache-2.0
View SPDX License List

Requires

Python >=3.8

Tags

caf

Classifiers

Report project as malware

Download files

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

Source Distribution

caf-0.4.0.tar.gz (121.3 kB view details)

Uploaded Source

Built Distributions

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

caf-0.4.0-py3-none-musllinux_1_2_x86_64.whl (683.4 kB view details)

Uploaded Python 3musllinux: musl 1.2+ x86-64

caf-0.4.0-py3-none-musllinux_1_2_aarch64.whl (652.7 kB view details)

Uploaded Python 3musllinux: musl 1.2+ ARM64

caf-0.4.0-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (619.6 kB view details)

Uploaded Python 3manylinux: glibc 2.17+ x86-64

caf-0.4.0-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (603.7 kB view details)

Uploaded Python 3manylinux: glibc 2.17+ ARM64

caf-0.4.0-py3-none-macosx_11_0_arm64.whl (581.1 kB view details)

Uploaded Python 3macOS 11.0+ ARM64

caf-0.4.0-py3-none-macosx_10_12_x86_64.whl (589.3 kB view details)

Uploaded Python 3macOS 10.12+ x86-64

File details

Details for the file caf-0.4.0.tar.gz.

File metadata

  • Download URL: caf-0.4.0.tar.gz
  • Upload date:
  • Size: 121.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for caf-0.4.0.tar.gz
Algorithm Hash digest
SHA256 635829acb099067ed2325f4d1a210359d08e2126ef61cc2371a52a7f254bed9f
MD5 d7e2415cae953d3655597054a275bcae
BLAKE2b-256 4e994190c1b81d636af05c70466dc6a237294e1da00852f7bbf57879eb13c284

See more details on using hashes here.

Provenance

The following attestation bundles were made for caf-0.4.0.tar.gz:

Publisher: publish.yml on jamesls/caf

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file caf-0.4.0-py3-none-musllinux_1_2_x86_64.whl.

File metadata

  • Download URL: caf-0.4.0-py3-none-musllinux_1_2_x86_64.whl
  • Upload date:
  • Size: 683.4 kB
  • Tags: Python 3, musllinux: musl 1.2+ x86-64
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for caf-0.4.0-py3-none-musllinux_1_2_x86_64.whl
Algorithm Hash digest
SHA256 a08154019215157759c00c84df8da2be2b33f8c02b686ef6a53e781452a14183
MD5 a04ac71626f877022219292162091032
BLAKE2b-256 7e2a62a35ce4c2dfdb580c64b588b1d2605ce25857ed4dcb99b643e04ba31fb0

See more details on using hashes here.

Provenance

The following attestation bundles were made for caf-0.4.0-py3-none-musllinux_1_2_x86_64.whl:

Publisher: publish.yml on jamesls/caf

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file caf-0.4.0-py3-none-musllinux_1_2_aarch64.whl.

File metadata

  • Download URL: caf-0.4.0-py3-none-musllinux_1_2_aarch64.whl
  • Upload date:
  • Size: 652.7 kB
  • Tags: Python 3, musllinux: musl 1.2+ ARM64
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for caf-0.4.0-py3-none-musllinux_1_2_aarch64.whl
Algorithm Hash digest
SHA256 8c48e935bee863df4cbfff106705fbc42f5542f0c790fb55355d8bfeb222917f
MD5 248fb1feb1228cb3067b27b4c09017c3
BLAKE2b-256 826bfc3d1746d62fd4b9390fa044f37b30ab84df2eb68d866fd06a1f49de199e

See more details on using hashes here.

Provenance

The following attestation bundles were made for caf-0.4.0-py3-none-musllinux_1_2_aarch64.whl:

Publisher: publish.yml on jamesls/caf

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file caf-0.4.0-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for caf-0.4.0-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 fac08989bca7dcad6d92f715548644ef4f420c8d487577a87cb8eebdc9a42b6b
MD5 0e26e0391783a2e005d8068dbbc5d159
BLAKE2b-256 c7b6f5fc99a4d17440b8c79b3066622f3ce46e2132ce02522f2d6f75e337eade

See more details on using hashes here.

Provenance

The following attestation bundles were made for caf-0.4.0-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl:

Publisher: publish.yml on jamesls/caf

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file caf-0.4.0-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl.

File metadata

File hashes

Hashes for caf-0.4.0-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Algorithm Hash digest
SHA256 64d3afef37854de94fc49ed8f542b80b36c5e29af25ec2636f96bca9f64c930f
MD5 4793669caab1a601e2d9d78b3db060e9
BLAKE2b-256 4b69eeb254120aa49fc000015a2e78c88b73fe1fd297b1635ba64a43b41c2793

See more details on using hashes here.

Provenance

The following attestation bundles were made for caf-0.4.0-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl:

Publisher: publish.yml on jamesls/caf

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file caf-0.4.0-py3-none-macosx_11_0_arm64.whl.

File metadata

  • Download URL: caf-0.4.0-py3-none-macosx_11_0_arm64.whl
  • Upload date:
  • Size: 581.1 kB
  • Tags: Python 3, macOS 11.0+ ARM64
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for caf-0.4.0-py3-none-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 f87354ad3eec7844c9c62a46a47c0dc4d87ed0d903643dd1e2d516529768d9b1
MD5 82f13ca21c55ecbf53d559e71d7b8474
BLAKE2b-256 8de55feb5e15f97015d1ff28cca872931e3ba978620885f918599398d0f55f6c

See more details on using hashes here.

Provenance

The following attestation bundles were made for caf-0.4.0-py3-none-macosx_11_0_arm64.whl:

Publisher: publish.yml on jamesls/caf

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file caf-0.4.0-py3-none-macosx_10_12_x86_64.whl.

File metadata

  • Download URL: caf-0.4.0-py3-none-macosx_10_12_x86_64.whl
  • Upload date:
  • Size: 589.3 kB
  • Tags: Python 3, macOS 10.12+ x86-64
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for caf-0.4.0-py3-none-macosx_10_12_x86_64.whl
Algorithm Hash digest
SHA256 f268868e4ee825238872df15cdf164da07654cf654ebd19cb782d7621216823f
MD5 b1766c119847c2bcc338c75b2bdde1cf
BLAKE2b-256 58ea1da7b1695fc13ea787d0098bce8f3632d2ea9434ebca28d78d90f00d606e

See more details on using hashes here.

Provenance

The following attestation bundles were made for caf-0.4.0-py3-none-macosx_10_12_x86_64.whl:

Publisher: publish.yml on jamesls/caf

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

This release

0.4.0 This release

7 files

0.3.1

7 files

0.3.0

6 files

0.2.0

2 files

0.1.1

2 files

0.1.0

2 files

0.0.1

2 files

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page