💬 Commit message: Update 2026-02-03 22:24:47, 2 files, 206 lines

📁 Files changed: 2 📝 Lines changed: 206 • publish.yml • RELEASE.md
2026-02-03 22:24:47 +01:00
parent e8d9fba7d8
commit d8bf867042
2 changed files with 90 additions and 116 deletions
@@ -0,0 +1,89 @@
+# Release Process
+
+## Publishing a Release
+
+Push a version tag to trigger the publish workflow:
+
+```bash
+git tag v0.1.2
+git push origin v0.1.2
+```
+
+The workflow will:
+1. Build the Python package
+2. Publish to PyPI
+3. Create a GitHub Release
+
+## Building Platform Binaries
+
+Platform-specific binaries can be built locally using [Nuitka](https://nuitka.net/).
+
+### Prerequisites
+
+```bash
+pip install nuitka
+pip install -e .
+```
+
+### Build Commands
+
+**Linux / macOS:**
+```bash
+python -m nuitka \
+  --standalone \
+  --onefile \
+  --output-dir=dist \
+  --output-filename=tsr \
+  --assume-yes-for-downloads \
+  --remove-output \
+  tensors.py
+```
+
+**Windows:**
+```powershell
+python -m nuitka `
+  --standalone `
+  --onefile `
+  --output-dir=dist `
+  --output-filename=tsr.exe `
+  --assume-yes-for-downloads `
+  --remove-output `
+  tensors.py
+```
+
+### Output Artifacts
+
+| Platform      | Arch  | Filename           |
+|---------------|-------|--------------------|
+| Linux         | x64   | `tsr-linux-x64`    |
+| Linux         | arm64 | `tsr-linux-arm64`  |
+| macOS         | arm64 | `tsr-macos-arm64`  |
+| macOS         | x64   | `tsr-macos-x64`    |
+| Windows       | x64   | `tsr-windows-x64.exe` |
+
+### macOS Code Signing (Optional)
+
+To sign and notarize macOS binaries:
+
+```bash
+# Sign the binary
+codesign --force --options runtime --sign "Developer ID Application" dist/tsr
+
+# Create zip for notarization
+ditto -c -k --keepParent dist/tsr dist/tsr.zip
+
+# Submit for notarization
+xcrun notarytool submit dist/tsr.zip \
+  --apple-id "$APPLE_ID" \
+  --password "$APPLE_ID_PASSWORD" \
+  --team-id "$APPLE_TEAM_ID" \
+  --wait
+
+# Staple the notarization ticket
+xcrun stapler staple dist/tsr
+```
+
+Required environment variables:
+- `APPLE_ID` - Apple Developer account email
+- `APPLE_ID_PASSWORD` - App-specific password
+- `APPLE_TEAM_ID` - Developer Team ID