notionary 0.1.0__tar.gz → 0.1.1__tar.gz

notionary-0.1.1/PKG-INFO

@@ -0,0 +1,214 @@
+Metadata-Version: 2.4
+Name: notionary
+Version: 0.1.1
+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: notion-client>=2.0.0
+Requires-Dist: markdown-it-py>=3.0.0
+Requires-Dist: beautifulsoup4>=4.13.0
+Requires-Dist: httpx>=0.28.0
+Requires-Dist: python-dotenv>=1.1.0
+Requires-Dist: lxml>=5.3.0
+Requires-Dist: attrs>=25.3.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.
+
+## Features
+
+- **Rich Markdown Support**: Write Notion pages using intuitive Markdown syntax with custom extensions
+- **Dynamic Database Operations**: Create, update, and query database entries with schema auto-detection
+- **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==`
+
+### 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.core.database.notion_database_manager import NotionDatabaseManager
+
+async def main():
+    database_id = "1a6389d5-7bd3-8097-aa38-e93cb052615a"
+    db = NotionDatabaseManager(database_id)
+    await db.initialize()
+
+    properties = {
+        "Title": "Created via Notionary",
+        "Description": "This entry was created using Notionary.",
+        "Status": "In Progress",
+        "Priority": "High"
+    }
+
+    result = await db.create_page(properties)
+
+    if result["success"]:
+        page_id = result["page_id"]
+        await db.update_page(page_id, {"Status": "Completed"})
+
+    filter_conditions = {
+        "property": "Status",
+        "status": {"equals": "Completed"}
+    }
+
+    pages = await db.get_pages(limit=10, filter_conditions=filter_conditions)
+
+    await db.close()
+
+if __name__ == "__main__":
+    asyncio.run(main())
+```
+
+## Finding Databases by Name
+
+Use fuzzy matching to find databases:
+
+```python
+from notionary.core.database.notion_database_manager_factory import NotionDatabaseFactory
+
+async def main():
+    db_manager = await NotionDatabaseFactory.from_database_name("Projects")
+    print(f"Found database: {db_manager.title}")
+    await db_manager.close()
+```
+
+## Page Content Management
+
+Create rich Notion pages using enhanced Markdown:
+
+```python
+from notionary.core.page.notion_page_manager import NotionPageManager
+
+async def create_rich_page():
+    url = "https://www.notion.so/Your-Page-1cd389d57bd381e58be9d35ce24adf3d"
+    page_manager = NotionPageManager(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)
+```
+
+## Perfect for AI Agents and Automation
+
+- **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
+
+## Examples
+
+See the `examples` folder for:
+
+- Database discovery and querying
+- Rich page creation with Markdown
+- Entry management
+- Metadata manipulation
+
+## License
+
+MIT
+
+## Contributing
+
+Contributions welcome — feel free to submit a pull request!

notionary-0.1.1/README.md

@@ -0,0 +1,184 @@
+# 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.
+
+## Features
+
+- **Rich Markdown Support**: Write Notion pages using intuitive Markdown syntax with custom extensions
+- **Dynamic Database Operations**: Create, update, and query database entries with schema auto-detection
+- **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==`
+
+### 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.core.database.notion_database_manager import NotionDatabaseManager
+
+async def main():
+    database_id = "1a6389d5-7bd3-8097-aa38-e93cb052615a"
+    db = NotionDatabaseManager(database_id)
+    await db.initialize()
+
+    properties = {
+        "Title": "Created via Notionary",
+        "Description": "This entry was created using Notionary.",
+        "Status": "In Progress",
+        "Priority": "High"
+    }
+
+    result = await db.create_page(properties)
+
+    if result["success"]:
+        page_id = result["page_id"]
+        await db.update_page(page_id, {"Status": "Completed"})
+
+    filter_conditions = {
+        "property": "Status",
+        "status": {"equals": "Completed"}
+    }
+
+    pages = await db.get_pages(limit=10, filter_conditions=filter_conditions)
+
+    await db.close()
+
+if __name__ == "__main__":
+    asyncio.run(main())
+```
+
+## Finding Databases by Name
+
+Use fuzzy matching to find databases:
+
+```python
+from notionary.core.database.notion_database_manager_factory import NotionDatabaseFactory
+
+async def main():
+    db_manager = await NotionDatabaseFactory.from_database_name("Projects")
+    print(f"Found database: {db_manager.title}")
+    await db_manager.close()
+```
+
+## Page Content Management
+
+Create rich Notion pages using enhanced Markdown:
+
+```python
+from notionary.core.page.notion_page_manager import NotionPageManager
+
+async def create_rich_page():
+    url = "https://www.notion.so/Your-Page-1cd389d57bd381e58be9d35ce24adf3d"
+    page_manager = NotionPageManager(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)
+```
+
+## Perfect for AI Agents and Automation
+
+- **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
+
+## Examples
+
+See the `examples` folder for:
+
+- Database discovery and querying
+- Rich page creation with Markdown
+- Entry management
+- Metadata manipulation
+
+## License
+
+MIT
+
+## Contributing
+
+Contributions welcome — feel free to submit a pull request!

