notionary 0.1.25__py3-none-any.whl → 0.1.27__py3-none-any.whl

notionary/elements/video_element.py

@@ -1,7 +1,10 @@
 import re
 from typing import Dict, Any, Optional, List
 from notionary.elements.notion_block_element import NotionBlockElement
-from notionary.elements.prompts.element_prompt_content import ElementPromptContent
+from notionary.elements.prompts.element_prompt_content import (
+    ElementPromptBuilder,
+    ElementPromptContent,
+)
 
 
 class VideoElement(NotionBlockElement):
@@ -30,19 +33,19 @@ class VideoElement(NotionBlockElement):
         re.compile(r"(?:https?://)?(?:www\.)?youtu\.be/([a-zA-Z0-9_-]{11})"),
     ]
 
-    @staticmethod
-    def match_markdown(text: str) -> bool:
+    @classmethod
+    def match_markdown(cls, text: str) -> bool:
         """Check if text is a markdown video embed."""
         text = text.strip()
         return text.startswith("@[") and bool(VideoElement.PATTERN.match(text))
 
-    @staticmethod
-    def match_notion(block: Dict[str, Any]) -> bool:
+    @classmethod
+    def match_notion(cls, block: Dict[str, Any]) -> bool:
         """Check if block is a Notion video."""
         return block.get("type") == "video"
 
-    @staticmethod
-    def is_youtube_url(url: str) -> bool:
+    @classmethod
+    def is_youtube_url(cls, url: str) -> bool:
         """Check if URL is a YouTube video and return video ID if it is."""
         for pattern in VideoElement.YOUTUBE_PATTERNS:
             match = pattern.match(url)
@@ -50,8 +53,8 @@ class VideoElement(NotionBlockElement):
                 return True
         return False
 
-    @staticmethod
-    def get_youtube_id(url: str) -> Optional[str]:
+    @classmethod
+    def get_youtube_id(cls, url: str) -> Optional[str]:
         """Extract YouTube video ID from URL."""
         for pattern in VideoElement.YOUTUBE_PATTERNS:
             match = pattern.match(url)
@@ -59,8 +62,8 @@ class VideoElement(NotionBlockElement):
                 return match.group(1)
         return None
 
-    @staticmethod
-    def markdown_to_notion(text: str) -> Optional[Dict[str, Any]]:
+    @classmethod
+    def markdown_to_notion(cls, text: str) -> Optional[Dict[str, Any]]:
         """Convert markdown video embed to Notion video block."""
         video_match = VideoElement.PATTERN.match(text.strip())
         if not video_match:
@@ -88,8 +91,8 @@ class VideoElement(NotionBlockElement):
 
         return video_block
 
-    @staticmethod
-    def notion_to_markdown(block: Dict[str, Any]) -> Optional[str]:
+    @classmethod
+    def notion_to_markdown(cls, block: Dict[str, Any]) -> Optional[str]:
         """Convert Notion video block to markdown video embed."""
         if block.get("type") != "video":
             return None
@@ -114,13 +117,13 @@ class VideoElement(NotionBlockElement):
 
         return f"@[{caption}]({url})"
 
-    @staticmethod
-    def is_multiline() -> bool:
+    @classmethod
+    def is_multiline(cls) -> bool:
         """Videos are single-line elements."""
         return False
 
-    @staticmethod
-    def _extract_text_content(rich_text: List[Dict[str, Any]]) -> str:
+    @classmethod
+    def _extract_text_content(cls, rich_text: List[Dict[str, Any]]) -> str:
         """Extract plain text content from Notion rich_text elements."""
         result = ""
         for text_obj in rich_text:
@@ -135,16 +138,22 @@ class VideoElement(NotionBlockElement):
         """
         Returns structured LLM prompt metadata for the video element.
         """
-        return {
-            "description": "Embeds video content from external sources like YouTube or direct video URLs.",
-            "when_to_use": (
+        return (
+            ElementPromptBuilder()
+            .with_description(
+                "Embeds video content from external sources like YouTube or direct video URLs."
+            )
+            .with_usage_guidelines(
                 "Use video embeds when you want to include multimedia content directly in your document. "
                 "Videos are useful for tutorials, demonstrations, presentations, or any content that benefits from visual explanation."
-            ),
-            "syntax": "@[Caption](https://example.com/video.mp4)",
-            "examples": [
-                "@[How to use this feature](https://www.youtube.com/watch?v=dQw4w9WgXcQ)",
-                "@[Product demo](https://example.com/videos/demo.mp4)",
-                "@[](https://youtu.be/dQw4w9WgXcQ)",
-            ],
-        }
+            )
+            .with_syntax("@[Caption](https://example.com/video.mp4)")
+            .with_examples(
+                [
+                    "@[How to use this feature](https://www.youtube.com/watch?v=dQw4w9WgXcQ)",
+                    "@[Product demo](https://example.com/videos/demo.mp4)",
+                    "@[](https://youtu.be/dQw4w9WgXcQ)",
+                ]
+            )
+            .build()
+        )

notionary/page/content/page_content_manager.py

@@ -1,3 +1,4 @@
+import json
 from typing import Any, Dict, List, Optional
 
 from notionary.elements.registry.block_element_registry import BlockElementRegistry
@@ -32,9 +33,7 @@ class PageContentManager(LoggingMixin):
         )
         self._chunker = NotionPageContentChunker()
 
-    async def append_markdown(
-        self, markdown_text: str, append_divider: bool = False
-    ) -> str:
+    async def append_markdown(self, markdown_text: str) -> str:
         """
         Append markdown text to a Notion page, automatically handling content length limits.
         First strips out triple backtick markdown fences if they wrap the entire content.
@@ -45,11 +44,6 @@ class PageContentManager(LoggingMixin):
         """
         try:
             blocks = self._markdown_to_notion_converter.convert(markdown_text)
-
-            if append_divider:
-                divider_block = {"type": "divider", "divider": {}}
-                blocks.append(divider_block)
-
             fixed_blocks = self._chunker.fix_blocks_content_length(blocks)
 
             result = await self._client.patch(
@@ -162,6 +156,7 @@ class PageContentManager(LoggingMixin):
             if parent_id is None
             else await self.get_block_children(parent_id)
         )
+
         if not blocks:
             return []