notionary 0.2.23__py3-none-any.whl → 0.2.25__py3-none-any.whl

notionary/markdown/markdown_document_model.py

@@ -1,228 +0,0 @@
-from __future__ import annotations
-
-from typing import Literal, Optional, Union
-
-from pydantic import BaseModel, Field
-
-from notionary.blocks.bookmark.bookmark_markdown_node import BookmarkMarkdownBlockParams
-from notionary.blocks.bulleted_list.bulleted_list_markdown_node import (
-    BulletedListMarkdownBlockParams,
-)
-from notionary.blocks.callout.callout_markdown_node import CalloutMarkdownBlockParams
-from notionary.blocks.divider.divider_markdown_node import DividerMarkdownBlockParams
-from notionary.blocks.embed.embed_markdown_node import EmbedMarkdownBlockParams
-from notionary.blocks.equation.equation_element_markdown_node import (
-    EquationMarkdownBlockParams,
-)
-from notionary.blocks.file.file_element_markdown_node import FileMarkdownNodeParams
-
-# Import all the existing params models
-from notionary.blocks.heading.heading_markdown_node import HeadingMarkdownBlockParams
-from notionary.blocks.image_block.image_markdown_node import ImageMarkdownBlockParams
-from notionary.blocks.numbered_list.numbered_list_markdown_node import (
-    NumberedListMarkdownBlockParams,
-)
-from notionary.blocks.paragraph.paragraph_markdown_node import (
-    ParagraphMarkdownBlockParams,
-)
-from notionary.blocks.quote.quote_markdown_node import QuoteMarkdownBlockParams
-from notionary.blocks.table.table_markdown_node import TableMarkdownBlockParams
-from notionary.blocks.table_of_contents.table_of_contents_markdown_node import (
-    TableOfContentsMarkdownBlockParams,
-)
-from notionary.blocks.todo.todo_markdown_node import TodoMarkdownBlockParams
-from notionary.blocks.video.video_markdown_node import VideoMarkdownBlockParams
-
-
-class HeadingBlock(BaseModel):
-    type: Literal["heading"] = "heading"
-    params: HeadingMarkdownBlockParams
-
-
-class ParagraphBlock(BaseModel):
-    type: Literal["paragraph"] = "paragraph"
-    params: ParagraphMarkdownBlockParams
-
-
-class QuoteBlock(BaseModel):
-    type: Literal["quote"] = "quote"
-    params: QuoteMarkdownBlockParams
-
-
-class BulletedListBlock(BaseModel):
-    type: Literal["bulleted_list"] = "bulleted_list"
-    params: BulletedListMarkdownBlockParams
-
-
-class NumberedListBlock(BaseModel):
-    type: Literal["numbered_list"] = "numbered_list"
-    params: NumberedListMarkdownBlockParams
-
-
-class TodoBlock(BaseModel):
-    type: Literal["todo"] = "todo"
-    params: TodoMarkdownBlockParams
-
-
-class CalloutBlock(BaseModel):
-    type: Literal["callout"] = "callout"
-    params: CalloutMarkdownBlockParams
-
-
-class CodeBlock(BaseModel):
-    type: Literal["code"] = "code"
-    params: CodeBlock
-
-
-class ImageBlock(BaseModel):
-    type: Literal["image"] = "image"
-    params: ImageMarkdownBlockParams
-
-
-class VideoBlock(BaseModel):
-    type: Literal["video"] = "video"
-    params: VideoMarkdownBlockParams
-
-
-class AudioBlock(BaseModel):
-    type: Literal["audio"] = "audio"
-    params: FileMarkdownNodeParams
-
-
-class FileBlock(BaseModel):
-    type: Literal["file"] = "file"
-    params: FileMarkdownNodeParams
-
-
-class PdfBlock(BaseModel):
-    type: Literal["pdf"] = "pdf"
-    params: FileMarkdownNodeParams
-
-
-class BookmarkBlock(BaseModel):
-    type: Literal["bookmark"] = "bookmark"
-    params: BookmarkMarkdownBlockParams
-
-
-class EmbedBlock(BaseModel):
-    type: Literal["embed"] = "embed"
-    params: EmbedMarkdownBlockParams
-
-
-class TableBlock(BaseModel):
-    type: Literal["table"] = "table"
-    params: TableMarkdownBlockParams
-
-
-class DividerBlock(BaseModel):
-    type: Literal["divider"] = "divider"
-    params: DividerMarkdownBlockParams
-
-
-class EquationBlock(BaseModel):
-    type: Literal["equation"] = "equation"
-    params: EquationMarkdownBlockParams
-
-
-class TableOfContentsBlock(BaseModel):
-    type: Literal["table_of_contents"] = "table_of_contents"
-    params: TableOfContentsMarkdownBlockParams
-
-
-# Special blocks for nested content
-class ToggleBlockParams(BaseModel):
-    title: str
-    children: list[MarkdownBlock] = Field(default_factory=list)
-
-
-class ToggleBlock(BaseModel):
-    type: Literal["toggle"] = "toggle"
-    params: ToggleBlockParams
-
-
-class ToggleableHeadingBlockParams(BaseModel):
-    text: str
-    level: int = Field(ge=1, le=3)
-    children: list[MarkdownBlock] = Field(default_factory=list)
-
-
-class ToggleableHeadingBlock(BaseModel):
-    type: Literal["toggleable_heading"] = "toggleable_heading"
-    params: ToggleableHeadingBlockParams
-
-
-class ColumnBlockParams(BaseModel):
-    columns: list[list[MarkdownBlock]] = Field(default_factory=list)
-    width_ratios: Optional[list[float]] = None
-
-
-class ColumnBlock(BaseModel):
-    type: Literal["columns"] = "columns"
-    params: ColumnBlockParams
-
-
-# Union of all possible blocks
-MarkdownBlock = Union[
-    HeadingBlock,
-    ParagraphBlock,
-    QuoteBlock,
-    BulletedListBlock,
-    NumberedListBlock,
-    TodoBlock,
-    CalloutBlock,
-    CodeBlock,
-    ImageBlock,
-    VideoBlock,
-    AudioBlock,
-    FileBlock,
-    PdfBlock,
-    BookmarkBlock,
-    EmbedBlock,
-    TableBlock,
-    DividerBlock,
-    EquationBlock,
-    TableOfContentsBlock,
-    ToggleBlock,
-    ToggleableHeadingBlock,
-    ColumnBlock,
-]
-
-
-# Update forward references
-ToggleBlockParams.model_rebuild()
-ToggleableHeadingBlockParams.model_rebuild()
-ColumnBlockParams.model_rebuild()
-
-
-class MarkdownDocumentModel(BaseModel):
-    """
-    Complete document model for generating Markdown via MarkdownBuilder.
-    Perfect for LLM structured output!
-
-    Example:
-        {
-            "blocks": [
-                {
-                    "type": "heading",
-                    "params": {"text": "My Document", "level": 1}
-                },
-                {
-                    "type": "paragraph",
-                    "params": {"text": "Introduction text"}
-                },
-                {
-                    "type": "pdf",
-                    "params": {"url": "https://example.com/doc.pdf", "caption": "Important PDF"}
-                }
-            ]
-        }
-    """
-
-    blocks: list[MarkdownBlock] = Field(default_factory=list)
-
-    def to_markdown(self) -> str:
-        """Convert the model directly to markdown string."""
-        from notionary.markdown.markdown_builder import MarkdownBuilder
-
-        builder = MarkdownBuilder.from_model(self)
-        return builder.build()

