decimo 0.1.0.dev0__py3-none-any.whl

decimo/__init__.py

@@ -0,0 +1,157 @@
+"""decimo: Arbitrary-precision decimal arithmetic for Python, powered by Mojo.
+
+Usage:
+    from decimo import Decimal
+
+    a = Decimal("1.5")
+    b = Decimal("2.3")
+    print(a + b)  # 3.8
+"""
+
+__version__ = "0.1.0.dev0"
+__all__ = ["Decimal", "BigDecimal"]
+
+try:
+    from ._decimo import BigDecimal as _BigDecimal
+except ImportError as _err:
+    raise ImportError(
+        "decimo requires a compiled Mojo extension (_decimo native module).\n"
+        "This package does not yet include pre-built wheels.\n"
+        "Build from source:\n"
+        "  git clone https://github.com/forfudan/decimo && cd decimo\n"
+        "  pixi run buildpy\n"
+        "  pip install -e python/\n"
+    ) from _err
+
+
+class Decimal:
+    """Arbitrary-precision decimal number.
+
+    This is a thin Python wrapper around decimo's Mojo-native BigDecimal type.
+    All heavy arithmetic is performed in Mojo at near-native speed.
+    """
+
+    __slots__ = ("_inner",)
+
+    def __init__(self, value="0"):
+        if isinstance(value, Decimal):
+            self._inner = value._inner
+        elif isinstance(value, _BigDecimal):
+            self._inner = value
+        else:
+            self._inner = _BigDecimal(str(value))
+
+    # --- String ---
+
+    def __str__(self):
+        return self._inner.to_string()
+
+    def __repr__(self):
+        return self._inner.to_repr()
+
+    # --- Arithmetic ---
+
+    def __add__(self, other):
+        if not isinstance(other, Decimal):
+            other = Decimal(other)
+        result = Decimal.__new__(Decimal)
+        result._inner = self._inner.add(other._inner)
+        return result
+
+    def __radd__(self, other):
+        return Decimal(other).__add__(self)
+
+    def __sub__(self, other):
+        if not isinstance(other, Decimal):
+            other = Decimal(other)
+        result = Decimal.__new__(Decimal)
+        result._inner = self._inner.sub(other._inner)
+        return result
+
+    def __rsub__(self, other):
+        return Decimal(other).__sub__(self)
+
+    def __mul__(self, other):
+        if not isinstance(other, Decimal):
+            other = Decimal(other)
+        result = Decimal.__new__(Decimal)
+        result._inner = self._inner.mul(other._inner)
+        return result
+
+    def __rmul__(self, other):
+        return Decimal(other).__mul__(self)
+
+    def __truediv__(self, other):
+        if not isinstance(other, Decimal):
+            other = Decimal(other)
+        result = Decimal.__new__(Decimal)
+        result._inner = self._inner.div(other._inner)
+        return result
+
+    def __neg__(self):
+        result = Decimal.__new__(Decimal)
+        result._inner = self._inner.neg()
+        return result
+
+    def __abs__(self):
+        result = Decimal.__new__(Decimal)
+        result._inner = self._inner.abs_()
+        return result
+
+    def __pos__(self):
+        return self  # no-op
+
+    # --- Comparison ---
+
+    def __eq__(self, other):
+        if not isinstance(other, Decimal):
+            try:
+                other = Decimal(other)
+            except Exception:
+                return NotImplemented
+        return self._inner.eq(other._inner)
+
+    def __lt__(self, other):
+        if not isinstance(other, Decimal):
+            try:
+                other = Decimal(other)
+            except Exception:
+                return NotImplemented
+        return self._inner.lt(other._inner)
+
+    def __le__(self, other):
+        if not isinstance(other, Decimal):
+            try:
+                other = Decimal(other)
+            except Exception:
+                return NotImplemented
+        return self._inner.le(other._inner)
+
+    def __gt__(self, other):
+        if not isinstance(other, Decimal):
+            try:
+                other = Decimal(other)
+            except Exception:
+                return NotImplemented
+        return not self._inner.le(other._inner)
+
+    def __ge__(self, other):
+        if not isinstance(other, Decimal):
+            try:
+                other = Decimal(other)
+            except Exception:
+                return NotImplemented
+        return not self._inner.lt(other._inner)
+
+    def __ne__(self, other):
+        eq_result = self.__eq__(other)
+        if eq_result is NotImplemented:
+            return NotImplemented
+        return not eq_result
+
+    def __bool__(self):
+        return str(self) not in ("0", "-0")
+
+
+# Also expose as BigDecimal for users who prefer the full name
+BigDecimal = Decimal

decimo/_decimo.pyi

