Add support for blocks (lolipopshock#31)

* making progress on adding blocks

* more progress on blocks

* Add parse_blocks

* add download_page_children

* Better README

Author: lolipopshock

README.md

@@ -1,6 +1,6 @@
 # `notion-df`: Seamlessly Connecting Notion Database with Pandas DataFrame
 
-*Please Note: This project is currently in pre-alpha stage. The code are not appropriately documented and tested. Please report any issues you find.*
+*Please Note: This project is currently in pre-alpha stage. The code are not appropriately documented and tested. Please report any issues you find. Thanks!*
 
 ## Installation
 
@@ -83,6 +83,32 @@ pip install notion-df
     # Similarly in pandas APIs: df.to_notion(notion_page_url, title="page-title")
     ```
 
+## Development 
+
+1. Clone the repo and install the dependencies:
+    ```bash
+    git clone git@github.com:lolipopshock/notion-df.git
+    cd notion-df
+    pip install -e .[dev]
+    ```
+2. How to run tests?
+    ```bash
+    NOTION_API_KEY="<the-api-key>" pytest tests/
+    ```
+    The tests are dependent on a list of notebooks, specified by the following environment variables:
+    
+| Environment Variable        | Description                             |
+| --------------------------- | --------------------------------------- |
+| `NOTION_API_KEY`            | The API key for your Notion integration |
+| `NOTION_ROLLUP_DF`          | -                                       |
+| `NOTION_FILES_DF`           | -                                       |
+| `NOTION_FORMULA_DF`         | -                                       |
+| `NOTION_RELATION_DF`        | -                                       |
+| `NOTION_RELATION_TARGET_DF` | -                                       |
+| `NOTION_LONG_STRING_DF`     | -                                       |
+| `NOTION_RICH_TEXT_DF`       | -                                       |
+    
+
 ## TODOs
 
 - [ ] Add tests for

src/notion_df/agent.py

@@ -12,6 +12,7 @@
 from notion_df.values import PageProperties, PageProperty
 from notion_df.configs import DatabaseSchema, NON_EDITABLE_TYPES
 from notion_df.utils import is_uuid
+from notion_df.blocks import parse_blocks
 
 API_KEY = None
 NOT_REVERSE_DATAFRAME = -1
@@ -437,3 +438,25 @@ def upload(
     if return_response:
         return notion_url, response
     return notion_url
+
+@use_client
+def download_page_children(
+    notion_url: str,
+    api_key: str = None,
+    client: Client = None,   
+):
+    """Download the children of a Notion page.
+
+    Args:
+        notion_url (str):
+            The url of the Notion page.
+        api_key (str, optional):
+            The API key of the Notion integration.
+            Defaults to None.
+        client (Client, optional):
+            The notion client.
+            Defaults to None.
+    """
+    page_id = get_id(notion_url)
+    r = client.blocks.children.list(block_id=page_id)
+    return parse_blocks(r['results'], recursive=True, client=client)

src/notion_df/base.py

@@ -216,7 +216,7 @@ def value(self):
 
 
 class FileObject(BaseModel):
-    name: str
+    name: Optional[str] #TODO: Figure out why this is not required...
     type: str
     file: Optional[FileTargetObject]
     external: Optional[FileTargetObject]
@@ -297,7 +297,7 @@ class BaseRichTextObject(BaseModel):
     href: Optional[str] = None
     annotations: Optional[AnnotationObject] = None
     type: Optional[RichTextTypeEnum]
-    
+
     @property
     def value(self):
         return self.plain_text
@@ -318,4 +318,9 @@ def encode_string(cls, value: str) -> List["RichTextObject"]:
         return [
             cls(text=TextObject(content=value[idx : idx + chunk_size]))
             for idx in range(0, len(value), chunk_size)
-        ]
+        ]
+
+
+class EmojiObject(BaseModel):
+    type: str = "emoji"
+    emoji: str