brotli-rs 9.0.0__tar.gz

brotli_rs-9.0.0/.gitattributes

@@ -0,0 +1,4 @@
+licenses/** linguist-vendored=true
+tests/upstream/** linguist-vendored=true
+# Codec fixtures are binary inputs even when their contents look like text.
+tests/upstream/**/testdata/** -text

brotli_rs-9.0.0/.github/workflows/ci.yml

@@ -0,0 +1,65 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  test:
+    name: Python ${{ matrix.python }} on ${{ matrix.os }}
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - os: ubuntu-latest
+            python: "3.11"
+          - os: ubuntu-latest
+            python: "3.12"
+          - os: ubuntu-latest
+            python: "3.13"
+          - os: ubuntu-latest
+            python: "3.14"
+          - os: ubuntu-latest
+            python: "3.15"
+          - os: macos-latest
+            python: "3.12"
+          - os: windows-latest
+            python: "3.12"
+    steps:
+      - uses: actions/checkout@v6
+      - uses: actions/setup-python@v6
+        with:
+          python-version: ${{ matrix.python }}
+      - uses: dtolnay/rust-toolchain@stable
+      - name: Install test tools
+        run: python -m pip install maturin pytest hypothesis "Brotli==1.2.1"
+      - name: Build wheel
+        run: maturin build --release --locked --out dist
+      - name: Install wheel
+        run: python -m pip install --no-index --find-links=dist --force-reinstall brotli-rs
+      - name: Test
+        run: pytest
+
+  rust:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+      - uses: dtolnay/rust-toolchain@stable
+        with:
+          components: clippy, rustfmt
+      - run: cargo fmt --check
+      - run: cargo clippy --locked --all-targets -- -D warnings
+
+  minimum-rust:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+      - uses: dtolnay/rust-toolchain@1.85
+      - run: cargo check --locked
+

brotli_rs-9.0.0/.github/workflows/release.yml

@@ -0,0 +1,156 @@
+name: Release
+
+on:
+  release:
+    types: [published]
+
+permissions:
+  contents: read
+
+jobs:
+  version:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+      - name: Match tag to package version
+        env:
+          RELEASE_TAG: ${{ github.event.release.tag_name }}
+        run: |
+          python - <<'PY'
+          import os
+          import tomllib
+
+          with open("pyproject.toml", "rb") as file:
+              version = tomllib.load(file)["project"]["version"]
+          expected = f"v{version}"
+          actual = os.environ["RELEASE_TAG"]
+          if actual != expected:
+              raise SystemExit(f"release tag {actual!r} must be {expected!r}")
+          PY
+
+  linux:
+    needs: version
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        target: [x86_64, aarch64]
+    steps:
+      - uses: actions/checkout@v6
+      - uses: actions/setup-python@v6
+        with:
+          python-version: "3.11"
+      - uses: PyO3/maturin-action@v1
+        with:
+          target: ${{ matrix.target }}
+          args: --release --locked --out dist
+          manylinux: auto
+      - uses: actions/upload-artifact@v6
+        with:
+          name: wheels-linux-${{ matrix.target }}
+          path: dist
+
+  musllinux:
+    needs: version
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        target: [x86_64, aarch64]
+    steps:
+      - uses: actions/checkout@v6
+      - uses: actions/setup-python@v6
+        with:
+          python-version: "3.11"
+      - uses: PyO3/maturin-action@v1
+        with:
+          target: ${{ matrix.target }}
+          args: --release --locked --out dist
+          manylinux: musllinux_1_2
+      - uses: actions/upload-artifact@v6
+        with:
+          name: wheels-musllinux-${{ matrix.target }}
+          path: dist
+
+  windows:
+    needs: version
+    runs-on: ${{ matrix.runner }}
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - runner: windows-latest
+            target: x64
+            python_architecture: x64
+          - runner: windows-11-arm
+            target: aarch64
+            python_architecture: arm64
+    steps:
+      - uses: actions/checkout@v6
+      - uses: actions/setup-python@v6
+        with:
+          python-version: "3.13"
+          architecture: ${{ matrix.python_architecture }}
+      - uses: PyO3/maturin-action@v1
+        with:
+          target: ${{ matrix.target }}
+          args: --release --locked --out dist
+      - uses: actions/upload-artifact@v6
+        with:
+          name: wheels-windows-${{ matrix.target }}
+          path: dist
+
+  macos:
+    needs: version
+    runs-on: ${{ matrix.runner }}
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - runner: macos-15-intel
+            target: x86_64
+          - runner: macos-latest
+            target: aarch64
+    steps:
+      - uses: actions/checkout@v6
+      - uses: actions/setup-python@v6
+        with:
+          python-version: "3.11"
+      - uses: PyO3/maturin-action@v1
+        with:
+          target: ${{ matrix.target }}
+          args: --release --locked --out dist
+      - uses: actions/upload-artifact@v6
+        with:
+          name: wheels-macos-${{ matrix.target }}
+          path: dist
+
+  sdist:
+    needs: version
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+      - uses: PyO3/maturin-action@v1
+        with:
+          command: sdist
+          args: --out dist
+      - uses: actions/upload-artifact@v6
+        with:
+          name: sdist
+          path: dist
+
+  publish:
+    runs-on: ubuntu-latest
+    needs: [linux, musllinux, windows, macos, sdist]
+    environment: pypi
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@v7
+        with:
+          path: dist
+          merge-multiple: true
+      - uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          packages-dir: dist
+

brotli_rs-9.0.0/.gitignore

@@ -0,0 +1,8 @@
+/target/
+/.pytest_cache/
+/.hypothesis/
+/.venv/
+/dist/
+*.so
+__pycache__/
+

brotli_rs-9.0.0/Cargo.lock

@@ -0,0 +1,170 @@
+# This file is automatically @generated by Cargo.
+# It is not intended for manual editing.
+version = 3
+
+[[package]]
+name = "alloc-no-stdlib"
+version = "3.0.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c2fb6cfd47bf496ff64095c20eaba0c201404ee38714d4142fcfa1dc334fcc7a"
+
+[[package]]
+name = "alloc-stdlib"
+version = "0.3.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0b5c1865780388bfa186411ab5f247819487fc4864c6e9c3106611fa347586e1"
+dependencies = [
+ "alloc-no-stdlib",
+]
+
+[[package]]
+name = "brotli"
+version = "9.0.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f8b851b75c23ca7873623d612fe49bd1989aeb03d08fb9432187eb253d3d4c6b"
+dependencies = [
+ "alloc-no-stdlib",
+ "alloc-stdlib",
+ "brotli-decompressor",
+]
+
+[[package]]
+name = "brotli-decompressor"
+version = "6.0.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "941cd9bd4ddab83cb46fa5a2d428f1c857b24ac78cb876cf7beb710840934bd7"
+dependencies = [
+ "alloc-no-stdlib",
+ "alloc-stdlib",
+]
+
+[[package]]
+name = "brotli-rs-python"
+version = "9.0.0"
+dependencies = [
+ "brotli",
+ "brotli-decompressor",
+ "pyo3",
+]
+
+[[package]]
+name = "heck"
+version = "0.5.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "2304e00983f87ffb38b55b444b5e3b60a884b5d30c0fca7d82fe33449bbe55ea"
+
+[[package]]
+name = "libc"
+version = "0.2.191"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "65cd87c9a6d60536580b316ad985726104730a5151c99845f2490428ef91240a"
+
+[[package]]
+name = "once_cell"
+version = "1.21.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9f7c3e4beb33f85d45ae3e3a1792185706c8e16d043238c593331cc7cd313b50"
+
+[[package]]
+name = "portable-atomic"
+version = "1.15.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "05c8b63e8d9609db387f0324918f81d68fe27748f084ef092fb35954d0539a85"
+
+[[package]]
+name = "proc-macro2"
+version = "1.0.107"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "985e7ec9bb745e6ce6535b544d84d6cd6f7ad8bd711c398938ae983b91a766d9"
+dependencies = [
+ "unicode-ident",
+]
+
+[[package]]
+name = "pyo3"
+version = "0.30.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "229ca13b8a15bb0d1487b81ab975bfcd97513416499a8312011b6036e42e0de4"
+dependencies = [
+ "libc",
+ "once_cell",
+ "portable-atomic",
+ "pyo3-build-config",
+ "pyo3-ffi",
+ "pyo3-macros",
+]
+
+[[package]]
+name = "pyo3-build-config"
+version = "0.30.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "70130e2b6dd1ee589a8788026a429561ca5c40fa7a2fa7914c2282eddae24700"
+dependencies = [
+ "target-lexicon",
+]
+
+[[package]]
+name = "pyo3-ffi"
+version = "0.30.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "5e7ff73c555c286d212d4ce7e5fbda845a973c4f61bd5f160f5f2c3c2a04d1c4"
+dependencies = [
+ "libc",
+ "pyo3-build-config",
+]
+
+[[package]]
+name = "pyo3-macros"
+version = "0.30.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c46d2e5862c7bb8207e3b639f713dda3c499933444784154c11d013c5a691b60"
+dependencies = [
+ "proc-macro2",
+ "pyo3-macros-backend",
+ "quote",
+ "syn",
+]
+
+[[package]]
+name = "pyo3-macros-backend"
+version = "0.30.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "38b89f066f2ae72a2aef52d1537ca2fcd104440ebfadee06e97aa90738a25b9b"
+dependencies = [
+ "heck",
+ "proc-macro2",
+ "quote",
+ "syn",
+]
+
+[[package]]
+name = "quote"
+version = "1.0.47"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1fbf4db142a473a8d80c26bbf18454ed458bf8d26c8219c331daecfdbd079001"
+dependencies = [
+ "proc-macro2",
+]
+
+[[package]]
+name = "syn"
+version = "3.0.9"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d78c8dee4c7bf0e14673097256fed6142ce9d3b85a408189d07482442145823b"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "unicode-ident",
+]
+
+[[package]]
+name = "target-lexicon"
+version = "0.13.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "adb6935a6f5c20170eeceb1a3835a49e12e19d792f6dd344ccc76a985ca5a6ca"
+
+[[package]]
+name = "unicode-ident"
+version = "1.0.27"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "a2c754d6c33795a1c324727428e5a7dedb5b06195f9890bdbcba760d3e246563"

brotli_rs-9.0.0/Cargo.toml

@@ -0,0 +1,21 @@
+[package]
+name = "brotli-rs-python"
+version = "9.0.0"
+edition = "2021"
+rust-version = "1.85"
+license = "MIT"
+description = "Python bindings for the safe-Rust brotli crate"
+repository = "https://github.com/bugsink/brotli-rs"
+homepage = "https://github.com/bugsink/brotli-rs"
+readme = "README.md"
+publish = false
+
+[lib]
+name = "_brotli_rs"
+crate-type = ["cdylib"]
+
+[dependencies]
+brotli = "=9.0.0"
+brotli-decompressor = "=6.0.1"
+pyo3 = { version = "0.30.1", features = ["abi3-py311", "extension-module"] }
+

brotli_rs-9.0.0/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2026 Bugsink
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

brotli_rs-9.0.0/PKG-INFO

@@ -0,0 +1,138 @@
+Metadata-Version: 2.4
+Name: brotli-rs
+Version: 9.0.0
+Classifier: Development Status :: 4 - Beta
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: 3.15
+Classifier: Programming Language :: Rust
+Classifier: Topic :: System :: Archiving :: Compression
+Classifier: Typing :: Typed
+Requires-Dist: brotli==1.2.1 ; extra == 'test'
+Requires-Dist: hypothesis>=6 ; extra == 'test'
+Requires-Dist: pytest>=8 ; extra == 'test'
+Provides-Extra: test
+License-File: LICENSE
+License-File: licenses/README.md
+License-File: licenses/alloc-no-stdlib-3.0.0/LICENSE
+License-File: licenses/alloc-stdlib-0.3.0/LICENSE
+License-File: licenses/brotli-9.0.0/LICENSE.BSD-3-Clause
+License-File: licenses/brotli-9.0.0/LICENSE.MIT
+License-File: licenses/brotli-decompressor-6.0.1/LICENSE
+License-File: licenses/heck-0.5.0/LICENSE-APACHE
+License-File: licenses/heck-0.5.0/LICENSE-MIT
+License-File: licenses/libc-0.2.191/LICENSE-APACHE
+License-File: licenses/libc-0.2.191/LICENSE-MIT
+License-File: licenses/once_cell-1.21.4/LICENSE-APACHE
+License-File: licenses/once_cell-1.21.4/LICENSE-MIT
+License-File: licenses/portable-atomic-1.15.0/LICENSE-APACHE
+License-File: licenses/portable-atomic-1.15.0/LICENSE-MIT
+License-File: licenses/proc-macro2-1.0.107/LICENSE-APACHE
+License-File: licenses/proc-macro2-1.0.107/LICENSE-MIT
+License-File: licenses/pyo3-0.30.1/LICENSE-APACHE
+License-File: licenses/pyo3-0.30.1/LICENSE-MIT
+License-File: licenses/pyo3-build-config-0.30.1/LICENSE-APACHE
+License-File: licenses/pyo3-build-config-0.30.1/LICENSE-MIT
+License-File: licenses/pyo3-ffi-0.30.1/LICENSE-APACHE
+License-File: licenses/pyo3-ffi-0.30.1/LICENSE-MIT
+License-File: licenses/pyo3-macros-0.30.1/LICENSE-APACHE
+License-File: licenses/pyo3-macros-0.30.1/LICENSE-MIT
+License-File: licenses/pyo3-macros-backend-0.30.1/LICENSE-APACHE
+License-File: licenses/pyo3-macros-backend-0.30.1/LICENSE-MIT
+License-File: licenses/quote-1.0.47/LICENSE-APACHE
+License-File: licenses/quote-1.0.47/LICENSE-MIT
+License-File: licenses/syn-3.0.9/LICENSE-APACHE
+License-File: licenses/syn-3.0.9/LICENSE-MIT
+License-File: licenses/target-lexicon-0.13.5/LICENSE
+License-File: licenses/unicode-ident-1.0.27/LICENSE-APACHE
+License-File: licenses/unicode-ident-1.0.27/LICENSE-MIT
+License-File: licenses/unicode-ident-1.0.27/LICENSE-UNICODE
+Summary: Python bindings for the safe-Rust brotli crate
+Keywords: brotli,compression,rust
+Home-Page: https://github.com/bugsink/brotli-rs
+License-Expression: MIT
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
+Project-URL: Issues, https://github.com/bugsink/brotli-rs/issues
+Project-URL: Source, https://github.com/bugsink/brotli-rs
+
+# brotli-rs
+
+Python bindings for Dropbox's safe-Rust
+[`brotli`](https://github.com/dropbox/rust-brotli) crate.
+
+The public API follows the `Brotli` Python package where that can be done
+without inheriting its C extension. The distribution and import names are
+both `brotli-rs` / `brotli_rs`, deliberately avoiding a collision with the
+existing `brotli` module.
+
+```python
+import brotli_rs as brotli
+
+compressed = brotli.compress(b"hello")
+assert brotli.decompress(compressed) == b"hello"
+```
+
+Streaming compression and decompression are available through `Compressor`
+and `Decompressor`. `Decompressor.process()` supports a strict
+`output_buffer_limit`, and both streaming and one-shot decompression accept an
+optional `max_output` limit.
+
+```python
+decoder = brotli.Decompressor(max_output=16 * 1024 * 1024)
+parts = []
+for compressed_chunk in source:
+    while not decoder.is_finished() and not decoder.can_accept_more_data():
+        parts.append(decoder.process(b"", output_buffer_limit=64 * 1024))
+    parts.append(decoder.process(compressed_chunk, output_buffer_limit=64 * 1024))
+while not decoder.is_finished() and not decoder.can_accept_more_data():
+    parts.append(decoder.process(b"", output_buffer_limit=64 * 1024))
+if not decoder.is_finished():
+    raise brotli.error("incomplete stream")
+```
+
+The compatibility surface consists of `compress`, `decompress`,
+`Compressor.process()` / `.flush()` / `.finish()`,
+`Decompressor.process()` / `.can_accept_more_data()` / `.is_finished()`, the
+three `MODE_*` constants, `error`, `version`, and `__version__`. Contiguous
+buffer-protocol inputs are accepted. `version` is a string alias of
+`__version__`, as it is in the current `Brotli` package.
+
+Compressed bytes are not promised to be byte-identical to Google's encoder.
+They are Brotli-compatible streams, tested in both directions against Google
+Brotli 1.2.1. Exception text, subclassing, pickling, non-contiguous buffers,
+and private implementation names are outside the compatibility contract.
+
+The base package version tracks the Rust `brotli` crate exactly.
+Python-binding-only fixes use PEP 440 post releases, such as `9.0.0.post1`,
+while still pinning `brotli = 9.0.0`.
+
+## Why?
+
+What do you think is more secure? World class engineers working at one of
+the world's largest tech companies trying to juggle chainsaws in their spare
+time, or an entirely vibe-coded wrapper in a memory-safe language with a Rust
+crate on the inside?
+
+If you bet on the latter, you've come to the right place.
+
+## Development
+
+Install Rust and Python 3.11 or newer, then:
+
+```console
+python -m venv .venv
+. .venv/bin/activate
+python -m pip install maturin
+maturin develop --extras=test
+pytest
+```
+
+See `tests/upstream/README.md` for the provenance of imported and adapted
+upstream tests.
+
+

brotli_rs-9.0.0/README.md

@@ -0,0 +1,75 @@
+# brotli-rs
+
+Python bindings for Dropbox's safe-Rust
+[`brotli`](https://github.com/dropbox/rust-brotli) crate.
+
+The public API follows the `Brotli` Python package where that can be done
+without inheriting its C extension. The distribution and import names are
+both `brotli-rs` / `brotli_rs`, deliberately avoiding a collision with the
+existing `brotli` module.
+
+```python
+import brotli_rs as brotli
+
+compressed = brotli.compress(b"hello")
+assert brotli.decompress(compressed) == b"hello"
+```
+
+Streaming compression and decompression are available through `Compressor`
+and `Decompressor`. `Decompressor.process()` supports a strict
+`output_buffer_limit`, and both streaming and one-shot decompression accept an
+optional `max_output` limit.
+
+```python
+decoder = brotli.Decompressor(max_output=16 * 1024 * 1024)
+parts = []
+for compressed_chunk in source:
+    while not decoder.is_finished() and not decoder.can_accept_more_data():
+        parts.append(decoder.process(b"", output_buffer_limit=64 * 1024))
+    parts.append(decoder.process(compressed_chunk, output_buffer_limit=64 * 1024))
+while not decoder.is_finished() and not decoder.can_accept_more_data():
+    parts.append(decoder.process(b"", output_buffer_limit=64 * 1024))
+if not decoder.is_finished():
+    raise brotli.error("incomplete stream")
+```
+
+The compatibility surface consists of `compress`, `decompress`,
+`Compressor.process()` / `.flush()` / `.finish()`,
+`Decompressor.process()` / `.can_accept_more_data()` / `.is_finished()`, the
+three `MODE_*` constants, `error`, `version`, and `__version__`. Contiguous
+buffer-protocol inputs are accepted. `version` is a string alias of
+`__version__`, as it is in the current `Brotli` package.
+
+Compressed bytes are not promised to be byte-identical to Google's encoder.
+They are Brotli-compatible streams, tested in both directions against Google
+Brotli 1.2.1. Exception text, subclassing, pickling, non-contiguous buffers,
+and private implementation names are outside the compatibility contract.
+
+The base package version tracks the Rust `brotli` crate exactly.
+Python-binding-only fixes use PEP 440 post releases, such as `9.0.0.post1`,
+while still pinning `brotli = 9.0.0`.
+
+## Why?
+
+What do you think is more secure? World class engineers working at one of
+the world's largest tech companies trying to juggle chainsaws in their spare
+time, or an entirely vibe-coded wrapper in a memory-safe language with a Rust
+crate on the inside?
+
+If you bet on the latter, you've come to the right place.
+
+## Development
+
+Install Rust and Python 3.11 or newer, then:
+
+```console
+python -m venv .venv
+. .venv/bin/activate
+python -m pip install maturin
+maturin develop --extras=test
+pytest
+```
+
+See `tests/upstream/README.md` for the provenance of imported and adapted
+upstream tests.
+