notionary/markdown/markdown_node.py

@@ -1,30 +0,0 @@
-from __future__ import annotations
-
-from abc import ABC, abstractmethod
-
-
-class MarkdownNode(ABC):
-    """
-    Abstract base class for all Markdown block elements.
-    Enforces implementation of to_markdown().
-    """
-
-    @abstractmethod
-    def to_markdown(self) -> str:
-        """
-        Returns the Markdown representation of the block.
-        Must be implemented by subclasses.
-        """
-        pass
-
-    @classmethod
-    @abstractmethod
-    def from_params(cls, params) -> MarkdownNode:
-        """
-        Creates an instance from a params object.
-        Must be implemented by subclasses.
-        """
-        pass
-
-    def __str__(self):
-        return self.to_markdown()

notionary/page/writer/markdown_to_notion_formatting_post_processor.py

@@ -1,73 +0,0 @@
-"""
-Post-processor for handling block formatting in Markdown to Notion conversion.
-
-Handles block formatting tasks like adding empty paragraphs before media blocks
-and other formatting-related post-processing.
-"""
-
-from typing import cast
-
-from notionary.blocks.models import BlockCreateRequest
-from notionary.blocks.types import BlockType
-from notionary.blocks.paragraph.paragraph_models import (
-    CreateParagraphBlock,
-    ParagraphBlock,
-)
-
-
-class MarkdownToNotionFormattingPostProcessor:
-    """Handles block formatting post-processing for Notion blocks."""
-
-    BLOCKS_NEEDING_EMPTY_PARAGRAPH: set[BlockType] = {
-        BlockType.DIVIDER,
-        BlockType.FILE,
-        BlockType.IMAGE,
-        BlockType.PDF,
-        BlockType.VIDEO,
-    }
-
-    def process(self, blocks: list[BlockCreateRequest]) -> list[BlockCreateRequest]:
-        """Process blocks with all formatting steps."""
-        if not blocks:
-            return blocks
-
-        return self._add_empty_paragraphs_for_media_blocks(blocks)
-
-    def _add_empty_paragraphs_for_media_blocks(
-        self, blocks: list[BlockCreateRequest]
-    ) -> list[BlockCreateRequest]:
-        """Add empty paragraphs before configured block types."""
-        if not blocks:
-            return blocks
-
-        result: list[BlockCreateRequest] = []
-
-        for i, block in enumerate(blocks):
-            block_type = block.type
-
-            if (
-                block_type in self.BLOCKS_NEEDING_EMPTY_PARAGRAPH
-                and i > 0
-                and not self._is_empty_paragraph(result[-1] if result else None)
-            ):
-
-                # Create empty paragraph block inline
-                empty_paragraph = CreateParagraphBlock(
-                    paragraph=ParagraphBlock(rich_text=[])
-                )
-                result.append(empty_paragraph)
-
-            result.append(block)
-
-        return result
-
-    def _is_empty_paragraph(self, block: BlockCreateRequest | None) -> bool:
-        if not block or block.type != BlockType.PARAGRAPH:
-            return False
-        if not isinstance(block, CreateParagraphBlock):
-            return False
-
-        para_block = cast(CreateParagraphBlock, block)
-        paragraph: ParagraphBlock | None = para_block.paragraph
-        if not paragraph:
-            return False

