notionary 0.2.13__py3-none-any.whl → 0.2.15__py3-none-any.whl

notionary-0.2.13.dist-info/METADATA

@@ -1,273 +0,0 @@
-Metadata-Version: 2.4
-Name: notionary
-Version: 0.2.13
-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
-Requires-Dist: posthog>=3.0.0
-Requires-Dist: click>=8.0.0
-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
-```
-
----
-
-## Quick Start
-
-### Creating and Managing Pages
-
-```python
-import asyncio
-from notionary import NotionPage
-
-async def main():
-    # Create a page from URL
-    page = NotionPage.from_url("https://www.notion.so/your-page-url")
-
-    # Or find by name
-    page = await NotionPage.from_page_name("My Project Page")
-
-    # Update page metadata
-    await page.set_title("Updated Title")
-    await page.set_emoji_icon("🚀")
-    await page.set_random_gradient_cover()
-
-    # Add markdown content
-    markdown = """
-    # Project Overview
-
-    !> [💡] This page was created programmatically using Notionary.
-
-    ## Features
-    - **Rich** Markdown support
-    - Async functionality
-    - Custom syntax extensions
-
-    +++ Implementation Details
-    | Notionary uses a custom converter to transform Markdown into Notion blocks.
-    | This makes it easy to create rich content programmatically.
-    """
-
-    await page.replace_content(markdown)
-
-if __name__ == "__main__":
-    asyncio.run(main())
-```
-
-### Working with Databases
-
-```python
-import asyncio
-from notionary import NotionDatabase, DatabaseDiscovery
-
-async def main():
-    # Discover available databases
-    discovery = DatabaseDiscovery()
-    await discovery()
-
-    # Connect to a database by name
-    db = await NotionDatabase.from_database_name("Projects")
-
-    # Create a new page in the database
-    page = await db.create_blank_page()
-
-    # Set properties
-    await page.set_property_value_by_name("Status", "In Progress")
-    await page.set_property_value_by_name("Priority", "High")
-
-    # Query pages from database
-    async for page in db.iter_pages():
-        title = await page.get_title()
-        print(f"Page: {title}")
-
-if __name__ == "__main__":
-    asyncio.run(main())
-```
-
-## Custom Markdown Syntax
-
-Notionary extends standard Markdown with special syntax to support Notion-specific features:
-
-### Text Formatting
-
-- Standard: `**bold**`, `*italic*`, `~~strikethrough~~`, `` `code` ``
-- Links: `[text](url)`
-- Quotes: `> This is a quote`
-- Divider: `---`
-
-### Callouts
-
-```markdown
-!> [💡] This is a default callout with the light bulb emoji  
-!> [🔔] This is a notification with a bell emoji  
-!> [⚠️] Warning: This is an important note
-```
-
-### Toggles
-
-```markdown
-+++ How to use Notionary
-| 1. Initialize with NotionPage  
-| 2. Update metadata with set_title(), set_emoji_icon(), etc.  
-| 3. Add content with replace_content() or append_markdown()
-```
-
-### Multi-Column Layout
-
-```markdown
-::: columns
-::: column
-
-## Left Column
-
-- Item 1
-- Item 2
-- Item 3
-  :::
-  ::: column
-
-## Right Column
-
-This text appears in the second column. Multi-column layouts are perfect for:
-
-- Comparing features
-- Creating side-by-side content
-- Improving readability of wide content
-  :::
-  :::
-```
-
-### Code Blocks
-
-```python
-def hello_world():
-    print("Hello from Notionary!")
-```
-
-### To-do Lists
-
-```markdown
-- [ ] Define project scope
-- [x] Create timeline
-- [ ] Assign resources
-```
-
-### Tables
-
-```markdown
-| Feature         | Status      | Priority |
-| --------------- | ----------- | -------- |
-| API Integration | Complete    | High     |
-| Documentation   | In Progress | Medium   |
-```
-
-### More Elements
-
-```markdown
-![Caption](https://example.com/image.jpg)  
-@[Caption](https://youtube.com/watch?v=...)  
-[bookmark](https://example.com "Title" "Description")
-```
-
-## Block Registry & Customization
-
-```python
-from notionary import NotionPage, BlockRegistryBuilder
-
-# Create a custom registry with only the elements you need
-custom_registry = (
-    BlockRegistryBuilder()
-    .with_headings()
-    .with_callouts()
-    .with_toggles()
-    .with_columns()  # Include multi-column support
-    .with_code()
-    .with_todos()
-    .with_paragraphs()
-    .build()
-)
-
-# Apply this registry to a page
-page = NotionPage.from_url("https://www.notion.so/your-page-url")
-page.block_registry = custom_registry
-
-# Replace content using only supported elements
-await page.replace_content("# Custom heading with selected elements only")
-```
-
-## AI-Ready: Generate LLM Prompts
-
-```python
-from notionary import BlockRegistryBuilder
-
-# Create a registry with all standard elements
-registry = BlockRegistryBuilder.create_full_registry()
-
-# Generate the LLM system prompt
-llm_system_prompt = registry.get_notion_markdown_syntax_prompt()
-print(llm_system_prompt)
-```
-
-## Examples
-
-See the `examples/` folder for:
-
-- [Database discovery and querying](examples/database_discovery_example.py)
-- [Rich page creation with Markdown](examples/page_example.py)
-- [Database management](examples/database_management_example.py)
-- [Iterating through database entries](examples/database_iteration_example.py)
-- [Temporary usage & debugging](examples/temp.py)
-
-## Perfect for AI Agents and Automation
-
-- **LLM Integration**: Generate Notion-compatible content with any LLM using the system prompt generator
-- **Dynamic Content Generation**: AI agents can generate content in Markdown and render it directly as Notion pages
-- **Schema-Aware Operations**: Automatically validate and format properties based on database schemas
-- **Simplified API**: Clean, intuitive interface for both human developers and AI systems
-
-## Contributing
-
-Contributions welcome — feel free to submit a pull request!

notionary-0.2.13.dist-info/RECORD

@@ -1,67 +0,0 @@
-notionary/__init__.py,sha256=U7I4nffaEt1Gfg6N7TFupC_GQVZttLhW5u0qjVX7gP4,717
-notionary/notion_client.py,sha256=gkREAr8LkUUKK9cOvq72r8jNjlXDleBP2fYm7LjjbjM,7311
-notionary/cli/main.py,sha256=0tmX9y_xJksKPV8evfUIxp2MTKsHAvNcq76CW4PZCSs,12836
-notionary/cli/onboarding.py,sha256=I7G6eaEw_WWmbfBKBa4nHgItGyZg6iwtEw9pZylsqa4,3376
-notionary/database/database_discovery.py,sha256=l9IjthwdA_Y_k_JXcAW-KnvZDwNYylIbsrQ5cpgtb5w,4484
-notionary/database/notion_database.py,sha256=vbMu8FRao0nXRkSK68Q6637ypiikyMpP2zOmzGWsgpU,7595
-notionary/database/notion_database_factory.py,sha256=6AK9c63R8qyQX46VY-eNL1DufHe6pK_Erka0QEBVO90,6594
-notionary/database/models/page_result.py,sha256=Vmm5_oYpYAkIIJVoTd1ZZGloeC3cmFLMYP255mAmtaw,233
-notionary/elements/audio_element.py,sha256=m1zMUYkpQNPCx9S0KpU85ps7pnm9Pzu4lglKYzOozF4,5343
-notionary/elements/bookmark_element.py,sha256=M_vGJfBVVhUDa7sDfHB622m1Q9wEn4Lw0pCmuDkxpvQ,8143
-notionary/elements/bulleted_list_element.py,sha256=dyWNu28l_fG6fob5zQzMadnWb5g_B2n7ixCHwaniPdE,2662
-notionary/elements/callout_element.py,sha256=OVaRLdxNFXTJnMzmfg3SZClOAYfJ4oORSr_Skm5EOPA,4490
-notionary/elements/code_block_element.py,sha256=hBMn3VpFJLgq12llvdSFkjLX05poMCIZWsBaUF9ZOQA,7527
-notionary/elements/column_element.py,sha256=VpPe2yVvozMFIladOMxMh0Q1nsND_XysYxpxWoIH8eU,12732
-notionary/elements/divider_element.py,sha256=sqfs1YRVqsEFlKdBOX9p8K2Ise2lDb19HwcwHM_R7nU,2330
-notionary/elements/embed_element.py,sha256=PkoaycRel6bAVkP1XHv57vuLVwFmzgeZYKqM5AT8Lg0,4577
-notionary/elements/heading_element.py,sha256=zgqC6alKoaucpeWDpDJd-TIsbMoJzNI5_BGP-D8Xbsc,3166
-notionary/elements/image_element.py,sha256=rd9P9BT9YUwofO24JadH7bMtQCJLxVHdjHF1_ykGS-g,4756
-notionary/elements/mention_element.py,sha256=-AVZ8rn6y-S9Paw-vUDZpa8nhn0dR5L_0qNjd9dQI_s,8225
-notionary/elements/notion_block_element.py,sha256=utWHp_JZSRQgNIWiZfJfzwl7y2ALuDqGTY-Ve3OoQeg,1285
-notionary/elements/numbered_list_element.py,sha256=kgJfQQ5FIKZVRjygd6sLJKkE9-IDlx-MFAEaxWVsg84,2661
-notionary/elements/paragraph_element.py,sha256=oOIRkknpEEAw5Pr81D6c-L6cGRvaZGtggLT3iVYGC4Q,3253
-notionary/elements/qoute_element.py,sha256=SCvNWht-38EwMIsDg19VPajKNc1IhZBP3oVxLQw_yVA,6120
-notionary/elements/table_element.py,sha256=6yTY0fNT_Ae2ncwGQE0CSsfCxGNvnDblTTzd3kdz-Sw,11247
-notionary/elements/text_inline_formatter.py,sha256=q1WePwTxhSkjhTFylcyAbhxaWLo_sjYS3Q_mIPgsKb4,8625
-notionary/elements/todo_element.py,sha256=BKw3KvjdDsZIlSXoqV52z9R-a3KBzkH-9DKo4dN7m9w,4122
-notionary/elements/toggle_element.py,sha256=sg3LfblBRa0pIrcSBHPRknq6FYWB5-mpDGvA7PBOZ9U,11080
-notionary/elements/toggleable_heading_element.py,sha256=sKvjD_x61QYOM4l8gfq6VodpLWqxf8FR2JGWXNeee08,9958
-notionary/elements/video_element.py,sha256=IlB88CmBueYPSFh6p7kxE5zVjcZBQJJ1K953G7kg99M,5725
-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/notion_page.py,sha256=CnEr5S425t7r8n4mZERwShlXsXnR2G7bbYjO8yb2oaU,18032
-notionary/page/notion_page_factory.py,sha256=_dsvxn3xmjZFQw3fKIhnTwiIQfk7p8pxVOFj1GMvBZc,11763
-notionary/page/notion_to_markdown_converter.py,sha256=vUQss0J7LUFLULGvW27PjaTFuWi8OsRQAUBowSYorkM,6408
-notionary/page/content/notion_page_content_chunker.py,sha256=kWJnV9GLU5YLgSVPKOjwMBbG_CMAmVRkuDtwJYb_UAA,3316
-notionary/page/content/page_content_retriever.py,sha256=MoRNwVyBacQEPFu-XseahKEFait0q8tjuhFUXHOBrMo,2208
-notionary/page/content/page_content_writer.py,sha256=PkH3i3sE8zbAUS8dtMbWHwKyq8yubuvzXCzeBZeUFKA,7436
-notionary/page/formatting/markdown_to_notion_converter.py,sha256=-CdGefHdeXtF3TyipOLkyrD6yFJbFDLmZMveoDiYBLo,17463
-notionary/page/formatting/spacer_rules.py,sha256=j2RHvdXT3HxXPVBEuCtulyy9cPxsEcOmj71pJqV-D3M,15677
-notionary/page/metadata/metadata_editor.py,sha256=0I-h5BbLpI_VbAobSdslK8G7TPWoHJb_fAPDtDEOc08,5116
-notionary/page/metadata/notion_icon_manager.py,sha256=_K23i1qsBW052ZuDez5X1l3S9zTRwkRoTnHnoeED98g,2562
-notionary/page/metadata/notion_page_cover_manager.py,sha256=2dQLw890gUGz2nEorAhGNkgLLQNlQKDa1VExABXiUOc,2201
-notionary/page/properites/database_property_service.py,sha256=RWNsze5bImUz4TXVReeFNtNSxlqOylEYS4EOL3bHxdQ,9895
-notionary/page/properites/page_property_manager.py,sha256=1Ga1Qf91yfxaLT55qNJuf5UMz9Z3-8xDZwEHptTqGdM,5729
-notionary/page/properites/property_formatter.py,sha256=k5yFPh87PX5yMaJqZiYjP2ZI8xbxXToYc6PMwNZ8Mpw,3653
-notionary/page/properites/property_value_extractor.py,sha256=5coK0-hSogSLeFL2P337ruGXuHHc447hP_Ry5niOI6M,2342
-notionary/page/relations/notion_page_relation_manager.py,sha256=PiwmOex8I4iR_9T8J0v_W58vS-E_BbTE1fsnnXD3nU4,11055
-notionary/page/relations/notion_page_title_resolver.py,sha256=LN89y-Tc0Rk81TiTeA5WsFqhittLLykdzn3x5Ok29YI,3561
-notionary/page/relations/page_database_relation.py,sha256=nkelofYzfuIFjmM7vR6IGJpWUG9XPmSDnU1WR8WtQrs,2231
-notionary/prompting/element_prompt_content.py,sha256=tHref-SKA81Ua_IQD2Km7y7BvFtHl74haSIjHNYE3FE,4403
-notionary/prompting/markdown_syntax_prompt_generator.py,sha256=_1qIYlqSfI6q6Fut10t6gGwTQuS8c3QBcC_5DBme9Mo,5084
-notionary/util/__init__.py,sha256=ra1jHFFiQNWYDzmVb81OVhtshzkZ0GcLVI8YDODYj3w,235
-notionary/util/logging_mixin.py,sha256=d5sRSmUtgQeuckdNBkO025IXPGe4oOb-7ueVAIP8amU,1846
-notionary/util/page_id_utils.py,sha256=EYNMxgf-7ghzL5K8lKZBZfW7g5CsdY0Xuj4IYmU8RPk,1381
-notionary/util/singleton.py,sha256=CKAvykndwPRZsA3n3MAY_XdCR59MBjjKP0vtm2BcvF0,428
-notionary/util/warn_direct_constructor_usage.py,sha256=vyJR73F95XVSRWIbyij-82IGOpAne9SBPM25eDpZfSU,1715
-notionary-0.2.13.dist-info/licenses/LICENSE,sha256=zOm3cRT1qD49eg7vgw95MI79rpUAZa1kRBFwL2FkAr8,1120
-notionary-0.2.13.dist-info/METADATA,sha256=jXcnz9Gqxx8vFbnLdrLhr_TiByxrWd_OMIxPPqyqHGY,7582
-notionary-0.2.13.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-notionary-0.2.13.dist-info/entry_points.txt,sha256=V7X21u3QNm7h7p6Cx0Sx2SO3mtmA7gVwXM8lNYnv9fk,54
-notionary-0.2.13.dist-info/top_level.txt,sha256=fhONa6BMHQXqthx5PanWGbPL0b8rdFqhrJKVLf_adSs,10
-notionary-0.2.13.dist-info/RECORD,,

notionary-0.2.13.dist-info/entry_points.txt

@@ -1,2 +0,0 @@
-[console_scripts]
-notionary = notionary.cli.main:main

notionary-0.2.13.dist-info/top_level.txt

@@ -1 +0,0 @@
-notionary