notionary-0.1.1/notionary.egg-info/PKG-INFO

@@ -0,0 +1,214 @@
+Metadata-Version: 2.4
+Name: notionary
+Version: 0.1.1
+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: notion-client>=2.0.0
+Requires-Dist: markdown-it-py>=3.0.0
+Requires-Dist: beautifulsoup4>=4.13.0
+Requires-Dist: httpx>=0.28.0
+Requires-Dist: python-dotenv>=1.1.0
+Requires-Dist: lxml>=5.3.0
+Requires-Dist: attrs>=25.3.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.
+
+## Features
+
+- **Rich Markdown Support**: Write Notion pages using intuitive Markdown syntax with custom extensions
+- **Dynamic Database Operations**: Create, update, and query database entries with schema auto-detection
+- **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==`
+
+### 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.core.database.notion_database_manager import NotionDatabaseManager
+
+async def main():
+    database_id = "1a6389d5-7bd3-8097-aa38-e93cb052615a"
+    db = NotionDatabaseManager(database_id)
+    await db.initialize()
+
+    properties = {
+        "Title": "Created via Notionary",
+        "Description": "This entry was created using Notionary.",
+        "Status": "In Progress",
+        "Priority": "High"
+    }
+
+    result = await db.create_page(properties)
+
+    if result["success"]:
+        page_id = result["page_id"]
+        await db.update_page(page_id, {"Status": "Completed"})
+
+    filter_conditions = {
+        "property": "Status",
+        "status": {"equals": "Completed"}
+    }
+
+    pages = await db.get_pages(limit=10, filter_conditions=filter_conditions)
+
+    await db.close()
+
+if __name__ == "__main__":
+    asyncio.run(main())
+```
+
+## Finding Databases by Name
+
+Use fuzzy matching to find databases:
+
+```python
+from notionary.core.database.notion_database_manager_factory import NotionDatabaseFactory
+
+async def main():
+    db_manager = await NotionDatabaseFactory.from_database_name("Projects")
+    print(f"Found database: {db_manager.title}")
+    await db_manager.close()
+```
+
+## Page Content Management
+
+Create rich Notion pages using enhanced Markdown:
+
+```python
+from notionary.core.page.notion_page_manager import NotionPageManager
+
+async def create_rich_page():
+    url = "https://www.notion.so/Your-Page-1cd389d57bd381e58be9d35ce24adf3d"
+    page_manager = NotionPageManager(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)
+```
+
+## Perfect for AI Agents and Automation
+
+- **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
+
+## Examples
+
+See the `examples` folder for:
+
+- Database discovery and querying
+- Rich page creation with Markdown
+- Entry management
+- Metadata manipulation
+
+## License
+
+MIT
+
+## Contributing
+
+Contributions welcome — feel free to submit a pull request!

notionary-0.1.1/setup.py

