notionary 0.2.3__py3-none-any.whl → 0.2.5__py3-none-any.whl

notionary/elements/code_block_element.py

@@ -114,14 +114,6 @@ class CodeBlockElement(NotionBlockElement):
                         {
                             "type": "text",
                             "text": {"content": content},
-                            "annotations": {
-                                "bold": False,
-                                "italic": False,
-                                "strikethrough": False,
-                                "underline": False,
-                                "code": False,
-                                "color": "default",
-                            },
                             "plain_text": content,
                         }
                     ],

notionary/page/content/page_content_retriever.py

@@ -25,6 +25,7 @@ class PageContentRetriever(LoggingMixin):
 
     async def get_page_content(self) -> str:
         blocks = await self._get_page_blocks_with_children()
+        print("blocks", json.dumps(blocks, indent=2))
         return self._notion_to_markdown_converter.convert(blocks)
 
     async def _get_page_blocks_with_children(

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,29 +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_file = Path(__file__).resolve()
-        current_dir = current_file.parent
-        template_path = current_dir / "res" / "notion_syntax_prompt.md"
-
-        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}\n"
-                f"Current working directory: {os.getcwd()}\n"
-                f"Script location: {current_file}"
-            )
-        except Exception as e:
-            raise RuntimeError(f"Error loading template file: {e}")
+    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.
+
+    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:
@@ -91,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.3.dist-info → notionary-0.2.5.dist-info}/METADATA

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

{notionary-0.2.3.dist-info → notionary-0.2.5.dist-info}/RECORD

@@ -8,7 +8,7 @@ notionary/elements/audio_element.py,sha256=7bEpFl9jA6S1UZlEXsmFzEUVoViEp1o_7zZIC
 notionary/elements/bookmark_element.py,sha256=msCtZvuPkIj1kiShNwE8i1GDYwamFb5mwRyZm4XyVY4,8145
 notionary/elements/bulleted_list_element.py,sha256=obsb3JqUNET3uS5OZM3yzDqxSzJzUuEob-Fzx0UIg9Y,2664
 notionary/elements/callout_element.py,sha256=ZsRvRtVy9kxdTwgrB5JGjZ4qcCiwcC0WimWJ_cW0aLY,4492
-notionary/elements/code_block_element.py,sha256=IbwpptMLtHDFO0Hyvt2o0p5AZ0S4vhxfzoBhTqKexSY,6240
+notionary/elements/code_block_element.py,sha256=Zy5l8bsX2R1QBgmCZDM_tkxzSXylHABshKY8r0kNBBo,5853
 notionary/elements/divider_element.py,sha256=0e10YK-CC8uGuL7921dEIjeJK9ha-WhRIYRf2fFuxVQ,2211
 notionary/elements/embed_element.py,sha256=Zcc18Kl8SGoG98P2aYE0TkBviRvSz-sYOdjMEs-tvgk,4579
 notionary/elements/heading_element.py,sha256=kqgjyfaawEODir2tzDyf7-7wm38DbqoZnsH5k94GsA0,3013
@@ -36,7 +36,7 @@ notionary/page/notion_page.py,sha256=NDxAJaNk4tlKUrenhKBdnuvjlVgnxC0Z6fprf2LyNeE
 notionary/page/notion_page_factory.py,sha256=2A3M5Ub_kV2-q7PPRqDgfwBjhkGCwtL5i3Kr2RfvvVo,7213
 notionary/page/notion_to_markdown_converter.py,sha256=vUQss0J7LUFLULGvW27PjaTFuWi8OsRQAUBowSYorkM,6408
 notionary/page/content/notion_page_content_chunker.py,sha256=xRks74Dqec-De6-AVTxMPnXs-MSJBzSm1HfJfaHiKr8,3330
-notionary/page/content/page_content_retriever.py,sha256=btVWarx06KZ2A2ZRxNpNEvkeYwyyI2tnM8dKWSkiQGQ,2235
+notionary/page/content/page_content_retriever.py,sha256=i6y4Q3_5EIzsd6HRgO3G-v1STZs1060OJe5DFkZi-QI,2290
 notionary/page/content/page_content_writer.py,sha256=czBzNCGcwdpqNLSQPyna1s8Y7pjyPzDgJC3UUK5PLGA,3793
 notionary/page/metadata/metadata_editor.py,sha256=HI7m8Zn_Lz6x36rBnW1EnbicVS-4Q8NmCJYKN-OlY-c,5130
 notionary/page/metadata/notion_icon_manager.py,sha256=6a9GS5sT0trfuAb0hlF2Cw_Wc1oM59a1QA4kO9asvMA,2576
@@ -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=N6t9FHS_4IP9L5-zFpTM6iS7E-QJvoe7muPwEnF3UgQ,3352
+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.3.dist-info/licenses/LICENSE,sha256=zOm3cRT1qD49eg7vgw95MI79rpUAZa1kRBFwL2FkAr8,1120
-notionary-0.2.3.dist-info/METADATA,sha256=5GDY-SZ4tVpUd_3KdQo6jNWMc7PCv4sQWHuAhnL3ALs,8374
-notionary-0.2.3.dist-info/WHEEL,sha256=DnLRTWE75wApRYVsjgc6wsVswC54sMSJhAEd4xhDpBk,91
-notionary-0.2.3.dist-info/top_level.txt,sha256=fhONa6BMHQXqthx5PanWGbPL0b8rdFqhrJKVLf_adSs,10
-notionary-0.2.3.dist-info/RECORD,,
+notionary-0.2.5.dist-info/licenses/LICENSE,sha256=zOm3cRT1qD49eg7vgw95MI79rpUAZa1kRBFwL2FkAr8,1120
+notionary-0.2.5.dist-info/METADATA,sha256=QT7PBlbv3Qu6BqzamzrxZnf28zwZp43_IgBa4F3uCwo,8374
+notionary-0.2.5.dist-info/WHEEL,sha256=DnLRTWE75wApRYVsjgc6wsVswC54sMSJhAEd4xhDpBk,91
+notionary-0.2.5.dist-info/top_level.txt,sha256=fhONa6BMHQXqthx5PanWGbPL0b8rdFqhrJKVLf_adSs,10
+notionary-0.2.5.dist-info/RECORD,,