@@ -0,0 +1,18 @@
+"""Type stubs for the _decimo Mojo extension module.
+
+This file tells Pylance/mypy the interface of the compiled _decimo.so.
+"""
+
+class BigDecimal:
+    def __init__(self, value: str) -> None: ...
+    def to_string(self) -> str: ...
+    def to_repr(self) -> str: ...
+    def add(self, other: BigDecimal) -> BigDecimal: ...
+    def sub(self, other: BigDecimal) -> BigDecimal: ...
+    def mul(self, other: BigDecimal) -> BigDecimal: ...
+    def div(self, other: BigDecimal) -> BigDecimal: ...
+    def neg(self) -> BigDecimal: ...
+    def abs_(self) -> BigDecimal: ...
+    def eq(self, other: BigDecimal) -> bool: ...
+    def lt(self, other: BigDecimal) -> bool: ...
+    def le(self, other: BigDecimal) -> bool: ...

decimo-0.1.0.dev0.dist-info/METADATA

@@ -0,0 +1,85 @@
+Metadata-Version: 2.4
+Name: decimo
+Version: 0.1.0.dev0
+Summary: Arbitrary-precision decimal and integer arithmetic for Python, powered by Mojo
+Project-URL: Homepage, https://github.com/forfudan/decimo
+Project-URL: Repository, https://github.com/forfudan/decimo
+Project-URL: Issues, https://github.com/forfudan/decimo/issues
+Project-URL: Changelog, https://github.com/forfudan/decimo/blob/main/docs/changelog.md
+Author-email: "ZHU Yuhao (朱宇浩)" <dr.yuhao.zhu@outlook.com>
+License: Apache-2.0
+Keywords: arbitrary-precision,arithmetic,bigdecimal,decimal,mojo,numeric
+Classifier: Development Status :: 2 - Pre-Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering :: Mathematics
+Classifier: Typing :: Typed
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+
+# decimo
+
+**Arbitrary-precision decimal and integer arithmetic for Python, powered by Mojo.**
+
+[![PyPI](https://img.shields.io/pypi/v/decimo)](https://pypi.org/project/decimo/)
+[![License](https://img.shields.io/badge/license-Apache--2.0-blue)](https://github.com/forfudan/decimo/blob/main/LICENSE)
+
+> ⚠️ **Pre-Alpha / Placeholder release.**  
+> The Python bindings are under active development. A proper installable wheel is coming soon.  
+> Full Mojo library is already available — see the [main repository](https://github.com/forfudan/decimo).
+
+---
+
+## What is decimo?
+
+`decimo` is an arbitrary-precision decimal and integer library, originally written in [Mojo](https://www.modular.com/mojo).  
+This package exposes `decimo`'s `BigDecimal` type to Python via a Mojo-built CPython extension module (`_decimo.so`),
+with a thin Python wrapper providing full Pythonic operator support.
+
+```python
+from decimo import Decimal
+
+a = Decimal("1.234567890123456789012345678901234567890")
+b = Decimal("9.876543210987654321098765432109876543210")
+
+print(a + b)   # 11.111111101111111110111111111111111111100
+print(a * b)   # 12.193263111263526900...
+print(a / b)   # 0.12499999...
+```
+
+## Status
+
+| Feature | Status |
+|---|---|
+| `Decimal` (BigDecimal) arithmetic (`+`, `-`, `*`, `/`) | ✅ Working |
+| Comparison operators | ✅ Working |
+| Unary `-`, `abs()`, `bool()` | ✅ Working |
+| Pre-built wheels on PyPI | 🚧 Coming soon |
+| `BigInt` / `Decimal128` Python bindings | 🔜 Planned |
+
+## Building from source
+
+The extension requires [Mojo](https://docs.modular.com/mojo/manual/get-started/) and [pixi](https://pixi.sh):
+
+```bash
+git clone https://github.com/forfudan/decimo
+cd decimo
+pixi run buildpy
+# .so is built at python/src/decimo/_decimo.so
+```
+
+Then install in editable mode:
+
+```bash
+pip install -e python/
+```
+
+## Links
+
+- **GitHub**: <https://github.com/forfudan/decimo>
+- **Changelog**: <https://github.com/forfudan/decimo/blob/main/docs/changelog.md>
+- **Mojo library docs**: <https://github.com/forfudan/decimo/blob/main/docs/api.md>

decimo-0.1.0.dev0.dist-info/RECORD

@@ -0,0 +1,6 @@
+decimo/__init__.py,sha256=8-JwcMU7gW8OoV3qryEJWInQrTDFXQLeYtZxee0o10I,4388
+decimo/_decimo.pyi,sha256=7uY7lm8gQIFDedjs6YJ9TLsM2a6EgwQ-ak0VeSM3yMQ,712
+decimo/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+decimo-0.1.0.dev0.dist-info/METADATA,sha256=VaZRKfruWUb3PxecDms6qHnYtVPMoHkoqDaAd9eJnq4,3133
+decimo-0.1.0.dev0.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+decimo-0.1.0.dev0.dist-info/RECORD,,

decimo-0.1.0.dev0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.29.0
+Root-Is-Purelib: true
+Tag: py3-none-any