Metadata-Version: 2.4
Name: b64t
Version: 0.1.25
Summary: Python bindings for b64t (requires system package)
Author-email: Saxon Lysaght-Wheeler <saxon.lysaght-wheeler@vivanti.com>
License-Expression: MIT
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Operating System :: POSIX :: Linux
Classifier: Operating System :: MacOS
Requires-Python: >=3.8
Description-Content-Type: text/markdown

# b64t - Python Bindings (Wrapper Package)

This is a minimal wrapper package for the system-installed b64t library.

## Installation

### 1. Install system package (required)

**macOS (Homebrew):**
```bash
curl -fsSL https://storage.googleapis.com/winged-keyword-487102-h4-b64t-homebrew/setup.sh | bash
```

Or manually:
```bash
brew tap vivanti/b64t
brew install vivanti/b64t/b64t
```

**Linux (APT):**
```bash
curl -fsSL https://storage.googleapis.com/winged-keyword-487102-h4-b64t-apt-mirror/setup.sh | sudo bash
sudo apt install b64t
```

### 2. Install pip wrapper (for virtual environments)

```bash
python3 -m venv myenv
source myenv/bin/activate
pip install b64t
```

## Usage

```python
import b64t

# Encode
encoded = b64t.encode(b'Hello, World!')
print(encoded)

# Decode
decoded = b64t.decode(encoded)
print(decoded)

# Streaming
with open('input.bin', 'rb') as f:
    for chunk in b64t.encodePipe(f):
        print(chunk)
```

## Notes

- This package requires the system `b64t` package to be installed via Homebrew (macOS) or APT (Linux)
- The Python extension is installed to:
  - Linux: `/usr/lib/python3/dist-packages/`
  - macOS: `/opt/homebrew/lib/python3/dist-packages/` (ARM64) or `/usr/local/lib/python3/dist-packages/` (Intel)
- This wrapper package adds the system dist-packages to sys.path in virtual environments
- Uses Python Stable ABI (Limited API) - one binary works with any Python 3.8+
- If the system package is not installed, import will fail with a clear error message
