meshtrade 0.0.4__tar.gz → 0.0.5__tar.gz

{meshtrade-0.0.4/src/meshtrade.egg-info → meshtrade-0.0.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: meshtrade
-Version: 0.0.4
+Version: 0.0.5
 Summary: Integration SDK for Mesh API Services
 Author-email: Bernard Bussy <bernard@meshtrade.co>
 License-Expression: LicenseRef-My-Custom-License
@@ -15,7 +15,7 @@ Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
-Requires-Python: >=3.8
+Requires-Python: >=3.12
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: grpcio<2.0,>=1.73.0

{meshtrade-0.0.4 → meshtrade-0.0.5}/pyproject.toml

@@ -4,12 +4,12 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "meshtrade"
-version = "v0.0.4"
+version = "v0.0.5"
 authors = [
     { name = "Bernard Bussy", email = "bernard@meshtrade.co" },
 ]
 description = "Integration SDK for Mesh API Services"
-requires-python = ">=3.8"
+requires-python = ">=3.12"
 keywords = ["meshtrade", "mesh", "mesh-sdk", "grpc", "betterproto", "grpclib"]
 license = "LicenseRef-My-Custom-License"
 license-files = ["LICENSE"]

meshtrade-0.0.5/src/meshtrade/type/v1/__init__.py

@@ -0,0 +1,7 @@
+from .amount import new_amount
+from .decimal_built_in_conversions import built_in_to_decimal, decimal_to_built_in
+from .decimal_pb2 import Decimal
+from .ledger_pb2 import Ledger
+from .ledger import get_ledger_no_decimal_places
+from .token_pb2 import Token
+from .amount_pb2 import Amount

meshtrade-0.0.5/src/meshtrade/type/v1/amount.py

@@ -0,0 +1,84 @@
+"""
+This module provides a factory function for creating Amount protobuf messages.
+"""
+
+from decimal import ROUND_DOWN, Decimal
+
+from .amount_pb2 import Amount
+from .decimal_built_in_conversions import built_in_to_decimal, decimal_to_built_in
+from .ledger import get_ledger_no_decimal_places
+from .token_pb2 import Token
+
+
+def new_amount(
+    value: Decimal,
+    token: Token,
+    precision_loss_tolerance: Decimal = Decimal("0.00000001")
+) -> Amount:
+    """Creates a new Amount, ensuring the value conforms to system-wide limits.
+
+    This function is the safe constructor for creating Amount protobuf messages.
+    While the underlying conversion from a Python `Decimal` to the protobuf's
+    `string` field is lossless, this function provides critical validation
+    to ensure the value adheres to constraints imposed by other downstream
+    systems (e.g., databases, other microservices with fixed-precision types).
+
+    Its primary operations are:
+
+    1.  **Validation:** It performs a serialization round-trip
+        (Python Decimal -> Protobuf Decimal -> Python Decimal) to simulate
+        how the value is stored and retrieved across the system. It then asserts
+        the value remains unchanged, guaranteeing it doesn't exceed the
+        precision limits of any consuming service.
+
+    2.  **Truncation:** It truncates the validated value to the exact number of
+        decimal places defined for the token's ledger, always rounding down to
+        prevent any inflation of values.
+
+    3.  **Construction:** It constructs and returns the final `Amount` message.
+
+    Args:
+        value: The numerical value of the amount as a Python `Decimal` object.
+        token: The `Token` protobuf message that defines the asset type
+               and its associated ledger.
+        precision_loss_tolerance: The maximum acceptable difference after the
+            validation round-trip. Since the string-based conversion is
+            lossless, any difference indicates a failure to conform to an
+            external system's parsing rules. Defaults to a small tolerance
+            for robustness.
+
+    Returns:
+        An `Amount` protobuf message containing the ledger-compliant, truncated
+        value and the specified token.
+
+    Raises:
+        AssertionError: If the input `value` changes during the validation
+                        round-trip, indicating it exceeds the system's
+                        representational limits and would be corrupted
+                        downstream.
+    """
+
+    # Perform a serialization round-trip to validate the value against
+    # system-wide architectural constraints. This is a lossless operation
+    # in isolation, so any change reveals an incompatibility.
+    value_after_roundtrip = decimal_to_built_in(built_in_to_decimal(value))
+
+    # Confirm the value is perfectly representable within the system's limits.
+    # If the original value had too much precision for a downstream service to
+    # parse, it would change during the round-trip, and this would fail.
+    assert abs(value_after_roundtrip - value) \
+        <= precision_loss_tolerance, \
+            "value exceeds system's precision limits and would be corrupted"
+
+    # Truncate the validated value to the number of decimal places specified by the
+    # token's ledger. ROUND_DOWN ensures the value is never inflated.
+    truncated_value = value_after_roundtrip.quantize(
+        Decimal(10) ** -get_ledger_no_decimal_places(token.ledger),
+        rounding=ROUND_DOWN,
+    )
+
+    # Construct and return the final Amount protobuf message using the sanitized value.
+    return Amount(
+        token=token,
+        value=built_in_to_decimal(truncated_value),
+    )

meshtrade-0.0.5/src/meshtrade/type/v1/decimal_built_in_conversions.py

@@ -0,0 +1,29 @@
+import decimal
+
+from .decimal_pb2 import Decimal
+
+
+def built_in_to_decimal(decimal_value: decimal.Decimal) -> Decimal:
+    """
+    Converts an instance of the built-in decimal.Decimal type to an instance of the
+    financial Decimal protobuf type.
+
+    :param decimal_value: The decimal.Decimal object to convert.
+    :return: The converted financial Decimal protobuf object.
+    """
+
+    # Contruct and return resultant decimal object
+    return Decimal(
+        value=str(decimal_value),
+    )
+
+
+def decimal_to_built_in(decimal_value: Decimal) -> decimal.Decimal:
+    """
+    Converts an instance of the financial Decimal protobuf type to an instance of the
+    built-in decimal.Decimal type.
+
+    :param decimal_value: The decimal_pb2.Decimal object to convert.
+    :return: The converted decimal.Decimal object.
+    """
+    return decimal.Decimal( decimal_value.value if decimal_value.value != "" else "0"  )

meshtrade-0.0.5/src/meshtrade/type/v1/ledger.py

@@ -0,0 +1,26 @@
+from typing import Dict
+
+from .ledger_pb2 import Ledger
+
+_ledger_decimal_places: Dict[Ledger, int] = {
+    Ledger.LEDGER_STELLAR: 7,
+    Ledger.LEDGER_SA_STOCK_BROKERS: 2,
+}
+
+class UnsupportedLedgerError(Exception):
+    """Exception raised for unsupported Ledger values."""
+
+    def __init__(self, ledger: Ledger):
+        self.financial_business_day_convention = ledger
+        message = f"Unsupported Ledger: {ledger}"
+        super().__init__(message)
+
+
+def get_ledger_no_decimal_places(ledger: Ledger) -> int:
+    """
+    Returns the number of decimal places supported by the given Ledger
+    """
+    if ledger in _ledger_decimal_places:
+        return _ledger_decimal_places[ledger]
+    else:
+        raise UnsupportedLedgerError(ledger)

{meshtrade-0.0.4 → meshtrade-0.0.5/src/meshtrade.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: meshtrade
-Version: 0.0.4
+Version: 0.0.5
 Summary: Integration SDK for Mesh API Services
 Author-email: Bernard Bussy <bernard@meshtrade.co>
 License-Expression: LicenseRef-My-Custom-License
@@ -15,7 +15,7 @@ Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
-Requires-Python: >=3.8
+Requires-Python: >=3.12
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: grpcio<2.0,>=1.73.0

{meshtrade-0.0.4 → meshtrade-0.0.5}/src/meshtrade.egg-info/SOURCES.txt

@@ -90,12 +90,15 @@ src/meshtrade/type/__init__.py
 src/meshtrade/type/v1/__init__.py
 src/meshtrade/type/v1/address_pb2.py
 src/meshtrade/type/v1/address_pb2.pyi
+src/meshtrade/type/v1/amount.py
 src/meshtrade/type/v1/amount_pb2.py
 src/meshtrade/type/v1/amount_pb2.pyi
 src/meshtrade/type/v1/contact_details_pb2.py
 src/meshtrade/type/v1/contact_details_pb2.pyi
+src/meshtrade/type/v1/decimal_built_in_conversions.py
 src/meshtrade/type/v1/decimal_pb2.py
 src/meshtrade/type/v1/decimal_pb2.pyi
+src/meshtrade/type/v1/ledger.py
 src/meshtrade/type/v1/ledger_pb2.py
 src/meshtrade/type/v1/ledger_pb2.pyi
 src/meshtrade/type/v1/token_pb2.py