notionary 0.2.27__py3-none-any.whl → 0.3.0__py3-none-any.whl

notionary/blocks/todo/todo_markdown_node.py

@@ -1,21 +0,0 @@
-from pydantic import Field
-from notionary.blocks.markdown.markdown_node import MarkdownNode
-
-
-class TodoMarkdownNode(MarkdownNode):
-    """
-    Enhanced Todo node with Pydantic integration.
-    Programmatic interface for creating Markdown todo items (checkboxes).
-    Supports checked and unchecked states.
-    Example: - [ ] Task, - [x] Done
-    """
-
-    text: str
-    checked: bool = False
-    marker: str = Field(default="-")
-
-    def to_markdown(self) -> str:
-        # Validate marker in to_markdown to ensure it's valid
-        valid_marker = self.marker if self.marker in {"-", "*", "+"} else "-"
-        checkbox = "[x]" if self.checked else "[ ]"
-        return f"{valid_marker} {checkbox} {self.text}"

notionary/blocks/todo/todo_models.py

@@ -1,18 +0,0 @@
-from typing import Literal, Optional
-
-from pydantic import BaseModel
-
-from notionary.blocks.models import Block
-from notionary.blocks.rich_text.rich_text_models import RichTextObject
-from notionary.blocks.types import BlockColor
-
-
-class ToDoBlock(BaseModel):
-    rich_text: list[RichTextObject]
-    checked: bool = False
-    color: BlockColor = BlockColor.DEFAULT
-
-
-class CreateToDoBlock(BaseModel):
-    type: Literal["to_do"] = "to_do"
-    to_do: ToDoBlock

notionary/blocks/toggle/__init__.py

@@ -1,12 +0,0 @@
-from notionary.blocks.toggle.toggle_element import ToggleElement
-from notionary.blocks.toggle.toggle_markdown_node import (
-    ToggleMarkdownNode,
-)
-from notionary.blocks.toggle.toggle_models import CreateToggleBlock, ToggleBlock
-
-__all__ = [
-    "ToggleElement",
-    "ToggleBlock",
-    "CreateToggleBlock",
-    "ToggleMarkdownNode",
-]

notionary/blocks/toggle/toggle_element.py

