Skip to main content

blossom-cli

blossom-cli is a thin Python wrapper that makes the upstream Rust Blossom client available through uvx:

uvx blossom-cli --version
uvx blossom-cli status
uvx blossom-cli upload ./file.pdf

The wrapper preserves the upstream command-line API. It does not add, rename, or reinterpret Rust CLI commands. It resolves the upstream executable in this order:

  1. BLOSSOM_RUST_CLI_BIN, when explicitly configured.
  2. A blossom-cli executable already available on PATH.
  3. A versioned executable in the user cache.
  4. cargo install blossom-cli --version 0.5.6 --locked into the user cache.

This package does not contain or reimplement the Blossom protocol. The Rust executable and protocol implementation come from MonumentalSystems/blossom-rs, which is published under the MIT License. This project exists only to provide a convenient uvx entry point for that upstream project.

Configuration

The upstream CLI continues to own all options and environment variables, including BLOSSOM_SECRET_KEY:

export BLOSSOM_SERVER="https://blossom.example.com"
export BLOSSOM_SECRET_KEY="<your-secret-key>"

uvx blossom-cli --server "$BLOSSOM_SERVER" --format json --no-publish upload ./file.pdf

Use uvx blossom-cli --help for the complete command surface. Read the upstream documentation for Blossom protocol behavior and server compatibility.

Development

uv sync --dev
uv run pytest
uv build

To test the wrapper against a locally available Rust executable without compiling anything:

BLOSSOM_RUST_CLI_BIN=/path/to/blossom-cli uvx --from . blossom-cli --version

License

The wrapper code is released under the MIT License; see LICENSE. The upstream project has separate MIT license terms reproduced in licenses/blossom-rs-MIT.txt.

Download files

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

Source Distribution

blossom_cli-0.5.6.tar.gz (13.0 kB view details)

Uploaded Source

Built Distributions

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

blossom_cli-0.5.6-py3-none-manylinux_2_35_x86_64.whl (7.4 kB view details)

Uploaded Python 3manylinux: glibc 2.35+ x86-64

blossom_cli-0.5.6-py3-none-any.whl (6.9 kB view details)

Uploaded Python 3

blossom_cli-0.5.6-cp314-cp314-macosx_15_0_x86_64.whl (7.4 kB view details)

Uploaded CPython 3.14macOS 15.0+ x86-64

blossom_cli-0.5.6-cp314-cp314-macosx_14_0_arm64.whl (7.4 kB view details)

Uploaded CPython 3.14macOS 14.0+ ARM64

blossom_cli-0.5.6-cp312-cp312-win_amd64.whl (7.4 kB view details)

Uploaded CPython 3.12Windows x86-64

File details

Details for the file blossom_cli-0.5.6.tar.gz.

File metadata

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

File hashes

Hashes for blossom_cli-0.5.6.tar.gz
Algorithm Hash digest
SHA256 b05c5c2d5aef400acbfa9bd7c6d47441d9ed7724c38aef114a8262ab88dc234b
MD5 fcce36ee2c2b5a8dd0a7c285d390cfab
BLAKE2b-256 c75a2b3ee3b3969af62141fc9c84f92799eaade75eac1c09fd8bf0d0761d067e

See more details on using hashes here.

Provenance

The following attestation bundles were made for blossom_cli-0.5.6.tar.gz:

Publisher: publish.yml on brenorb/blossom-cli

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

File details

Details for the file blossom_cli-0.5.6-py3-none-manylinux_2_35_x86_64.whl.

File metadata

File hashes

Hashes for blossom_cli-0.5.6-py3-none-manylinux_2_35_x86_64.whl
Algorithm Hash digest
SHA256 6da25023f2a537d1baecf068347f43e86f0e9b24d927c5c3c9ebe8dabcf0588a
MD5 8f7b48f11a674782a742793debfcf1a6
BLAKE2b-256 5f6e901d182744a7db6953ca99d35cb6360b37e11b31164094f32c78686206ff

See more details on using hashes here.

Provenance

The following attestation bundles were made for blossom_cli-0.5.6-py3-none-manylinux_2_35_x86_64.whl:

Publisher: publish.yml on brenorb/blossom-cli

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

File details

Details for the file blossom_cli-0.5.6-py3-none-any.whl.

File metadata

  • Download URL: blossom_cli-0.5.6-py3-none-any.whl
  • Upload date:
  • Size: 6.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for blossom_cli-0.5.6-py3-none-any.whl
Algorithm Hash digest
SHA256 7c047ce9423b51d6fbb61d02a4fd0f977ff671777025f46dc5106f13837acf9b
MD5 e1e761938f73830ef901f6f146422148
BLAKE2b-256 a7108f04bbaa93a857e3a72cfb32a18489d02bf5a9f7ccc7d84aeda6e66b4131

See more details on using hashes here.

Provenance

The following attestation bundles were made for blossom_cli-0.5.6-py3-none-any.whl:

Publisher: publish.yml on brenorb/blossom-cli

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

File details

Details for the file blossom_cli-0.5.6-cp314-cp314-macosx_15_0_x86_64.whl.

File metadata

File hashes

Hashes for blossom_cli-0.5.6-cp314-cp314-macosx_15_0_x86_64.whl
Algorithm Hash digest
SHA256 732bf968a3a78c3b60703947374da9643f3d49948fd7575c3d6af4b0eed17dd9
MD5 0e6f95fa7305d38e3a2d7f4bba339a96
BLAKE2b-256 d856724bd661705296db924842924d202d41977dcd9c4070f9e2456644387e07

See more details on using hashes here.

Provenance

The following attestation bundles were made for blossom_cli-0.5.6-cp314-cp314-macosx_15_0_x86_64.whl:

Publisher: publish.yml on brenorb/blossom-cli

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

File details

Details for the file blossom_cli-0.5.6-cp314-cp314-macosx_14_0_arm64.whl.

File metadata

File hashes

Hashes for blossom_cli-0.5.6-cp314-cp314-macosx_14_0_arm64.whl
Algorithm Hash digest
SHA256 52ba81125861d8d30f42a4e73163539d244962c4db7be87a23278fe45c0db27f
MD5 1675409f3f7d1f341d9ac9e1b637bbe1
BLAKE2b-256 51641b37ce8a81cdb2233553a529cddf1aa738d7de10730398aa77f567eaa3e7

See more details on using hashes here.

Provenance

The following attestation bundles were made for blossom_cli-0.5.6-cp314-cp314-macosx_14_0_arm64.whl:

Publisher: publish.yml on brenorb/blossom-cli

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

File details

Details for the file blossom_cli-0.5.6-cp312-cp312-win_amd64.whl.

File metadata

File hashes

Hashes for blossom_cli-0.5.6-cp312-cp312-win_amd64.whl
Algorithm Hash digest
SHA256 69b43d685b2f7f6558f56b374f67c2ca0994c2aa4bef6f0b2e682fc0fe6f7acd
MD5 24dcfcb49435b9a72da08f9e240e6df9
BLAKE2b-256 2050eb4997995a92f633548914afdb286d480077840bd15b304a08b8e7cf76f9

See more details on using hashes here.

Provenance

The following attestation bundles were made for blossom_cli-0.5.6-cp312-cp312-win_amd64.whl:

Publisher: publish.yml on brenorb/blossom-cli

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

Supported by

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