earshot 0.1.0__tar.gz

earshot-0.1.0/.gitignore

@@ -0,0 +1,5 @@
+target/
+__pycache__/
+*.so
+*.egg-info/
+dist/

earshot-0.1.0/Cargo.lock

@@ -0,0 +1,287 @@
+# This file is automatically @generated by Cargo.
+# It is not intended for manual editing.
+version = 4
+
+[[package]]
+name = "autocfg"
+version = "1.5.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c08606f8c3cbf4ce6ec8e28fb0014a2c086708fe954eaa885384a6165172e7e8"
+
+[[package]]
+name = "cfg-if"
+version = "1.0.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9330f8b2ff13f34540b44e946ef35111825727b38d33286ef986142615121801"
+
+[[package]]
+name = "earshot"
+version = "1.0.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d393a8f23619412e0502df1b94cd148e34855a50a4143d365cc6336cc338b4f4"
+dependencies = [
+ "libm",
+]
+
+[[package]]
+name = "earshot-python"
+version = "0.1.0"
+dependencies = [
+ "earshot",
+ "ndarray",
+ "numpy",
+ "pyo3",
+]
+
+[[package]]
+name = "heck"
+version = "0.5.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "2304e00983f87ffb38b55b444b5e3b60a884b5d30c0fca7d82fe33449bbe55ea"
+
+[[package]]
+name = "indoc"
+version = "2.0.7"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "79cf5c93f93228cf8efb3ba362535fb11199ac548a09ce117c9b1adc3030d706"
+dependencies = [
+ "rustversion",
+]
+
+[[package]]
+name = "libc"
+version = "0.2.184"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "48f5d2a454e16a5ea0f4ced81bd44e4cfc7bd3a507b61887c99fd3538b28e4af"
+
+[[package]]
+name = "libm"
+version = "0.2.16"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b6d2cec3eae94f9f509c767b45932f1ada8350c4bdb85af2fcab4a3c14807981"
+
+[[package]]
+name = "matrixmultiply"
+version = "0.3.10"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "a06de3016e9fae57a36fd14dba131fccf49f74b40b7fbdb472f96e361ec71a08"
+dependencies = [
+ "autocfg",
+ "rawpointer",
+]
+
+[[package]]
+name = "memoffset"
+version = "0.9.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "488016bfae457b036d996092f6cb448677611ce4449e970ceaf42695203f218a"
+dependencies = [
+ "autocfg",
+]
+
+[[package]]
+name = "ndarray"
+version = "0.16.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "882ed72dce9365842bf196bdeedf5055305f11fc8c03dee7bb0194a6cad34841"
+dependencies = [
+ "matrixmultiply",
+ "num-complex",
+ "num-integer",
+ "num-traits",
+ "portable-atomic",
+ "portable-atomic-util",
+ "rawpointer",
+]
+
+[[package]]
+name = "num-complex"
+version = "0.4.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "73f88a1307638156682bada9d7604135552957b7818057dcef22705b4d509495"
+dependencies = [
+ "num-traits",
+]
+
+[[package]]
+name = "num-integer"
+version = "0.1.46"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7969661fd2958a5cb096e56c8e1ad0444ac2bbcd0061bd28660485a44879858f"
+dependencies = [
+ "num-traits",
+]
+
+[[package]]
+name = "num-traits"
+version = "0.2.19"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "071dfc062690e90b734c0b2273ce72ad0ffa95f0c74596bc250dcfd960262841"
+dependencies = [
+ "autocfg",
+]
+
+[[package]]
+name = "numpy"
+version = "0.24.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "a7cfbf3f0feededcaa4d289fe3079b03659e85c5b5a177f4ba6fb01ab4fb3e39"
+dependencies = [
+ "libc",
+ "ndarray",
+ "num-complex",
+ "num-integer",
+ "num-traits",
+ "pyo3",
+ "pyo3-build-config",
+ "rustc-hash",
+]
+
+[[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.13.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c33a9471896f1c69cecef8d20cbe2f7accd12527ce60845ff44c153bb2a21b49"
+
+[[package]]
+name = "portable-atomic-util"
+version = "0.2.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "091397be61a01d4be58e7841595bd4bfedb15f1cd54977d79b8271e94ed799a3"
+dependencies = [
+ "portable-atomic",
+]
+
+[[package]]
+name = "proc-macro2"
+version = "1.0.106"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8fd00f0bb2e90d81d1044c2b32617f68fcb9fa3bb7640c23e9c748e53fb30934"
+dependencies = [
+ "unicode-ident",
+]
+
+[[package]]
+name = "pyo3"
+version = "0.24.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e5203598f366b11a02b13aa20cab591229ff0a89fd121a308a5df751d5fc9219"
+dependencies = [
+ "cfg-if",
+ "indoc",
+ "libc",
+ "memoffset",
+ "once_cell",
+ "portable-atomic",
+ "pyo3-build-config",
+ "pyo3-ffi",
+ "pyo3-macros",
+ "unindent",
+]
+
+[[package]]
+name = "pyo3-build-config"
+version = "0.24.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "99636d423fa2ca130fa5acde3059308006d46f98caac629418e53f7ebb1e9999"
+dependencies = [
+ "once_cell",
+ "target-lexicon",
+]
+
+[[package]]
+name = "pyo3-ffi"
+version = "0.24.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "78f9cf92ba9c409279bc3305b5409d90db2d2c22392d443a87df3a1adad59e33"
+dependencies = [
+ "libc",
+ "pyo3-build-config",
+]
+
+[[package]]
+name = "pyo3-macros"
+version = "0.24.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0b999cb1a6ce21f9a6b147dcf1be9ffedf02e0043aec74dc390f3007047cecd9"
+dependencies = [
+ "proc-macro2",
+ "pyo3-macros-backend",
+ "quote",
+ "syn",
+]
+
+[[package]]
+name = "pyo3-macros-backend"
+version = "0.24.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "822ece1c7e1012745607d5cf0bcb2874769f0f7cb34c4cde03b9358eb9ef911a"
+dependencies = [
+ "heck",
+ "proc-macro2",
+ "pyo3-build-config",
+ "quote",
+ "syn",
+]
+
+[[package]]
+name = "quote"
+version = "1.0.45"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "41f2619966050689382d2b44f664f4bc593e129785a36d6ee376ddf37259b924"
+dependencies = [
+ "proc-macro2",
+]
+
+[[package]]
+name = "rawpointer"
+version = "0.2.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "60a357793950651c4ed0f3f52338f53b2f809f32d83a07f72909fa13e4c6c1e3"
+
+[[package]]
+name = "rustc-hash"
+version = "2.1.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "94300abf3f1ae2e2b8ffb7b58043de3d399c73fa6f4b73826402a5c457614dbe"
+
+[[package]]
+name = "rustversion"
+version = "1.0.22"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b39cdef0fa800fc44525c84ccb54a029961a8215f9619753635a9c0d2538d46d"
+
+[[package]]
+name = "syn"
+version = "2.0.117"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e665b8803e7b1d2a727f4023456bbbbe74da67099c585258af0ad9c5013b9b99"
+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.24"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e6e4313cd5fcd3dad5cafa179702e2b244f760991f45397d14d4ebf38247da75"
+
+[[package]]
+name = "unindent"
+version = "0.2.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7264e107f553ccae879d21fbea1d6724ac785e8c3bfc762137959b5802826ef3"

earshot-0.1.0/Cargo.toml

@@ -0,0 +1,15 @@
+[package]
+name = "earshot-python"
+version = "0.1.0"
+edition = "2021"
+readme = "README.md"
+
+[lib]
+name = "earshot_python"
+crate-type = ["cdylib"]
+
+[dependencies]
+pyo3 = { version = "0.24", features = ["extension-module", "abi3-py38"] }
+numpy = "0.24"
+earshot = "1.0"
+ndarray = "0.16"

earshot-0.1.0/PKG-INFO

@@ -0,0 +1,65 @@
+Metadata-Version: 2.4
+Name: earshot
+Version: 0.1.0
+Requires-Dist: numpy>=1.20
+Requires-Dist: scipy>=1.7
+Summary: Python bindings for earshot - fast VAD in Rust
+License: MIT OR Apache-2.0
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
+
+# earshot-python
+
+Python bindings for [earshot](https://github.com/pykeio/earshot) - fast VAD in Rust.
+
+## Installation
+
+```bash
+pip install earshot
+```
+
+## Usage
+
+```python
+import earshot
+import numpy as np
+
+audio = np.load("audio.npy")
+segments = earshot.detect(audio, sr=16000)
+
+for start, end in segments:
+    print(f"Speech: {start:.2f}s - {end:.2f}s")
+```
+
+## Development
+
+### Building from Source
+
+```bash
+# Clone the repository
+git clone https://codeberg.org/yourusername/earshot-python
+cd earshot-python
+
+# Install in development mode
+pip install -e .
+
+# Or build wheels
+maturin build --release
+```
+
+### Releasing
+
+This project uses a manual release process. See [RELEASE.md](RELEASE.md) for detailed instructions.
+
+Quick release:
+```bash
+./release.sh --test   # TestPyPI first
+./release.sh          # Production PyPI
+```
+
+Requirements:
+- Rust toolchain
+- Docker Desktop
+- PyPI API token in `~/.pypirc`
+```
+

earshot-0.1.0/README.md

@@ -0,0 +1,54 @@
+# earshot-python
+
+Python bindings for [earshot](https://github.com/pykeio/earshot) - fast VAD in Rust.
+
+## Installation
+
+```bash
+pip install earshot
+```
+
+## Usage
+
+```python
+import earshot
+import numpy as np
+
+audio = np.load("audio.npy")
+segments = earshot.detect(audio, sr=16000)
+
+for start, end in segments:
+    print(f"Speech: {start:.2f}s - {end:.2f}s")
+```
+
+## Development
+
+### Building from Source
+
+```bash
+# Clone the repository
+git clone https://codeberg.org/yourusername/earshot-python
+cd earshot-python
+
+# Install in development mode
+pip install -e .
+
+# Or build wheels
+maturin build --release
+```
+
+### Releasing
+
+This project uses a manual release process. See [RELEASE.md](RELEASE.md) for detailed instructions.
+
+Quick release:
+```bash
+./release.sh --test   # TestPyPI first
+./release.sh          # Production PyPI
+```
+
+Requirements:
+- Rust toolchain
+- Docker Desktop
+- PyPI API token in `~/.pypirc`
+```

earshot-0.1.0/RELEASE.md

@@ -0,0 +1,281 @@
+# Release Guide for earshot-python
+
+This document describes how to build and publish wheels for the `earshot` package to PyPI.
+
+## Overview
+
+Since this project uses Codeberg (not GitHub) for hosting, we use a **manual release process** instead of automated CI/CD. The release is performed from your local machine using the provided scripts.
+
+### Platform Support
+
+| Platform | Architecture | Method | Status |
+|----------|-------------|--------|--------|
+| Linux | x86_64 | Docker (manylinux2014) | ✅ Supported |
+| Linux | ARM64 | Docker (manylinux2014) | ✅ Supported |
+| macOS | ARM64 | Native (your machine) | ✅ Supported |
+| macOS | x86_64 | Cross-compile | ✅ Supported |
+| Windows | x86_64/ARM64 | Not available | ❌ Not built (source install works) |
+
+**Note:** Windows users can install from the source distribution, which will compile the Rust extension locally (requires Rust toolchain).
+
+## Prerequisites
+
+### Required Software
+
+1. **Rust toolchain** (latest stable)
+   ```bash
+   curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
+   rustup target add x86_64-apple-darwin aarch64-apple-darwin
+   ```
+
+2. **Python packages**
+   ```bash
+   pip install maturin twine
+   ```
+
+3. **Docker Desktop** with:
+   - Linux/amd64 support (enabled by default)
+   - Linux/arm64 support (enable in Settings → Features → "Use containerd for pulling and storing images")
+
+4. **PyPI credentials** in `~/.pypirc`:
+   ```ini
+   [pypi]
+   username = __token__
+   password = pypi-your-api-token-here
+
+   [testpypi]
+   username = __token__
+   password = pypi-your-test-token-here
+   ```
+
+   Get your token from: https://pypi.org/manage/account/#api-tokens
+
+## Quick Start
+
+### Standard Release
+
+```bash
+./release.sh
+```
+
+This interactive script will:
+1. Check prerequisites
+2. Optionally bump the version
+3. Build wheels for all platforms
+4. Validate with `twine check`
+5. Upload to PyPI
+
+### Test Release (TestPyPI)
+
+```bash
+./release.sh --test
+```
+
+Uploads to TestPyPI first to verify everything works:
+- Install with: `pip install --index-url https://test.pypi.org/simple/ earshot`
+
+### Dry Run (Build only, no upload)
+
+```bash
+./release.sh --dry-run
+```
+
+Builds all wheels but doesn't upload - useful for testing the build process.
+
+### Re-upload (skip build)
+
+```bash
+./release.sh --skip-build
+```
+
+If you already have wheels in `dist/` and want to re-upload them.
+
+## Version Management
+
+### Bump Version Interactively
+
+During `release.sh`, you'll be prompted to bump the version. Options:
+- `p` or `patch`: 0.1.0 → 0.1.1
+- `m` or `minor`: 0.1.0 → 0.2.0
+- `M` or `major`: 0.1.0 → 1.0.0
+- `s` or `set`: Enter custom version
+- `n` or `no`: Keep current version
+
+### Bump Version Manually
+
+```bash
+# Patch release (bug fixes)
+python scripts/bump_version.py patch
+
+# Minor release (new features)
+python scripts/bump_version.py minor
+
+# Major release (breaking changes)
+python scripts/bump_version.py major
+
+# Set explicit version
+python scripts/bump_version.py --version 1.2.3
+```
+
+This updates both `Cargo.toml` and `pyproject.toml` in sync.
+
+## Build Process Details
+
+### What's Built
+
+1. **Source Distribution** (`.tar.gz`)
+   - Contains Rust source and Python files
+   - Installable on any platform with Rust toolchain
+
+2. **Linux Wheels** (`.whl`)
+   - Built in Docker containers for manylinux2014 compliance
+   - Works on most Linux distributions (glibc 2.17+)
+   - Two architectures: x86_64 and ARM64 (aarch64)
+
+3. **macOS Wheels** (`.whl`)
+   - Built natively on your Apple Silicon Mac
+   - Universal2 not needed due to abi3 (single wheel per arch)
+   - Two architectures: x86_64 (Intel) and ARM64 (Apple Silicon)
+
+### ABI3 Advantage
+
+The `abi3-py38` feature in `Cargo.toml` means:
+- **One wheel per platform** covers Python 3.8 through 3.12+
+- **Smaller total release size**
+- **Faster build times**
+
+Without abi3, you'd need 4-5 wheels per platform (one per Python version).
+
+## Troubleshooting
+
+### Docker Issues
+
+**Problem:** "Cannot connect to Docker daemon"
+```bash
+# Solution: Start Docker Desktop
+open -a Docker
+```
+
+**Problem:** "Linux ARM64 build fails"
+```bash
+# Solution: Enable containerd in Docker Desktop
+# Settings → Features → "Use containerd for pulling and storing images"
+```
+
+### Build Issues
+
+**Problem:** "Rust target not found"
+```bash
+# Solution: Add missing target
+rustup target add x86_64-unknown-linux-gnu  # Not needed for Docker builds
+rustup target add x86_64-apple-darwin
+rustup target add aarch64-apple-darwin
+```
+
+**Problem:** "missing dependencies: numpy, scipy"
+```bash
+# Solution: The wheels don't bundle numpy/scipy
+# These are declared as dependencies in pyproject.toml
+# pip will install them automatically when users install earshot
+```
+
+### Upload Issues
+
+**Problem:** "Invalid API token"
+```bash
+# Solution: Check your .pypirc
+cat ~/.pypirc
+# Ensure token includes 'pypi-' prefix
+```
+
+**Problem:** "File already exists" on re-upload
+```bash
+# PyPI doesn't allow overwriting files
+# Solution: Bump version or use TestPyPI
+./release.sh --test
+```
+
+## Manual Steps (without script)
+
+If you prefer not to use the script, here's the manual process:
+
+```bash
+# 1. Clean
+rm -rf dist target/wheels
+
+# 2. Bump version (edit Cargo.toml and pyproject.toml manually)
+# version = "0.1.0" → "0.1.1"
+
+# 3. Build sdist
+maturin sdist -o dist
+
+# 4. Build Linux x86_64
+docker run --rm -v $(pwd):/io ghcr.io/pyo3/maturin build --release --manylinux 2014
+
+# 5. Build Linux ARM64 (if Docker supports it)
+docker run --rm --platform linux/arm64 -v $(pwd):/io ghcr.io/pyo3/maturin build --release --manylinux 2014 --target aarch64-unknown-linux-gnu
+
+# 6. Build macOS ARM64
+maturin build --release --target aarch64-apple-darwin
+
+# 7. Build macOS x86_64
+maturin build --release --target x86_64-apple-darwin
+
+# 8. Check
+twine check dist/*
+
+# 9. Upload to TestPyPI first
+twine upload --repository testpypi dist/*
+
+# 10. Upload to PyPI
+twine upload dist/*
+
+# 11. Tag release
+git add Cargo.toml pyproject.toml
+git commit -m "Release v0.1.1"
+git tag v0.1.1
+git push origin main
+git push origin v0.1.1
+```
+
+## Post-Release Checklist
+
+After releasing:
+
+- [ ] Verify package on PyPI: https://pypi.org/project/earshot/
+- [ ] Test install: `pip install earshot --upgrade`
+- [ ] Push git commit and tag to Codeberg
+- [ ] Verify wheels are available for your platform: `pip debug --verbose | grep compatible`
+- [ ] Optional: Create release notes on Codeberg
+
+## Release Schedule Recommendations
+
+**Patch releases (0.1.0 → 0.1.1):**
+- Bug fixes only
+- Can release anytime
+- Users upgrade automatically with `pip install -U earshot`
+
+**Minor releases (0.1.0 → 0.2.0):**
+- New features, backward compatible
+- Consider announcing on Codeberg
+
+**Major releases (0.1.0 → 1.0.0):**
+- Breaking changes
+- Provide migration guide
+- Consider deprecation warnings in previous release
+
+## Security Notes
+
+- **Never commit `.pypirc`** - Keep it in your home directory only
+- **Use API tokens, not passwords** - Scoped to specific projects
+- **Rotate tokens regularly** - Delete and recreate on PyPI periodically
+- **Use TestPyPI first** - Always test before production release
+- **Verify checksums** - The script runs `twine check` automatically
+
+## Questions?
+
+If you encounter issues:
+1. Check this troubleshooting section
+2. Review maturin docs: https://maturin.rs/
+3. Review PyPI publishing guide: https://packaging.python.org/
+4. Open an issue on Codeberg