rgwfuncs 0.0.112__tar.gz → 0.0.115__tar.gz

{rgwfuncs-0.0.112/src/rgwfuncs.egg-info → rgwfuncs-0.0.115}/PKG-INFO

@@ -1,9 +1,7 @@
 Metadata-Version: 2.4
 Name: rgwfuncs
-Version: 0.0.112
+Version: 0.0.115
 Summary: A functional programming paradigm for mathematical modelling and data science
-Home-page: https://github.com/ryangerardwilson/rgwfuncs
-Author: Ryan Gerard Wilson
 Author-email: Ryan Gerard Wilson <ryangerardwilson@gmail.com>
 Project-URL: Homepage, https://github.com/ryangerardwilson/rgwfuncs
 Project-URL: Issues, https://github.com/ryangerardwilson/rgwfuncs
@@ -25,6 +23,7 @@ Requires-Dist: slack-sdk
 Requires-Dist: google-api-python-client
 Requires-Dist: boto3
 Requires-Dist: pyfiglet
+Requires-Dist: snowflake-connector-python
 Dynamic: license-file
 
 # RGWFUNCS

{rgwfuncs-0.0.112 → rgwfuncs-0.0.115}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "rgwfuncs"
-version = "0.0.112"
+version = "0.0.115"
 authors = [
   { name = "Ryan Gerard Wilson", email = "ryangerardwilson@gmail.com" },
 ]
@@ -28,7 +28,8 @@ dependencies = [
     "slack-sdk",                 
     "google-api-python-client",  
     "boto3",           
-    "pyfiglet" 
+    "pyfiglet",
+    "snowflake-connector-python"
 ]
 
 dynamic = ["scripts"]

rgwfuncs-0.0.115/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

{rgwfuncs-0.0.112 → rgwfuncs-0.0.115}/src/rgwfuncs/__init__.py

@@ -1,7 +1,7 @@
 # This file is automatically generated
 # Dynamically importing functions from modules
 
-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_aws_athena_query, load_data_from_big_query, load_data_from_path, load_data_from_query, load_data_from_sqlite_path, load_fresh_data_or_pull_from_cache, 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 .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_aws_athena_query, load_data_from_big_query, load_data_from_path, load_data_from_query, load_data_from_snowflake, load_data_from_sqlite_path, load_fresh_data_or_pull_from_cache, 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 .interactive_shell_lib import interactive_shell
 from .docs_lib import docs
 from .str_lib import heading, send_telegram_message, sub_heading, title

{rgwfuncs-0.0.112 → rgwfuncs-0.0.115}/src/rgwfuncs/df_lib.py

@@ -20,6 +20,9 @@ from email.mime.text import MIMEText
 from email.mime.base import MIMEBase
 from email import encoders
 from googleapiclient.discovery import build
+import snowflake.connector
+from cryptography.hazmat.primitives import serialization
+from cryptography.hazmat.backends import default_backend
 import base64
 import boto3
 from typing import Optional, Dict, List, Tuple, Any, Callable, Union
