notionhelper 0.4.4__py3-none-any.whl → 0.4.5__py3-none-any.whl

notionhelper/helper.py

@@ -67,6 +67,9 @@ class NotionHelper:
 
     update_data_source(data_source_id, properties=None, title=None, icon=None, in_trash=None, parent=None):
         Updates the attributes of a specified data source.
+
+    move_page_to_trash(page_id):
+        Moves a Notion page to trash by setting in_trash to True.
     """
 
     def __init__(self, notion_token: str):
@@ -397,10 +400,92 @@ class NotionHelper:
         return self._make_request("POST", url, payload)
 
     def append_page_body(self, page_id: str, blocks: List[Dict[str, Any]]) -> Dict[str, Any]:
-        """Appends blocks of text to the body of a Notion page."""
+        """Appends blocks of text to the body of a Notion page.
+        
+        Args:
+            page_id: The ID of the Notion page (with or without dashes)
+            blocks: List of block objects to append. Each block must have a "type" 
+                   and a corresponding nested object. See examples below.
+        
+        Returns:
+            Dict containing the API response
+            
+        Raises:
+            ValueError: If blocks is not a list or is empty
+            requests.exceptions.HTTPError: If the request fails
+            
+        Examples:
+            # Append a paragraph
+            blocks = [{
+                "object": "block",
+                "type": "paragraph",
+                "paragraph": {
+                    "rich_text": [{
+                        "type": "text",
+                        "text": {"content": "Hello, world!"}
+                    }]
+                }
+            }]
+            
+            # Append a heading
+            blocks = [{
+                "object": "block",
+                "type": "heading_2",
+                "heading_2": {
+                    "rich_text": [{
+                        "type": "text",
+                        "text": {"content": "My Heading"}
+                    }]
+                }
+            }]
+        """
+        # Validate input
+        if not isinstance(blocks, list):
+            raise ValueError(f"blocks must be a list, got {type(blocks).__name__}")
+        
+        if len(blocks) == 0:
+            raise ValueError("blocks list cannot be empty")
+        
+        # Validate each block has required structure
+        for i, block in enumerate(blocks):
+            if not isinstance(block, dict):
+                raise ValueError(f"Block at index {i} must be a dict, got {type(block).__name__}")
+            
+            if "type" not in block:
+                raise ValueError(f"Block at index {i} missing required 'type' field. Block: {block}")
+            
+            block_type = block["type"]
+            if block_type not in block:
+                raise ValueError(
+                    f"Block at index {i} of type '{block_type}' must have a '{block_type}' property. "
+                    f"Example: {{'type': '{block_type}', '{block_type}': {{'rich_text': [...]}}}}"
+                )
+        
         payload = {"children": blocks}
         url = f"https://api.notion.com/v1/blocks/{page_id}/children"
-        return self._make_request("PATCH", url, payload)
+        
+        try:
+            return self._make_request("PATCH", url, payload)
+        except requests.exceptions.HTTPError as e:
+            if e.response.status_code == 400:
+                print(f"\n❌ Bad Request (400) - The block structure is invalid.")
+                print(f"First block in your request: {json.dumps(blocks[0], indent=2)}")
+                print(f"\nExpected structure example:")
+                print(json.dumps({
+                    "object": "block",
+                    "type": "paragraph",
+                    "paragraph": {
+                        "rich_text": [{
+                            "type": "text",
+                            "text": {"content": "Your text here"}
+                        }]
+                    }
+                }, indent=2))
+            elif e.response.status_code == 404:
+                print(f"\n❌ Page not found (404). Make sure:")
+                print(f"   1. The page ID is correct: {page_id}")
+                print(f"   2. The page (or parent database) is shared with your integration")
+            raise
 
     def get_data_source_page_ids(self, data_source_id: str) -> List[str]:
         """Returns the IDs of all pages in a given data source.
