notionary 0.2.8__py3-none-any.whl → 0.2.10__py3-none-any.whl

notionary/elements/column_element.py

@@ -2,7 +2,7 @@ import re
 from typing import Dict, Any, Optional, List, Tuple, Callable
 
 from notionary.elements.notion_block_element import NotionBlockElement
-from notionary.prompting.element_prompt_content import ElementPromptContent
+from notionary.prompting.element_prompt_content import ElementPromptBuilder, ElementPromptContent
 
 
 class ColumnElement(NotionBlockElement):
@@ -309,14 +309,19 @@ class ColumnElement(NotionBlockElement):
         """
         Returns structured LLM prompt metadata for the column layout element.
         """
-        return {
-            "description": "Creates a multi-column layout that displays content side by side.",
-            "when_to_use": (
+        return (
+            ElementPromptBuilder()
+            .with_description(
+                "Creates a multi-column layout that displays content side by side."
+            )
+            .with_usage_guidelines(
                 "Use columns sparingly, only for direct comparisons or when parallel presentation significantly improves readability. "
-                "Best for pros/cons lists, feature comparisons, or pairing images with descriptions. "
-                "Avoid overusing as it can complicate document structure."
-            ),
-            "syntax": (
+                "Best for pros/cons lists, feature comparisons, or pairing images with descriptions."
+            )
+            .with_avoidance_guidelines(
+                "Avoid overusing as it can complicate document structure. Do not use for simple content that works better in linear format."
+            )
+            .with_syntax(
                 "::: columns\n"
                 "::: column\n"
                 "Content for first column\n"
@@ -325,8 +330,8 @@ class ColumnElement(NotionBlockElement):
                 "Content for second column\n"
                 ":::\n"
                 ":::"
-            ),
-            "examples": [
+            )
+            .with_examples([
                 "::: columns\n"
                 "::: column\n"
                 "## Features\n"
@@ -341,13 +346,15 @@ class ColumnElement(NotionBlockElement):
                 "- Simplified workflows\n"
                 ":::\n"
                 ":::",
+                
                 "::: columns\n"
                 "::: column\n"
                 "![Image placeholder](/api/placeholder/400/320)\n"
                 ":::\n"
                 "::: column\n"
-                "This text appears next to the image, creating a media-with-caption style layout that's perfect for documentation or articles.\n"
+                "This text appears next to the image, creating a media-with-caption style layout.\n"
                 ":::\n"
-                ":::",
-            ],
-        }
+                ":::"
+            ])
+            .build()
+        )

notionary/page/content/page_content_writer.py

@@ -44,9 +44,9 @@ class PageContentWriter(LoggingMixin):
             )
             append_divider = False
 
-        # Append divider in markdown format as it will be converted to a Notion divider block
+        # Append divider in markdown format as it will be converted to a Notion divider block (eher davor als danach wie ich finde.)
         if append_divider:
-            markdown_text = markdown_text + "\n---"
+            markdown_text = markdown_text + "---\n"
 
         markdown_text = self._process_markdown_whitespace(markdown_text)
 

notionary/page/markdown_to_notion_converter.py

@@ -86,7 +86,6 @@ class MarkdownToNotionConverter:
             result = self._process_line_for_spacers(
                 line,
                 processed_lines,
-                found_first_heading,
                 last_line_was_spacer,
                 last_non_empty_was_heading,
             )
@@ -115,7 +114,6 @@ class MarkdownToNotionConverter:
         self,
         line: str,
         processed_lines: List[str],
-        found_first_heading: bool,
         last_line_was_spacer: bool,
         last_non_empty_was_heading: bool,
     ) -> Dict[str, bool]:
@@ -143,15 +141,21 @@ class MarkdownToNotionConverter:
 
         # Check if line is a heading
         if re.match(self.HEADING_PATTERN, line):
+            # Check if there's content before this heading (excluding spacers)
+            has_content_before = any(
+                processed_line.strip() and processed_line.strip() != self.SPACER_MARKER 
+                for processed_line in processed_lines
+            )
+            
             if (
-                found_first_heading
+                has_content_before
                 and not last_line_was_spacer
                 and not last_non_empty_was_heading
             ):
-                # Add spacer only if:
-                # 1. Not the first heading
-                # 2. Last non-empty line was not a heading
-                # 3. Last line was not already a spacer
+                # Add spacer if:
+                # 1. There's content before this heading
+                # 2. Last line was not already a spacer
+                # 3. Last non-empty line was not a heading
                 processed_lines.append(self.SPACER_MARKER)
                 added_spacer = True
 

notionary/prompting/element_prompt_content.py

@@ -40,7 +40,6 @@ class ElementPromptContent:
         if not self.when_to_use:
             raise ValueError("Usage guidelines are required")
 