@@ -1,112 +0,0 @@
-from __future__ import annotations
-
-import re
-from typing import Optional
-
-from notionary.blocks.base_block_element import BaseBlockElement
-from notionary.blocks.syntax_prompt_builder import BlockElementMarkdownInformation
-from notionary.blocks.models import Block, BlockCreateResult, BlockType
-from notionary.blocks.rich_text.rich_text_models import RichTextObject
-from notionary.blocks.rich_text.text_inline_formatter import TextInlineFormatter
-from notionary.blocks.toggle.toggle_models import CreateToggleBlock, ToggleBlock
-from notionary.blocks.types import BlockColor
-
-
-class ToggleElement(BaseBlockElement):
-    """
-    Simplified ToggleElement class that works with the stack-based converter.
-    Children are automatically handled by the StackBasedMarkdownConverter.
-    """
-
-    # Updated pattern for ultra-simplified +++ Title syntax (no quotes!)
-    TOGGLE_PATTERN = re.compile(r"^[+]{3}\s+(.+)$", re.IGNORECASE)
-    TRANSCRIPT_TOGGLE_PATTERN = re.compile(r"^[+]{3}\s+Transcript$", re.IGNORECASE)
-
-    @classmethod
-    def match_notion(cls, block: Block) -> bool:
-        """Check if the block is a Notion toggle block."""
-        return block.type == BlockType.TOGGLE
-
-    @classmethod
-    async def markdown_to_notion(cls, text: str) -> BlockCreateResult:
-        """
-        Convert markdown toggle line to Notion ToggleBlock.
-        Children are automatically handled by the StackBasedMarkdownConverter.
-        """
-        if not (match := cls.TOGGLE_PATTERN.match(text.strip())):
-            return None
-
-        title = match.group(1).strip()
-        rich_text = await TextInlineFormatter.parse_inline_formatting(title)
-
-        # Create toggle block with empty children - they will be populated automatically
-        toggle_content = ToggleBlock(
-            rich_text=rich_text, color=BlockColor.DEFAULT, children=[]
-        )
-
-        return CreateToggleBlock(toggle=toggle_content)
-
-    @classmethod
-    async def notion_to_markdown(cls, block: Block) -> Optional[str]:
-        """
-        Converts a Notion toggle block into markdown using the ultra-simplified +++ syntax.
-        """
-        if block.type != BlockType.TOGGLE:
-            return None
-
-        if not block.toggle:
-            return None
-
-        toggle_data = block.toggle
-
-        # Extract title from rich_text
-        title = cls._extract_text_content(toggle_data.rich_text or [])
-
-        # Create toggle line with ultra-simplified syntax (no quotes!)
-        toggle_line = f"+++ {title}"
-
-        # Process children if available
-        children = toggle_data.children or []
-        if not children:
-            return toggle_line + "\n+++"
-
-        # Add a placeholder line for each child
-        child_lines = ["[Nested content]" for _ in children]
-
-        return toggle_line + "\n" + "\n".join(child_lines) + "\n+++"
-
-    @classmethod
-    def _extract_text_content(cls, rich_text: list[RichTextObject]) -> str:
-        """Extracts plain text content from Notion rich_text blocks."""
-        result = ""
-        for text_obj in rich_text:
-            if hasattr(text_obj, "plain_text"):
-                result += text_obj.plain_text or ""
-            elif (
-                hasattr(text_obj, "type")
-                and text_obj.type == "text"
-                and hasattr(text_obj, "text")
-            ):
-                result += text_obj.text.content or ""
-            # Fallback for dict-style access (backward compatibility)
-            elif isinstance(text_obj, dict):
-                if text_obj.get("type") == "text":
-                    result += text_obj.get("text", {}).get("content", "")
-                elif "plain_text" in text_obj:
-                    result += text_obj.get("plain_text", "")
-        return result
-
-    @classmethod
-    @classmethod
-    def get_system_prompt_information(cls) -> Optional[BlockElementMarkdownInformation]:
-        """Get system prompt information for toggle blocks."""
-        return BlockElementMarkdownInformation(
-            block_type=cls.__name__,
-            description="Toggle blocks create collapsible sections with expandable content",
-            syntax_examples=[
-                "+++Title\nContent goes here\n+++",
-                "+++Details\nMore information\nAdditional content\n+++",
-                "+++FAQ\nFrequently asked questions\n+++",
-            ],
-            usage_guidelines="Use for collapsible content sections. Start with +++Title, add content, end with +++. Great for FAQs, details, or organizing long content.",
-        )

notionary/blocks/toggle/toggle_markdown_node.py

@@ -1,31 +0,0 @@
-from notionary.blocks.markdown.markdown_node import MarkdownNode
-
-
-class ToggleMarkdownNode(MarkdownNode):
-    """
-    Enhanced Toggle node with Pydantic integration.
-    Clean programmatic interface for creating Notion-style Markdown toggle blocks
-    with the simplified +++ "Title" syntax.
-
-    Example:
-        +++ "Advanced Details"
-        Content here
-        More content
-        +++
-    """
-
-    title: str
-    children: list[MarkdownNode] = []
-
-    def to_markdown(self) -> str:
-        result = f"+++ {self.title}"
-
-        if not self.children:
-            result += "\n+++"
-            return result
-
-        # Convert children to markdown
-        content_parts = [child.to_markdown() for child in self.children]
-        content_text = "\n\n".join(content_parts)
-
-        return result + "\n" + content_text + "\n+++"

notionary/blocks/toggle/toggle_models.py

