pidatametrics1 0.3.4__tar.gz → 0.3.5__tar.gz

{pidatametrics1-0.3.4 → pidatametrics1-0.3.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pidatametrics1
-Version: 0.3.4
+Version: 0.3.5
 Summary: A wrapper for Pi Datametrics API with CSV and BigQuery support.
 Requires-Dist: google-auth
 Requires-Dist: google-cloud-bigquery

{pidatametrics1-0.3.4 → pidatametrics1-0.3.5}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "pidatametrics1"
-version = "0.3.4"
+version = "0.3.5"
 description = "A wrapper for Pi Datametrics API with CSV and BigQuery support."
 dependencies = [
     "requests",

{pidatametrics1-0.3.4 → pidatametrics1-0.3.5}/src/pidatametrics/manager.py

@@ -5,6 +5,25 @@ import datetime
 from dateutil.relativedelta import relativedelta
 
 class PiReportManager(PiDataMetrics):
+    
+    # --- HELPER: Generate Unique Tab Name ---
+    def _generate_tab_name(self, base_name, workspace_ref=None):
+        """
+        Creates a tab name like: Volume_12345_0502_1430
+        (Base_WorkspaceID_Date_Time)
+        """
+        now = datetime.datetime.now()
+        timestamp = now.strftime("%d%m_%H%M") # e.g., 0502_1430 (5th Feb, 14:30)
+        
+        ws_part = f"_{workspace_ref}" if workspace_ref else ""
+        
+        # Google Sheets tab limit is 31 chars. 
+        # Timestamp (9) + Base (approx 10) leaves ~10 for ID.
+        full_name = f"{base_name}{ws_part}_{timestamp}"
+        
+        # Truncate to 31 chars to avoid API errors
+        return full_name[:31]
+
     def _resolve_workspaces(self, ids_str=None, name_pattern=None):
         all_ws = self.get_workspaces()
         targets = {}
@@ -43,8 +62,7 @@ class PiReportManager(PiDataMetrics):
                 current_date -= relativedelta(months=1)
         return dates
 
-    # --- HELPER METHOD FOR EXPORTING ---
-    def _export_data(self, data, output_mode, filename, bq_config, spreadsheet_name, tab_name="Sheet1"):
+    def _export_data(self, data, output_mode, filename, bq_config, spreadsheet_name, tab_name):
         if not data:
             print("No data to export.")
             return
@@ -54,9 +72,9 @@ class PiReportManager(PiDataMetrics):
         elif output_mode == 'excel':
             PiExporter.to_excel(data, filename)
         elif output_mode == 'gsheet' and spreadsheet_name:
+            # tab_name is already generated with ID and Timestamp before calling this
             PiExporter.to_google_sheet(data, spreadsheet_name, tab_name)
         else:
-            # Default to CSV
             PiExporter.to_csv(data, filename)
 
     def run_volume_report(self, filename, workspace_ids=None, workspace_name=None, output_mode='csv', bq_config=None, spreadsheet_name=None):
@@ -71,7 +89,11 @@ class PiReportManager(PiDataMetrics):
                 rows = PiParsers.parse_volume_data(vol_data, stg['name'], terms, ws_name)
                 all_rows.extend(rows)
         
-        self._export_data(all_rows, output_mode, filename, bq_config, spreadsheet_name, tab_name="Volume")
+        # Get the first Workspace ID found to use in the tab name
+        ws_ref = list(targets.keys())[0] if targets else "Multi"
+        unique_tab = self._generate_tab_name("Vol", ws_ref)
+
+        self._export_data(all_rows, output_mode, filename, bq_config, spreadsheet_name, tab_name=unique_tab)
 
     def run_serp_report(self, data_sources, output_mode='csv', bq_config=None, filename=None, manual_duplication=None, spreadsheet_name=None):
         yesterday = (datetime.datetime.now() - datetime.timedelta(days=1)).strftime("%Y-%m-%d")
@@ -83,7 +105,11 @@ class PiReportManager(PiDataMetrics):
             rows = PiParsers.parse_serp_response(raw_data, market, w_name, se_name, yesterday, cat_map, manual_duplication)
             all_rows.extend(rows)
         
-        self._export_data(all_rows, output_mode, filename or "serp_output", bq_config, spreadsheet_name, tab_name="SERP")
+        # Use the Workspace ID from the first data source
+        ws_ref = data_sources[0][1] if data_sources else "All"
+        unique_tab = self._generate_tab_name("SERP", ws_ref)
+
+        self._export_data(all_rows, output_mode, filename or "serp_output", bq_config, spreadsheet_name, tab_name=unique_tab)
 
     def run_historical_serp_report(self, data_sources, duration, frequency, start_date=None, features=None, num_results=25, output_mode='csv', bq_config=None, filename="historical_data", spreadsheet_name=None):
         if features is None:
@@ -96,12 +122,11 @@ class PiReportManager(PiDataMetrics):
         
         print(f"Starting Historical Report ({frequency}) for last {duration} periods...")
         
-        all_file_rows = [] # Used for CSV, Excel, and GSheet
+        all_file_rows = [] 
 
         for i, date in enumerate(target_dates):
             print(f"[{i+1}/{len(target_dates)}] Processing Date: {date}...")
-            
-            daily_rows = [] # Reset container for this specific date
+            daily_rows = [] 
 
             for source in data_sources:
                 market, w_id, w_name, se_id, se_name = source
@@ -111,31 +136,24 @@ class PiReportManager(PiDataMetrics):
                         'serp-feature[]': features
                     }
                     raw_data = self.get_bulk_serp_data(w_id, se_id, date, **params)
-                    
-                    rows = PiParsers.parse_serp_response(
-                        raw_data, market, w_name, se_name, date, category_map=None
-                    )
-                    
+                    rows = PiParsers.parse_serp_response(raw_data, market, w_name, se_name, date, category_map=None)
                     daily_rows.extend(rows)
-
                 except Exception as e:
                     print(f"Failed to fetch {w_name} on {date}: {e}")
 
-            # --- UPLOAD LOGIC: PER DATE (BigQuery Only) ---
             if output_mode == 'bigquery' and bq_config:
                 if daily_rows:
                     print(f"Uploading {len(daily_rows)} rows for {date} to BigQuery...")
                     PiExporter.to_bigquery(daily_rows, bq_config['project'], bq_config['dataset'], bq_config['table'])
-                else:
-                    print(f"No data found for {date}, skipping upload.")
-            
-            # --- FILE LOGIC: ACCUMULATE (CSV, Excel, GSheet) ---
             elif output_mode in ['csv', 'excel', 'gsheet']:
                 all_file_rows.extend(daily_rows)
 
-        # Final Save for File-based outputs
         if output_mode in ['csv', 'excel', 'gsheet']:
-            self._export_data(all_file_rows, output_mode, filename, bq_config, spreadsheet_name, tab_name="Historical")
+            # Use the Workspace ID from the first data source
+            ws_ref = data_sources[0][1] if data_sources else "All"
+            unique_tab = self._generate_tab_name("Hist", ws_ref)
+            
+            self._export_data(all_file_rows, output_mode, filename, bq_config, spreadsheet_name, tab_name=unique_tab)
 
     def run_llm_report(self, data_sources, start_period, end_period, stg_ids=None, output_mode='csv', bq_config=None, filename="llm_output", spreadsheet_name=None):
         all_rows = []
@@ -146,11 +164,14 @@ class PiReportManager(PiDataMetrics):
             try:
                 print(f"Fetching LLM data for {w_name} ({se_name})...")
                 raw_data = self.get_llm_mentions(w_id, se_id, start_period, end_period, stg_ids)
-                
                 rows = PiParsers.parse_llm_response(raw_data, market, w_name, se_name)
                 all_rows.extend(rows)
                 print(f"Found {len(rows)} mentions/queries.")
             except Exception as e:
                 print(f"Failed to fetch LLM data for {w_name}: {e}")
 
-        self._export_data(all_rows, output_mode, filename, bq_config, spreadsheet_name, tab_name="LLM_Mentions")
+        # Use the Workspace ID from the first data source
+        ws_ref = data_sources[0][1] if data_sources else "All"
+        unique_tab = self._generate_tab_name("LLM", ws_ref)
+
+        self._export_data(all_rows, output_mode, filename, bq_config, spreadsheet_name, tab_name=unique_tab)