pylibsparseir 0.7.4__cp312-cp312-macosx_15_0_arm64.whl

pylibsparseir-0.7.4.dist-info/METADATA

@@ -0,0 +1,209 @@
+Metadata-Version: 2.4
+Name: pylibsparseir
+Version: 0.7.4
+Summary: Python bindings for the sparse-ir-capi library
+Project-URL: Homepage, https://github.com/SpM-lab/sparse-ir-rs
+Project-URL: Documentation, https://github.com/SpM-lab/sparse-ir-rs
+Project-URL: Repository, https://github.com/SpM-lab/sparse-ir-rs
+Project-URL: Issues, https://github.com/SpM-lab/sparse-ir-rs/issues
+Maintainer: SpM-lab
+License: MIT License
+        
+        Copyright (c) 2024 SpM-lab
+        
+        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.
+License-File: LICENSE
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Rust
+Classifier: Topic :: Scientific/Engineering :: Physics
+Requires-Python: >=3.10
+Requires-Dist: numpy>=1.26.4
+Requires-Dist: scipy
+Description-Content-Type: text/markdown
+
+# Python bindings for sparse-ir-capi
+
+This is a low-level binding for the [sparse-ir-capi](https://github.com/SpM-lab/sparse-ir-rs) Rust library.
+
+## Requirements
+
+- Python >= 3.10
+- Rust toolchain (for building the Rust library)
+- numpy >= 1.26.4
+- scipy
+
+### BLAS Support
+
+This package automatically uses SciPy's BLAS backend for optimal performance. No additional BLAS installation is required - SciPy will provide the necessary BLAS functionality.
+
+## Build
+
+### Install Dependencies and Build
+
+```bash
+# Build the package (Rust library will be built automatically)
+cd python
+uv build
+```
+
+This will:
+- Automatically build the Rust sparse-ir-capi library using Cargo (via CMake)
+- Copy the built library and header files to the Python package
+- Create both source distribution (sdist) and wheel packages
+
+### Development Build
+
+For development:
+
+```bash
+# Install in development mode (will auto-prepare if needed)
+uv sync
+```
+
+**Note for CI/CD**: The Rust library is built automatically during the Python package build. No separate build step is needed:
+
+```bash
+# In CI/CD scripts
+cd python
+uv build
+```
+
+See `.github-workflows-example.yml` for a complete GitHub Actions example.
+
+### BLAS Configuration
+
+The package automatically uses SciPy's BLAS backend, which provides optimized BLAS operations without requiring separate BLAS installation. The build system is configured to use SciPy's BLAS functions directly.
+
+### Clean Build Artifacts
+
+To remove build artifacts and files copied from the parent directory:
+
+```bash
+uv run clean
+```
+
+This will remove:
+- Build directories: `build/`, `dist/`, `*.egg-info`
+- Compiled libraries: `pylibsparseir/*.so`, `pylibsparseir/*.dylib`, `pylibsparseir/*.dll`
+- Cache directories: `pylibsparseir/__pycache__`
+
+### Build Process Overview
+
+The build process works as follows:
+
+1. **CMake Configuration**: scikit-build-core invokes CMake, which:
+   - Finds the Cargo executable
+   - Sets up build targets for the Rust library
+
+2. **Rust Library Build**: CMake calls Cargo to build `sparse-ir-capi`:
+   - Compiles the Rust library to a shared library (`.so`, `.dylib`, or `.dll`)
+   - Generates C header file (`sparseir.h`) using cbindgen (via build.rs)
+   - Copies the library and header to the `pylibsparseir` directory
+
+3. **Python Package Building**: `uv build` or `uv sync`:
+   - Packages everything into distributable wheels and source distributions
+
+4. **Installation**: The built package includes the compiled shared library and Python bindings
+
+### Conda Build
+
+This package can also be built and distributed via conda-forge. The conda recipe is located in `conda-recipe/` and supports multiple platforms and Python versions.
+
+**Building conda packages locally:**
+
+```bash
+# Install conda-build
+conda install conda-build
+
+# Build the conda package
+cd python
+conda build conda-recipe
+
+# Build for specific platforms
+conda build conda-recipe --platform linux-64
+conda build conda-recipe --platform osx-64
+conda build conda-recipe --platform osx-arm64
+```
+
+**Supported platforms:**
+- Linux x86_64
+- macOS Intel (x86_64)
+- macOS Apple Silicon (ARM64)
+
+**Supported Python versions:**
+- Python 3.11, 3.12, 3.13
+
+**Supported NumPy versions:**
+- NumPy 2.1, 2.2, 2.3
+
+The conda build automatically:
+- Uses SciPy's BLAS backend for optimal performance
+- Cleans up old shared libraries before building
+- Builds platform-specific packages with proper dependencies
+
+## Performance Notes
+
+### BLAS Support
+
+This package automatically uses SciPy's optimized BLAS backend for improved linear algebra performance:
+
+- **Automatic BLAS**: Uses SciPy's BLAS functions for optimal performance
+- **No additional setup**: SciPy provides all necessary BLAS functionality
+
+The build system automatically configures BLAS support through SciPy. You can verify BLAS support by checking the build output for messages like:
+
+```bash
+export SPARSEIR_DEBUG=1
+python -c "import pylibsparseir"
+```
+
+This will show:
+```
+BLAS support enabled
+Registered SciPy BLAS dgemm @ 0x...
+```
+
+### Troubleshooting
+
+**Build fails with missing Cargo:**
+```bash
+# Make sure Rust toolchain is installed
+# Install from https://rustup.rs/
+# Then retry:
+cd python
+uv build
+```
+
+**Clean rebuild:**
+```bash
+# Remove all build artifacts
+uv run clean
+cd ../sparse-ir-capi
+cargo clean
+cd ../python
+uv build
+```

pylibsparseir-0.7.4.dist-info/RECORD

@@ -0,0 +1,12 @@
+pylibsparseir-0.7.4.dist-info/RECORD,,
+pylibsparseir-0.7.4.dist-info/WHEEL,sha256=9gv_WQapzfiGQ7jdrimtrtzMoA7ItUiOdFq9sXat7ns,133
+pylibsparseir-0.7.4.dist-info/METADATA,sha256=AX0j_-CYwDflnrjHMTzSkgeS_rDlpurVL6MAzZFO3ws,6603
+pylibsparseir-0.7.4.dist-info/licenses/LICENSE,sha256=f7O_CoSPJW9fmszTOBcCtKDB2QMfPsrYyL41nyE3I-o,1064
+pylibsparseir/ctypes_wrapper.py,sha256=jVkusNcseLDXiiceddQEJ8Apmsm7vyUgPcCxEEvwmZY,901
+pylibsparseir/sparseir.h,sha256=0QhEQD3D1S9vR-kTrhJnbx4_DHHakdDXC8gR7v7b9DY,68995
+pylibsparseir/clean_build_artifacts.py,sha256=--opVAb2lHh6PIXgdPhw77-LFDdKR_fAQPEsf-Qemjc,2112
+pylibsparseir/constants.py,sha256=Ek3JnmgiDWy3LB8f_9QA7Gh0ReaEC-W2MlCBJG3cBYg,864
+pylibsparseir/ctypes_autogen.py,sha256=SAJEbsjUZcpxdyUIb0u1FC1sGVIzJzSOZsPMjpNM28I,11747
+pylibsparseir/__init__.py,sha256=tJrHAYi_Zb9HCcvwsbrUsWIETdDrlh44o42kpmNpsCM,948
+pylibsparseir/core.py,sha256=kdwWc3DXJutJhQmpp7k4-R09zsjPKSQzzv4_ZPpNPy0,24385
+pylibsparseir/libsparse_ir_capi.dylib,sha256=GzwcR2Kruls4xYw4jsDtW7ciwSsn0ZyS16TE4Lk7iG8,2556848

pylibsparseir-0.7.4.dist-info/WHEEL

@@ -0,0 +1,6 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.28.0
+Root-Is-Purelib: false
+Tag: cp312-cp312-macosx_15_0_arm64
+Generator: delocate 0.13.0
+

pylibsparseir-0.7.4.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 SpM-lab
+
+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.