finish adding python support

Author: programmerjake

Cargo.toml

@@ -2,7 +2,7 @@
 # See Notices.txt for copyright information
 [package]
 name = "algebraics"
-version = "0.1.1"
+version = "0.1.2"
 authors = ["Jacob Lifshay <[email protected]>"]
 edition = "2018"
 license = "LGPL-2.1-or-later"

README.md

@@ -1,8 +1,9 @@
-[Algebraic Numbers](https://en.wikipedia.org/wiki/Algebraic_number) Library
+## [Algebraic Numbers](https://en.wikipedia.org/wiki/Algebraic_number) Library
 
 Use when you need exact arithmetic, speed is not critical, and rational numbers aren't good enough.
 
-Example:
+## Example:
+
 ```rust
 use algebraics::prelude::*;
 use algebraics::RealAlgebraicNumber as Number;
@@ -66,3 +67,32 @@ assert_eq!(
      000000000000000000023"
 )
 ```
+
+## Python support
+
+Using algebraics from Python:
+
+```bash
+python3 -m pip install algebraics==0.1.2
+```
+
+```python
+from algebraics import RealAlgebraicNumber
+sqrt_2 = 2 ** (RealAlgebraicNumber(1) / 2)
+assert sqrt_2 * sqrt_2 == 2
+```
+
+Using algebraics in your own Rust project:
+
+```toml
+[dependencies.algebraics]
+version = "0.1.2"
+features = ["python"]
+```
+
+Developing algebraics:
+
+```bash
+cargo install maturin
+maturin develop --cargo-extra-args="--features python-extension"
+```

src/python.rs

@@ -19,6 +19,44 @@ use pyo3::PyNumberProtocol;
 use pyo3::PyObjectProtocol;
 use std::sync::Arc;
 
+impl FromPyObject<'_> for RealAlgebraicNumber {
+    fn extract(value: &PyAny) -> PyResult<Self> {
+        Ok((*RealAlgebraicNumberPy::extract(value)?.value).clone())
+    }
+}
+
+impl<'a> FromPyObject<'a> for &'a RealAlgebraicNumber {
+    fn extract(value: &'a PyAny) -> PyResult<Self> {
+        let result = RealAlgebraicNumberPy::extract(value)?.value.clone();
+        let result: &'a _ = value.py().register_any(result);
+        Ok(&**result)
+    }
+}
+
+impl IntoPy<PyObject> for RealAlgebraicNumber {
+    fn into_py(self, py: Python) -> PyObject {
+        RealAlgebraicNumberPy {
+            value: Arc::new(self),
+        }
+        .into_py(py)
+    }
+}
+
+impl IntoPy<PyObject> for &'_ RealAlgebraicNumber {
+    fn into_py(self, py: Python) -> PyObject {
+        RealAlgebraicNumberPy {
+            value: Arc::new(self.clone()),
+        }
+        .into_py(py)
+    }
+}
+
+impl ToPyObject for RealAlgebraicNumber {
+    fn to_object(&self, py: Python) -> PyObject {
+        self.into_py(py)
+    }
+}
+
 #[pyclass(name=RealAlgebraicNumber, module="algebraics")]
 #[derive(Clone)]
 struct RealAlgebraicNumberPy {
@@ -220,3 +258,33 @@ fn algebraics(_py: Python, m: &PyModule) -> PyResult<()> {
     m.add_class::<RealAlgebraicNumberPy>()?;
     Ok(())
 }
+
+#[cfg(test)]
+mod tests {
+    use super::*;
+
+    #[test]
+    fn conversion_compile_test() {
+        #![allow(dead_code)]
+
+        #[pyfunction]
+        fn identity_ref_result(v: &RealAlgebraicNumber) -> PyResult<&RealAlgebraicNumber> {
+            Ok(v)
+        }
+
+        #[pyfunction]
+        fn identity_result(v: RealAlgebraicNumber) -> PyResult<RealAlgebraicNumber> {
+            Ok(v)
+        }
+
+        #[pyfunction]
+        fn identity_ref(v: &RealAlgebraicNumber) -> &RealAlgebraicNumber {
+            v
+        }
+
+        #[pyfunction]
+        fn identity(v: RealAlgebraicNumber) -> RealAlgebraicNumber {
+            v
+        }
+    }
+}