@@ -1,17 +0,0 @@
-from pydantic import BaseModel, Field
-from typing_extensions import Literal
-
-from notionary.blocks.models import Block
-from notionary.blocks.rich_text.rich_text_models import RichTextObject
-from notionary.blocks.types import BlockColor
-
-
-class ToggleBlock(BaseModel):
-    rich_text: list[RichTextObject]
-    color: BlockColor = BlockColor.DEFAULT
-    children: list[Block] = Field(default_factory=list)
-
-
-class CreateToggleBlock(BaseModel):
-    type: Literal["toggle"] = "toggle"
-    toggle: ToggleBlock

notionary/blocks/toggleable_heading/__init__.py

@@ -1,11 +0,0 @@
-from notionary.blocks.toggleable_heading.toggleable_heading_element import (
-    ToggleableHeadingElement,
-)
-from notionary.blocks.toggleable_heading.toggleable_heading_markdown_node import (
-    ToggleableHeadingMarkdownNode,
-)
-
-__all__ = [
-    "ToggleableHeadingElement",
-    "ToggleableHeadingMarkdownNode",
-]

notionary/blocks/toggleable_heading/toggleable_heading_element.py

@@ -1,115 +0,0 @@
-from __future__ import annotations
-
-import re
-from typing import Optional
-
-from notionary.blocks.base_block_element import BaseBlockElement
-from notionary.blocks.heading.heading_models import (
-    CreateHeading1Block,
-    CreateHeading2Block,
-    CreateHeading3Block,
-    HeadingBlock,
-)
-from notionary.blocks.syntax_prompt_builder import BlockElementMarkdownInformation
-from notionary.blocks.models import Block, BlockCreateResult, BlockType
-from notionary.blocks.rich_text.text_inline_formatter import TextInlineFormatter
-
-
-class ToggleableHeadingElement(BaseBlockElement):
-    """
-    Simplified ToggleableHeadingElement that works with the stack-based converter.
-    Children are automatically handled by the StackBasedMarkdownConverter.
-    """
-
-    # Updated pattern for simplified +++# Title syntax (no quotes!)
-    PATTERN = re.compile(r"^[+]{3}(?P<level>#{1,3})\s+(.+)$", re.IGNORECASE)
-
-    @staticmethod
-    def match_notion(block: Block) -> bool:
-        """Check if block is a Notion toggleable heading."""
-        # Use BlockType enum for matching heading blocks
-        if block.type not in (
-            BlockType.HEADING_1,
-            BlockType.HEADING_2,
-            BlockType.HEADING_3,
-        ):
-            return False
-
-        if block.heading_1 and block.heading_1.is_toggleable:
-            return True
-        if block.heading_2 and block.heading_2.is_toggleable:
-            return True
-        if block.heading_3 and block.heading_3.is_toggleable:
-            return True
-
-    @classmethod
-    async def markdown_to_notion(cls, text: str) -> BlockCreateResult:
-        """
-        Convert markdown collapsible heading to a toggleable Notion HeadingBlock.
-        Children are automatically handled by the StackBasedMarkdownConverter.
-        """
-        if not (match := cls.PATTERN.match(text.strip())):
-            return None
-
-        level = len(match.group("level"))  # Count # characters
-        content = match.group(2).strip()  # group(2) is the title (no quotes needed)
-
-        if level < 1 or level > 3 or not content:
-            return None
-
-        rich_text = await TextInlineFormatter.parse_inline_formatting(content)
-
-        heading_content = HeadingBlock(
-            rich_text=rich_text, color="default", is_toggleable=True, children=[]
-        )
-
-        if level == 1:
-            return CreateHeading1Block(heading_1=heading_content)
-        elif level == 2:
-            return CreateHeading2Block(heading_2=heading_content)
-        else:
-            return CreateHeading3Block(heading_3=heading_content)
-
-    @staticmethod
-    async def notion_to_markdown(block: Block) -> Optional[str]:
-        """Convert Notion toggleable heading block to markdown collapsible heading."""
-        # Only handle heading blocks via BlockType enum
-        if block.type not in (
-            BlockType.HEADING_1,
-            BlockType.HEADING_2,
-            BlockType.HEADING_3,
-        ):
-            return None
-
-        # Determine heading level from enum
-        if block.type == BlockType.HEADING_1:
-            level = 1
-        elif block.type == BlockType.HEADING_2:
-            level = 2
-        else:
-            level = 3
-
-        heading_content = getattr(block, block.type.value)
-        if not isinstance(heading_content, HeadingBlock):
-            return None
-
-        text = await TextInlineFormatter.extract_text_with_formatting(
-            heading_content.rich_text
-        )
-        prefix = "#" * level
-
-        return f'+++{prefix} {text or ""}'
-
-    @classmethod
-    def get_system_prompt_information(cls) -> Optional[BlockElementMarkdownInformation]:
-        """Get system prompt information for toggleable heading blocks."""
-        return BlockElementMarkdownInformation(
-            block_type=cls.__name__,
-            description="Toggleable heading blocks create collapsible sections with heading-style titles",
-            syntax_examples=[
-                "+++# Main Section\nContent goes here\n+++",
-                "+++## Subsection\nSubsection content\n+++",
-                "+++### Details\nDetailed information\n+++",
-            ],
-            usage_guidelines="Use for collapsible sections with heading structure. Combines heading levels (1-3) with toggle functionality. Great for organizing hierarchical expandable content.",
-        )

