abstract-math 0.0.0.17__tar.gz → 0.0.0.19__tar.gz

abstract_math-0.0.0.19/PKG-INFO

@@ -0,0 +1,81 @@
+Metadata-Version: 2.4
+Name: abstract_math
+Version: 0.0.0.19
+Author: putkoff
+Author-email: partners@abstractendeavors.com
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Requires-Python: >=3.6
+Description-Content-Type: text/markdown
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: requires-python
+
+# abstract_math
+
+## Description
+The abstract_math Python module, currently in its Alpha development stage (version 0.0.0.14), is designed for performing complex mathematical operations and token manipulations. This module comprises primarily of two scripts: `safe_math` and `derive_tokens`.
+
+## Features
+- Performing complex mathematical operations.
+- Manipulation and derivation of mathematical tokens, referred to as 'lamports'.
+- High precision for decimal calculations for better accuracy.
+- Functions for deriving quantities like lamports, virtual reserves, sol reserves, sol amounts, token reserves, token amounts, derived token ratio, price, and token decimals.
+- Module components for updating Sol and token variables.
+
+## Scripts Overview
+
+- `derive_tokens.py`: This script is involved in the complex manipulation or derivation of mathematical tokens, referred to as 'lamports'. The functions defined in this script handle various aspects of token manipulations and calculations. 
+
+
+## Installation
+To install the abstract_math module, ensure that your Python version is 3.6 or later. This module currently does not have any external dependencies to be installed.
+
+## Usage
+This module could potentially be used as a framework for handling complex mathematical operations or token manipulations. Developers interested in working with and enhancing this module can access the source code at the repository (provide repo link here).
+
+## Dependencies
+Currently, the module does not require any external dependencies.
+
+## License
+The module is provided under the MIT License.
+
+## Author & Contact
+This Python module was authored by 'putkoff', who can be reached at partners@abstractendeavors.com for further queries or assistance.
+
+## Contributing
+Contributions are welcome to help in the development of the abstract_math module, particularly with the 'safe_math' and 'derive_tokens' scripts that form the core of the module.
+# Unknown Package (vUnknown Version)
+
+No description available
+
+## Installation
+
+```bash
+pip install Unknown Package
+```
+
+## Dependencies
+
+None
+
+## Modules
+
+### src/abstract_math/safe_math.py
+
+Description of script based on prompt: You are analyzing a Python script 'safe_math.py' l (mock response)
+
+### src/abstract_math/__init__.py
+
+Description of script based on prompt: You are analyzing a Python script '__init__.py' lo (mock response)
+
+### src/abstract_math/derive_tokens.py
+
+Description of script based on prompt: You are analyzing a Python script 'derive_tokens.p (mock response)
+

abstract_math-0.0.0.19/README.md

@@ -0,0 +1,62 @@
+# abstract_math
+
+## Description
+The abstract_math Python module, currently in its Alpha development stage (version 0.0.0.14), is designed for performing complex mathematical operations and token manipulations. This module comprises primarily of two scripts: `safe_math` and `derive_tokens`.
+
+## Features
+- Performing complex mathematical operations.
+- Manipulation and derivation of mathematical tokens, referred to as 'lamports'.
+- High precision for decimal calculations for better accuracy.
+- Functions for deriving quantities like lamports, virtual reserves, sol reserves, sol amounts, token reserves, token amounts, derived token ratio, price, and token decimals.
+- Module components for updating Sol and token variables.
+
+## Scripts Overview
+
+- `derive_tokens.py`: This script is involved in the complex manipulation or derivation of mathematical tokens, referred to as 'lamports'. The functions defined in this script handle various aspects of token manipulations and calculations. 
+
+
+## Installation
+To install the abstract_math module, ensure that your Python version is 3.6 or later. This module currently does not have any external dependencies to be installed.
+
+## Usage
+This module could potentially be used as a framework for handling complex mathematical operations or token manipulations. Developers interested in working with and enhancing this module can access the source code at the repository (provide repo link here).
+
+## Dependencies
+Currently, the module does not require any external dependencies.
+
+## License
+The module is provided under the MIT License.
+
+## Author & Contact
+This Python module was authored by 'putkoff', who can be reached at partners@abstractendeavors.com for further queries or assistance.
+
+## Contributing
+Contributions are welcome to help in the development of the abstract_math module, particularly with the 'safe_math' and 'derive_tokens' scripts that form the core of the module.
+# Unknown Package (vUnknown Version)
+
+No description available
+
+## Installation
+
+```bash
+pip install Unknown Package
+```
+
+## Dependencies
+
+None
+
+## Modules
+
+### src/abstract_math/safe_math.py
+
+Description of script based on prompt: You are analyzing a Python script 'safe_math.py' l (mock response)
+
+### src/abstract_math/__init__.py
+
+Description of script based on prompt: You are analyzing a Python script '__init__.py' lo (mock response)
+
+### src/abstract_math/derive_tokens.py
+
+Description of script based on prompt: You are analyzing a Python script 'derive_tokens.p (mock response)
+

