pyweatherenriched 0.6.0__tar.gz

pyweatherenriched-0.6.0/.github/workflows/release.yml

@@ -0,0 +1,103 @@
+name: Build and Release Wheels
+
+on:
+  push:
+    tags:
+      - 'v*'
+  workflow_dispatch:
+
+permissions:
+  contents: write
+
+jobs:
+  build:
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        include:
+          # Linux x86_64
+          - os: ubuntu-latest
+            target: x86_64-unknown-linux-gnu
+            python-version: '3.10'
+
+          # Linux ARM64
+          - os: ubuntu-latest
+            target: aarch64-unknown-linux-gnu
+            python-version: '3.10'
+
+          # macOS Intel
+          - os: macos-latest
+            target: x86_64-apple-darwin
+            python-version: '3.10'
+
+          # macOS Apple Silicon
+          - os: macos-latest
+            target: aarch64-apple-darwin
+            python-version: '3.10'
+
+          # Windows x86_64
+          - os: windows-latest
+            target: x86_64-pc-windows-msvc
+            python-version: '3.10'
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v4
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install Rust
+        uses: dtolnay/rust-toolchain@stable
+
+      - name: Install maturin
+        run: pip install maturin
+
+      - name: Install build dependencies (Linux)
+        if: runner.os == 'Linux'
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y libssl-dev pkg-config
+
+      - name: Build wheels
+        run: maturin build --release
+
+      - name: Upload wheels
+        uses: actions/upload-artifact@v3
+        with:
+          name: wheels-${{ matrix.os }}-${{ matrix.target }}
+          path: target/wheels/
+
+  publish:
+    needs: build
+    runs-on: ubuntu-latest
+    if: startsWith(github.ref, 'refs/tags/v')
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Download all wheels
+        uses: actions/download-artifact@v3
+        with:
+          path: wheels
+
+      - name: Flatten wheels directory
+        run: |
+          mkdir -p flat_wheels
+          find wheels -name "*.whl" -exec cp {} flat_wheels/ \;
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          packages-dir: flat_wheels/
+          password: ${{ secrets.PYPI_API_TOKEN }}
+
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v1
+        with:
+          files: flat_wheels/*.whl
+          draft: false
+          prerelease: false
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

pyweatherenriched-0.6.0/.github/workflows/tests.yml

@@ -0,0 +1,17 @@
+name: Tests
+on: [push, pull_request]
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.10", "3.11", "3.12"]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v4
+        with:
+          python-version: ${{ matrix.python-version }}
+      - name: Install
+        run: pip install -e ".[dev]" 2>/dev/null || pip install -e .
+      - name: Test
+        run: pytest

pyweatherenriched-0.6.0/.gitignore

@@ -0,0 +1,31 @@
+target/
+
+# Python Build Artifacts
+build/
+dist/
+*.whl
+*.egg-info/
+__pycache__/
+*.pyc
+.eggs/
+*.so
+*.pyd
+
+# Dependencies
+.venv/
+venv/
+env/
+
+# IDE/Editor
+.vscode/
+.idea/
+*.swp
+.DS_Store
+
+# Cache
+.pytest_cache/
+.mypy_cache/
+
+# Environment
+.env
+.env.local

pyweatherenriched-0.6.0/BUILD.md

@@ -0,0 +1,170 @@
+# Build Instructions
+
+PyWeatherEnriched ships to PyPI as prebuilt wheels. Source is on GitHub at
+https://github.com/Mullassery/PyWeatherEnriched under a proprietary license
+(see `LICENSE`) — visible for review, not open for redistribution/reuse
+without permission.
+
+## Installation from PyPI
+
+```bash
+pip install pyweatherenriched
+```
+
+Requires Python 3.10 or higher.
+
+Supported platforms:
+- Linux (x86_64, ARM64)
+- macOS (Intel, Apple Silicon)
+- Windows (x86_64)
+
+## Building Wheels (For Maintainers)
+
+PyWeatherEnriched uses Maturin to build PyO3 wheels from Rust source code.
+
+### Prerequisites
+
+1. **Rust toolchain** (latest stable):
+   ```bash
+   curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
+   source $HOME/.cargo/env
+   ```
+
+2. **Python 3.10+** with development headers:
+   ```bash
+   # Linux (Debian/Ubuntu)
+   sudo apt-get install python3.10-dev
+
+   # macOS
+   brew install python@3.10
+
+   # Windows
+   # Install from python.org or use Windows Store
+   ```
+
+3. **Maturin**:
+   ```bash
+   pip install maturin
+   ```
+
+### Build Steps
+
+1. **Build wheels for your current platform**:
+   ```bash
+   cd /path/to/PyWeatherEnriched
+   maturin build --release
+   ```
+
+   Wheels appear in `target/wheels/`
+
+2. **Build wheels for multiple Python versions**:
+   ```bash
+   maturin build --release -i python3.10 -i python3.11 -i python3.12 -i python3.13
+   ```
+
+3. **Build wheels for multiple platforms** (cross-compilation):
+   ```bash
+   # Linux x86_64 and ARM64
+   maturin build --release --target x86_64-unknown-linux-gnu
+   maturin build --release --target aarch64-unknown-linux-gnu
+
+   # macOS Intel and Apple Silicon
+   maturin build --release --target x86_64-apple-darwin
+   maturin build --release --target aarch64-apple-darwin
+
+   # Windows x86_64
+   maturin build --release --target x86_64-pc-windows-msvc
+   ```
+
+### Upload to PyPI
+
+Using Twine:
+
+```bash
+# Install twine
+pip install twine
+
+# Upload wheels
+twine upload target/wheels/pyweatherenriched*.whl
+
+# With token authentication
+twine upload --repository pypi target/wheels/pyweatherenriched*.whl
+```
+
+## GitHub Actions (Automatic Builds)
+
+The repository includes a GitHub Actions workflow (`.github/workflows/release.yml`) that:
+- Builds wheels for Linux, macOS, and Windows
+- Runs on each release tag
+- Automatically uploads to PyPI
+
+To create a release:
+```bash
+git tag v0.1.0
+git push origin v0.1.0
+```
+
+## Wheel Contents
+
+Each wheel contains:
+- `pyweatherenriched._pyweatherenriched`, the compiled Rust/PyO3 extension module (.so/.pyd)
+- The pure-Python `pyweatherenriched` package (`__init__.py`, `features.py`)
+- Metadata and license information
+
+## Troubleshooting
+
+### "No module named 'maturin'"
+```bash
+pip install maturin
+```
+
+### Python version mismatch
+Ensure your Python installation matches the wheel being built:
+```bash
+python --version
+maturin build -i /path/to/python3.10
+```
+
+### Rust compilation errors
+Update Rust:
+```bash
+rustup update stable
+```
+
+### OpenSSL errors on Linux
+```bash
+sudo apt-get install libssl-dev
+```
+
+## Distribution Policy
+
+- **PyPI**: Prebuilt wheels (verified via `pip install`)
+- **GitHub Releases**: Wheels as binary artifacts
+- **Source**: Public on GitHub, proprietary license (see LICENSE file — review is fine, redistribution/reuse is not)
+
+## Support
+
+For build issues:
+- GitHub Issues: https://github.com/Mullassery/PyWeatherEnriched/issues
+- Email: mullassery@gmail.com
+
+## Development Setup
+
+```bash
+# Clone repository
+git clone https://github.com/Mullassery/PyWeatherEnriched.git
+cd PyWeatherEnriched
+
+# Build development mode (installs the extension into your active venv)
+maturin develop --release
+
+# Run the Rust test suite
+cargo test
+
+# Run the Python test suite (needs `maturin develop` first)
+pip install -e ".[dev]"
+pytest tests/ -v
+
+# Build optimized wheels
+maturin build --release
+```