@@ -563,6 +566,129 @@ def load_data_from_big_query(
     return pd.DataFrame(rows, columns=columns)
 
 
+def load_data_from_snowflake(
+    query: str,
+    private_key_path: Optional[str] = None,
+    private_key_password: Optional[str] = None,
+    account: Optional[str] = None,
+    user: Optional[str] = None,
+    warehouse: Optional[str] = None,
+    database: Optional[str] = None,
+    schema: Optional[str] = None,
+    preset: Optional[str] = None
+) -> pd.DataFrame:
+    """
+    Load data from Snowflake with a query, returning a DataFrame.
+
+    Parameters:
+        query (str): The SQL query to execute.
+        private_key_path (Optional[str]): Path to the private key file (PEM).
+        private_key_password (Optional[str]): Password for the encrypted private key (if any).
+        account (Optional[str]): Snowflake account identifier.
+        user (Optional[str]): Snowflake username.
+        warehouse (Optional[str]): Snowflake warehouse name.
+        database (Optional[str]): Snowflake database name.
+        schema (Optional[str]): Snowflake schema name.
+        preset (Optional[str]): Name of the Snowflake preset in the .rgwfuncsrc file.
+
+    Returns:
+        pd.DataFrame: DataFrame with the query results.
+
+    Raises:
+        ValueError: If both preset and direct creds are mixed, neither provided,
+                    or required creds missing.
+        FileNotFoundError: If no '.rgwfuncsrc' found for preset.
+        RuntimeError: If preset not found or missing details.
+    """
+    def get_config() -> dict:
+        """Hunt for '.rgwfuncsrc' upwards like a sane person."""
+        current_dir = os.getcwd()
+        while True:
+            config_path = os.path.join(current_dir, '.rgwfuncsrc')  # Wait, your example had .rgwfuncsrc, assuming that's not a typo.
+            if os.path.isfile(config_path):
+                with open(config_path, 'r', encoding='utf-8') as f:
+                    content = f.read().strip()
+                    if not content:
+                        raise ValueError(f"Empty config at {config_path}'")
+                    try:
+                        return json.loads(content)
+                    except json.JSONDecodeError as e:
+                        raise ValueError(f"JSON crap in {config_path}: {e}")
+            parent = os.path.dirname(current_dir)
+            if parent == current_dir:
+                raise FileNotFoundError("Can't find '.rgwfuncsrc' anywhere useful")
+            current_dir = parent
+
+    def get_db_preset(config: dict, preset_name: str) -> dict:
+        """Grab the preset or complain."""
+        db_presets = config.get('db_presets', [])
+        for p in db_presets:
+            if p.get('name') == preset_name:
+                return p
+        raise RuntimeError(f"Preset '{preset_name}' missing, go add it")
+
+    # Input validation—because people are idiots and will screw this up
+    direct_creds = [private_key_path, private_key_password, account, user, warehouse, database, schema]
+    has_direct = any(d is not None for d in direct_creds)
+    if preset and has_direct:
+        raise ValueError("Don't mix preset with direct params, pick one")
+    if not preset and not has_direct_creds:  # Wait, better: require at least the core ones
+        if not private_key_path or not account or not user:
+            raise ValueError("Need private_key_path, account, and user if no preset")
+    if not preset and not preset:
+        raise ValueError("Provide preset or direct creds")
+
+    # Load creds from preset
+    if preset:
+        config = get_config()
+        creds = get_db_preset(config, preset)
+        if creds.get('db_type') != 'snowflake':
+            raise ValueError(f"Preset '{preset}' isn't for Snowflake")
+        private_key_path = creds.get('private_key_path')
+        private_key_password = creds.get('private_key_password')
+        account = creds.get('account')
+        user = creds.get('user')
+        warehouse = creds.get('warehouse')
+        database = creds.get('database')
+        schema = creds.get('schema')
+        if not private_key_path or not account or not user:
+            raise ValueError(f"Missing key creds in preset '{preset}'")
+
+    # Load the damn private key
+    if not os.path.exists(private_key_path):
+        raise FileNotFoundError(f"Private key missing at {private_key_path}")
+    with open(private_key_path, "rb") as key_file:
+        pkey_data = key_file.read()
+        private_key = serialization.load_pem_private_key(
+            pkey_data,
+            password=private_key_password.encode() if private_key_password else None,
+            backend=default_backend()
+        )
+
+    # Connect and query—keep it tight, no bloat
+    try:
+        conn = {
+            'account': account,
+            'user': user,
+            'private_key': private_key,
+        }
+        if warehouse:
+            conn['warehouse'] = warehouse
+        if database:
+            conn['database'] = database
+        if schema:
+            conn['schema'] = schema
+        conn = snowflake.connector.connect(**conn)
+        cur = conn.cursor()
+        results = cur.execute(query).fetchall()
+        columns = [desc[0] for desc in cur.description]
+        cur.close()
+        conn.close()
+        return pd.DataFrame(results, columns=columns)
+    except Exception as e:
+        raise RuntimeError(f"Query bombed: {e}")
+
+
 def load_data_from_aws_athena_query(
     query: str,
     aws_region: Optional[str] = None,

{rgwfuncs-0.0.112 → rgwfuncs-0.0.115}/src/rgwfuncs/str_lib.py

@@ -101,17 +101,19 @@ def send_telegram_message(message: str, preset_name: Optional[str] = None, bot_t
     response.raise_for_status()
 
 
-def title(text: str, font: str = "slant", typing_speed: float = 0.005) -> None:
+def title(text: str, font: str = "slant", typing_speed: float = 0.005, animate: bool = True) -> None:
     """
-    Print text as ASCII art with a typewriter effect using the specified font (default: slant),
+    Print text as ASCII art with an optional typewriter effect using the specified font (default: slant),
     indented by 4 spaces. All output, including errors and separators, is printed with the
-    typewriter effect within this function.
+    typewriter effect if animate is True.
 
     Args:
         text (str): The text to convert to ASCII art.
         font (str, optional): The pyfiglet font to use. Defaults to "slant".
         typing_speed (float, optional): Delay between printing each character in seconds.
                                       Defaults to 0.005.
+        animate (bool, optional): If True, applies typewriter effect. If False, prints instantly.
+                                 Defaults to True.
 
     Raises:
         ValueError: If the specified font is invalid or unavailable.
@@ -129,20 +131,26 @@ def title(text: str, font: str = "slant", typing_speed: float = 0.005) -> None:
         # Indent each line by 4 spaces
         indented_ascii_art = '\n'.join('    ' + line for line in ascii_art.splitlines())
 
-        # Print ASCII art with typewriter effect
+        # Print ASCII art with or without typewriter effect
         print(heading_color, end='')
-        for char in indented_ascii_art + '\n':
-            print(char, end='', flush=True)
-            if char != '\n':  # Don't delay on newlines
-                time.sleep(typing_speed)
+        if animate:
+            for char in indented_ascii_art + '\n':
+                print(char, end='', flush=True)
+                if char != '\n':  # Don't delay on newlines
+                    time.sleep(typing_speed)
+        else:
+            print(indented_ascii_art + '\n', end='', flush=True)
         print(reset_color, end='')
 
-        # Print separator line with typewriter effect
+        # Print separator line with or without typewriter effect
         print(heading_color, end='')
-        for char in '=' * 79 + '\n':
-            print(char, end='', flush=True)
-            if char != '\n':
-                time.sleep(typing_speed)
+        if animate:
+            for char in '=' * 79 + '\n':
+                print(char, end='', flush=True)
+                if char != '\n':
+                    time.sleep(typing_speed)
+        else:
+            print('=' * 79 + '\n', end='', flush=True)
         print(reset_color, end='')
 
     except Exception as e:
@@ -150,19 +158,26 @@ def title(text: str, font: str = "slant", typing_speed: float = 0.005) -> None:
         if "font" in str(e).lower():
             error_msg = f"Invalid or unavailable font: {font}. Ensure the font is supported by pyfiglet.\n"
             print(reset_color, end='')
+            if animate:
+                for char in error_msg:
+                    print(char, end='', flush=True)
+                    if char != '\n':
+                        time.sleep(typing_speed)
+            else:
+                print(error_msg, end='', flush=True)
+            raise ValueError(error_msg)
+        error_msg = f"Error generating ASCII art for \"{text}\" with font {font}: {e}\n"
+        print(reset_color, end='')
+        if animate:
             for char in error_msg:
                 print(char, end='', flush=True)
                 if char != '\n':
                     time.sleep(typing_speed)
-            raise ValueError(error_msg)
-        error_msg = f"Error generating ASCII art for \"{text}\" with font {font}: {e}\n"
-        print(reset_color, end='')
-        for char in error_msg:
-            print(char, end='', flush=True)
-            if char != '\n':
-                time.sleep(typing_speed)
+        else:
+            print(error_msg, end='', flush=True)
         raise RuntimeError(error_msg)
 
+
 def heading(text: str, typing_speed: float = 0.002) -> None:
     """
     Print a heading with the specified text in uppercase,

{rgwfuncs-0.0.112 → rgwfuncs-0.0.115/src/rgwfuncs.egg-info}/PKG-INFO

@@ -1,9 +1,7 @@
 Metadata-Version: 2.4
 Name: rgwfuncs
-Version: 0.0.112
+Version: 0.0.115
 Summary: A functional programming paradigm for mathematical modelling and data science
-Home-page: https://github.com/ryangerardwilson/rgwfuncs
-Author: Ryan Gerard Wilson
 Author-email: Ryan Gerard Wilson <ryangerardwilson@gmail.com>
 Project-URL: Homepage, https://github.com/ryangerardwilson/rgwfuncs
 Project-URL: Issues, https://github.com/ryangerardwilson/rgwfuncs
@@ -25,6 +23,7 @@ Requires-Dist: slack-sdk
 Requires-Dist: google-api-python-client
 Requires-Dist: boto3
 Requires-Dist: pyfiglet
+Requires-Dist: snowflake-connector-python
 Dynamic: license-file
 
 # RGWFUNCS

{rgwfuncs-0.0.112 → rgwfuncs-0.0.115}/src/rgwfuncs.egg-info/SOURCES.txt

@@ -1,7 +1,6 @@
 LICENSE
 README.md
 pyproject.toml
-setup.cfg
 src/rgwfuncs/__init__.py
 src/rgwfuncs/df_lib.py
 src/rgwfuncs/docs_lib.py
@@ -10,6 +9,5 @@ src/rgwfuncs/str_lib.py
 src/rgwfuncs.egg-info/PKG-INFO
 src/rgwfuncs.egg-info/SOURCES.txt
 src/rgwfuncs.egg-info/dependency_links.txt
-src/rgwfuncs.egg-info/entry_points.txt
 src/rgwfuncs.egg-info/requires.txt
 src/rgwfuncs.egg-info/top_level.txt

{rgwfuncs-0.0.112 → rgwfuncs-0.0.115}/src/rgwfuncs.egg-info/requires.txt

@@ -10,3 +10,4 @@ slack-sdk
 google-api-python-client
 boto3
 pyfiglet
+snowflake-connector-python

rgwfuncs-0.0.112/setup.cfg

@@ -1,44 +0,0 @@
-[metadata]
-name = rgwfuncs
-version = 0.0.112
-author = Ryan Gerard Wilson
-author_email = ryangerardwilson@gmail.com
-description = A functional programming paradigm for mathematical modelling and data science
-long_description = file: README.md
-long_description_content_type = text/markdown
-url = https://github.com/ryangerardwilson/rgwfuncs
-classifiers = 
-	Programming Language :: Python :: 3
-	License :: OSI Approved :: MIT License
-	Operating System :: OS Independent
-
-[options]
-packages = find:
-package_dir = 
-	= src
-python_requires = >=3.10
-install_requires = 
-	pandas
-	pymssql
-	mysql-connector-python
-	clickhouse-connect
-	google-cloud-bigquery
-	google-auth
-	xgboost
-	requests
-	slack-sdk
-	google-api-python-client
-	boto3
-	pyfiglet
-
-[options.packages.find]
-where = src
-
-[options.entry_points]
-console_scripts = 
-	rgwfuncs = rgwfuncs:main
-
-[egg_info]
-tag_build = 
-tag_date = 0
-

rgwfuncs-0.0.112/src/rgwfuncs.egg-info/entry_points.txt

@@ -1,2 +0,0 @@
-[console_scripts]
-rgwfuncs = rgwfuncs:main