ADD : add retrieve block children features

CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## 1.1.0 (2023-5-30)
+
+### Features
+
+* Add retrieve block children
+  * https://github.com/minwook-shin/notion-database/issues/16
+
 ## 1.0.0 (2023-5-28)
 
 we've implemented all features, change the version rule to the semantic version.

README.md

@@ -86,6 +86,9 @@ python setup.py install
   * ✅ Retrieve a database
   * ✅ Update a database
   * ✅ Update database properties
+* Blocks
+  * ✅ Retrieve a block
+  * ✅ Retrieve block children
 
 ## Contributing
 

notion_database/block.py

@@ -0,0 +1,43 @@
+"""
+Notion API Block
+"""
+from typing import Dict, List
+
+from notion_database.components.request import Request
+
+
+class Block:  # pylint: disable=too-few-public-methods
+    """
+    Notion API Block class
+    """
+
+    def __init__(self, integrations_token: str):
+        """
+        init
+
+        :param integrations_token: Notion Internal Integration Token
+        """
+        self.properties_list: List[Dict] = []
+        self.url: str = 'https://api.notion.com/v1/blocks'
+        self.result: Dict = {}
+        self.request: Request = Request(self.url, integrations_token=integrations_token)
+
+    def retrieve_block(self, block_id: str, is_children: bool = False,
+                       page_size: int = 100, start_cursor: str = None):
+        """
+        Retrieve a block
+
+        :param block_id: Identifier for a Notion blocks
+        :param is_children: Trigger's paginated array of child block objects
+        :param start_cursor: optional parameter for is_children=True
+        :param page_size: optional parameter for is_children=True
+        :return:
+        """
+        if is_children:
+            param = f"children?page_size={page_size}&start_cursor={start_cursor}"
+            if start_cursor is None:
+                param = param.split("&")[0]
+            self.result = self.request.call_api_get(self.url + "/" + block_id
+                                                    + "/" + param)
+        else:
+            self.result = self.request.call_api_get(self.url + "/" + block_id)

page_content_example.py

@@ -0,0 +1,37 @@
+import os
+import pprint
+
+from block import Block
+from notion_database.const.query import Direction, Timestamp
+from notion_database.database import Database
+from notion_database.search import Search
+
+try:
+    from dotenv import load_dotenv
+
+    load_dotenv()
+except ModuleNotFoundError:
+    pass
+
+NOTION_KEY = os.getenv('NOTION_KEY')
+
+S = Search(integrations_token=NOTION_KEY)
+S.search_database(query="", sort={"direction": Direction.ascending, "timestamp": Timestamp.last_edited_time})
+
+for i in S.result:
+    database_id = i["id"]
+    D = Database(integrations_token=NOTION_KEY)
+    D.retrieve_database(database_id=database_id)
+    D.find_all_page(database_id=database_id, page_size=1)
+    pprint.pprint(D.result)
+
+    B = Block(integrations_token=NOTION_KEY)
+    for j in D.result["results"]:
+        B.retrieve_block(block_id=j["id"])
+        pprint.pprint(B.result)
+        # B.retrieve_block(block_id=j["id"], is_children=True)
+        # pprint.pprint(B.result)
+        B.retrieve_block(block_id=j["id"], is_children=True, page_size=1)
+        pprint.pprint(B.result)
+        # B.retrieve_block(block_id=j["id"],is_children=True, page_size=1, start_cursor=B.result["next_cursor"])
+        # pprint.pprint(B.result)

setup.py

@@ -5,7 +5,7 @@
 
 setuptools.setup(
     name="notion-database",
-    version="1.0.0",
+    version="1.1.0",
     author="minwook-shin",
     author_email="minwook0106@gmail.com",
     description=" Python bindings for Notion Database API",