Init Python bindings

Author: kylebarron

python/python/async_tiff/Cargo.toml

@@ -0,0 +1,28 @@
+[package]
+name = "async-tiff"
+version = "0.1.0-beta.1"
+authors = ["Kyle Barron <[email protected]>"]
+edition = "2021"
+# description = "Fast, memory-efficient 2D spatial indexes for Python."
+readme = "README.md"
+repository = "https://github.com/developmentseed/async-tiff"
+license = "MIT OR Apache-2.0"
+keywords = ["python", "geospatial"]
+categories = ["science::geo"]
+rust-version = "1.75"
+
+# See more keys and their definitions at https://doc.rust-lang.org/cargo/reference/manifest.html
+[lib]
+name = "_async_tiff"
+crate-type = ["cdylib"]
+
+[dependencies]
+async-tiff = { path = "../" }
+bytes = "1.8"
+pyo3 = { version = "0.23.0", features = ["macros"] }
+pyo3-bytes = "0.1.2"
+thiserror = "1"
+
+[profile.release]
+lto = true
+codegen-units = 1

python/python/async_tiff/DEVELOP.md

@@ -0,0 +1,11 @@
+# async-tiff
+
+<!-- [![PyPI][pypi_badge]][pypi_link]
+
+[pypi_badge]: https://badge.fury.io/py/geoindex-rs.svg
+[pypi_link]: https://pypi.org/project/geoindex-rs/ -->
+
+Fast, async TIFF and GeoTIFF reader for Python.
+
+<!-- This documentation is for the Python bindings. [Refer here for the Rust crate documentation](https://docs.rs/geo-index). -->
+

python/python/async_tiff/README.md

@@ -0,0 +1,3 @@
+from ._async_tiff import ___version
+
+__version__: str = ___version()

python/python/async_tiff/__init__.py

@@ -0,0 +1,35 @@
+[build-system]
+requires = ["maturin>=1.4.0,<2.0"]
+build-backend = "maturin"
+
+[project]
+name = "async-tiff"
+requires-python = ">=3.9"
+dependencies = []
+dynamic = ["version"]
+classifiers = [
+    "Programming Language :: Rust",
+    "Programming Language :: Python :: Implementation :: CPython",
+    "Programming Language :: Python :: Implementation :: PyPy",
+]
+
+[tool.maturin]
+features = ["pyo3/extension-module"]
+module-name = "async_tiff._async_tiff"
+python-source = "python"
+
+[tool.uv]
+dev-dependencies = [
+    "griffe-inherited-docstrings>=1.0.1",
+    "ipykernel>=6.29.5",
+    "maturin>=1.7.4",
+    "mike>=2.1.3",
+    "mkdocs-material[imaging]>=9.5.40",
+    "mkdocs>=1.6.1",
+    "mkdocstrings-python>=1.13.0",
+    "mkdocstrings>=0.27.0",
+    "numpy>=1",
+    "pip>=24.2",
+    "pytest>=8.3.3",
+    "ruff>=0.8.4",
+]

python/python/async_tiff/_async_tiff.pyi

@@ -0,0 +1,44 @@
+#![deny(clippy::undocumented_unsafe_blocks)]
+
+mod coord_type;
+mod kdtree;
+mod rtree;
+pub(crate) mod util;
+
+use pyo3::prelude::*;
+
+const VERSION: &str = env!("CARGO_PKG_VERSION");
+
+#[pyfunction]
+fn ___version() -> &'static str {
+    VERSION
+}
+
+/// Raise RuntimeWarning for debug builds
+#[pyfunction]
+fn check_debug_build(_py: Python) -> PyResult<()> {
+    #[cfg(debug_assertions)]
+    {
+        use pyo3::exceptions::PyRuntimeWarning;
+        use pyo3::intern;
+        use pyo3::types::PyTuple;
+
+        let warnings_mod = _py.import(intern!(_py, "warnings"))?;
+        let warning = PyRuntimeWarning::new_err(
+            "async-tiff has not been compiled in release mode. Performance will be degraded.",
+        );
+        let args = PyTuple::new(_py, vec![warning])?;
+        warnings_mod.call_method1(intern!(_py, "warn"), args)?;
+    }
+
+    Ok(())
+}
+
+#[pymodule]
+fn _async_tiff(py: Python, m: &Bound<PyModule>) -> PyResult<()> {
+    check_debug_build(py)?;
+
+    m.add_wrapped(wrap_pyfunction!(___version))?;
+
+    Ok(())
+}

python/python/async_tiff/py.typed

@@ -16,8 +16,8 @@ use crate::error::{AiocogeoError, Result};
 ///
 /// Notes:
 ///
-/// 1. There is a default implementation for types that implement [`AsyncRead`]
-///    and [`AsyncSeek`], for example [`tokio::fs::File`].
+/// 1. There is a default implementation for types that implement [`tokio::io::AsyncRead`]
+///    and [`tokio::io::AsyncSeek`], for example [`tokio::fs::File`].
 ///
 /// 2. [`ObjectReader`], available when the `object_store` crate feature
 ///    is enabled, implements this interface for [`ObjectStore`].