notionary-0.2.23.dist-info/METADATA

@@ -1,235 +0,0 @@
-Metadata-Version: 2.3
-Name: notionary
-Version: 0.2.23
-Summary: Python library for programmatic Notion workspace management - databases, pages, and content with advanced Markdown support
-License: MIT
-Author: Mathis Arends
-Author-email: mathisarends27@gmail.com
-Requires-Python: >=3.9
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
-Requires-Dist: httpx (>=0.28.0)
-Requires-Dist: posthog (>=6.3.1,<7.0.0)
-Requires-Dist: pydantic (>=2.11.4)
-Requires-Dist: python-dotenv (>=1.1.0)
-Project-URL: Homepage, https://github.com/mathisarends/notionary
-Description-Content-Type: text/markdown
-
-<picture>
-  <source media="(prefers-color-scheme: dark)" srcset="./static/notionary-dark.png">
-  <source media="(prefers-color-scheme: light)" srcset="./static/notionary-light.png">
-  <img alt="Notionary logo: dark mode shows a white logo, light mode shows a black logo." src="./static/browser-use.png"  width="full">
-</picture>
-
-<h1 align="center">Notion API simplified for Python developers 🐍</h1>
-
-<div align="center">
-
-[![Python Version](https://img.shields.io/badge/python-3.8%2B-blue.svg)](https://www.python.org/downloads/)
-[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
-[![Documentation](https://img.shields.io/badge/docs-mathisarends.github.io-blue.svg)](https://mathisarends.github.io/notionary/)
-
-Transform complex Notion API interactions into simple, Pythonic code. Build AI agents, automate workflows, and create dynamic content with ease.
-
-</div>
-
----
-
-## Why Notionary?
-
-- **Smart Discovery**: Find pages and databases by name—no more hunting for URLs or IDs
-- **Rich Markdown**: Convert extended Markdown (callouts, toggles, columns) directly into beautiful Notion blocks
-- **Async-First**: Built for modern Python with full async/await support and high performance
-- **AI-Ready**: Perfect foundation for AI agents that generate and manage Notion content
-- **Round-Trip**: Read existing content, modify it, and write it back while preserving formatting
-
----
-
-## Quick Start
-
-```bash
-pip install notionary
-```
-
-Set up your [Notion integration](https://www.notion.so/profile/integrations) and add your token:
-
-```bash
-NOTION_SECRET=your_integration_key
-```
-
-### Simple Flow: Find → Create → Update
-
-```python
-import asyncio
-from notionary import NotionPage, NotionDatabase
-
-async def main():
-    # Work with pages - find by name, no exact match needed!
-    page = await NotionPage.from_page_name("Meeting Notes")
-
-    # Direct Markdown - quick & intuitive
-    await page.append_markdown("""
-    ## Action Items
-    - Review project proposal
-    - Schedule team meeting
-    - Update documentation
-
-    [callout](Important meeting decisions require follow-up "💡")
-    """)
-
-    # Builder Pattern - type-safe & powerful for complex layouts
-    await page.append_markdown(lambda builder: (
-        builder
-        .h2("Project Status")
-        .callout("Project milestone reached!", "🎉")
-        .columns(
-            lambda col: (col
-                .h3("Completed")
-                .bulleted_list(["API design", "Database setup", "Authentication"])
-            ),
-            lambda col: (col
-                .h3("In Progress")
-                .bulleted_list(["Frontend UI", "Testing", "Documentation"])
-            )
-        )
-        .table(
-            headers=["Task", "Owner", "Due Date"],
-            rows=[
-                ["Launch prep", "Alice", "2024-03-15"],
-                ["Marketing", "Bob", "2024-03-20"]
-            ]
-        )
-    ))
-
-asyncio.run(main())
-```
-
-### Create Rich Database Entries
-
-```python
-# Work with databases - connect and create styled entries
-db = await NotionDatabase.from_database_name("Projects")
-
-# Create new project with full styling
-project = await db.create_blank_page()
-await project.set_title("New Marketing Campaign")
-await project.set_emoji_icon("🚀")
-await project.set_random_gradient_cover()
-
-# Set database properties
-await project.set_property_value_by_name("Status", "Planning")
-await project.set_property_value_by_name("Priority", "High")
-await project.set_property_value_by_name("Team Lead", "sarah@company.com")
-
-# Add rich content to the new page
-await project.replace_content(lambda builder: (
-    builder
-    .h1("Campaign Overview")
-    .callout("New marketing initiative targeting Q2 growth", "🎯")
-    .h2("Goals & Objectives")
-    .numbered_list([
-        "Increase brand awareness by 25%",
-        "Generate 500 qualified leads",
-        "Launch in 3 target markets"
-    ])
-    .h2("Budget Breakdown")
-    .table(
-        headers=["Category", "Allocated", "Spent", "Remaining"],
-        rows=[
-            ["Digital Ads", "$15,000", "$3,200", "$11,800"],
-            ["Content Creation", "$8,000", "$1,500", "$6,500"],
-            ["Events", "$12,000", "$0", "$12,000"]
-        ]
-    )
-    .divider()
-    .toggle("Technical Requirements", lambda toggle: (
-        toggle
-        .paragraph("Platform specifications and integration details.")
-        .bulleted_list([
-            "CRM integration with Salesforce",
-            "Analytics tracking setup",
-            "Landing page development"
-        ])
-    ))
-))
-
-print(f"✅ Created styled project: {project.url}")
-```
-
-### Extended Markdown Syntax
-
-Notionary supports rich formatting with callouts, toggles, multi-column layouts, tables, media embeds, and more. Use either direct markdown syntax or the type-safe builder pattern.
-
-See the complete [Block Types documentation](https://mathisarends.github.io/notionary/blocks/) for all available formatting options and syntax examples.
-
-## What You Can Build
-
-- **AI Content Generation** - Perfect for AI agents that create structured reports and documentation
-- **Workflow Automation** - Update project status, sync data between databases, generate reports
-- **Dynamic Documentation** - Auto-generate team docs, API references, and knowledge bases
-- **Content Management** - Bulk page updates, template generation, and content migration
-
-## Core Features
-
-| Feature              | Description                                            |
-| -------------------- | ------------------------------------------------------ |
-| **Smart Discovery**  | Find pages/databases by name with fuzzy matching       |
-| **Rich Markdown**    | Extended syntax for callouts, toggles, columns, tables |
-| **Async-First**      | Modern Python with full async/await support            |
-| **Round-Trip**       | Read content as markdown, edit, and write back         |
-| **AI-Ready**         | Generate system prompts for AI content creation        |
-| **All Block Types**  | Support for every Notion block type                    |
-| **Type Safety**      | Full type hints for better IDE support                 |
-| **High Performance** | Efficient batch operations and caching                 |
-
-## Examples & Documentation
-
-Explore comprehensive guides and real-world examples:
-
-- **[📖 Full Documentation](https://mathisarends.github.io/notionary/)** - Complete API reference and guides
-- **[Getting Started](https://mathisarends.github.io/notionary/get-started/)** - Quick setup and first steps
-- **[Page Management](https://mathisarends.github.io/notionary/page/)** - Work with page content and properties
-- **[Database Operations](https://mathisarends.github.io/notionary/database/)** - Query and manage databases
-- **[Block Types](https://mathisarends.github.io/notionary/blocks/)** - Complete formatting reference
-
-Check out the `examples/` directory for hands-on tutorials:
-
-### Core Examples
-
-- **[Page Management](examples/page_example.py)** - Create, update, and manage pages
-- **[Database Operations](examples/database.py)** - Connect to and query databases
-- **[Workspace Discovery](examples/workspace_discovery.py)** - Explore your workspace
-
-### Markdown Examples
-
-- **[Basic Formatting](examples/markdown/basic.py)** - Text, lists, and links
-- **[Callouts](examples/markdown/callout.py)** - Eye-catching information boxes
-- **[Toggles](examples/markdown/toggle.py)** - Collapsible content sections
-- **[Multi-Column](examples/markdown/columns.py)** - Side-by-side layouts
-- **[Tables](examples/markdown/table.py)** - Structured data presentation
-
-## Contributing
-
-We'd love your help making Notionary even better!
-
-Whether it's fixing bugs, adding features, improving docs, or sharing examples - all contributions are welcome.
-
-See our [Contributing Guide](https://mathisarends.github.io/notionary/contributing/) to get started.
-
----
-
-<div align="center">
-
-**Ready to transform your Notion workflow?**
-
-[📖 Read the Docs](https://mathisarends.github.io/notionary/) • [Getting Started](https://mathisarends.github.io/notionary/get-started/) • [Examples](examples/)
-
-Built with ❤️ for the Python community
-
-</div>
-