-
 class ElementPromptBuilder:
     """
     Builder class for creating ElementPromptContent with a fluent interface.

{notionary-0.2.8.dist-info → notionary-0.2.10.dist-info}/METADATA

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

{notionary-0.2.8.dist-info → notionary-0.2.10.dist-info}/RECORD

@@ -9,7 +9,7 @@ notionary/elements/bookmark_element.py,sha256=msCtZvuPkIj1kiShNwE8i1GDYwamFb5mwR
 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=YHOiV2eQIe7gbsOnrsQnztomTZ-eP3HRHsonzrj3Tt8,7529
-notionary/elements/column_element.py,sha256=pUgu0e2vptvti2Mms_jcivSX0VmeBY9B1asCrVnXrxc,12476
+notionary/elements/column_element.py,sha256=RGLgsL-6et3vJSfU6sTKGKPqRIEMsHqpQxflpEM9RLc,12692
 notionary/elements/divider_element.py,sha256=h6lzk4HITuBwHzxQU967QCWL4F8j2GfEOloWnZ8xs8E,2332
 notionary/elements/embed_element.py,sha256=Zcc18Kl8SGoG98P2aYE0TkBviRvSz-sYOdjMEs-tvgk,4579
 notionary/elements/heading_element.py,sha256=4X8LLhUb2oyfErQ5p-r0bq3wSR6TGSTSQjoVAhVnTO4,3166
@@ -32,13 +32,13 @@ notionary/exceptions/page_creation_exception.py,sha256=4v7IuZD6GsQLrqhDLriGjuG3M
 notionary/models/notion_block_response.py,sha256=gzL4C6K9QPcaMS6NbAZaRceSEnMbNwYBVVzxysza5VU,6002
 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=-IC2yJimrmJ7e5EorV-48V6V12n1VBmsOHKejZxAKCo,20909
+notionary/page/markdown_to_notion_converter.py,sha256=s6ImGEx82QFvqZdpvRq57tFSkr9ouSPEp1Nol1orySE,21136
 notionary/page/notion_page.py,sha256=NDxAJaNk4tlKUrenhKBdnuvjlVgnxC0Z6fprf2LyNeE,18046
 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=f8IU1CIfSTTT07m72-vgpUr_VOCsisqqFHQ1JeOhb3g,2222
-notionary/page/content/page_content_writer.py,sha256=LOn70vFLOzPoCP2vqH922eNEh96B3cNiBuI3eDy8yLA,7439
+notionary/page/content/page_content_writer.py,sha256=RcS5qaU1arENUWhgAhlvAC7qWB74sMxpfGyE15qLdjY,7478
 notionary/page/metadata/metadata_editor.py,sha256=HI7m8Zn_Lz6x36rBnW1EnbicVS-4Q8NmCJYKN-OlY-c,5130
 notionary/page/metadata/notion_icon_manager.py,sha256=6a9GS5sT0trfuAb0hlF2Cw_Wc1oM59a1QA4kO9asvMA,2576
 notionary/page/metadata/notion_page_cover_manager.py,sha256=gHQSA8EtO4gbkMt_C3nKc0DF44SY_4ycd57cJSihdqk,2215
@@ -49,13 +49,13 @@ notionary/page/properites/property_value_extractor.py,sha256=TZIbJXWcA1UQ7FutbGl
 notionary/page/relations/notion_page_relation_manager.py,sha256=tfkvLHClaYel_uEad1PIZ7yzhb2tXS-QrLn1CBvUuuw,11069
 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/element_prompt_content.py,sha256=tBhOL07bKcjC8OK03HcaC5jhFcVBk9cjRfBohKNO8H8,4401
 notionary/prompting/markdown_syntax_prompt_generator.py,sha256=_1qIYlqSfI6q6Fut10t6gGwTQuS8c3QBcC_5DBme9Mo,5084
 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.8.dist-info/licenses/LICENSE,sha256=zOm3cRT1qD49eg7vgw95MI79rpUAZa1kRBFwL2FkAr8,1120
-notionary-0.2.8.dist-info/METADATA,sha256=RtbtcBYg8U9oqX64Tl2VD79bf199uwLZEqVD9QQ2jio,7521
-notionary-0.2.8.dist-info/WHEEL,sha256=zaaOINJESkSfm_4HQVc5ssNzHCPXhJm0kEUakpsEHaU,91
-notionary-0.2.8.dist-info/top_level.txt,sha256=fhONa6BMHQXqthx5PanWGbPL0b8rdFqhrJKVLf_adSs,10
-notionary-0.2.8.dist-info/RECORD,,
+notionary-0.2.10.dist-info/licenses/LICENSE,sha256=zOm3cRT1qD49eg7vgw95MI79rpUAZa1kRBFwL2FkAr8,1120
+notionary-0.2.10.dist-info/METADATA,sha256=PK9wuL7gA-Wi0HySvGYa3XOpd6gcSnZ2qGCuW7_1DzY,7522
+notionary-0.2.10.dist-info/WHEEL,sha256=zaaOINJESkSfm_4HQVc5ssNzHCPXhJm0kEUakpsEHaU,91
+notionary-0.2.10.dist-info/top_level.txt,sha256=fhONa6BMHQXqthx5PanWGbPL0b8rdFqhrJKVLf_adSs,10
+notionary-0.2.10.dist-info/RECORD,,