notionary 0.2.12__py3-none-any.whl → 0.2.14__py3-none-any.whl

notionary/{elements → blocks}/numbered_list_element.py

@@ -1,13 +1,10 @@
 import re
 from typing import Dict, Any, Optional
-from notionary.elements.notion_block_element import NotionBlockElement, auto_track_conversions
-from notionary.prompting.element_prompt_content import (
-    ElementPromptBuilder,
-    ElementPromptContent,
-)
-from notionary.elements.text_inline_formatter import TextInlineFormatter
+from notionary.blocks import NotionBlockElement
+from notionary.blocks import ElementPromptContent, ElementPromptBuilder
+from notionary.blocks.text_inline_formatter import TextInlineFormatter
+
 
-@auto_track_conversions
 class NumberedListElement(NotionBlockElement):
     """Class for converting between Markdown numbered lists and Notion numbered list items."""
 

notionary/{elements → blocks}/paragraph_element.py

@@ -1,13 +1,10 @@
 from typing import Dict, Any, Optional
 
-from notionary.elements.notion_block_element import NotionBlockElement, auto_track_conversions
-from notionary.prompting.element_prompt_content import (
-    ElementPromptBuilder,
-    ElementPromptContent,
-)
-from notionary.elements.text_inline_formatter import TextInlineFormatter
+from notionary.blocks import NotionBlockElement
+from notionary.blocks import ElementPromptContent, ElementPromptBuilder
+from notionary.blocks.text_inline_formatter import TextInlineFormatter
+
 
-@auto_track_conversions
 class ParagraphElement(NotionBlockElement):
     """Handles conversion between Markdown paragraphs and Notion paragraph blocks."""
 

notionary/{prompting/element_prompt_content.py → blocks/prompts/element_prompt_builder.py}

@@ -1,44 +1,5 @@
-from dataclasses import field, dataclass
 from typing import Optional, List, Self
-
-
-@dataclass
-class ElementPromptContent:
-    """
-    Dataclass defining the standardized structure for element prompt content.
-    This ensures consistent formatting across all Notion block elements.
-    """
-
-    description: str
-    """Concise explanation of what the element is and its purpose in Notion."""
-
-    syntax: str
-    """The exact markdown syntax pattern used to create this element."""
-
-    when_to_use: str
-    """Guidelines explaining the appropriate scenarios for using this element."""
-
-    examples: List[str] = field(default_factory=list)
-    """List of practical usage examples showing the element in context."""
-
-    avoid: Optional[str] = None
-    """Optional field listing scenarios when this element should be avoided."""
-
-    is_standard_markdown: bool = False
-    """Indicates whether this element follows standard Markdown syntax (and does not require full examples)."""
-
-    def __post_init__(self):
-        """Validates that the content meets minimum requirements."""
-        if not self.description:
-            raise ValueError("Description is required")
-        if not self.syntax:
-            raise ValueError("Syntax is required")
-        if not self.examples and not self.is_standard_markdown:
-            raise ValueError(
-                "At least one example is required unless it's standard markdown."
-            )
-        if not self.when_to_use:
-            raise ValueError("Usage guidelines are required")
+from notionary.blocks.prompts.element_prompt_content import ElementPromptContent
 
 
 class ElementPromptBuilder:

notionary/blocks/prompts/element_prompt_content.py

@@ -0,0 +1,41 @@
+from dataclasses import field, dataclass
+from typing import Optional, List
+
+
+@dataclass
+class ElementPromptContent:
+    """
+    Dataclass defining the standardized structure for element prompt content.
+    This ensures consistent formatting across all Notion block elements.
+    """
+
+    description: str
+    """Concise explanation of what the element is and its purpose in Notion."""
+
+    syntax: str
+    """The exact markdown syntax pattern used to create this element."""
+
+    when_to_use: str
+    """Guidelines explaining the appropriate scenarios for using this element."""
+
+    examples: List[str] = field(default_factory=list)
+    """List of practical usage examples showing the element in context."""
+
+    avoid: Optional[str] = None
+    """Optional field listing scenarios when this element should be avoided."""
+
+    is_standard_markdown: bool = False
+    """Indicates whether this element follows standard Markdown syntax (and does not require full examples)."""
+
+    def __post_init__(self):
+        """Validates that the content meets minimum requirements."""
+        if not self.description:
+            raise ValueError("Description is required")
+        if not self.syntax:
+            raise ValueError("Syntax is required")
+        if not self.examples and not self.is_standard_markdown:
+            raise ValueError(
+                "At least one example is required unless it's standard markdown."
+            )
+        if not self.when_to_use:
+            raise ValueError("Usage guidelines are required")

