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

notionary/blocks/heading/heading_element.py

@@ -1,112 +0,0 @@
-from __future__ import annotations
-
-import re
-from typing import Optional, cast
-
-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
-from notionary.blocks.types import BlockColor
-
-
-class HeadingElement(BaseBlockElement):
-    """Handles conversion between Markdown headings and Notion heading blocks."""
-
-    PATTERN = re.compile(r"^(#{1,3})[ \t]+(.+)$")
-
-    @classmethod
-    def match_notion(cls, block: Block) -> bool:
-        return (
-            block.type
-            in (
-                BlockType.HEADING_1,
-                BlockType.HEADING_2,
-                BlockType.HEADING_3,
-            )
-            and getattr(block, block.type.value) is not None
-        )
-
-    @classmethod
-    async def markdown_to_notion(cls, text: str) -> BlockCreateResult:
-        """Convert markdown headings (#, ##, ###) to Notion HeadingBlock."""
-        match = cls.PATTERN.match(text.strip())
-        if not match:
-            return None
-
-        level = len(match.group(1))
-        if level < 1 or level > 3:
-            return None
-
-        content = match.group(2).strip()
-        if not content:
-            return None
-
-        rich_text = await TextInlineFormatter.parse_inline_formatting(content)
-        heading_content = HeadingBlock(
-            rich_text=rich_text, color=BlockColor.DEFAULT, is_toggleable=False
-        )
-
-        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)
-
-    @classmethod
-    async def notion_to_markdown(cls, block: Block) -> Optional[str]:
-        # 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_obj = getattr(block, block.type.value)
-        if not heading_obj:
-            return None
-
-        heading_data = cast(HeadingBlock, heading_obj)
-        if not heading_data.rich_text:
-            return None
-
-        text = await TextInlineFormatter.extract_text_with_formatting(
-            heading_data.rich_text
-        )
-        if not text:
-            return None
-
-        # Use hash-style for all heading levels
-        return f"{('#' * level)} {text}"
-
-    @classmethod
-    def get_system_prompt_information(cls) -> Optional[BlockElementMarkdownInformation]:
-        """Get system prompt information for heading blocks."""
-        return BlockElementMarkdownInformation(
-            block_type=cls.__name__,
-            description="Heading blocks create hierarchical document structure with different levels",
-            syntax_examples=[
-                "# Heading Level 1",
-                "## Heading Level 2",
-                "### Heading Level 3",
-                "# Heading with **bold text**",
-                "## Heading with *italic text*",
-            ],
-            usage_guidelines="Use # for main titles, ## for sections, ### for subsections. Supports inline formatting. Only levels 1-3 are supported in Notion.",
-        )

notionary/blocks/heading/heading_markdown_node.py

@@ -1,16 +0,0 @@
-from pydantic import Field
-from notionary.blocks.markdown.markdown_node import MarkdownNode
-
-
-class HeadingMarkdownNode(MarkdownNode):
-    """
-    Enhanced Heading node with Pydantic integration.
-    Programmatic interface for creating Markdown headings (H1-H3).
-    Example: # Heading 1, ## Heading 2, ### Heading 3
-    """
-
-    text: str
-    level: int = Field(default=1, ge=1, le=3)
-
-    def to_markdown(self) -> str:
-        return f"{'#' * self.level} {self.text}"

notionary/blocks/heading/heading_models.py

@@ -1,29 +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 HeadingBlock(BaseModel):
-    rich_text: list[RichTextObject]
-    color: BlockColor = BlockColor.DEFAULT
-    is_toggleable: bool = False
-    children: Optional[list[Block]] = None
-
-
-class CreateHeading1Block(BaseModel):
-    type: Literal["heading_1"] = "heading_1"
-    heading_1: HeadingBlock
-
-
-class CreateHeading2Block(BaseModel):
-    type: Literal["heading_2"] = "heading_2"
-    heading_2: HeadingBlock
-
-
-class CreateHeading3Block(BaseModel):
-    type: Literal["heading_3"] = "heading_3"
-    heading_3: HeadingBlock

notionary/blocks/image_block/__init__.py

@@ -1,11 +0,0 @@
-from notionary.blocks.image_block.image_element import ImageElement
-from notionary.blocks.image_block.image_markdown_node import (
-    ImageMarkdownNode,
-)
-from notionary.blocks.image_block.image_models import CreateImageBlock
-
-__all__ = [
-    "ImageElement",
-    "CreateImageBlock",
-    "ImageMarkdownNode",
-]

notionary/blocks/image_block/image_element.py

