notionary 0.2.2__py3-none-any.whl → 0.2.4__py3-none-any.whl

notionary/elements/registry/block_registry_builder.py

@@ -67,7 +67,7 @@ class BlockRegistryBuilder:
             .with_paragraphs()
             .with_toggleable_heading_element()
         ).build()
-        
+
     @classmethod
     def create_minimal_registry(cls) -> BlockRegistry:
         """

notionary/models/notion_database_response.py

@@ -1,4 +1,3 @@
-
 from pydantic import BaseModel
 from dataclasses import dataclass
 from typing import Optional, List, Dict, Any, Literal
@@ -55,4 +54,4 @@ class NotionDatabaseResponse(BaseModel):
     public_url: Optional[str]
     archived: bool
     in_trash: bool
-    request_id: Optional[str] = None
+    request_id: Optional[str] = None

notionary/notion_client.py

@@ -69,8 +69,6 @@ class NotionClient(LoggingMixin):
         """
         return await self._make_request(HttpMethod.GET, endpoint)
 
-    # TODO: Get Blocks implementeren und Patch Blcoks hierfür das Typing finden:
-
     async def get_database(self, database_id: str) -> NotionDatabaseResponse:
         """
         Ruft die Metadaten einer Notion-Datenbank anhand ihrer ID ab und gibt sie als NotionPageResponse zurück.

notionary/prompting/markdown_syntax_prompt_generator.py

@@ -1,5 +1,4 @@
-import os
-from pathlib import Path
+from textwrap import dedent
 from typing import Type, List
 from notionary.elements.notion_block_element import NotionBlockElement
 
@@ -12,24 +11,46 @@ class MarkdownSyntaxPromptGenerator:
     and formats them optimally for LLMs.
     """
 
-    def __init__(self):
-        # Lade das Template aus der Markdown-Datei
-        self.SYSTEM_PROMPT_TEMPLATE = self._load_template()
-
-    def _load_template(self) -> str:
-        """
-        Lädt das Prompt-Template aus der Markdown-Datei.
+    SYSTEM_PROMPT_TEMPLATE = dedent(
         """