notionary/{elements → blocks}/qoute_element.py

@@ -1,12 +1,10 @@
 import re
 from typing import Dict, Any, Optional, List, Tuple
-from notionary.elements.notion_block_element import NotionBlockElement, auto_track_conversions
-from notionary.prompting.element_prompt_content import (
-    ElementPromptBuilder,
-    ElementPromptContent,
-)
 
-@auto_track_conversions
+from notionary.blocks import NotionBlockElement
+from notionary.blocks import ElementPromptContent, ElementPromptBuilder
+
+
 class QuoteElement(NotionBlockElement):
     """Class for converting between Markdown blockquotes and Notion quote blocks."""
 

notionary/{elements → blocks}/registry/block_registry.py

@@ -1,13 +1,13 @@
 from __future__ import annotations
 from typing import Dict, Any, Optional, List, Set, Type
 
-from notionary.elements.notion_block_element import NotionBlockElement
-from notionary.prompting.markdown_syntax_prompt_generator import (
+from notionary.blocks.notion_block_element import NotionBlockElement
+from notionary.page.markdown_syntax_prompt_generator import (
     MarkdownSyntaxPromptGenerator,
 )
-from notionary.elements.text_inline_formatter import TextInlineFormatter
+from notionary.blocks.text_inline_formatter import TextInlineFormatter
 
-from notionary.elements.notion_block_element import NotionBlockElement
+from notionary.blocks import NotionBlockElement
 
 
 class BlockRegistry:
@@ -28,28 +28,6 @@ class BlockRegistry:
             for element in elements:
                 self.register(element)
 
-    def to_builder(self):
-        """
-        Convert this registry to a builder for modifications.
-        Imports only when needed to avoid circular imports.
-        """
-        from notionary.elements.registry.block_registry_builder import (
-            BlockRegistryBuilder,
-        )
-
-        builder = BlockRegistryBuilder()
-        for element in self._elements:
-            builder.add_element(element)
-        return builder
-
-    @property
-    def builder(self):
-        """
-        Returns a new builder pre-configured with the current registry elements.
-        Uses lazy import to avoid circular dependencies.
-        """
-        return self.to_builder()
-
     def register(self, element_class: Type[NotionBlockElement]) -> bool:
         """
         Register an element class.

notionary/{elements → blocks}/registry/block_registry_builder.py

@@ -1,33 +1,32 @@
 from __future__ import annotations
-from typing import List, Type
+from typing import List, Type, TYPE_CHECKING
 from collections import OrderedDict
 
-from notionary.elements.column_element import ColumnElement
-from notionary.elements.notion_block_element import NotionBlockElement
-
-from notionary.elements.audio_element import AudioElement
-from notionary.elements.bulleted_list_element import BulletedListElement
-from notionary.elements.embed_element import EmbedElement
-from notionary.elements.mention_element import MentionElement
-from notionary.elements.notion_block_element import NotionBlockElement
-from notionary.elements.numbered_list_element import NumberedListElement
-from notionary.elements.registry.block_registry import (
-    BlockRegistry,
+from notionary.blocks import (
+    ParagraphElement,
+    AudioElement,
+    BulletedListElement,
+    CalloutElement,
+    CodeBlockElement,
+    ColumnElement,
+    DividerElement,
+    EmbedElement,
+    HeadingElement,
+    ImageElement,
+    MentionElement,
+    NumberedListElement,
+    TableElement,
+    TodoElement,
+    ToggleElement,
+    ToggleableHeadingElement,
+    VideoElement,
+    BookmarkElement,
+    QuoteElement,
+    NotionBlockElement,
 )
 
-from notionary.elements.paragraph_element import ParagraphElement
-from notionary.elements.heading_element import HeadingElement
-from notionary.elements.callout_element import CalloutElement
-from notionary.elements.code_block_element import CodeBlockElement
-from notionary.elements.divider_element import DividerElement
-from notionary.elements.table_element import TableElement
-from notionary.elements.todo_element import TodoElement
-from notionary.elements.qoute_element import QuoteElement
-from notionary.elements.image_element import ImageElement
-from notionary.elements.toggleable_heading_element import ToggleableHeadingElement
-from notionary.elements.video_element import VideoElement
-from notionary.elements.toggle_element import ToggleElement
-from notionary.elements.bookmark_element import BookmarkElement
+if TYPE_CHECKING:
+    from notionary.blocks import BlockRegistry
 
 
 class BlockRegistryBuilder:
@@ -281,6 +280,8 @@ class BlockRegistryBuilder:
         Returns:
             A configured BlockRegistry instance
         """
+        from notionary.blocks import BlockRegistry
+
         if ParagraphElement.__name__ not in self._elements:
             self.add_element(ParagraphElement)
         else:

notionary/{elements → blocks}/table_element.py

@@ -1,13 +1,11 @@
 import re
 from typing import Dict, Any, Optional, List, Tuple
-from notionary.elements.notion_block_element import NotionBlockElement, auto_track_conversions
-from notionary.elements.text_inline_formatter import TextInlineFormatter
-from notionary.prompting.element_prompt_content import (
-    ElementPromptBuilder,
-    ElementPromptContent,
-)
-
-@auto_track_conversions
+
+from notionary.blocks import NotionBlockElement
+from notionary.blocks.text_inline_formatter import TextInlineFormatter
+from notionary.blocks import ElementPromptContent, ElementPromptBuilder
+
+
 class TableElement(NotionBlockElement):
     """
     Handles conversion between Markdown tables and Notion table blocks.

notionary/{elements → blocks}/text_inline_formatter.py

@@ -1,10 +1,7 @@
 from typing import Dict, Any, List, Tuple
 import re
 
-from notionary.prompting.element_prompt_content import (
-    ElementPromptBuilder,
-    ElementPromptContent,
-)
+from notionary.blocks import ElementPromptBuilder, ElementPromptContent
 
 
 class TextInlineFormatter:

notionary/{elements → blocks}/todo_element.py

@@ -1,13 +1,11 @@
 import re
 from typing import Dict, Any, Optional
-from notionary.elements.notion_block_element import NotionBlockElement, auto_track_conversions
-from notionary.prompting.element_prompt_content import (
-    ElementPromptBuilder,
-    ElementPromptContent,
-)
-from notionary.elements.text_inline_formatter import TextInlineFormatter
-
-@auto_track_conversions
+
+from notionary.blocks import NotionBlockElement
+from notionary.blocks import ElementPromptContent, ElementPromptBuilder
+from notionary.blocks.text_inline_formatter import TextInlineFormatter
+
+
 class TodoElement(NotionBlockElement):
     """
     Handles conversion between Markdown todo items and Notion to_do blocks.

notionary/{elements → blocks}/toggle_element.py

@@ -1,13 +1,10 @@
 import re
 from typing import Dict, Any, Optional, List, Tuple, Callable
 
-from notionary.elements.notion_block_element import NotionBlockElement, auto_track_conversions
-from notionary.prompting.element_prompt_content import (
-    ElementPromptBuilder,
-    ElementPromptContent,
-)
+from notionary.blocks import NotionBlockElement
+from notionary.blocks import ElementPromptContent, ElementPromptBuilder
+
 
-@auto_track_conversions
 class ToggleElement(NotionBlockElement):
     """
     Improved ToggleElement class using pipe syntax instead of indentation.

notionary/{elements → blocks}/toggleable_heading_element.py

@@ -1,14 +1,11 @@
 import re
 from typing import Dict, Any, Optional, List, Tuple, Callable
 
-from notionary.elements.notion_block_element import NotionBlockElement, auto_track_conversions
-from notionary.prompting.element_prompt_content import (
-    ElementPromptBuilder,
-    ElementPromptContent,
-)
-from notionary.elements.text_inline_formatter import TextInlineFormatter
-
-@auto_track_conversions
+from notionary.blocks import NotionBlockElement
+from notionary.blocks import ElementPromptContent, ElementPromptBuilder
+from notionary.blocks.text_inline_formatter import TextInlineFormatter
+
+
 class ToggleableHeadingElement(NotionBlockElement):
     """Handles conversion between Markdown collapsible headings and Notion toggleable heading blocks with pipe syntax."""
 

notionary/{elements → blocks}/video_element.py

@@ -1,12 +1,10 @@
 import re
 from typing import Dict, Any, Optional, List
-from notionary.elements.notion_block_element import NotionBlockElement, auto_track_conversions
-from notionary.prompting.element_prompt_content import (
-    ElementPromptBuilder,
-    ElementPromptContent,
-)
 
-@auto_track_conversions
+from notionary.blocks import NotionBlockElement
+from notionary.blocks import ElementPromptContent, ElementPromptBuilder
+
+
 class VideoElement(NotionBlockElement):
     """
     Handles conversion between Markdown video embeds and Notion video blocks.