@@ -768,3 +853,27 @@ class NotionHelper:
         }
         response = requests.patch(update_url, headers=headers, json=data)
         return response.json()
+
+    def move_page_to_trash(self, page_id: str) -> Dict[str, Any]:
+        """Moves a Notion page to trash by setting in_trash to True.
+
+        Parameters
+        ----------
+        page_id : str
+            The unique identifier of the Notion page to move to trash.
+
+        Returns
+        -------
+        dict
+            A dictionary representing the updated page object with in_trash set to True.
+
+        Examples
+        --------
+        >>> helper = NotionHelper(token="your_token")
+        >>> result = helper.move_page_to_trash("page_id_here")
+        >>> print(result['in_trash'])
+        True
+        """
+        payload = {"in_trash": True}
+        url = f"https://api.notion.com/v1/pages/{page_id}"
+        return self._make_request("PATCH", url, payload)

{notionhelper-0.4.4.dist-info → notionhelper-0.4.5.dist-info}/METADATA

@@ -1,11 +1,10 @@
 Metadata-Version: 2.4
 Name: notionhelper
-Version: 0.4.4
+Version: 0.4.5
 Summary: NotionHelper is a Python library that simplifies interactions with the Notion API, enabling easy management of databases, pages, and files within Notion workspaces.
 Author-email: Jan du Plessis <drjanduplessis@icloud.com>
 Requires-Python: >=3.10
 Requires-Dist: mimetype>=0.1.5
-Requires-Dist: notebook>=7.4.5
 Requires-Dist: notion-client>=2.4.0
 Requires-Dist: pandas>=2.3.1
 Requires-Dist: requests>=2.32.4
@@ -27,7 +26,7 @@ Description-Content-Type: text/markdown
 
 # NotionHelper
 
-![NotionHelper](https://github.com/janduplessis883/notionhelper/blob/master/images/notionh3.png?raw=true)
+![NotionHelper](images/notionh4.png?raw=true)
 
 `NotionHelper` is a Python library that provides a convenient interface for interacting with the Notion API, specifically designed to leverage the **Notion API Version 2025-09-03**. It simplifies common tasks such as managing databases, data sources, pages, and file uploads, allowing you to integrate Notion's powerful features into your applications with ease.
 

notionhelper-0.4.5.dist-info/RECORD

@@ -0,0 +1,6 @@
+notionhelper/__init__.py,sha256=lidq1uQioToT1ePIu02XktGYTPMp_uY5Btw63GlNqOo,117
+notionhelper/helper.py,sha256=yQfjjRke-MzDTGkXhlyBV6-9EZe1DcLlI02b946iDYE,37201
+notionhelper/ml_logger.py,sha256=d8KwboWwskn2Xa9cYWvqPKqcoNYywHb_MCoKgx5WCpw,8652
+notionhelper-0.4.5.dist-info/METADATA,sha256=B0H7DBdgkx7LafBiMosqolu_FDdhefgQbwJhJzw4o3w,21136
+notionhelper-0.4.5.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+notionhelper-0.4.5.dist-info/RECORD,,

notionhelper-0.4.4.dist-info/RECORD

@@ -1,6 +0,0 @@
-notionhelper/__init__.py,sha256=lidq1uQioToT1ePIu02XktGYTPMp_uY5Btw63GlNqOo,117
-notionhelper/helper.py,sha256=6-iJU2y9YlGinadvnRWFeq0rvh5fbYYHsYDkS4bkhHk,33075
-notionhelper/ml_logger.py,sha256=d8KwboWwskn2Xa9cYWvqPKqcoNYywHb_MCoKgx5WCpw,8652
-notionhelper-0.4.4.dist-info/METADATA,sha256=fb1VhtTRAPK7yTQsE2mcv8ZAVcKXstzzMp8Jqi_xC_8,21227
-notionhelper-0.4.4.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-notionhelper-0.4.4.dist-info/RECORD,,