notionary 0.1.17__py3-none-any.whl → 0.1.19__py3-none-any.whl

notionary/database/notion_database.py

@@ -217,6 +217,26 @@ class NotionDatabase(LoggingMixin):
             self.logger.error("Error in delete_page: %s", str(e))
             return {"success": False, "message": f"Error: {str(e)}"}
 
+    async def get_last_edited_time(self) -> Optional[str]:
+        """
+        Retrieve the last edited time of the database.
+
+        Returns:
+            ISO 8601 timestamp string of the last database edit, or None if request fails
+        """
+        try:
+            response = await self._client.get(f"databases/{self.database_id}")
+
+            if response and "last_edited_time" in response:
+                return response["last_edited_time"]
+
+            self.logger.warning("Could not retrieve last_edited_time for database %s", self.database_id)
+            return None
+
+        except Exception as e:
+            self.logger.error("Error fetching last_edited_time: %s", str(e))
+            return None
+
     async def close(self) -> None:
         """Close the client connection."""
         await self._client.close()

{notionary-0.1.17.dist-info → notionary-0.1.19.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: notionary
-Version: 0.1.17
+Version: 0.1.19
 Summary: A toolkit to convert between Markdown and Notion blocks
 Home-page: https://github.com/mathisarends/notionary
 Author: Mathis Arends
@@ -10,13 +10,8 @@ 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
@@ -33,12 +28,14 @@ Dynamic: summary
 [![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.
+**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**: Write Notion pages using intuitive Markdown syntax with custom extensions
+- **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
@@ -56,7 +53,7 @@ Notionary extends standard Markdown with special syntax to support Notion-specif
 ### Text Formatting
 
 - Standard Markdown: `**bold**`, `*italic*`, `~~strikethrough~~`, `` `code` ``
-- Highlights: `==highlighted text==`, `==red warning==`, `==blue==`
+- Highlights: `==highlighted text==`, `==red:warning==`, `==blue:note==`
 
 ### Block Elements
 
@@ -111,50 +108,43 @@ Notionary makes it easy to work with Notion databases, automatically handling sc
 
 ```python
 import asyncio
-from notionary.core.database.notion_database_manager import NotionDatabaseManager
+from notionary import NotionDatabaseFactory
 
 async def main():
-    database_id = "1a6389d5-7bd3-8097-aa38-e93cb052615a"
-    db = NotionDatabaseManager(database_id)
-    await db.initialize()
+    # 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",
-        "Description": "This entry was created using Notionary.",
         "Status": "In Progress",
         "Priority": "High"
     }
 
-    result = await db.create_page(properties)
+    page = await db_manager.create_blank_page()
 
-    if result["success"]:
-        page_id = result["page_id"]
-        await db.update_page(page_id, {"Status": "Completed"})
+    # Set page content with rich Markdown
+    await page.set_title("My New Project")
+    await page.set_page_icon(emoji="🚀")
 
-    filter_conditions = {
-        "property": "Status",
-        "status": {"equals": "Completed"}
-    }
+    markdown = """
+    # Project Overview
 
-    pages = await db.get_pages(limit=10, filter_conditions=filter_conditions)
+    !> [💡] This page was created programmatically using Notionary.
 
-    await db.close()
+    ## Tasks
+    - [ ] Define project scope
+    - [ ] Create timeline
+    - [ ] Assign resources
 
-if __name__ == "__main__":
-    asyncio.run(main())
-```
-
-## Finding Databases by Name
-
-Use fuzzy matching to find databases:
+    +++ Implementation Details
+      This project will use our standard architecture with custom extensions.
+    """
 
-```python
-from notionary.core.database.notion_database_manager_factory import NotionDatabaseFactory
+    await page.replace_content(markdown)
 
-async def main():
-    db_manager = await NotionDatabaseFactory.from_database_name("Projects")
-    print(f"Found database: {db_manager.title}")
-    await db_manager.close()
+if __name__ == "__main__":
+    asyncio.run(main())
 ```
 
 ## Page Content Management
@@ -162,11 +152,11 @@ async def main():
 Create rich Notion pages using enhanced Markdown:
 
 ```python
-from notionary.core.page.notion_page_manager import NotionPageManager
+from notionary import NotionPage
 
 async def create_rich_page():
     url = "https://www.notion.so/Your-Page-1cd389d57bd381e58be9d35ce24adf3d"
-    page_manager = NotionPageManager(url=url)
+    page_manager = NotionPage(url=url)
 
     await page_manager.set_title("Notionary Demo")
     await page_manager.set_page_icon(emoji="✨")
@@ -190,20 +180,71 @@ async def create_rich_page():
     await page_manager.replace_content(markdown)
 ```
 
-## Perfect for AI Agents and Automation
+## Block Registry & Builder
 
-- **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
+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_standard_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_standard_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 for:
+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
 
-- Database discovery and querying
-- Rich page creation with Markdown
-- Entry management
-- Metadata manipulation
+- **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
 

{notionary-0.1.17.dist-info → notionary-0.1.19.dist-info}/RECORD

@@ -2,7 +2,7 @@ notionary/__init__.py,sha256=sVqdwzMQcc9jf6FKi1qflilsx8rnWzluVhWewVi5gyI,717
 notionary/notion_client.py,sha256=NPPK7zId6EaC-hQeFJ7geaiROGtZfmc8cVP2nQez5DU,6040
 notionary/database/database_discovery.py,sha256=qDGFhXG9s-_6CXdRg8tMiwX4dvX7jLjgAUFPSNlYtlI,4506
 notionary/database/database_info_service.py,sha256=Ig6gx8jUSPYORJvfgEV5kV6t72pZQsWU8HPMqd43B-o,1336
-notionary/database/notion_database.py,sha256=RY5MlXNE5DVNWLC_Derljsz87ZMHkE-05Vgm80kvLxg,7250
+notionary/database/notion_database.py,sha256=Zm5Ev0n4idKUe3ms8l3B4fyIezNNCCEDWHZ5vDoTknQ,7985
 notionary/database/notion_database_factory.py,sha256=Af57yaUHidD8TKJ8uyXOc2nnqHm7on6VGFdDRjxiq9o,6692
 notionary/database/models/page_result.py,sha256=Vmm5_oYpYAkIIJVoTd1ZZGloeC3cmFLMYP255mAmtaw,233
 notionary/elements/audio_element.py,sha256=XLARz5zlPPW_Qof6uhcYXFmyYzyS1fLdxdfsvh6GMOs,5589
@@ -49,8 +49,8 @@ notionary/page/relations/relation_operation_result.py,sha256=NDxBzGntOxc_89ti-HG
 notionary/util/logging_mixin.py,sha256=fKsx9t90bwvL74ZX3dU-sXdC4TZCQyO6qU9I8txkw_U,1369
 notionary/util/page_id_utils.py,sha256=EYNMxgf-7ghzL5K8lKZBZfW7g5CsdY0Xuj4IYmU8RPk,1381
 notionary/util/singleton_decorator.py,sha256=GTNMfIlVNRUVMw_c88xqd12-DcqZJjmyidN54yqiNVw,472
-notionary-0.1.17.dist-info/licenses/LICENSE,sha256=zOm3cRT1qD49eg7vgw95MI79rpUAZa1kRBFwL2FkAr8,1120
-notionary-0.1.17.dist-info/METADATA,sha256=VZF2Dx-fZCwhEE42S8RTXaJabhLml8qrL_SVfSlcB-w,6154
-notionary-0.1.17.dist-info/WHEEL,sha256=CmyFI0kx5cdEMTLiONQRbGQwjIoR1aIYB7eCAQ4KPJ0,91
-notionary-0.1.17.dist-info/top_level.txt,sha256=fhONa6BMHQXqthx5PanWGbPL0b8rdFqhrJKVLf_adSs,10
-notionary-0.1.17.dist-info/RECORD,,
+notionary-0.1.19.dist-info/licenses/LICENSE,sha256=zOm3cRT1qD49eg7vgw95MI79rpUAZa1kRBFwL2FkAr8,1120
+notionary-0.1.19.dist-info/METADATA,sha256=Ws3WI2Yp4HopH7_Jo4eQbzSN0ziOHZOaqieDNZK9kSM,8350
+notionary-0.1.19.dist-info/WHEEL,sha256=pxyMxgL8-pra_rKaQ4drOZAegBVuX-G_4nRHjjgWbmo,91
+notionary-0.1.19.dist-info/top_level.txt,sha256=fhONa6BMHQXqthx5PanWGbPL0b8rdFqhrJKVLf_adSs,10
+notionary-0.1.19.dist-info/RECORD,,

{notionary-0.1.17.dist-info → notionary-0.1.19.dist-info}/WHEEL

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