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

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

@@ -1,6 +1,6 @@
 notionary/__init__.py,sha256=hPvZ-iqt5R_dAs9KaRBhC5eXzuQ5uvt-9EaU2O_7bZw,691
 notionary/notion_client.py,sha256=O-lvy2-jMNSDc_8cWKuGVfckCdc1_PiQOlfxQKjQ6_A,7325
-notionary/database/database_discovery.py,sha256=qDGFhXG9s-_6CXdRg8tMiwX4dvX7jLjgAUFPSNlYtlI,4506
+notionary/database/database_discovery.py,sha256=Ebn-9HuNb8fwqf9KP4Vyys8t5zCKUOqBACS_-mohkbk,4498
 notionary/database/notion_database.py,sha256=zbHPejETr101pprd7kewZ555d_TONN_wJi7b9Eyfoyg,7634
 notionary/database/notion_database_factory.py,sha256=FmijGYz6A4mCWVionOg9sxgFXfb9he52xdgNswJw24k,6584
 notionary/database/models/page_result.py,sha256=Vmm5_oYpYAkIIJVoTd1ZZGloeC3cmFLMYP255mAmtaw,233
@@ -8,10 +8,11 @@ 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=Zy5l8bsX2R1QBgmCZDM_tkxzSXylHABshKY8r0kNBBo,5853
-notionary/elements/divider_element.py,sha256=0e10YK-CC8uGuL7921dEIjeJK9ha-WhRIYRf2fFuxVQ,2211
+notionary/elements/code_block_element.py,sha256=YHOiV2eQIe7gbsOnrsQnztomTZ-eP3HRHsonzrj3Tt8,7529
+notionary/elements/column_element.py,sha256=pUgu0e2vptvti2Mms_jcivSX0VmeBY9B1asCrVnXrxc,12476
+notionary/elements/divider_element.py,sha256=h6lzk4HITuBwHzxQU967QCWL4F8j2GfEOloWnZ8xs8E,2332
 notionary/elements/embed_element.py,sha256=Zcc18Kl8SGoG98P2aYE0TkBviRvSz-sYOdjMEs-tvgk,4579
-notionary/elements/heading_element.py,sha256=kqgjyfaawEODir2tzDyf7-7wm38DbqoZnsH5k94GsA0,3013
+notionary/elements/heading_element.py,sha256=4X8LLhUb2oyfErQ5p-r0bq3wSR6TGSTSQjoVAhVnTO4,3166
 notionary/elements/image_element.py,sha256=cwdovaWK8e4uZJU97l_fJ2etAxAgM2rG2EE34t4eag8,4758
 notionary/elements/mention_element.py,sha256=L4t6eAY3RcbOqIiwVT_CAqwatDtP4tBs9FaqRhaCbpQ,8227
 notionary/elements/notion_block_element.py,sha256=BVrZH09vyojuacs3KGReVx3W0Ee6di_5o9E8N5sex28,1258
@@ -24,20 +25,20 @@ notionary/elements/todo_element.py,sha256=ND3oOzSnd0l1AUGTcG2NiHW50ZbI4-atjtNorL
 notionary/elements/toggle_element.py,sha256=h9vYkkAIUHzn-0mu31qC6UPdlk_0EFIsU5A4T_A2ZI8,11082
 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=Wnob3PbgzVAoXBW0Eon1KzX4aD4d36KeaDe_uYIKFnU,9311
+notionary/elements/registry/block_registry.py,sha256=g0id_Q6guzTyNY6HfnB9AjOBvCR4CvtpnUeFAY8kgY0,5027
+notionary/elements/registry/block_registry_builder.py,sha256=5zRKnw2102rAeHpANs6Csu4DVufOazf1peEovChWcgs,9572
 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=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/markdown_to_notion_converter.py,sha256=-IC2yJimrmJ7e5EorV-48V6V12n1VBmsOHKejZxAKCo,20909
 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=czBzNCGcwdpqNLSQPyna1s8Y7pjyPzDgJC3UUK5PLGA,3793
+notionary/page/content/page_content_writer.py,sha256=LOn70vFLOzPoCP2vqH922eNEh96B3cNiBuI3eDy8yLA,7439
 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,12 +50,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=0hD2DZDDjQ3ZKHPvZnDKpUs6Puq5O_E2IGW1te1R6v4,4751
