notionary 0.1.12__py3-none-any.whl → 0.1.13__py3-none-any.whl

notionary/page/notion_page_factory.py

@@ -0,0 +1,256 @@
+import logging
+from typing import List, Optional, Dict, Any
+from difflib import SequenceMatcher
+
+from notionary import NotionPage, NotionClient
+from notionary.util.logging_mixin import LoggingMixin
+from notionary.util.page_id_utils import format_uuid, extract_and_validate_page_id
+
+
+class NotionPageFactory(LoggingMixin):
+    """
+    Factory class for creating NotionPage instances.
+    Provides methods for creating page instances by page ID, URL, or name.
+    """
+
+    @classmethod
+    def class_logger(cls):
+        """Class logger - for class methods"""
+        return logging.getLogger(cls.__name__)
+
+    @classmethod
+    async def from_page_id(
+        cls, page_id: str, token: Optional[str] = None
+    ) -> NotionPage:
+        """
+        Create a NotionPage from a page ID.
+
+        Args:
+            page_id: The ID of the Notion page
+            token: Optional Notion API token (uses environment variable if not provided)
+
+        Returns:
+            An initialized NotionPage instance
+
+        Raises:
+            NotionError: If there is any error during page creation or connection
+        """
+        logger = cls.class_logger()
+
+        try:
+            formatted_id = format_uuid(page_id) or page_id
+
+            page = NotionPage(page_id=formatted_id, token=token)
+
+            logger.info("Successfully created page instance for ID: %s", formatted_id)
+            return page
+
+        except Exception as e:
+            error_msg = f"Error connecting to page {page_id}: {str(e)}"
+            logger.error(error_msg)
+
+    @classmethod
+    async def from_url(cls, url: str, token: Optional[str] = None) -> NotionPage:
+        """
+        Create a NotionPage from a Notion URL.
+
+        Args:
+            url: The URL of the Notion page
+            token: Optional Notion API token (uses environment variable if not provided)
+
+        Returns:
+            An initialized NotionPage instance
+
+        Raises:
+            NotionError: If there is any error during page creation or connection
+        """
+        logger = cls.class_logger()
+
+        try:
+            page_id = extract_and_validate_page_id(url=url)
+            if not page_id:
+                error_msg = f"Could not extract valid page ID from URL: {url}"
+                logger.error(error_msg)
+
+            page = NotionPage(page_id=page_id, url=url, token=token)
+
+            logger.info(
+                "Successfully created page instance from URL for ID: %s", page_id
+            )
+            return page
+
+        except Exception as e:
+            error_msg = f"Error connecting to page with URL {url}: {str(e)}"
+            logger.error(error_msg)
+
+    @classmethod
+    async def from_page_name(
+        cls, page_name: str, token: Optional[str] = None
+    ) -> NotionPage:
+        """
+        Create a NotionPage by finding a page with a matching name.
+        Uses fuzzy matching to find the closest match to the given name.
+        If no good match is found, suggests closest alternatives ("Did you mean?").
+
+        Args:
+            page_name: The name of the Notion page to search for
+            token: Optional Notion API token (uses environment variable if not provided)
+
+        Returns:
+            An initialized NotionPage instance
+
+        Raises:
+            NotionError: If there is any error during page search or connection
+            NotionPageNotFoundError: If no matching page found, includes suggestions
+        """
+        logger = cls.class_logger()
+        logger.debug("Searching for page with name: %s", page_name)
+
+        client = NotionClient(token=token)
+
+        try:
+            logger.debug("Using search endpoint to find pages")
+
+            search_payload = {
+                "filter": {"property": "object", "value": "page"},
+                "page_size": 100,
+            }
+
+            response = await client.post("search", search_payload)
+
+            if not response or "results" not in response:
+                error_msg = "Failed to fetch pages using search endpoint"
+                logger.error(error_msg)
+
+            pages = response.get("results", [])
+
+            if not pages:
+                error_msg = f"No pages found matching '{page_name}'"
+                logger.warning(error_msg)
+
+            logger.debug("Found %d pages, searching for best match", len(pages))
+
+            # Store all matches with their scores for potential suggestions
+            matches = []
+            best_match = None
+            best_score = 0
+
+            for page in pages:
+                title = cls._extract_title_from_page(page)
+                score = SequenceMatcher(None, page_name.lower(), title.lower()).ratio()
+
+                matches.append((page, title, score))
+
+                if score > best_score:
+                    best_score = score
+                    best_match = page
+
+            if best_score < 0.6 or not best_match:
+                # Sort matches by score in descending order
+                matches.sort(key=lambda x: x[2], reverse=True)
+
+                # Take top N suggestions (adjust as needed)
+                suggestions = [title for _, title, _ in matches[:5]]
+
+                error_msg = f"No good match found for '{page_name}'. Did you mean one of these?\n"
+                error_msg += "\n".join(f"- {suggestion}" for suggestion in suggestions)
+
+                logger.warning(
+                    "No good match found for '%s'. Best score: %.2f",
+                    page_name,
+                    best_score,
+                )
+
+            page_id = best_match.get("id")
+
+            if not page_id:
+                error_msg = "Best match page has no ID"
+                logger.error(error_msg)
+
+            matched_name = cls._extract_title_from_page(best_match)
+
+            logger.info(
+                "Found matching page: '%s' (ID: %s) with score: %.2f",
+                matched_name,
+                page_id,
+                best_score,
+            )
+
+            page = NotionPage(
+                page_id=page_id, title=matched_name, token=token
+            )
+
+            logger.info("Successfully created page instance for '%s'", matched_name)
+            await client.close()
+            return page
+
+        except Exception as e:
+            error_msg = f"Error finding page by name: {str(e)}"
+            logger.error(error_msg)
+
+    @classmethod
+    def _extract_title_from_page(cls, page: Dict[str, Any]) -> str:
+        """
+        Extract the title from a page object.
+
+        Args:
+            page: The page object returned from the Notion API
+
+        Returns:
+            The title of the page
+
+        Raises:
+            NotionError: If the title cannot be extracted
+        """
+        try:
+            if "properties" in page:
+                for prop_value in page["properties"].values():
+                    if prop_value.get("type") != "title":
+                        continue
+                    title_array = prop_value.get("title", [])
+                    if not title_array:
+                        continue
+                    return cls._extract_text_from_rich_text(title_array)
+
+            if "child_page" in page:
+                return page.get("child_page", {}).get("title", "Untitled")
+
+            return "Untitled"
+
+        except Exception as e:
+            error_msg = f"Error extracting page title: {str(e)}"
+            cls.class_logger().warning(error_msg)
+            return "Untitled"
+
+    @classmethod
+    def _extract_text_from_rich_text(cls, rich_text: List[Dict[str, Any]]) -> str:
+        """
+        Extract plain text from a rich text array.
+
+        Args:
+            rich_text: A list of rich text objects from the Notion API
+
+        Returns:
+            The combined plain text content
+        """
+        if not rich_text:
+            return ""
+
+        text_parts = []
+        for text_obj in rich_text:
+            if "plain_text" in text_obj:
+                text_parts.append(text_obj["plain_text"])
+
+        return "".join(text_parts)
+
+
+async def demo():
+    clipboard = await NotionPageFactory.from_page_name("Jarvis Clipboard")
+    icon = await clipboard.get_icon()
+    print(f"Icon: {icon}")
+
+
+if __name__ == "__main__":
+    import asyncio
+
+    asyncio.run(demo())

