rgwfuncs 0.0.37__tar.gz → 0.0.40__tar.gz

{rgwfuncs-0.0.37/src/rgwfuncs.egg-info → rgwfuncs-0.0.40}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: rgwfuncs
-Version: 0.0.37
+Version: 0.0.40
 Summary: A functional programming paradigm for mathematical modelling and data science
 Home-page: https://github.com/ryangerardwilson/rgwfunc
 Author: Ryan Gerard Wilson
@@ -23,12 +23,16 @@ Requires-Dist: xgboost
 Requires-Dist: requests
 Requires-Dist: slack-sdk
 Requires-Dist: google-api-python-client
+Requires-Dist: boto
 
 # RGWFUNCS
 
 ***By Ryan Gerard Wilson (https://ryangerardwilson.com)***
 
-This library is meant to make ML/ Data Science pipelines more readable. It assumes a linux environment, and the existence of a `.rgwfuncsrc` file for certain features (like db querying, sending data to slack, etc.)
+
+This library is meant to protect your eyes (and brain) from OOP syntax. It is unbelievably sad that some of the best work done in creating math and data science libraries in Python has been corrupted by the OOP mind-virus. 
+
+By creating a functional-programming wrapper around these libraries, we aim to soothe. This library assumes a Linux environment and the existence of a `.rgwfuncsrc` file for certain features (like database querying, sending data to Slack, etc.).
 
 --------------------------------------------------------------------------------
 
@@ -362,6 +366,42 @@ Converts a polynomial expression written in Python syntax to a LaTeX formatted s
 
 --------------------------------------------------------------------------------
 
+### 6. `expand_polynomial_expression`
+
+Expands a polynomial expression written in Python syntax and converts it into a LaTeX formatted string. This function takes algebraic expressions provided as strings using Python's syntax, applies polynomial expansion through SymPy, and translates them into LaTeX representations, suitable for academic or professional documentation. It supports expressions with named variables and provides an option to substitute specific values into the expression before expansion.
+
+- Parameters:
+  - `expression` (str): The algebraic expression to expand and convert to LaTeX. This string should be formatted using Python syntax acceptable by SymPy.
+  - `subs` (Optional[Dict[str, float]]): An optional dictionary of substitutions where the keys are variable names in the expression, and the values are the numbers with which to substitute those variables before expanding.
+
+- Returns:
+  - `str`: The LaTeX formatted string of the expanded expression.
+
+- Raises:
+  - `ValueError`: If the expression cannot be parsed due to syntax errors.
+
+- Example:
+
+    from rgwfuncs import expand_polynomial_expression
+
+    # Expand a simple polynomial expression and convert to LaTeX
+    latex_result1 = expand_polynomial_expression("(x + y)**2")
+    print(latex_result1)  # Output: "x^{2} + 2 x y + y^{2}"
+
+    # Expand polynomial expression with substituted values
+    latex_result2 = expand_polynomial_expression("(x + y)**2", {"x": 3, "y": 4})
+    print(latex_result2)  # Output: "49"
+
+    # Another example with partial substitution
+    latex_result3 = expand_polynomial_expression("(x + y)**2", {"x": 3})
+    print(latex_result3)  # Output: "y^{2} + 6 y + 9"
+
+    # Handling trigonometric functions with symbolic variables
+    latex_result4 = expand_polynomial_expression("sin(x + z**2) + cos(y)", {"x": 55})
+    print(latex_result4)  # Output: "cos y + sin \\left(z^{2} + 55\\right)"
+
+--------------------------------------------------------------------------------
+
 ### 6. `simplify_polynomial_expression`
 
 Simplifies an algebraic expression in polynomial form and returns it in LaTeX format. Takes an algebraic expression, in polynomial form, written in Python syntax and simplifies it. The result is returned as a LaTeX formatted string, suitable for academic or professional documentation.

{rgwfuncs-0.0.37 → rgwfuncs-0.0.40}/README.md

@@ -2,7 +2,10 @@
 
 ***By Ryan Gerard Wilson (https://ryangerardwilson.com)***
 
-This library is meant to make ML/ Data Science pipelines more readable. It assumes a linux environment, and the existence of a `.rgwfuncsrc` file for certain features (like db querying, sending data to slack, etc.)
+
+This library is meant to protect your eyes (and brain) from OOP syntax. It is unbelievably sad that some of the best work done in creating math and data science libraries in Python has been corrupted by the OOP mind-virus. 
+
+By creating a functional-programming wrapper around these libraries, we aim to soothe. This library assumes a Linux environment and the existence of a `.rgwfuncsrc` file for certain features (like database querying, sending data to Slack, etc.).
 
 --------------------------------------------------------------------------------
 
@@ -336,6 +339,42 @@ Converts a polynomial expression written in Python syntax to a LaTeX formatted s
 
 --------------------------------------------------------------------------------
 
+### 6. `expand_polynomial_expression`
+
+Expands a polynomial expression written in Python syntax and converts it into a LaTeX formatted string. This function takes algebraic expressions provided as strings using Python's syntax, applies polynomial expansion through SymPy, and translates them into LaTeX representations, suitable for academic or professional documentation. It supports expressions with named variables and provides an option to substitute specific values into the expression before expansion.
+
+- Parameters:
+  - `expression` (str): The algebraic expression to expand and convert to LaTeX. This string should be formatted using Python syntax acceptable by SymPy.
+  - `subs` (Optional[Dict[str, float]]): An optional dictionary of substitutions where the keys are variable names in the expression, and the values are the numbers with which to substitute those variables before expanding.
+
+- Returns:
+  - `str`: The LaTeX formatted string of the expanded expression.
+
+- Raises:
+  - `ValueError`: If the expression cannot be parsed due to syntax errors.
+
+- Example:
+
+    from rgwfuncs import expand_polynomial_expression
+
+    # Expand a simple polynomial expression and convert to LaTeX
+    latex_result1 = expand_polynomial_expression("(x + y)**2")
+    print(latex_result1)  # Output: "x^{2} + 2 x y + y^{2}"
+
+    # Expand polynomial expression with substituted values
+    latex_result2 = expand_polynomial_expression("(x + y)**2", {"x": 3, "y": 4})
+    print(latex_result2)  # Output: "49"
+
+    # Another example with partial substitution
+    latex_result3 = expand_polynomial_expression("(x + y)**2", {"x": 3})
+    print(latex_result3)  # Output: "y^{2} + 6 y + 9"
+
+    # Handling trigonometric functions with symbolic variables
+    latex_result4 = expand_polynomial_expression("sin(x + z**2) + cos(y)", {"x": 55})
+    print(latex_result4)  # Output: "cos y + sin \\left(z^{2} + 55\\right)"
+
+--------------------------------------------------------------------------------
+
 ### 6. `simplify_polynomial_expression`
 
 Simplifies an algebraic expression in polynomial form and returns it in LaTeX format. Takes an algebraic expression, in polynomial form, written in Python syntax and simplifies it. The result is returned as a LaTeX formatted string, suitable for academic or professional documentation.

{rgwfuncs-0.0.37 → rgwfuncs-0.0.40}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "rgwfuncs"
-version = "0.0.37"
+version = "0.0.40"
 authors = [
   { name = "Ryan Gerard Wilson", email = "ryangerardwilson@gmail.com" },
 ]
@@ -27,6 +27,7 @@ dependencies = [
     "requests",
     "slack-sdk",
     "google-api-python-client",
+    "boto"
 ]
 
 dynamic = ["scripts"]

{rgwfuncs-0.0.37 → rgwfuncs-0.0.40}/setup.cfg

@@ -1,6 +1,6 @@
 [metadata]
 name = rgwfuncs
-version = 0.0.37
+version = 0.0.40
 author = Ryan Gerard Wilson
 author_email = ryangerardwilson@gmail.com
 description = A functional programming paradigm for mathematical modelling and data science
@@ -28,6 +28,7 @@ install_requires =
 	requests
 	slack-sdk
 	google-api-python-client
+	boto
 
 [options.packages.find]
 where = src

{rgwfuncs-0.0.37 → rgwfuncs-0.0.40}/src/rgwfuncs/__init__.py

@@ -1,7 +1,7 @@
 # This file is automatically generated
 # Dynamically importing functions from modules
 
-from .algebra_lib import compute_constant_expression, compute_constant_expression_involving_matrices, compute_constant_expression_involving_ordered_series, compute_prime_factors, python_polynomial_expression_to_latex, simplify_polynomial_expression, solve_homogeneous_polynomial_expression
+from .algebra_lib import compute_constant_expression, compute_constant_expression_involving_matrices, compute_constant_expression_involving_ordered_series, compute_prime_factors, expand_polynomial_expression, python_polynomial_expression_to_latex, simplify_polynomial_expression, solve_homogeneous_polynomial_expression
 from .df_lib import append_columns, append_percentile_classification_column, append_ranged_classification_column, append_ranged_date_classification_column, append_rows, append_xgb_labels, append_xgb_logistic_regression_predictions, append_xgb_regression_predictions, bag_union_join, bottom_n_unique_values, cascade_sort, delete_rows, drop_duplicates, drop_duplicates_retain_first, drop_duplicates_retain_last, filter_dataframe, filter_indian_mobiles, first_n_rows, from_raw_data, insert_dataframe_in_sqlite_database, last_n_rows, left_join, limit_dataframe, load_data_from_path, load_data_from_query, load_data_from_sqlite_path, mask_against_dataframe, mask_against_dataframe_converse, numeric_clean, order_columns, print_correlation, print_dataframe, print_memory_usage, print_n_frequency_cascading, print_n_frequency_linear, rename_columns, retain_columns, right_join, send_data_to_email, send_data_to_slack, send_dataframe_via_telegram, sync_dataframe_to_sqlite_database, top_n_unique_values, union_join, update_rows
 from .docs_lib import docs
 from .interactive_shell_lib import interactive_shell

{rgwfuncs-0.0.37 → rgwfuncs-0.0.40}/src/rgwfuncs/algebra_lib.py

@@ -320,6 +320,50 @@ def python_polynomial_expression_to_latex(
     latex_result = latex(expr)
     return latex_result
 
+def expand_polynomial_expression(
+    expression: str,
+    subs: Optional[Dict[str, float]] = None
+) -> str:
+    """
+    Expands a polynomial expression written in Python syntax and converts it to LaTeX format.
+
+    This function takes an algebraic expression written in Python syntax, 
+    applies polynomial expansion, and converts the expanded expression 
+    to a LaTeX formatted string. The expression should be compatible with sympy.
+
+    Parameters:
+    expression (str): The algebraic expression to expand and convert to LaTeX. 
+                      The expression should be written using Python syntax.
+    subs (Optional[Dict[str, float]]): An optional dictionary of substitutions 
+                                       to apply to variables in the expression 
+                                       before expansion.
+
+    Returns:
+    str: The expanded expression represented as a LaTeX string.
+
+    Raises:
+    ValueError: If the expression cannot be parsed due to syntax errors.
+    """
+    transformations = standard_transformations + (implicit_multiplication_application,)
+    
+    def parse_and_expand_expression(expr_str: str, sym_vars: Dict[str, symbols]) -> symbols:
+        try:
+            expr = parse_expr(expr_str, local_dict=sym_vars, transformations=transformations)
+            if subs:
+                subs_symbols = {symbols(k): v for k, v in subs.items()}
+                expr = expr.subs(subs_symbols)
+            return expr.expand()
+        except (SyntaxError, ValueError, TypeError) as e:
+            raise ValueError(f"Error parsing expression: {expr_str}. Error: {e}")
+
+    variable_names = set(re.findall(r'\b[a-zA-Z]\w*\b', expression))
+    sym_vars = {var: symbols(var) for var in variable_names}
+
+    expr = parse_and_expand_expression(expression, sym_vars)
+    latex_result = latex(expr)
+    return latex_result
+
+
 
 def simplify_polynomial_expression(
     expression: str,

{rgwfuncs-0.0.37 → rgwfuncs-0.0.40}/src/rgwfuncs/df_lib.py

@@ -21,6 +21,7 @@ from email.mime.base import MIMEBase
 from email import encoders
 from googleapiclient.discovery import build
 import base64
+import boto3
 # import inspect
 from typing import Optional, Dict, List, Tuple, Any
 import warnings
@@ -434,7 +435,7 @@ def load_data_from_query(db_preset_name: str, query: str) -> pd.DataFrame:
             return pd.DataFrame(data, columns=columns)
 
 
-        aws_region = db_preset['region']
+        aws_region = db_preset['aws_region']
         database = db_preset['database']
         output_bucket = db_preset['output_bucket']
         

{rgwfuncs-0.0.37 → rgwfuncs-0.0.40/src/rgwfuncs.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: rgwfuncs
-Version: 0.0.37
+Version: 0.0.40
 Summary: A functional programming paradigm for mathematical modelling and data science
 Home-page: https://github.com/ryangerardwilson/rgwfunc
 Author: Ryan Gerard Wilson
@@ -23,12 +23,16 @@ Requires-Dist: xgboost
 Requires-Dist: requests
 Requires-Dist: slack-sdk
 Requires-Dist: google-api-python-client
+Requires-Dist: boto
 
 # RGWFUNCS
 
 ***By Ryan Gerard Wilson (https://ryangerardwilson.com)***
 
-This library is meant to make ML/ Data Science pipelines more readable. It assumes a linux environment, and the existence of a `.rgwfuncsrc` file for certain features (like db querying, sending data to slack, etc.)
+
+This library is meant to protect your eyes (and brain) from OOP syntax. It is unbelievably sad that some of the best work done in creating math and data science libraries in Python has been corrupted by the OOP mind-virus. 
+
+By creating a functional-programming wrapper around these libraries, we aim to soothe. This library assumes a Linux environment and the existence of a `.rgwfuncsrc` file for certain features (like database querying, sending data to Slack, etc.).
 
 --------------------------------------------------------------------------------
 
@@ -362,6 +366,42 @@ Converts a polynomial expression written in Python syntax to a LaTeX formatted s
 
 --------------------------------------------------------------------------------
 
+### 6. `expand_polynomial_expression`
+
+Expands a polynomial expression written in Python syntax and converts it into a LaTeX formatted string. This function takes algebraic expressions provided as strings using Python's syntax, applies polynomial expansion through SymPy, and translates them into LaTeX representations, suitable for academic or professional documentation. It supports expressions with named variables and provides an option to substitute specific values into the expression before expansion.
+
+- Parameters:
+  - `expression` (str): The algebraic expression to expand and convert to LaTeX. This string should be formatted using Python syntax acceptable by SymPy.
+  - `subs` (Optional[Dict[str, float]]): An optional dictionary of substitutions where the keys are variable names in the expression, and the values are the numbers with which to substitute those variables before expanding.
+
+- Returns:
+  - `str`: The LaTeX formatted string of the expanded expression.
+
+- Raises:
+  - `ValueError`: If the expression cannot be parsed due to syntax errors.
+
+- Example:
+
+    from rgwfuncs import expand_polynomial_expression
+
+    # Expand a simple polynomial expression and convert to LaTeX
+    latex_result1 = expand_polynomial_expression("(x + y)**2")
+    print(latex_result1)  # Output: "x^{2} + 2 x y + y^{2}"
+
+    # Expand polynomial expression with substituted values
+    latex_result2 = expand_polynomial_expression("(x + y)**2", {"x": 3, "y": 4})
+    print(latex_result2)  # Output: "49"
+
+    # Another example with partial substitution
+    latex_result3 = expand_polynomial_expression("(x + y)**2", {"x": 3})
+    print(latex_result3)  # Output: "y^{2} + 6 y + 9"
+
+    # Handling trigonometric functions with symbolic variables
+    latex_result4 = expand_polynomial_expression("sin(x + z**2) + cos(y)", {"x": 55})
+    print(latex_result4)  # Output: "cos y + sin \\left(z^{2} + 55\\right)"
+
+--------------------------------------------------------------------------------
+
 ### 6. `simplify_polynomial_expression`
 
 Simplifies an algebraic expression in polynomial form and returns it in LaTeX format. Takes an algebraic expression, in polynomial form, written in Python syntax and simplifies it. The result is returned as a LaTeX formatted string, suitable for academic or professional documentation.

{rgwfuncs-0.0.37 → rgwfuncs-0.0.40}/src/rgwfuncs.egg-info/requires.txt

@@ -8,3 +8,4 @@ xgboost
 requests
 slack-sdk
 google-api-python-client
+boto