notionary 0.2.27__tar.gz → 0.2.28__tar.gz

notionary-0.2.28/.gitignore

@@ -0,0 +1,94 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+temp/
+
+# Virtual environments
+venv/
+env/
+.venv/
+.env/
+
+# Mkdocs
+site/
+
+# Distribution / packaging
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# PyInstaller
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+.hypothesis/
+.pytest_cache/
+
+# Jupyter Notebook checkpoints
+.ipynb_checkpoints
+
+# pyenv
+.python-version
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre
+.pyre/
+
+# Pytype
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# VS Code
+.vscode/
+
+# JetBrains IDEs (PyCharm, etc.)
+.idea/
+
+# MacOS
+.DS_Store
+
+# Windows
+Thumbs.db
+ehthumbs.db
+desktop.ini
+
+# dotenv files
+.env
+
+docs/node_modules/
+
+.ruff_cache/
+bandit-report.json

{notionary-0.2.27 → notionary-0.2.28}/LICENSE

@@ -4,18 +4,18 @@ Copyright (c) 2025 Mathis Kristoffer Arends
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights  
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell  
-copies of the Software, and to permit persons to whom the Software is  
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
 furnished to do so, subject to the following conditions:
 
-The above copyright notice and this permission notice shall be included in  
+The above copyright notice and this permission notice shall be included in
 all copies or substantial portions of the Software.
 
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR  
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,  
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE  
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER  
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN  
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
 THE SOFTWARE.

{notionary-0.2.27 → notionary-0.2.28}/PKG-INFO

@@ -1,24 +1,16 @@
-Metadata-Version: 2.3
+Metadata-Version: 2.4
 Name: notionary
-Version: 0.2.27
+Version: 0.2.28
 Summary: Python library for programmatic Notion workspace management - databases, pages, and content with advanced Markdown support
-License: MIT
-Author: Mathis Arends
-Author-email: mathisarends27@gmail.com
-Requires-Python: >=3.9
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
-Requires-Dist: aiofiles (>=24.1.0,<25.0.0)
-Requires-Dist: httpx (>=0.28.0)
-Requires-Dist: posthog (>=6.3.1,<7.0.0)
-Requires-Dist: pydantic (>=2.11.4)
-Requires-Dist: python-dotenv (>=1.1.0)
 Project-URL: Homepage, https://github.com/mathisarends/notionary
+Author-email: Mathis Arends <mathisarends27@gmail.com>
+License: MIT
+License-File: LICENSE
+Requires-Python: >=3.11
+Requires-Dist: aiofiles<25.0.0,>=24.1.0
+Requires-Dist: httpx>=0.28.0
+Requires-Dist: pydantic>=2.11.4
+Requires-Dist: python-dotenv<2.0.0,>=1.0.1
 Description-Content-Type: text/markdown
 
 <picture>