-        current_dir = Path(__file__).parent
-        template_path = current_dir /  "res/notion_syntax_prompt.md"
+    You are a knowledgeable assistant that helps users create content for Notion pages.
+    Notion supports standard Markdown with some special extensions for creating rich content.
+
+    # Understanding Notion Blocks
+
+    Notion documents are composed of individual blocks. Each block has a specific type (paragraph, heading, list item, etc.) and format.
+    The Markdown syntax you use directly maps to these Notion blocks.
+
+    {element_docs}
+
+    CRITICAL USAGE GUIDELINES:
+
+    1. Do NOT start content with a level 1 heading (# Heading). In Notion, the page title is already displayed in the metadata, so starting with an H1 heading is redundant. Begin with H2 (## Heading) or lower for section headings.
+
+    2. INLINE FORMATTING - VERY IMPORTANT:
+    ✅ You can use inline formatting within almost any block type.
+    ✅ Combine **bold**, _italic_, `code`, and other formatting as needed.
+    ✅ Format text to create visual hierarchy and emphasize important points.
+    ❌ DO NOT overuse formatting - be strategic with formatting for best readability.
+
+    3. BACKTICK HANDLING - EXTREMELY IMPORTANT:
+    ❌ NEVER wrap entire content or responses in triple backticks (```).
+    ❌ DO NOT use triple backticks (```) for anything except CODE BLOCKS or DIAGRAMS.
+    ❌ DO NOT use triple backticks to mark or highlight regular text or examples.
+    ✅ USE triple backticks ONLY for actual programming code, pseudocode, or specialized notation.
+    ✅ For inline code, use single backticks (`code`).
+    ✅ When showing Markdown syntax examples, use inline code formatting with single backticks.
+
+    4. BLOCK SEPARATION - IMPORTANT:
+    ✅ Use empty lines between different blocks to ensure proper rendering in Notion.
+    ✅ For major logical sections, use the spacer element (see documentation below).
+    ⚠️ While headings can sometimes work without an empty line before the following paragraph, including empty lines between all block types ensures consistent rendering.
 
-        try:
-            with open(template_path, "r", encoding="utf-8") as file:
-                return file.read()
-        except FileNotFoundError:
-            raise FileNotFoundError(f"Template file not found at {template_path}")
-        except Exception as e:
-            raise RuntimeError(f"Error loading template file: {e}")
+    5. CONTENT FORMATTING - CRITICAL:
+    ❌ DO NOT include introductory phrases like "I understand that..." or "Here's the content...".
+    ✅ Provide ONLY the requested content directly without any prefacing text or meta-commentary.
+    ✅ Generate just the content itself, formatted according to these guidelines."""
+    )
 
     @staticmethod
     def generate_element_doc(element_class: Type[NotionBlockElement]) -> str:
@@ -86,7 +107,5 @@ class MarkdownSyntaxPromptGenerator:
         """
         Generates a complete system prompt for LLMs.
         """
-        # Erstelle eine Instanz, um das Template zu laden
-        instance = cls()
         element_docs = cls.generate_element_docs(element_classes)
-        return instance.SYSTEM_PROMPT_TEMPLATE.format(element_docs=element_docs)
+        return cls.SYSTEM_PROMPT_TEMPLATE.format(element_docs=element_docs)

{notionary-0.2.2.dist-info → notionary-0.2.4.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: notionary
-Version: 0.2.2
+Version: 0.2.4
 Summary: A toolkit to convert between Markdown and Notion blocks
 Home-page: https://github.com/mathisarends/notionary
 Author: Mathis Arends

{notionary-0.2.2.dist-info → notionary-0.2.4.dist-info}/RECORD

@@ -1,5 +1,5 @@
 notionary/__init__.py,sha256=hPvZ-iqt5R_dAs9KaRBhC5eXzuQ5uvt-9EaU2O_7bZw,691
-notionary/notion_client.py,sha256=1TfXiEg9ixE_ZT9iL6zSs7WphOoNlEQmTsaJAt6P3hA,7410
+notionary/notion_client.py,sha256=O-lvy2-jMNSDc_8cWKuGVfckCdc1_PiQOlfxQKjQ6_A,7325
 notionary/database/database_discovery.py,sha256=qDGFhXG9s-_6CXdRg8tMiwX4dvX7jLjgAUFPSNlYtlI,4506
 notionary/database/notion_database.py,sha256=zbHPejETr101pprd7kewZ555d_TONN_wJi7b9Eyfoyg,7634
 notionary/database/notion_database_factory.py,sha256=FmijGYz6A4mCWVionOg9sxgFXfb9he52xdgNswJw24k,6584
@@ -25,11 +25,11 @@ notionary/elements/toggle_element.py,sha256=h9vYkkAIUHzn-0mu31qC6UPdlk_0EFIsU5A4
 notionary/elements/toggleable_heading_element.py,sha256=XdaPsd8anufwAACL8J-Egd_RcqPqZ1gFlzeol1GOyyc,9960
 notionary/elements/video_element.py,sha256=y0OmOYXdQBc2rSYAHRmA4l4rzNqPnyhuXbEipcgzQgY,5727
 notionary/elements/registry/block_registry.py,sha256=giWGcdgc3Z60wvfUr-FS6UMc-k-Q6DlXO8T0gl4fVC8,5027
-notionary/elements/registry/block_registry_builder.py,sha256=5dQhWiJ7jsyKUin1y7r-1Cmp0oOEAIfh6g91w8O4ydI,9319
+notionary/elements/registry/block_registry_builder.py,sha256=Wnob3PbgzVAoXBW0Eon1KzX4aD4d36KeaDe_uYIKFnU,9311
 notionary/exceptions/database_exceptions.py,sha256=I-Tx6bYRLpi5pjGPtbT-Mqxvz3BFgYTiuZxknJeLxtI,2638
 notionary/exceptions/page_creation_exception.py,sha256=4v7IuZD6GsQLrqhDLriGjuG3ML638gAO53zDCrLePuU,281
 notionary/models/notion_block_response.py,sha256=gzL4C6K9QPcaMS6NbAZaRceSEnMbNwYBVVzxysza5VU,6002
-notionary/models/notion_database_response.py,sha256=k-IRInJPN63vAWpg3MKO6Oc7594V5vG6ljjOKvSMxp8,1213
+notionary/models/notion_database_response.py,sha256=FMAasQP20S12J_KMdMlNpcHHwxFKX2YtbE4Q9xn-ruQ,1213
 notionary/models/notion_page_response.py,sha256=r4fwMwwDocj92JdbSmyrzIqBKsnEaz4aDUiPabrg9BM,1762
 notionary/page/markdown_to_notion_converter.py,sha256=EuqUGNv2HZu67INOnGheeJkt7WHTWGuLnhEG72_Wv5Y,15833
 notionary/page/notion_page.py,sha256=NDxAJaNk4tlKUrenhKBdnuvjlVgnxC0Z6fprf2LyNeE,18046
@@ -49,12 +49,12 @@ notionary/page/relations/notion_page_relation_manager.py,sha256=tfkvLHClaYel_uEa
 notionary/page/relations/notion_page_title_resolver.py,sha256=dIjiEeHjjNT-DrIhz1nynkfHkMpUuJJFOEjb25Wy7f4,3575
 notionary/page/relations/page_database_relation.py,sha256=8lEp8fQjPwjWhA8nZu3k8mW6EEc54ki1Uwf4iUV1DOU,2245
 notionary/prompting/element_prompt_content.py,sha256=tHref-SKA81Ua_IQD2Km7y7BvFtHl74haSIjHNYE3FE,4403
-notionary/prompting/markdown_syntax_prompt_generator.py,sha256=xKzTF62SFKzadyC7FHcOxWueRzkKiJ054pBHu9B4aLg,3155
+notionary/prompting/markdown_syntax_prompt_generator.py,sha256=0hD2DZDDjQ3ZKHPvZnDKpUs6Puq5O_E2IGW1te1R6v4,4751
 notionary/util/logging_mixin.py,sha256=b6wHj0IoVSWXbHh0yynfJlwvIR33G2qmaGNzrqyb7Gs,1825
 notionary/util/page_id_utils.py,sha256=EYNMxgf-7ghzL5K8lKZBZfW7g5CsdY0Xuj4IYmU8RPk,1381
 notionary/util/warn_direct_constructor_usage.py,sha256=vyJR73F95XVSRWIbyij-82IGOpAne9SBPM25eDpZfSU,1715
-notionary-0.2.2.dist-info/licenses/LICENSE,sha256=zOm3cRT1qD49eg7vgw95MI79rpUAZa1kRBFwL2FkAr8,1120
-notionary-0.2.2.dist-info/METADATA,sha256=O_A1Bnrg57G52QbqcILdspn6hi-juDA2_qaw9oavQ9g,8374
-notionary-0.2.2.dist-info/WHEEL,sha256=DnLRTWE75wApRYVsjgc6wsVswC54sMSJhAEd4xhDpBk,91
-notionary-0.2.2.dist-info/top_level.txt,sha256=fhONa6BMHQXqthx5PanWGbPL0b8rdFqhrJKVLf_adSs,10
-notionary-0.2.2.dist-info/RECORD,,
+notionary-0.2.4.dist-info/licenses/LICENSE,sha256=zOm3cRT1qD49eg7vgw95MI79rpUAZa1kRBFwL2FkAr8,1120
+notionary-0.2.4.dist-info/METADATA,sha256=g51EGI7BvjxmUuUOcrzC9XjS-lYTkKqndxuWp-FZBuY,8374
+notionary-0.2.4.dist-info/WHEEL,sha256=DnLRTWE75wApRYVsjgc6wsVswC54sMSJhAEd4xhDpBk,91
+notionary-0.2.4.dist-info/top_level.txt,sha256=fhONa6BMHQXqthx5PanWGbPL0b8rdFqhrJKVLf_adSs,10
+notionary-0.2.4.dist-info/RECORD,,