notionary/{core/page → page}/properites/database_property_service.py

@@ -1,5 +1,5 @@
 from typing import Dict, List, Optional, Any, Tuple
-from notionary.core.notion_client import NotionClient
+from notionary.notion_client import NotionClient
 from notionary.util.logging_mixin import LoggingMixin
 
 

notionary/{core/page → page}/properites/page_property_manager.py

@@ -1,17 +1,17 @@
 from typing import Dict, Any, List, Optional
-from notionary.core.notion_client import NotionClient
-from notionary.core.page.metadata.metadata_editor import MetadataEditor
-from notionary.core.page.properites.property_operation_result import (
+from notionary.notion_client import NotionClient
+from notionary.page.metadata.metadata_editor import MetadataEditor
+from notionary.page.properites.property_operation_result import (
     PropertyOperationResult,
 )
-from notionary.core.page.relations.notion_page_title_resolver import (
+from notionary.page.relations.notion_page_title_resolver import (
     NotionPageTitleResolver,
 )
-from notionary.core.page.properites.database_property_service import (
+from notionary.page.properites.database_property_service import (
     DatabasePropertyService,
 )
-from notionary.core.page.relations.page_database_relation import PageDatabaseRelation
-from notionary.core.page.properites.property_value_extractor import (
+from notionary.page.relations.page_database_relation import PageDatabaseRelation
+from notionary.page.properites.property_value_extractor import (
     PropertyValueExtractor,
 )
 from notionary.util.logging_mixin import LoggingMixin

notionary/{core/page → page}/relations/notion_page_relation_manager.py

@@ -1,9 +1,9 @@
 from typing import Any, Dict, List, Optional
-from notionary.core.notion_client import NotionClient
-from notionary.core.page.relations.notion_page_title_resolver import (
+from notionary.notion_client import NotionClient
+from notionary.page.relations.notion_page_title_resolver import (
     NotionPageTitleResolver,
 )
-from notionary.core.page.relations.relation_operation_result import (
+from notionary.page.relations.relation_operation_result import (
     RelationOperationResult,
 )
 from notionary.util.logging_mixin import LoggingMixin

notionary/{core/page → page}/relations/notion_page_title_resolver.py

@@ -1,5 +1,5 @@
 from typing import Optional
-from notionary.core.notion_client import NotionClient
+from notionary.notion_client import NotionClient
 from notionary.util.logging_mixin import LoggingMixin
 
 

notionary/{core/page → page}/relations/page_database_relation.py

@@ -1,5 +1,5 @@
 from typing import Dict, Optional, Any
-from notionary.core.notion_client import NotionClient
+from notionary.notion_client import NotionClient
 from notionary.util.logging_mixin import LoggingMixin
 
 

notionary/util/page_id_utils.py

@@ -27,7 +27,9 @@ def format_uuid(value: str) -> Optional[str]:
     return extract_uuid(value)
 
 
-def extract_and_validate_page_id(page_id: Optional[str], url: Optional[str]) -> str:
+def extract_and_validate_page_id(
+    page_id: Optional[str] = None, url: Optional[str] = None
+) -> str:
     if not page_id and not url:
         raise ValueError("Either page_id or url must be provided")
 

{notionary-0.1.12.dist-info → notionary-0.1.13.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: notionary
-Version: 0.1.12
+Version: 0.1.13
 Summary: A toolkit to convert between Markdown and Notion blocks
 Home-page: https://github.com/mathisarends/notionary
 Author: Mathis Arends

notionary-0.1.13.dist-info/RECORD

@@ -0,0 +1,56 @@
+notionary/__init__.py,sha256=kG1u5pB2PCrr2aXG4B1YhVqucPqU_LG-qyw5t5Bjayw,739
+notionary/notion_client.py,sha256=VdIE1TSEZTy2BhR7Hnx_McndvQYxlu-aJN_7LeDpXgY,4497
+notionary/converters/__init__.py,sha256=GOUehJbe4BKHtec1MqL1YGu3AX8zFtkwSZfhYkY5-P0,1798
+notionary/converters/markdown_to_notion_converter.py,sha256=xmoXpE7KqaueUHAcDt76BTDUE_tNv4QbNtgBgX_YAXk,15100
+notionary/converters/notion_to_markdown_converter.py,sha256=aX2qabOI6cp3bYOfDxJtODQYBQCp_zRFlezLXjwFV9Q,1277
+notionary/converters/elements/audio_element.py,sha256=jCCReh0pBKjB4Dq46XZMkKJ1ZZy0DvjgFbeQKW5VGzM,5600
+notionary/converters/elements/bookmark_element.py,sha256=Ki0Tv3lpYmo6g7OKtXg9smzMtbB2C5O9Qfr6QF8goko,8588
+notionary/converters/elements/callout_element.py,sha256=tUUzTrt0JXhvvvnxCdF-KPp9mVsil_6bmUBhDeeRrYg,5954
+notionary/converters/elements/code_block_element.py,sha256=wZh3LXA5qsan0Z9w7SnRKWJMYrw5cT7cfHZ61RtRKM8,5184
+notionary/converters/elements/column_element.py,sha256=5i6jODlsaGz5S7gJFEzTYnmf1yPyM1-8oMJvJp3EUno,10717
+notionary/converters/elements/divider_element.py,sha256=6Zv15SXLFkXo6HkiQ_iXGd_FfFr3tEObXrlNiw1gE2g,2787
+notionary/converters/elements/embed_element.py,sha256=PMF2th4eSjKWUqkxgb0hTvt-ZO2W5mGspMExn_UBa2U,4779
+notionary/converters/elements/heading_element.py,sha256=L-VZaXO1uFnfGNWkTmtHg5YXKLncR23MVFJvwJtqSuA,2778
+notionary/converters/elements/image_element.py,sha256=sz5nXZzKTBb0U6QULOMVQ4XBdAHi6yOh9-TTodz_0-Q,4856
+notionary/converters/elements/list_element.py,sha256=CRp8R1Kxn01dqZNal9EaAwV2D3Z4c_sXRZ0crZ4OTOI,4868
+notionary/converters/elements/notion_block_element.py,sha256=lLRBDXhBeRaRzkbvdpYpr-U9nbkd62oVtqdSe-svT4c,1746
+notionary/converters/elements/paragraph_element.py,sha256=-gIZr5MD_b7akh9euQ95PsiQlhvswC2S1VFgwBXRFQQ,2756
+notionary/converters/elements/qoute_element.py,sha256=3Nr62ddgr4erncdBs-xhb2OMiPhlXAKuoqu-3hefTRc,9052
+notionary/converters/elements/table_element.py,sha256=7eqFMYxZUx7aG25WEp1cNSMHDkKTWwZvUVpq4dTnvHc,11244
+notionary/converters/elements/text_inline_formatter.py,sha256=FE_Sq2cozpu5RVtMbnPq21gD06UjH3LMRYr3s16JKYo,10606
+notionary/converters/elements/todo_lists.py,sha256=6d74O11TfCr5umQa2xrsIiUv3PB9sZoDcWdfg21M7po,4255
+notionary/converters/elements/toggle_element.py,sha256=69JSanxAGPXKwpBsMtXlvW0aCn080Me4gwk_DxTxM2Q,7253
+notionary/converters/elements/video_element.py,sha256=XKfZcG8m8lZ5RyQGz_GgZCGPCMY3SjcvyuRJ6P1ymMI,6042
+notionary/converters/registry/block_element_registry.py,sha256=Bi1DlEdP8xloqh_YeTh1PKzOKxtS1u1W-lu8kEcXY94,8690
+notionary/converters/registry/block_element_registry_builder.py,sha256=UMJNE3bVMNqwTeA5pvNf-_gxYzIuUX1AOy1sYQXlBs4,9367
+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_factory.py,sha256=Af57yaUHidD8TKJ8uyXOc2nnqHm7on6VGFdDRjxiq9o,6692
+notionary/database/models/page_result.py,sha256=Vmm5_oYpYAkIIJVoTd1ZZGloeC3cmFLMYP255mAmtaw,233
+notionary/exceptions/database_exceptions.py,sha256=I-Tx6bYRLpi5pjGPtbT-Mqxvz3BFgYTiuZxknJeLxtI,2638
+notionary/exceptions/page_creation_exception.py,sha256=4v7IuZD6GsQLrqhDLriGjuG3ML638gAO53zDCrLePuU,281
+notionary/page/notion_page.py,sha256=u5lPCteJ5Bz89N40TlwF2cHjHAMmwYOi2NHMo5neJZU,17003
+notionary/page/notion_page_factory.py,sha256=ucTrAaXvlD4pzfqRXfhygldfD8MLx4n23XpsWESXEr4,8466
+notionary/page/content/notion_page_content_chunker.py,sha256=xRks74Dqec-De6-AVTxMPnXs-MSJBzSm1HfJfaHiKr8,3330
+notionary/page/content/page_content_manager.py,sha256=X4p6jBJpFpOhtbiH2BOzwoAnWRLz1EDauV16QYJMW58,3942
+notionary/page/metadata/metadata_editor.py,sha256=61uiw8oB25O8ePhytoJvZDetuof5sjPoM6aoHZGo4wc,4949
+notionary/page/metadata/notion_icon_manager.py,sha256=ixZrWsHGVpmF05Ncy9LCt8vZlKAQHYFZW-2yI5JZZDI,1426
+notionary/page/metadata/notion_page_cover_manager.py,sha256=qgQxQE-bx4oWjLFUQvpXD5GzO1Mx7w7htz1xC2BOqUg,1717
+notionary/page/properites/database_property_service.py,sha256=AJuBGahbb53VQa6IGGHxBMoOgCy6vFZg08uR_eDjNUs,11570
+notionary/page/properites/page_property_manager.py,sha256=Xl8Cwn8WVszqpFXT_NvASkmP5igpCTEgRVhG_F45424,6914
+notionary/page/properites/property_formatter.py,sha256=d_Nr5XQxgjB6VIS0u3ey14MOUKY416o_BvdXjbkUNAQ,3667
+notionary/page/properites/property_operation_result.py,sha256=PhxHJJxxG2BdDl7aswhWnMSmf9RQtoinKkRHDoqxwCs,3913
+notionary/page/properites/property_value_extractor.py,sha256=1BfyCYrFzfIUmNTozavrLTjG--6P6Dy2tkewf6rHHwQ,2353
+notionary/page/relations/notion_page_relation_manager.py,sha256=D7JZJLXjX2Jn3CIseJxoMK9qL9gp88t4NmL9Ihu06eg,12682
+notionary/page/relations/notion_page_title_resolver.py,sha256=jUYsEkfyDgdh77oh2awYEB5g1vQqLBq6xYSXL-4uPH8,1722
+notionary/page/relations/page_database_relation.py,sha256=F9aGXFjjL8ZLNbfTGeGm_QAyXhz2AEOw7GgDLdprEcE,2313
+notionary/page/relations/relation_operation_result.py,sha256=NDxBzGntOxc_89ti-HG8xDSqfY6PwyGHKHrrKbCzNjM,5010
+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.13.dist-info/licenses/LICENSE,sha256=zOm3cRT1qD49eg7vgw95MI79rpUAZa1kRBFwL2FkAr8,1120
+notionary-0.1.13.dist-info/METADATA,sha256=oVy9WSKlRNiV1Hg_hnf8z4ZfZgo-bBl6qaF0S6zX0Z4,6154
+notionary-0.1.13.dist-info/WHEEL,sha256=CmyFI0kx5cdEMTLiONQRbGQwjIoR1aIYB7eCAQ4KPJ0,91
+notionary-0.1.13.dist-info/top_level.txt,sha256=fhONa6BMHQXqthx5PanWGbPL0b8rdFqhrJKVLf_adSs,10
+notionary-0.1.13.dist-info/RECORD,,