{abstract_math-0.0.0.17 → abstract_math-0.0.0.19}/setup.py

@@ -4,7 +4,7 @@ with open("README.md", "r", encoding="utf-8") as fh:
     long_description = fh.read()
 setuptools.setup(
     name='abstract_math',
-    version='0.0.0.17',
+    version='0.0.0.19',
     author='putkoff',
     author_email='partners@abstractendeavors.com',
     description="",

{abstract_math-0.0.0.17 → abstract_math-0.0.0.19}/src/abstract_math/__init__.py

@@ -1,2 +1,3 @@
 from .safe_math import *
 from .derive_tokens import *
+from .solar_math import *

{abstract_math-0.0.0.17 → abstract_math-0.0.0.19}/src/abstract_math/derive_tokens.py

@@ -1,18 +1,19 @@
 from decimal import Decimal, getcontext
 from .safe_math import *
+from .safe_math import exp_it, divide_it  # if you need these
 
-# Set high precision for decimal operations
+# High precision for decimal ops
 getcontext().prec = 50
 
-# Constants for SOL decimal places and lamports conversion
+# SOL constants
 SOL_DECIMAL_PLACE = 9
-SOL_LAMPORTS = sol_lamports = int(exponential(1, SOL_DECIMAL_PLACE, 1))
+# lamports per SOL = 10**9
+SOL_LAMPORTS = sol_lamports = int(exponential(1, exp=SOL_DECIMAL_PLACE, num=1))
 
 
 def get_proper_args(strings, *args, **kwargs):
     """
-    Extracts values from kwargs based on the provided keys (strings). If not present in kwargs,
-    falls back to positional args in order.
+    Extract values for keys in `strings` from kwargs; if missing, pull from positional args in order.
     """
     properArgs = []
     for key in strings:
@@ -23,25 +24,26 @@ def get_proper_args(strings, *args, **kwargs):
         properArgs.append(kwarg)
     return properArgs
 
-# Lamports calculations
 
-def get_lamports(integer):
+# ---------- Lamports helpers ----------
+def get_lamports(integer: int):
     """
-    Given an integer representing SOL, returns lamports (10^(digits_in_integer+1)).
+    Convert an integer N to 10^(len(str(N)) + 1).
+    NOTE: this is your original behavior, not 10**9 unless N is 1 with exp=9.
     """
     return exp_it(10, len(str(integer)) + 1, 1)
 
 
-def get_lamport_difference(lamports, virtual_lamports):
+def get_lamport_difference(lamports: int, virtual_lamports: int):
     """
-    Compares actual lamports to virtual lamports and returns the corresponding exponent-based difference.
+    Compare 'lamports' vs 'virtual_lamports' and return 10^(len(str(int(virtual/actual))))
     """
     integer = int(virtual_lamports / lamports)
     exp = len(str(integer))
     return int(exponential(1, exp, 1))
 
-# Virtual reserves and ratios
 
+# ---------- Virtual reserves / ratios ----------
 def get_vitual_reserves(*args, **kwargs):
     return get_proper_args(["virtualSolReserves", "virtualTokenReserves"], *args, **kwargs)
 
@@ -50,8 +52,8 @@ def get_virtual_reserve_ratio(*args, **kwargs):
     sol_res, token_res = get_vitual_reserves(*args, **kwargs)
     return divide_it(sol_res, token_res)
 
-# SOL-specific calculations
 
+# ---------- SOL-specific ----------
 def get_virtual_sol_reservs(*args, **kwargs):
     reserves = get_proper_args(["virtualSolReserves"], *args, **kwargs)
     return reserves[0] if reserves else None
@@ -66,7 +68,6 @@ def get_virtual_sol_lamp_difference(*args, **kwargs):
     v_lam = get_virtual_sol_lamports(*args, **kwargs)
     return get_lamport_difference(SOL_LAMPORTS, v_lam)
 
-# SOL amount conversions
 
 def get_sol_amount(*args, **kwargs):
     amounts = get_proper_args(["solAmount"], *args, **kwargs)
@@ -77,8 +78,8 @@ def getSolAmountUi(*args, **kwargs):
     sol_amt = get_sol_amount(*args, **kwargs)
     return exponential(sol_amt, SOL_DECIMAL_PLACE)
 
-# Token-specific calculations
 
+# ---------- Token-specific ----------
 def get_virtual_token_reserves(*args, **kwargs):
     reserves = get_proper_args(["virtualTokenReserves"], *args, **kwargs)
     return reserves[0] if reserves else None
@@ -94,22 +95,10 @@ def get_token_amount(*args, **kwargs):
     return amounts[0] if amounts else None
 
 
-def get_token_amount_ui(*args, **kwargs):
-    token_amt = get_token_amount(*args, **kwargs)
-    token_decimals = derive_decimals_from_vars(*args, **kwargs)
-    return exponential(token_amt, token_decimals)
-
-
-def derive_token_decimals_from_token_variables(**variables):
-    variables["price"] = get_price(**variables)
-    variables["tokenDecimals"] = derive_decimals_from_vars(**variables)
-    return variables
-
-
-def get_derived_token_ratio(*args, **kwargs):
-    derived_amt = derive_token_amount(*args, **kwargs)
-    token_amt = get_token_amount(*args, **kwargs)
-    return divide_it(derived_amt, token_amt)
+def get_price(*args, **kwargs):
+    reserve_ratio = get_virtual_reserve_ratio(*args, **kwargs)
+    sol_diff = get_virtual_sol_lamp_difference(*args, **kwargs)
+    return divide_it(reserve_ratio, sol_diff)
 
 
 def derive_token_amount(*args, **kwargs):
@@ -118,22 +107,35 @@ def derive_token_amount(*args, **kwargs):
     return divide_it(token_res, price)
 
 
-def get_price(*args, **kwargs):
-    reserve_ratio = get_virtual_reserve_ratio(*args, **kwargs)
-    sol_diff = get_virtual_sol_lamp_difference(*args, **kwargs)
-    return divide_it(reserve_ratio, sol_diff)
+def get_derived_token_ratio(*args, **kwargs):
+    derived_amt = derive_token_amount(*args, **kwargs)
+    token_amt = get_token_amount(*args, **kwargs)
+    return divide_it(derived_amt, token_amt)
 
 
 def derive_decimals_from_vars(*args, **kwargs):
     ratio = get_derived_token_ratio(*args, **kwargs)
     decimals = -1
+    # Count how many decimal places are needed to make ratio an integer (<= 1e-9 tolerance)
     while abs(ratio - round(ratio)) > 1e-9:
         ratio *= 10
         decimals += 1
     return decimals
 
 
-def update_token_variables(variables):
+def get_token_amount_ui(*args, **kwargs):
+    token_amt = get_token_amount(*args, **kwargs)
+    token_decimals = derive_decimals_from_vars(*args, **kwargs)
+    return exponential(token_amt, token_decimals)
+
+
+def derive_token_decimals_from_token_variables(**variables):
+    variables["price"] = get_price(**variables)
+    variables["tokenDecimals"] = derive_decimals_from_vars(**variables)
+    return variables
+
+
+def update_token_variables(variables: dict):
     variables['solAmountUi'] = getSolAmountUi(**variables)
     variables['solDecimals'] = SOL_DECIMAL_PLACE
     variables = derive_token_decimals_from_token_variables(**variables)