notionary/blocks/toggleable_heading/toggleable_heading_markdown_node.py

@@ -1,34 +0,0 @@
-from pydantic import Field
-
-from notionary.blocks.markdown.markdown_node import MarkdownNode
-
-
-class ToggleableHeadingMarkdownNode(MarkdownNode):
-    """
-    Enhanced Toggleable Heading node with Pydantic integration.
-    Clean programmatic interface for creating collapsible Markdown headings (toggleable headings)
-    with pipe-prefixed nested content using MarkdownNode children.
-
-    Example syntax for a level-2 toggleable heading:
-        +++## Advanced Section
-        some content
-        +++
-    """
-
-    text: str
-    level: int = Field(ge=1, le=3)
-    children: list[MarkdownNode] = []
-
-    def to_markdown(self) -> str:
-        prefix = "+++" + ("#" * self.level)
-        result = f"{prefix} {self.text}"
-
-        if not self.children:
-            result += "\n+++"
-            return result
-
-        # Convert children to markdown
-        content_parts = [child.to_markdown() for child in self.children]
-        content_text = "\n\n".join(content_parts)
-
-        return result + "\n" + content_text + "\n+++"

notionary/blocks/types.py

@@ -1,130 +0,0 @@
-from __future__ import annotations
-
-from enum import Enum
-
-from typing import Protocol, TYPE_CHECKING
-
-if TYPE_CHECKING:
-    from notionary.blocks.models import BlockCreateRequest
-    from notionary.blocks.rich_text.rich_text_models import RichTextObject
-
-
-class BlockColor(str, Enum):
-    BLUE = "blue"
-    BLUE_BACKGROUND = "blue_background"
-    BROWN = "brown"
-    BROWN_BACKGROUND = "brown_background"
-    DEFAULT = "default"
-    GRAY = "gray"
-    GRAY_BACKGROUND = "gray_background"
-    GREEN = "green"
-    GREEN_BACKGROUND = "green_background"
-    ORANGE = "orange"
-    ORANGE_BACKGROUND = "orange_background"
-    YELLOW = "yellow"
-    YELLOW_BACKGROUND = "yellow_background"
-    PINK = "pink"
-    PINK_BACKGROUND = "pink_background"
-    PURPLE = "purple"
-    PURPLE_BACKGROUND = "purple_background"
-    RED = "red"
-    RED_BACKGROUND = "red_background"
-    DEFAULT_BACKGROUND = "default_background"
-
-
-class BlockType(str, Enum):
-    BOOKMARK = "bookmark"
-    BREADCRUMB = "breadcrumb"
-    BULLETED_LIST_ITEM = "bulleted_list_item"
-    CALLOUT = "callout"
-    CHILD_DATABASE = "child_database"
-    CHILD_PAGE = "child_page"
-    COLUMN = "column"
-    COLUMN_LIST = "column_list"
-    CODE = "code"
-    DIVIDER = "divider"
-    EMBED = "embed"
-    EQUATION = "equation"
-    FILE = "file"
-    HEADING_1 = "heading_1"
-    HEADING_2 = "heading_2"
-    HEADING_3 = "heading_3"
-    IMAGE = "image"
-    LINK_PREVIEW = "link_preview"
-    LINK_TO_PAGE = "link_to_page"
-    NUMBERED_LIST_ITEM = "numbered_list_item"
-    PARAGRAPH = "paragraph"
-    PDF = "pdf"
-    QUOTE = "quote"
-    SYNCED_BLOCK = "synced_block"
-    TABLE = "table"
-    TABLE_OF_CONTENTS = "table_of_contents"
-    TABLE_ROW = "table_row"
-    TO_DO = "to_do"
-    TOGGLE = "toggle"
-    UNSUPPORTED = "unsupported"
-    VIDEO = "video"
-    AUDIO = "audio"
-
-
-class MarkdownBlockType(str, Enum):
-    """
-    Extended block types for the MarkdownBuilder.
-    Includes all BlockType values and adds user-friendly aliases
-    for blocks with no direct Notion API counterpart.
-    """
-
-    # All BlockType values
-    BOOKMARK = "bookmark"
-    BREADCRUMB = "breadcrumb"
-    BULLETED_LIST_ITEM = "bulleted_list_item"
-    CALLOUT = "callout"
-    CHILD_DATABASE = "child_database"
-    CHILD_PAGE = "child_page"
-    COLUMN = "column"
-    COLUMN_LIST = "column_list"
-    CODE = "code"
-    DIVIDER = "divider"
-    EMBED = "embed"
-    EQUATION = "equation"
-    FILE = "file"
-    HEADING_1 = "heading_1"
-    HEADING_2 = "heading_2"
-    HEADING_3 = "heading_3"
-    IMAGE = "image"
-    LINK_PREVIEW = "link_preview"
-    LINK_TO_PAGE = "link_to_page"
-    NUMBERED_LIST_ITEM = "numbered_list_item"
-    PARAGRAPH = "paragraph"
-    PDF = "pdf"
-    QUOTE = "quote"
-    SYNCED_BLOCK = "synced_block"
-    TABLE = "table"
-    TABLE_OF_CONTENTS = "table_of_contents"
-    TABLE_ROW = "table_row"
-    TO_DO = "to_do"
-    TOGGLE = "toggle"
-    UNSUPPORTED = "unsupported"
-    VIDEO = "video"
-    AUDIO = "audio"
-
-    # Markdown-specific aliases
-    HEADING = "heading"
-    BULLETED_LIST = "bulleted_list"
-    NUMBERED_LIST = "numbered_list"
-    TODO = "todo"
-    TOGGLEABLE_HEADING = "toggleable_heading"
-    COLUMNS = "columns"
-    SPACE = "space"
-
-
-class HasRichText(Protocol):
-    """Protocol for objects that have a rich_text attribute."""
-
-    rich_text: list[RichTextObject]
-
-
-class HasChildren(Protocol):
-    """Protocol for objects that have children blocks."""
-
-    children: list[BlockCreateRequest]

notionary/blocks/video/__init__.py

@@ -1,11 +0,0 @@
-from notionary.blocks.video.video_element import VideoElement
-from notionary.blocks.video.video_element_models import CreateVideoBlock
-from notionary.blocks.video.video_markdown_node import (
-    VideoMarkdownNode,
-)
-
-__all__ = [
-    "VideoElement",
-    "CreateVideoBlock",
-    "VideoMarkdownNode",
-]