@@ -1,130 +0,0 @@
-from __future__ import annotations
-
-import re
-from typing import Optional
-
-from notionary.blocks.base_block_element import BaseBlockElement
-from notionary.blocks.file.file_element_models import (
-    ExternalFile,
-    FileType,
-    FileUploadFile,
-)
-from notionary.blocks.image_block.image_models import CreateImageBlock, FileBlock
-from notionary.blocks.mixins.captions import CaptionMixin
-from notionary.blocks.mixins.file_upload.file_upload_mixin import FileUploadMixin
-from notionary.blocks.syntax_prompt_builder import BlockElementMarkdownInformation
-from notionary.blocks.models import Block, BlockCreateResult, BlockType
-
-
-class ImageElement(BaseBlockElement, CaptionMixin, FileUploadMixin):
-    r"""
-    Handles conversion between Markdown images and Notion image blocks.
-
-    Supports both external URLs and local image file uploads.
-
-    Markdown image syntax:
-    - [image](https://example.com/image.jpg) - External URL
-    - [image](./local/photo.png) - Local image file (will be uploaded)
-    - [image](C:\Pictures\avatar.jpg) - Absolute local path (will be uploaded)
-    - [image](https://example.com/image.jpg)(caption:This is a caption) - URL with caption
-    - (caption:Profile picture)[image](./avatar.jpg) - Caption before URL
-    """
-
-    # Pattern matches both URLs and file paths
-    IMAGE_PATTERN = re.compile(r"\[image\]\(([^)]+)\)")
-
-    @classmethod
-    def match_notion(cls, block: Block) -> bool:
-        return block.type == BlockType.IMAGE and block.image
-
-    @classmethod
-    async def markdown_to_notion(cls, text: str) -> Optional[BlockCreateResult]:
-        """Convert markdown image syntax to Notion ImageBlock."""
-        image_path = cls._extract_image_path(text.strip())
-        if not image_path:
-            return None
-
-        cls.logger.info(f"Processing image: {image_path}")
-
-        # Extract caption
-        caption_text = cls.extract_caption(text.strip())
-        caption_rich_text = cls.build_caption_rich_text(caption_text or "")
-
-        # Determine if it's a local file or external URL
-        if cls._is_local_file_path(image_path):
-            cls.logger.debug(f"Detected local image file: {image_path}")
-
-            # Upload the local image file using mixin method
-            file_upload_id = await cls._upload_local_file(image_path, "image")
-            if not file_upload_id:
-                cls.logger.error(f"Failed to upload image: {image_path}")
-                return None
-
-            image_block = FileBlock(
-                type=FileType.FILE_UPLOAD,
-                file_upload=FileUploadFile(id=file_upload_id),
-                caption=caption_rich_text,
-            )
-
-        else:
-            cls.logger.debug(f"Using external image URL: {image_path}")
-
-            image_block = FileBlock(
-                type=FileType.EXTERNAL,
-                external=ExternalFile(url=image_path),
-                caption=caption_rich_text,
-            )
-
-        return CreateImageBlock(image=image_block)
-
-    @classmethod
-    async def notion_to_markdown(cls, block: Block) -> Optional[str]:
-        if block.type != BlockType.IMAGE or not block.image:
-            return None
-
-        fo = block.image
-
-        # Determine the source for markdown
-        if fo.type == FileType.EXTERNAL and fo.external:
-            source = fo.external.url
-        elif fo.type == FileType.FILE and fo.file:
-            source = fo.file.url
-        else:
-            return None
-
-        result = f"[image]({source})"
-
-        # Add caption if present
-        caption_markdown = await cls.format_caption_for_markdown(fo.caption or [])
-        if caption_markdown:
-            result += caption_markdown
-
-        return result
-
-    @classmethod
-    def get_system_prompt_information(cls) -> Optional[BlockElementMarkdownInformation]:
-        """Get system prompt information for image blocks."""
-        return BlockElementMarkdownInformation(
-            block_type=cls.__name__,
-            description="Image blocks display images from external URLs or upload local image files with optional captions",
-            syntax_examples=[
-                "[image](https://example.com/photo.jpg)",
-                "[image](./local/screenshot.png)",
-                "[image](C:\\Pictures\\avatar.jpg)",
-                "[image](https://example.com/diagram.png)(caption:Architecture Diagram)",
-                "(caption:Sales Chart)[image](./chart.svg)",
-                "[image](./screenshot.png)(caption:Dashboard **overview**)",
-            ],
-            usage_guidelines="Use for displaying images from external URLs or local files. Local image files will be automatically uploaded to Notion. Supports common image formats (jpg, png, gif, svg, webp, bmp, tiff, heic). Caption supports rich text formatting and describes the image content.",
-        )
-
-    @classmethod
-    def _extract_image_path(cls, text: str) -> Optional[str]:
-        """Extract image path/URL from text, handling caption patterns."""
-        clean_text = cls.remove_caption(text)
-
-        match = cls.IMAGE_PATTERN.search(clean_text)
-        if match:
-            return match.group(1).strip()
-
-        return None

notionary/blocks/image_block/image_markdown_node.py

@@ -1,25 +0,0 @@
-from typing import Optional
-
-from notionary.blocks.markdown.markdown_node import MarkdownNode
-from notionary.blocks.mixins.captions import CaptionMarkdownNodeMixin
-
-
-class ImageMarkdownNode(MarkdownNode, CaptionMarkdownNodeMixin):
-    """
-    Enhanced Image node with Pydantic integration.
-    Programmatic interface for creating Notion-style image blocks.
-    """
-
-    url: str
-    caption: Optional[str] = None
-    alt: Optional[str] = None
-
-    def to_markdown(self) -> str:
-        """Return the Markdown representation.
-
-        Examples:
-        - [image](https://example.com/screenshot.png)
-        - [image](https://example.com/screenshot.png)(caption:Dashboard overview)
-        """
-        base_markdown = f"[image]({self.url})"
-        return self.append_caption_to_markdown(base_markdown, self.caption)

notionary/blocks/image_block/image_models.py

@@ -1,10 +0,0 @@
-from typing import Literal
-
-from pydantic import BaseModel
-
-from notionary.blocks.file.file_element_models import FileBlock
-
-
-class CreateImageBlock(BaseModel):
-    type: Literal["image"] = "image"
-    image: FileBlock