notionary 0.1.21__tar.gz → 0.1.23__tar.gz

{notionary-0.1.21 → notionary-0.1.23}/PKG-INFO

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

{notionary-0.1.21 → notionary-0.1.23}/notionary/elements/code_block_element.py

@@ -155,4 +155,5 @@ class CodeBlockElement(NotionBlockElement):
                 '```json\n{"name": "Alice", "age": 30}\n```',
                 "```mermaid\nflowchart TD\n  A --> B\n```",
             ],
-        }
+            "avoid": "NEVER EVER wrap markdown content with ```markdown. Markdown should be written directly without code block formatting. NEVER use ```markdown under any circumstances."
+        }

{notionary-0.1.21 → notionary-0.1.23}/notionary/elements/prompts/element_prompt_content.py

@@ -1,4 +1,4 @@
-from typing import TypedDict, List
+from typing import NotRequired, TypedDict, List
 
 
 class ElementPromptContent(TypedDict):
@@ -18,3 +18,7 @@ class ElementPromptContent(TypedDict):
 
     when_to_use: str
     """Guidelines explaining the appropriate scenarios for using this element."""
+    
+    avoid: NotRequired[str]
+    """Optional field listing scenarios when this element should be avoided."""
+

{notionary-0.1.21 → notionary-0.1.23}/notionary/elements/prompts/synthax_prompt_builder.py

@@ -15,21 +15,30 @@ Notion supports standard Markdown with some special extensions for creating rich
 
 {element_docs}
 
-Important usage guidelines:
+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. The backtick code fence syntax (```) should ONLY be used when creating actual code blocks or diagrams.
-Do not wrap examples or regular content in backticks unless you're showing code.
+2. 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.
+   ✅ When showing Markdown syntax examples, use inline code formatting with single backticks.
 
 3. Use inline formatting (bold, italic, etc.) across all content to enhance readability.
-Proper typography is essential for creating scannable, well-structured documents.
+   Proper typography is essential for creating scannable, well-structured documents.
 
 4. Notion's extensions to Markdown provide richer formatting options than standard Markdown
-while maintaining the familiar Markdown syntax for basic elements.
+   while maintaining the familiar Markdown syntax for basic elements.
 
 5. Always structure content with clear headings, lists, and paragraphs to create visually appealing
-and well-organized documents.
+   and well-organized documents.
+
+6. 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
@@ -58,8 +67,10 @@ and well-organized documents.
             f"**Example:** {content['examples'][0]}" if content["examples"] else "",
             f"**When to use:** {content['when_to_use']}",
         ]
+        
+        if "avoid" in content and content["avoid"]:
+            doc_parts.append(f"**Avoid:** {content['avoid']}")
 
-        # Filter out any empty parts and join with newlines
         return "\n".join([part for part in doc_parts if part])
 
     @classmethod

{notionary-0.1.21 → notionary-0.1.23}/notionary/elements/registry/block_element_registry.py

@@ -14,7 +14,7 @@ class BlockElementRegistry:
         """
         Initialize a new registry instance.
         """
-        self._elements = []
+        self._elements: List[NotionBlockElement] = []
 
         if elements:
             for element in elements:
@@ -33,6 +33,12 @@ class BlockElementRegistry:
             self._elements.remove(element_class)
             return True
         return False
+    
+    def contains(self, element_class: Type[NotionBlockElement]) -> bool:
+        """
+        Check if the registry contains the specified element class.
+        """
+        return element_class in self._elements
 
     def clear(self):
         """Clear the registry completely."""

{notionary-0.1.21 → notionary-0.1.23}/notionary/page/content/page_content_manager.py

@@ -35,6 +35,7 @@ class PageContentManager(LoggingMixin):
     async def append_markdown(self, markdown_text: str) -> str:
         """
         Append markdown text to a Notion page, automatically handling content length limits.
+        First strips out triple backtick markdown fences if they wrap the entire content.
         """
         try:
             blocks = self._markdown_to_notion_converter.convert(markdown_text)
@@ -171,4 +172,4 @@ class PageContentManager(LoggingMixin):
 
     async def get_text(self) -> str:
         blocks = await self.get_page_blocks_with_children()
-        return self._notion_to_markdown_converter.convert(blocks)
+        return self._notion_to_markdown_converter.convert(blocks)

{notionary-0.1.21 → notionary-0.1.23}/notionary.egg-info/PKG-INFO

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

{notionary-0.1.21 → notionary-0.1.23}/setup.py

@@ -2,7 +2,7 @@ from setuptools import setup, find_namespace_packages
 
 setup(
     name="notionary",
-    version="0.1.21",
+    version="0.1.23",
     packages=find_namespace_packages(include=["notionary*"]),
     install_requires=[
         "httpx>=0.28.0",