@@ -35,7 +27,7 @@ Description-Content-Type: text/markdown
 [![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
 [![Documentation](https://img.shields.io/badge/docs-mathisarends.github.io-blue.svg)](https://mathisarends.github.io/notionary/)
 
-**Transform complex Notion API interactions into simple, Pythonic code.**  
+**Transform complex Notion API interactions into simple, Pythonic code.**
 Perfect for developers building AI agents, automation workflows, and dynamic content systems.
 
 </div>
@@ -73,13 +65,13 @@ export NOTION_SECRET=your_integration_key
 
 https://github.com/user-attachments/assets/da8b4691-bee4-4b0f-801e-dccacb630398
 
-*Create styled project pages with properties, content, and rich formatting*
+_Create styled project pages with properties, content, and rich formatting_
 
 ### Local File Uploads (Videos & Images)
 
 https://github.com/user-attachments/assets/a079ec01-bb56-4c65-8260-7b1fca42ac68
 
-*Upload videos and images using simple markdown syntax - files are automatically uploaded to Notion*
+_Upload videos and images using simple markdown syntax - files are automatically uploaded to Notion_
 
 ---
 
@@ -93,33 +85,33 @@ from notionary import NotionPage, NotionDatabase
 
 async def main():
     # Find pages by name - fuzzy matching included!
-    page = await NotionPage.from_page_name("Meeting Notes")
-    
+    page = await NotionPage.from_title("Meeting Notes")
+
     # Option 1: Direct Extended Markdown
     await page.append_markdown("""
     ## Action Items
     - [x] Review project proposal
-    - [ ] Schedule team meeting  
+    - [ ] Schedule team meeting
     - [ ] Update documentation
 
     [callout](Meeting decisions require follow-up "💡")
-    
+
     +++ Details
     Additional context and next steps...
     +++
     """)
-    
+
     # Option 2: Type-Safe Builder (maps to same markdown internally)
     await page.append_markdown(lambda builder: (
         builder
-        .h2("Project Status") 
+        .h2("Project Status")
         .callout("Milestone reached!", "🎉")
         .columns(
             lambda col: col.h3("Completed").bulleted_list([
                 "API design", "Database setup", "Authentication"
             ]),
             lambda col: col.h3("In Progress").bulleted_list([
-                "Frontend UI", "Testing", "Documentation"  
+                "Frontend UI", "Testing", "Documentation"
             ]),
             width_ratios=[0.6, 0.4]
         )
@@ -138,33 +130,36 @@ asyncio.run(main())
 
 Every Notion block type with extended syntax:
 
-| Block Type | Markdown Syntax | Use Case |
-|------------|-----------------|----------|
-| **Callouts** | `[callout](Text "🔥")` | Highlighting key information |
-| **Toggles** | `+++ Title\nContent\n+++` | Collapsible sections |
-| **Columns** | `::: columns\n::: column\nContent\n:::\n:::` | Side-by-side layouts |
-| **Tables** | Standard markdown tables | Structured data |
-| **Media** | `[video](./file.mp4)(caption:Description)` | Auto-uploading files |
-| **Code** | Standard code fences with captions | Code snippets |
-| **Equations** | `$LaTeX$` | Mathematical expressions |
-| **TOC** | `[toc](blue_background)` | Auto-generated navigation |
+| Block Type    | Markdown Syntax                              | Use Case                     |
+| ------------- | -------------------------------------------- | ---------------------------- |
+| **Callouts**  | `[callout](Text "🔥")`                       | Highlighting key information |
+| **Toggles**   | `+++ Title\nContent\n+++`                    | Collapsible sections         |
+| **Columns**   | `::: columns\n::: column\nContent\n:::\n:::` | Side-by-side layouts         |
+| **Tables**    | Standard markdown tables                     | Structured data              |
+| **Media**     | `[video](./file.mp4)(caption:Description)`   | Auto-uploading files         |
+| **Code**      | Standard code fences with captions           | Code snippets                |
+| **Equations** | `$LaTeX$`                                    | Mathematical expressions     |
+| **TOC**       | `[toc](blue_background)`                     | Auto-generated navigation    |
 
 ---
 
 ## What You Can Build 💡
 
 ### **AI Content Systems**
+
 - **Report Generation**: AI agents that create structured reports, documentation, and analysis
 - **Content Pipelines**: Automated workflows that process data and generate Notion pages
 - **Knowledge Management**: AI-powered documentation systems with smart categorization
 
-### **Workflow Automation**  
+### **Workflow Automation**
+
 - **Project Management**: Sync project status, update timelines, generate progress reports
 - **Data Integration**: Connect external APIs and databases to Notion workspaces
 - **Template Systems**: Dynamic page generation from templates and data sources
 
 ### **Content Management**
-- **Bulk Operations**: Mass page updates, content migration, and database management  
+
+- **Bulk Operations**: Mass page updates, content migration, and database management
 - **Media Handling**: Automated image/video uploads with proper organization
 - **Cross-Platform**: Sync content between Notion and other platforms
 
@@ -177,34 +172,40 @@ Every Notion block type with extended syntax:
 <td width="50%">
 
 ### Smart Discovery
+
 - Find pages/databases by name
-- Fuzzy matching for approximate searches  
+- Fuzzy matching for approximate searches
 - No more hunting for IDs or URLs
 
 ### Extended Markdown
+
 - Rich syntax beyond standard markdown
 - Callouts, toggles, columns, media uploads
 - Schema provided for AI agent integration
 
-### Modern Python 
+### Modern Python
+
 - Full async/await support
-- Type hints throughout  
+- Type hints throughout
 - High-performance batch operations
 
 </td>
 <td width="50%">
 
 ### Round-Trip Editing
+
 - Read existing content as markdown
 - Edit and modify preserving formatting
 - Write back to Notion seamlessly
 
 ### AI-Ready Architecture
+
 - Schema-driven syntax for LLM prompts
 - Perfect for AI content generation
 - Handles complex nested structures
 
 ### Complete Coverage
+
 - Every Notion block type supported
 - File uploads with automatic handling
 - Database operations and properties
@@ -218,24 +219,28 @@ Every Notion block type with extended syntax:
 ## Examples & Documentation
 
 ### Full Documentation
+
 [**mathisarends.github.io/notionary**](https://mathisarends.github.io/notionary/) - Complete API reference, guides, and tutorials
 
 ### Quick Links
+
 - [**Getting Started**](https://mathisarends.github.io/notionary/get-started/) - Setup and first steps
-- [**Page Management**](https://mathisarends.github.io/notionary/page/) - Content and properties  
+- [**Page Management**](https://mathisarends.github.io/notionary/page/) - Content and properties
 - [**Database Operations**](https://mathisarends.github.io/notionary/database/) - Queries and management
 - [**Block Types Reference**](https://mathisarends.github.io/notionary/blocks/) - Complete syntax guide
 
 ### Hands-On Examples
 
 **Core Functionality:**
+
 - [Page Management](examples/page_example.py) - Create, update, and manage pages
-- [Database Operations](examples/database.py) - Connect and query databases  
+- [Database Operations](examples/database.py) - Connect and query databases
 - [Workspace Discovery](examples/workspace_discovery.py) - Explore your workspace
 
 **Extended Markdown:**
+
 - [Basic Formatting](examples/markdown/basic.py) - Text, lists, and links
-- [Callouts & Highlights](examples/markdown/callout.py) - Information boxes  
+- [Callouts & Highlights](examples/markdown/callout.py) - Information boxes
 - [Toggle Sections](examples/markdown/toggle.py) - Collapsible content
 - [Multi-Column Layouts](examples/markdown/columns.py) - Side-by-side design
 - [Tables & Data](examples/markdown/table.py) - Structured presentations
@@ -245,8 +250,9 @@ Every Notion block type with extended syntax:
 ## Contributing
 
 We welcome contributions from the community! Whether you're:
+
 - **Fixing bugs** - Help improve stability and reliability
-- **Adding features** - Extend functionality for new use cases  
+- **Adding features** - Extend functionality for new use cases
 - **Improving docs** - Make the library more accessible
 - **Sharing examples** - Show creative applications and patterns
 
@@ -260,11 +266,10 @@ Check our [**Contributing Guide**](https://mathisarends.github.io/notionary/cont
 
 [📖 **Read the Docs**](https://mathisarends.github.io/notionary/) • [🚀 **Getting Started**](https://mathisarends.github.io/notionary/get-started/) • [💻 **Browse Examples**](examples/)
 
-*Built with ❤️ for Python developers and AI agents*
+_Built with ❤️ for Python developers and AI agents_
 
 ---
 
 **Transform complex Notion API interactions into simple, powerful code.**
 
 </div>
-

{notionary-0.2.27 → notionary-0.2.28}/README.md

@@ -12,7 +12,7 @@
 [![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
 [![Documentation](https://img.shields.io/badge/docs-mathisarends.github.io-blue.svg)](https://mathisarends.github.io/notionary/)
 
-**Transform complex Notion API interactions into simple, Pythonic code.**  
+**Transform complex Notion API interactions into simple, Pythonic code.**
 Perfect for developers building AI agents, automation workflows, and dynamic content systems.
 
 </div>
@@ -50,13 +50,13 @@ export NOTION_SECRET=your_integration_key
 
 https://github.com/user-attachments/assets/da8b4691-bee4-4b0f-801e-dccacb630398
 
-*Create styled project pages with properties, content, and rich formatting*
+_Create styled project pages with properties, content, and rich formatting_
 
 ### Local File Uploads (Videos & Images)
 
 https://github.com/user-attachments/assets/a079ec01-bb56-4c65-8260-7b1fca42ac68
 
-*Upload videos and images using simple markdown syntax - files are automatically uploaded to Notion*
+_Upload videos and images using simple markdown syntax - files are automatically uploaded to Notion_
 
 ---
 
@@ -70,33 +70,33 @@ from notionary import NotionPage, NotionDatabase
 
 async def main():
     # Find pages by name - fuzzy matching included!
-    page = await NotionPage.from_page_name("Meeting Notes")
-    
+    page = await NotionPage.from_title("Meeting Notes")
+
     # Option 1: Direct Extended Markdown
     await page.append_markdown("""
     ## Action Items
     - [x] Review project proposal
-    - [ ] Schedule team meeting  
+    - [ ] Schedule team meeting
     - [ ] Update documentation
 
     [callout](Meeting decisions require follow-up "💡")
-    
+
     +++ Details
     Additional context and next steps...
     +++
     """)
-    
+
     # Option 2: Type-Safe Builder (maps to same markdown internally)
     await page.append_markdown(lambda builder: (
         builder
-        .h2("Project Status") 
+        .h2("Project Status")
         .callout("Milestone reached!", "🎉")
         .columns(
             lambda col: col.h3("Completed").bulleted_list([
                 "API design", "Database setup", "Authentication"
             ]),
             lambda col: col.h3("In Progress").bulleted_list([
-                "Frontend UI", "Testing", "Documentation"  
+                "Frontend UI", "Testing", "Documentation"
             ]),
             width_ratios=[0.6, 0.4]
         )
@@ -115,33 +115,36 @@ asyncio.run(main())
 
 Every Notion block type with extended syntax:
 
-| Block Type | Markdown Syntax | Use Case |
-|------------|-----------------|----------|
-| **Callouts** | `[callout](Text "🔥")` | Highlighting key information |
-| **Toggles** | `+++ Title\nContent\n+++` | Collapsible sections |
-| **Columns** | `::: columns\n::: column\nContent\n:::\n:::` | Side-by-side layouts |
-| **Tables** | Standard markdown tables | Structured data |
-| **Media** | `[video](./file.mp4)(caption:Description)` | Auto-uploading files |
-| **Code** | Standard code fences with captions | Code snippets |
-| **Equations** | `$LaTeX$` | Mathematical expressions |
-| **TOC** | `[toc](blue_background)` | Auto-generated navigation |
+| Block Type    | Markdown Syntax                              | Use Case                     |
+| ------------- | -------------------------------------------- | ---------------------------- |
+| **Callouts**  | `[callout](Text "🔥")`                       | Highlighting key information |
+| **Toggles**   | `+++ Title\nContent\n+++`                    | Collapsible sections         |
+| **Columns**   | `::: columns\n::: column\nContent\n:::\n:::` | Side-by-side layouts         |
+| **Tables**    | Standard markdown tables                     | Structured data              |
+| **Media**     | `[video](./file.mp4)(caption:Description)`   | Auto-uploading files         |
+| **Code**      | Standard code fences with captions           | Code snippets                |
+| **Equations** | `$LaTeX$`                                    | Mathematical expressions     |
+| **TOC**       | `[toc](blue_background)`                     | Auto-generated navigation    |
 
 ---
 
 ## What You Can Build 💡
 
 ### **AI Content Systems**
+
 - **Report Generation**: AI agents that create structured reports, documentation, and analysis
 - **Content Pipelines**: Automated workflows that process data and generate Notion pages
 - **Knowledge Management**: AI-powered documentation systems with smart categorization
 
-### **Workflow Automation**  
+### **Workflow Automation**
+
 - **Project Management**: Sync project status, update timelines, generate progress reports
 - **Data Integration**: Connect external APIs and databases to Notion workspaces
 - **Template Systems**: Dynamic page generation from templates and data sources
 
 ### **Content Management**
-- **Bulk Operations**: Mass page updates, content migration, and database management  
+
+- **Bulk Operations**: Mass page updates, content migration, and database management
 - **Media Handling**: Automated image/video uploads with proper organization
 - **Cross-Platform**: Sync content between Notion and other platforms
 
@@ -154,34 +157,40 @@ Every Notion block type with extended syntax:
 <td width="50%">
 
 ### Smart Discovery
+
 - Find pages/databases by name
-- Fuzzy matching for approximate searches  
+- Fuzzy matching for approximate searches
 - No more hunting for IDs or URLs
 
 ### Extended Markdown
+
 - Rich syntax beyond standard markdown
 - Callouts, toggles, columns, media uploads
 - Schema provided for AI agent integration
 
-### Modern Python 
+### Modern Python
+
 - Full async/await support
-- Type hints throughout  
+- Type hints throughout
 - High-performance batch operations
 
 </td>
 <td width="50%">
 
 ### Round-Trip Editing
+
 - Read existing content as markdown
 - Edit and modify preserving formatting
 - Write back to Notion seamlessly
 
 ### AI-Ready Architecture
+
 - Schema-driven syntax for LLM prompts
 - Perfect for AI content generation
 - Handles complex nested structures
 
 ### Complete Coverage
+
 - Every Notion block type supported
 - File uploads with automatic handling
 - Database operations and properties
@@ -195,24 +204,28 @@ Every Notion block type with extended syntax:
 ## Examples & Documentation
 
 ### Full Documentation
+
 [**mathisarends.github.io/notionary**](https://mathisarends.github.io/notionary/) - Complete API reference, guides, and tutorials
 
 ### Quick Links
+
 - [**Getting Started**](https://mathisarends.github.io/notionary/get-started/) - Setup and first steps
-- [**Page Management**](https://mathisarends.github.io/notionary/page/) - Content and properties  
+- [**Page Management**](https://mathisarends.github.io/notionary/page/) - Content and properties
 - [**Database Operations**](https://mathisarends.github.io/notionary/database/) - Queries and management
 - [**Block Types Reference**](https://mathisarends.github.io/notionary/blocks/) - Complete syntax guide
 
 ### Hands-On Examples
 
 **Core Functionality:**
+
 - [Page Management](examples/page_example.py) - Create, update, and manage pages
-- [Database Operations](examples/database.py) - Connect and query databases  
+- [Database Operations](examples/database.py) - Connect and query databases
 - [Workspace Discovery](examples/workspace_discovery.py) - Explore your workspace
 
 **Extended Markdown:**
+
 - [Basic Formatting](examples/markdown/basic.py) - Text, lists, and links
-- [Callouts & Highlights](examples/markdown/callout.py) - Information boxes  
+- [Callouts & Highlights](examples/markdown/callout.py) - Information boxes
 - [Toggle Sections](examples/markdown/toggle.py) - Collapsible content
 - [Multi-Column Layouts](examples/markdown/columns.py) - Side-by-side design
 - [Tables & Data](examples/markdown/table.py) - Structured presentations
@@ -222,8 +235,9 @@ Every Notion block type with extended syntax:
 ## Contributing
 
 We welcome contributions from the community! Whether you're:
+
 - **Fixing bugs** - Help improve stability and reliability
-- **Adding features** - Extend functionality for new use cases  
+- **Adding features** - Extend functionality for new use cases
 - **Improving docs** - Make the library more accessible
 - **Sharing examples** - Show creative applications and patterns
 
@@ -237,7 +251,7 @@ Check our [**Contributing Guide**](https://mathisarends.github.io/notionary/cont
 
 [📖 **Read the Docs**](https://mathisarends.github.io/notionary/) • [🚀 **Getting Started**](https://mathisarends.github.io/notionary/get-started/) • [💻 **Browse Examples**](examples/)
 
-*Built with ❤️ for Python developers and AI agents*
+_Built with ❤️ for Python developers and AI agents_
 
 ---
 

notionary-0.2.28/notionary/__init__.py

@@ -0,0 +1,7 @@
+from .data_source.service import NotionDataSource
+from .database.service import NotionDatabase
+from .page.content.markdown.builder import MarkdownBuilder
+from .page.service import NotionPage
+from .workspace import NotionWorkspace
+
+__all__ = ["MarkdownBuilder", "NotionDataSource", "NotionDatabase", "NotionPage", "NotionWorkspace", "NotionWorkspace"]