+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.6.dist-info/licenses/LICENSE,sha256=zOm3cRT1qD49eg7vgw95MI79rpUAZa1kRBFwL2FkAr8,1120
-notionary-0.2.6.dist-info/METADATA,sha256=9_QkhSrN2ndPn6BjDjWeIUMUEGXFbObEG4gxsfHYOBI,8374
-notionary-0.2.6.dist-info/WHEEL,sha256=DnLRTWE75wApRYVsjgc6wsVswC54sMSJhAEd4xhDpBk,91
-notionary-0.2.6.dist-info/top_level.txt,sha256=fhONa6BMHQXqthx5PanWGbPL0b8rdFqhrJKVLf_adSs,10
-notionary-0.2.6.dist-info/RECORD,,
+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.6.dist-info → notionary-0.2.8.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (80.4.0)
+Generator: setuptools (80.8.0)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

notionary-0.2.6.dist-info/METADATA

@@ -1,256 +0,0 @@
-Metadata-Version: 2.4
-Name: notionary
-Version: 0.2.6
-Summary: A toolkit to convert between Markdown and Notion blocks
-Home-page: https://github.com/mathisarends/notionary
-Author: Mathis Arends
-Author-email: mathisarends27@gmail.com
-Classifier: Programming Language :: Python :: 3
-Classifier: License :: OSI Approved :: MIT License
-Requires-Python: >=3.7
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: httpx>=0.28.0
-Requires-Dist: python-dotenv>=1.1.0
-Requires-Dist: pydantic>=2.11.4
-Dynamic: author
-Dynamic: author-email
-Dynamic: classifier
-Dynamic: description
-Dynamic: description-content-type
-Dynamic: home-page
-Dynamic: license-file
-Dynamic: requires-dist
-Dynamic: requires-python
-Dynamic: summary
-
-# Notionary 📝
-
-[![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)
-
-**Notionary** is a powerful Python library for interacting with the Notion API, making it easy to create, update, and manage Notion pages and databases programmatically with a clean, intuitive interface. It's specifically designed to be the foundation for AI-driven Notion content generation.
-
-## Features
-
-- **Rich Markdown Support**: Create Notion pages using intuitive Markdown syntax with custom extensions
-- **Dynamic Database Operations**: Create, update, and query database entries with schema auto-detection
-- **Extensible Block Registry**: Add, customize, or remove Notion block elements with a flexible registry pattern
-- **LLM-Ready Prompts**: Generate system prompts explaining Markdown syntax for LLMs to create Notion content
-- **Async-First Design**: Built for modern Python with full async/await support
-- **Schema-Based Validation**: Automatic property validation based on database schemas
-- **Intelligent Content Conversion**: Bidirectional conversion between Markdown and Notion blocks
-
-## Installation
-
-```bash
-pip install notionary
-```
-
-## Custom Markdown Syntax
-
-Notionary extends standard Markdown with special syntax to support Notion-specific features:
-
-### Text Formatting
-
-- Standard Markdown: `**bold**`, `*italic*`, `~~strikethrough~~`, `` `code` ``
-- Highlights: `==highlighted text==`, `==red:warning==`, `==blue:note==`
-
-### Block Elements
-
-#### Callouts
-
-```markdown
-!> [💡] This is a default callout with the light bulb emoji  
-!> [🔔] This is a callout with a bell emoji  
-!> {blue_background} [💧] This is a blue callout with a water drop emoji  
-!> {yellow_background} [⚠️] Warning: This is an important note
-```
-
-#### Toggles
-
-```markdown
-+++ How to use NotionPageManager
-
-1. Initialize with NotionPageManager
-2. Update metadata with set_title(), set_page_icon(), etc.
-3. Add content with replace_content() or append_markdown()
-```
-
-#### Bookmarks
-
-```markdown
-[bookmark](https://notion.so "Notion Homepage" "Your connected workspace")
-```
-
-#### Multi-Column Layouts
-
-```markdown
-::: columns
-::: column
-Content for first column
-:::
-::: column
-Content for second column
-:::
-:::
-```
-
-And more:
-
-- Tables with standard Markdown syntax
-- Code blocks with syntax highlighting
-- To-do lists with `- [ ]` and `- [x]`
-- Block quotes with `>`
-
-## Database Management
-
-Notionary makes it easy to work with Notion databases, automatically handling schema detection and property conversion:
-
-```python
-import asyncio
-from notionary import NotionDatabaseFactory
-
-async def main():
-    # Find database by name with fuzzy matching
-    db_manager = await NotionDatabaseFactory.from_database_name("Projects")
-
-    # Create a new page with properties
-    properties = {
-        "Title": "Created via Notionary",
-        "Status": "In Progress",
-        "Priority": "High"
-    }
-
-    page = await db_manager.create_blank_page()
-
-    # Set page content with rich Markdown
-    await page.set_title("My New Project")
-    await page.set_page_icon(emoji="🚀")
-
-    markdown = """
-    # Project Overview
-
-    !> [💡] This page was created programmatically using Notionary.
-
-    ## Tasks
-    - [ ] Define project scope
-    - [ ] Create timeline
-    - [ ] Assign resources
-
-    +++ Implementation Details
-      This project will use our standard architecture with custom extensions.
-    """
-
-    await page.replace_content(markdown)
-
-if __name__ == "__main__":
-    asyncio.run(main())
-```
-
-## Page Content Management
-
-Create rich Notion pages using enhanced Markdown:
-
-```python
-from notionary import NotionPage
-
-async def create_rich_page():
-    url = "https://www.notion.so/Your-Page-1cd389d57bd381e58be9d35ce24adf3d"
-    page_manager = NotionPage(url=url)
-
-    await page_manager.set_title("Notionary Demo")
-    await page_manager.set_page_icon(emoji="✨")
-    await page_manager.set_page_cover("https://images.unsplash.com/photo-1555066931-4365d14bab8c")
-
-    markdown = '''
-    # Notionary Rich Content Demo
-
-    !> [💡] This page was created with Notionary's custom Markdown syntax.
-
-    ## Features
-    - Easy-to-use Python API
-    - **Rich** Markdown support
-    - Async functionality
-
-    +++ Implementation Details
-      Notionary uses a custom converter to transform Markdown into Notion blocks.
-      This makes it easy to create rich content programmatically.
-    '''
-
-    await page_manager.replace_content(markdown)
-```
-
-## Block Registry & Builder
-
-Notionary uses a flexible registry pattern with a builder to customize which Notion elements are supported, allowing programmatic creation of complex UI layouts that were previously only possible through Notion's UI:
-
-```python
-from notionary import NotionPage
-from notionary.elements.block_element_registry_builder import BlockElementRegistryBuilder
-
-# Create a registry with standard Notion elements
-registry = BlockElementRegistryBuilder.create_full_registry()
-
-# Or build a custom registry with only the elements you need
-custom_registry = (
-    BlockElementRegistryBuilder()
-    .with_headings()
-    .with_callouts()
-    .with_toggles()
-    .with_lists()
-    .with_tables()
-    .with_paragraphs()
-    .build()
-)
-
-# Apply this registry to a page to enable custom Markdown support
-page = NotionPage(url="https://www.notion.so/your-page-url")
-page.block_registry = custom_registry
-
-# Now your page supports exactly the elements you've defined
-await page.replace_content("# Custom heading with only selected elements")
-```
-
-This registry approach gives you granular control over which Notion UI elements can be created through Markdown, making it possible to programmatically construct any page layout that would normally require manual UI interaction.
-
-## AI-Ready LLM Prompt Generation
-
-Notionary can automatically generate comprehensive system prompts for LLMs to understand Notion's custom Markdown syntax:
-
-```python
-from notionary.elements.block_element_registry_builder import BlockElementRegistryBuilder
-
-registry = BlockElementRegistryBuilder.create_full_registry()
-llm_system_prompt = registry.generate_llm_prompt()
-
-# Use this prompt with your LLM to generate Notion-compatible Markdown
-print(llm_system_prompt)
-```
-
-This makes Notionary the perfect foundation for AI-driven Notion content generation, enabling LLMs to create properly formatted Notion pages.
-
-## Examples
-
-See the [examples folder](examples/) for more comprehensive demonstrations:
-
-- [Database discovery and querying](examples/database_discovery_example.py)
-- [Rich page creation with Markdown](examples/page_example.py)
-- [Database factory usage](examples/database_factory_example.py)
-- [Page lookup and access](examples/page_factory_by_url_example.py)
-- [Iterating through database entries](examples/iter_database_example.py)
-
-## Perfect for AI Agents and Automation
-
-- **LLM Integration**: Generate Notion-compatible content with LLMs using the system prompt generator
-- **Dynamic Content Generation**: AI agents can generate content in Markdown and render it as Notion pages
-- **Schema-Aware Operations**: Automatically validate and format properties
-- **Simplified API**: Easier integration with AI workflows
-
-## License
-
-MIT
-
-## Contributing
-
-Contributions welcome — feel free to submit a pull request!