brynq-sdk-monday 1.1.5__tar.gz → 1.2.1__tar.gz

{brynq_sdk_monday-1.1.5 → brynq_sdk_monday-1.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 1.0
 Name: brynq_sdk_monday
-Version: 1.1.5
+Version: 1.2.1
 Summary: Monday.com wrapper from BrynQ
 Home-page: UNKNOWN
 Author: BrynQ

{brynq_sdk_monday-1.1.5 → brynq_sdk_monday-1.2.1}/brynq_sdk_monday/extract_monday.py

@@ -32,7 +32,7 @@ class ExtractMonday(BrynQ):
 
         return headers
 
-    def get_activity_logs(self, board_id: int, start_date: str, end_date: str, column_ids: str = '', limit: int = 25):
+    def get_activity_logs_boards(self, board_id: int, start_date: str, end_date: str, column_ids: str = '', limit: int = 25):
         """
         See for the docs: https://developer.monday.com/api-reference/docs/activity-logs
         :param board_id: the ID of the board you want to get the activity logs from
@@ -63,6 +63,85 @@ class ExtractMonday(BrynQ):
                 continue_loop = False
         return df
 
+    
+    def get_activity_logs_items(
+        self,
+        board_id: int,
+        item_ids: list,
+        start_date: str,
+        end_date: str = None,
+        limit: int = 500,
+    ):
+        """
+        Retrieve activity‑log history for one or more items on a monday.com board.
+
+        Parameters
+        ----------
+        board_id : int
+            ID of the board that owns the items.
+        item_ids : list
+            List of item IDs (max 50 per request, per monday API limits).
+        start_date : str
+            Lower‑bound timestamp in ISO‑8601 format (``YYYY‑MM‑DDThh:mm:ssZ``).
+        end_date : str, optional
+            Upper‑bound timestamp in ISO‑8601 format. ``None`` means "up to now".
+        limit : int, optional
+            Maximum log rows per page (default 500, monday hard‑caps at 500).
+
+        Returns
+        -------
+        pandas.DataFrame
+            DataFrame containing the activity‑log rows.
+        """
+        continue_loop = True
+        page = 0
+        df = pd.DataFrame()
+
+        # Pre‑format the item‑ID literal once
+        ids_literal = ",".join(str(i) for i in item_ids)
+
+        while continue_loop:
+            page += 1
+            to_clause = f'to: "{end_date}", ' if end_date else ''
+            query = (
+                f'query {{ boards (ids: {board_id}) {{ '
+                f'activity_logs (item_ids: [{ids_literal}], '
+                f'from: "{start_date}", '
+                + to_clause +
+                f'limit: {limit}, page: {page}) '
+                f'{{ id event entity data user_id created_at }} }} }}'
+            )
+            payload = json.dumps({"query": query})
+
+            if self.debug:
+                print(payload)
+
+            response = requests.request("POST", self.endpoint, headers=self.headers, data=payload)
+
+            if self.debug:
+                print(response.json())
+
+            response.raise_for_status()
+
+            logs = response.json()["data"]["boards"][0]["activity_logs"]
+
+            # Append to dataframe if we received rows
+            if logs:
+                df = pd.concat([df, pd.json_normalize(logs)], axis=0)
+
+            # Stop looping once the page returns fewer rows than the page size
+            if len(logs) < limit:
+                continue_loop = False
+
+        # -- flatten the JSON held in the "data" column into real columns
+        if not df.empty and "data" in df.columns:
+            # convert JSON‑encoded strings into dicts
+            data_dicts = df["data"].apply(lambda x: json.loads(x) if isinstance(x, str) and x.startswith("{") else {})
+            df_expanded = pd.json_normalize(data_dicts, sep="__")
+            df = pd.concat([df.drop(columns=["data"]).reset_index(drop=True), df_expanded.reset_index(drop=True)], axis=1)
+        
+        return df
+
     def get_users(self, limit: int = 50, fields: str = 'id name created_at email is_admin is_guest is_view_only is_pending enabled join_date title last_activity account {id}'):
         continue_loop = True
         page = 0
@@ -248,4 +327,3 @@ class ExtractMonday(BrynQ):
                     continue_loop = False
 
         return df
-

{brynq_sdk_monday-1.1.5 → brynq_sdk_monday-1.2.1}/brynq_sdk_monday.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 1.0
 Name: brynq-sdk-monday
-Version: 1.1.5
+Version: 1.2.1
 Summary: Monday.com wrapper from BrynQ
 Home-page: UNKNOWN
 Author: BrynQ

{brynq_sdk_monday-1.1.5 → brynq_sdk_monday-1.2.1}/setup.py

@@ -2,7 +2,7 @@ from setuptools import setup, find_namespace_packages
 
 setup(
     name='brynq_sdk_monday',
-    version='1.1.5',
+    version='1.2.1',
     description='Monday.com wrapper from BrynQ',
     long_description='Monday.com wrapper from BrynQ',
     author='BrynQ',