@@ -0,0 +1,27 @@
+from setuptools import setup, find_packages
+
+setup(
+    name="notionary",
+    version="0.1.1",
+    packages=find_packages(),
+    install_requires=[
+        "notion-client>=2.0.0",
+        "markdown-it-py>=3.0.0",
+        "beautifulsoup4>=4.13.0",
+        "httpx>=0.28.0",
+        "python-dotenv>=1.1.0",
+        "lxml>=5.3.0",
+        "attrs>=25.3.0",
+    ],
+    author="Mathis Arends",
+    author_email="mathisarends27@gmail.com",
+    description="A toolkit to convert between Markdown and Notion blocks",
+    long_description=open("README.md", encoding="utf-8").read(),
+    long_description_content_type="text/markdown",
+    url="https://github.com/mathisarends/notionary",
+    classifiers=[
+        "Programming Language :: Python :: 3",
+        "License :: OSI Approved :: MIT License",
+    ],
+    python_requires=">=3.7",
+)

notionary-0.1.0/PKG-INFO

@@ -1,43 +0,0 @@
-Metadata-Version: 2.4
-Name: notionary
-Version: 0.1.0
-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: notion-client>=2.0.0
-Requires-Dist: markdown-it-py>=3.0.0
-Requires-Dist: beautifulsoup4>=4.13.0
-Requires-Dist: httpx>=0.28.0
-Requires-Dist: python-dotenv>=1.1.0
-Requires-Dist: lxml>=5.3.0
-Requires-Dist: attrs>=25.3.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
-
-**Notionary** is a Python toolkit that enables seamless conversion between **Markdown** and **Notion blocks**, making it easier to build, edit, and format Notion pages programmatically.
-
----
-
-## ✨ Features
-
-- Convert Markdown strings into Notion block structures
-- Convert Notion blocks back into Markdown
-- Register and manage custom Notion block elements
-- Generate LLM-ready prompts to explain your Markdown extensions
-- Support for rich text formatting, inline styles, and block-level elements

notionary-0.1.0/README.md

@@ -1,13 +0,0 @@
-# 🧠 Notionary
-
-**Notionary** is a Python toolkit that enables seamless conversion between **Markdown** and **Notion blocks**, making it easier to build, edit, and format Notion pages programmatically.
-
----
-
-## ✨ Features
-
-- Convert Markdown strings into Notion block structures
-- Convert Notion blocks back into Markdown
-- Register and manage custom Notion block elements
-- Generate LLM-ready prompts to explain your Markdown extensions
-- Support for rich text formatting, inline styles, and block-level elements

notionary-0.1.0/notionary.egg-info/PKG-INFO

@@ -1,43 +0,0 @@
-Metadata-Version: 2.4
-Name: notionary
-Version: 0.1.0
-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: notion-client>=2.0.0
-Requires-Dist: markdown-it-py>=3.0.0
-Requires-Dist: beautifulsoup4>=4.13.0
-Requires-Dist: httpx>=0.28.0
-Requires-Dist: python-dotenv>=1.1.0
-Requires-Dist: lxml>=5.3.0
-Requires-Dist: attrs>=25.3.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
-
-**Notionary** is a Python toolkit that enables seamless conversion between **Markdown** and **Notion blocks**, making it easier to build, edit, and format Notion pages programmatically.
-
----
-
-## ✨ Features
-
-- Convert Markdown strings into Notion block structures
-- Convert Notion blocks back into Markdown
-- Register and manage custom Notion block elements
-- Generate LLM-ready prompts to explain your Markdown extensions
-- Support for rich text formatting, inline styles, and block-level elements

notionary-0.1.0/setup.py

@@ -1,27 +0,0 @@
-from setuptools import setup, find_packages
-
-setup(
-    name='notionary',
-    version='0.1.0',
-    packages=find_packages(),
-    install_requires=[
-        'notion-client>=2.0.0',
-        'markdown-it-py>=3.0.0',
-        'beautifulsoup4>=4.13.0',
-        'httpx>=0.28.0',
-        'python-dotenv>=1.1.0',
-        'lxml>=5.3.0',
-        'attrs>=25.3.0',
-    ],
-    author='Mathis Arends',
-    author_email='mathisarends27@gmail.com',
-    description='A toolkit to convert between Markdown and Notion blocks',
-    long_description=open('README.md').read(),
-    long_description_content_type='text/markdown',
-    url='https://github.com/mathisarends/notionary',
-    classifiers=[
-        'Programming Language :: Python :: 3',
-        'License :: OSI Approved :: MIT License',
-    ],
-    python_requires='>=3.7',
-)