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

notionary/core/page/relations/relation_operation_result.py

@@ -1,11 +1,12 @@
 from typing import Any, Dict, List, Optional
 from dataclasses import dataclass, field
 
+
 @dataclass
 class RelationOperationResult:
     """
     Result of a relation operation in Notion.
-    
+
     Attributes:
         success: Whether the operation was successful overall
         property_name: Name of the affected relation property
@@ -15,6 +16,7 @@ class RelationOperationResult:
         error: Error message, if any
         api_response: The original API response
     """
+
     success: bool
     property_name: str
     found_pages: List[str] = field(default_factory=list)
@@ -22,32 +24,38 @@ class RelationOperationResult:
     page_ids_added: List[str] = field(default_factory=list)
     error: Optional[str] = None
     api_response: Optional[Dict[str, Any]] = None
-    
+
     NO_API_RESPONSE = "Failed to update relation (no API response)"
     NO_PAGES_FOUND = "No valid pages found for relation"
-    
+
     @classmethod
-    def from_success(cls, property_name: str, 
-                     found_pages: List[str], 
-                     page_ids_added: List[str], 
-                     api_response: Dict[str, Any],
-                     not_found_pages: Optional[List[str]] = None) -> "RelationOperationResult":
+    def from_success(
+        cls,
+        property_name: str,
+        found_pages: List[str],
+        page_ids_added: List[str],
+        api_response: Dict[str, Any],
+        not_found_pages: Optional[List[str]] = None,
+    ) -> "RelationOperationResult":
         """Creates a success result."""
         return cls(
-            success=True, 
+            success=True,
             property_name=property_name,
             found_pages=found_pages,
             not_found_pages=not_found_pages or [],
             page_ids_added=page_ids_added,
-            api_response=api_response
+            api_response=api_response,
         )
-    
+
     @classmethod
-    def from_error(cls, property_name: str, 
-                  error: str,
-                  found_pages: Optional[List[str]] = None,
-                  not_found_pages: Optional[List[str]] = None,
-                  page_ids_added: Optional[List[str]] = None) -> "RelationOperationResult":
+    def from_error(
+        cls,
+        property_name: str,
+        error: str,
+        found_pages: Optional[List[str]] = None,
+        not_found_pages: Optional[List[str]] = None,
+        page_ids_added: Optional[List[str]] = None,
+    ) -> "RelationOperationResult":
         """Creates an error result."""
         return cls(
             success=False,
@@ -55,81 +63,82 @@ class RelationOperationResult:
             found_pages=found_pages or [],
             not_found_pages=not_found_pages or [],
             page_ids_added=page_ids_added or [],
-            error=error
+            error=error,
         )
-    
+
     @classmethod
-    def from_no_pages_found(cls, property_name: str, 
-                            not_found_pages: List[str]) -> "RelationOperationResult":
+    def from_no_pages_found(
+        cls, property_name: str, not_found_pages: List[str]
+    ) -> "RelationOperationResult":
         """Creates a standardized result for when no pages were found."""
         return cls.from_error(
             property_name=property_name,
             error=cls.NO_PAGES_FOUND,
-            not_found_pages=not_found_pages
+            not_found_pages=not_found_pages,
         )
 
     @classmethod
-    def from_no_api_response(cls, property_name: str, 
-                            found_pages: List[str],
-                            page_ids_added: List[str]) -> "RelationOperationResult":
+    def from_no_api_response(
+        cls, property_name: str, found_pages: List[str], page_ids_added: List[str]
+    ) -> "RelationOperationResult":
         """Creates a standardized result for a missing API response."""
         return cls.from_error(
             property_name=property_name,
             error=cls.NO_API_RESPONSE,
             found_pages=found_pages,
-            page_ids_added=page_ids_added
+            page_ids_added=page_ids_added,
         )
-    
+
     @property
     def has_not_found_pages(self) -> bool:
         """Returns True if there were any pages that couldn't be found."""
         return len(self.not_found_pages) > 0
-    
+
     @property
     def has_found_pages(self) -> bool:
         """Returns True if any pages were found."""
         return len(self.found_pages) > 0
-    
+
     def to_dict(self) -> Dict[str, Any]:
         """Converts the result to a dictionary."""
         result = {
             "success": self.success,
             "property": self.property_name,
         }
-        
+
         if self.found_pages:
             result["found_pages"] = self.found_pages
-            
+
         if self.not_found_pages:
             result["not_found_pages"] = self.not_found_pages
-            
+
         if self.page_ids_added:
             result["page_ids_added"] = self.page_ids_added
-        
+
         if not self.success:
             result["error"] = self.error
-            
+
         if self.api_response:
             result["api_response"] = self.api_response
-            
+
         return result
-    
+
     def __str__(self) -> str:
         """String representation of the result."""
         if self.success:
             base = f"Success: Added {len(self.page_ids_added)} relation(s) to property '{self.property_name}'"
-            
+
             if self.not_found_pages:
                 pages_str = "', '".join(self.not_found_pages)
                 base += f"\nWarning: Could not find pages: '{pages_str}'"
-                
+
             return base
-        
+
         if not self.found_pages and self.not_found_pages:
             pages_str = "', '".join(self.not_found_pages)
             return f"Error: {self.error}\nNone of the requested pages were found: '{pages_str}'"
-        
+
         if self.found_pages and not self.page_ids_added:
             return f"Error: {self.error}\nPages were found but could not be added to the relation."
-            
-        return f"Error: {self.error}"
+
+        return f"Error: {self.error}"

notionary/util/page_id_utils.py

@@ -4,39 +4,43 @@ from typing import Optional
 UUID_PATTERN = r"^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$"
 UUID_RAW_PATTERN = r"([a-f0-9]{32})"
 
+
 def extract_uuid(source: str) -> Optional[str]:
     if is_valid_uuid(source):
         return source
-        
+
     match = re.search(UUID_RAW_PATTERN, source.lower())
     if not match:
         return None
-    
+
     uuid_raw = match.group(1)
     return f"{uuid_raw[0:8]}-{uuid_raw[8:12]}-{uuid_raw[12:16]}-{uuid_raw[16:20]}-{uuid_raw[20:32]}"
 
+
 def is_valid_uuid(uuid: str) -> bool:
     return bool(re.match(UUID_PATTERN, uuid.lower()))
 
+
 def format_uuid(value: str) -> Optional[str]:
     if is_valid_uuid(value):
         return value
     return extract_uuid(value)
 
+
 def extract_and_validate_page_id(page_id: Optional[str], url: Optional[str]) -> str:
     if not page_id and not url:
         raise ValueError("Either page_id or url must be provided")
-    
+
     candidate = page_id or url
-    
+
     if is_valid_uuid(candidate):
         return candidate
-        
+
     extracted_id = extract_uuid(candidate)
     if not extracted_id:
         raise ValueError(f"Could not extract a valid UUID from: {candidate}")
-    
+
     formatted = format_uuid(extracted_id)
     if not formatted or not is_valid_uuid(formatted):
         raise ValueError(f"Invalid UUID format: {formatted}")
-    return formatted
+    return formatted

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

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

{notionary-0.1.11.dist-info → notionary-0.1.12.dist-info}/RECORD

@@ -1,15 +1,15 @@
-notionary/__init__.py,sha256=5T16clJlSHFsopcPUnkGrEo8spNDUQ0i-O00UEF7nR8,320
-notionary/core/notion_client.py,sha256=9o9-Ki1homkSbM1C51nsaAzVPMt2d4r8cPzoX3NK_HQ,4495
+notionary/__init__.py,sha256=19UodWJsuHVSQBFZ5rFBnsSPznz22GTy2XYLIldL7-Q,730
+notionary/core/notion_client.py,sha256=VdIE1TSEZTy2BhR7Hnx_McndvQYxlu-aJN_7LeDpXgY,4497
 notionary/core/converters/__init__.py,sha256=GOUehJbe4BKHtec1MqL1YGu3AX8zFtkwSZfhYkY5-P0,1798
-notionary/core/converters/markdown_to_notion_converter.py,sha256=PGtg4v5lUvkXXl1Y8E6a3Mf8hEfxfhBrslPs_H_Lq_E,16564
+notionary/core/converters/markdown_to_notion_converter.py,sha256=u2mjshWiiLRVHYrdcXh7fdVMDwWMQLq5LKtvDmX_IWo,15110
 notionary/core/converters/notion_to_markdown_converter.py,sha256=c8GyWX8-UrNfRDk7OOBKbSEb5qOwljUCwI6g5risO2c,1287
-notionary/core/converters/elements/audio_element.py,sha256=qTYxpErHw327JdESr4Biv-H89iZRXzBcllamrFu8P_k,5587
+notionary/core/converters/elements/audio_element.py,sha256=as8X3EKRn5YIZQph60UdSdnrYQWDCCknvuQ4D3vr8B4,5605
 notionary/core/converters/elements/bookmark_element.py,sha256=bpHobkGnyBGDAJK5vY9R3Ntl4GiRSF-EyyA31aq2O3E,8593
 notionary/core/converters/elements/callout_element.py,sha256=rkDoXikjIl-zU3GLawSXgRunBJGLnEvin9zIlCgW4TY,5964
 notionary/core/converters/elements/code_block_element.py,sha256=G1iGMsGSK5KPSk-tA8TsPs9XNU9ydjYfOVnjIvdZG74,5189
 notionary/core/converters/elements/column_element.py,sha256=ZwQsLBEownVJnzyv-GfNjvzJhAfKz9ncggqZUmZHF5A,10722
 notionary/core/converters/elements/divider_element.py,sha256=Ul0wXHY96qWL72iAvttRQMOoAGuASgwFwPraGnpUkX0,2792
-notionary/core/converters/elements/embed_element.py,sha256=vEqY7VBOAvtI4uwys6_E1FT9j4bkHJM21OYaT51ahe8,4800
+notionary/core/converters/elements/embed_element.py,sha256=AOFCAj5cR1mTg8scFh1GK3bmasSZLltp_xcrVZR3sOc,4784
 notionary/core/converters/elements/heading_element.py,sha256=BCBcpEO_UX92nzCclVHAjlOLFJ5zu9wDlAGbphesaOQ,2788
 notionary/core/converters/elements/image_element.py,sha256=uU3bY26LvJwD_CAXN11tqYt5Ed84gjUeHWnJmxvH07Y,4861
 notionary/core/converters/elements/list_element.py,sha256=lM9nVGVG3VtmjMkqxrBj71wiJITuRypwxORu4zghqAM,4878
@@ -19,36 +19,37 @@ notionary/core/converters/elements/qoute_element.py,sha256=CZD1Fe_Lhxsv4mdAM_dr4
 notionary/core/converters/elements/table_element.py,sha256=3V9bnNBdsslXZivQ0vpF4_rzrdyI3SWt3aYR814mOzA,11254
 notionary/core/converters/elements/text_inline_formatter.py,sha256=FE_Sq2cozpu5RVtMbnPq21gD06UjH3LMRYr3s16JKYo,10606
 notionary/core/converters/elements/todo_lists.py,sha256=wgY6YejURBQ5ESdVLZVIy9QKchS-x8odrmS8X4cC5Kc,4265
-notionary/core/converters/elements/toggle_element.py,sha256=Xv4MuuOyoamvT3IEJX4mynvLEycgtZ9LWt6Nm764KXE,6980
+notionary/core/converters/elements/toggle_element.py,sha256=17chs10njaMfhGeQblvy_JZA7gRMqLp7cXfipIdK3Jo,7635
 notionary/core/converters/elements/video_element.py,sha256=xrBLY3e_SgKNamItZkfPNMbNEh37Ftp4jWIV6nwV-ds,6047
-notionary/core/converters/registry/block_element_registry.py,sha256=SRIsPr6xb6xX7GHyrYYNBbt9-l6os29rQndmoXnr5W0,8707
+notionary/core/converters/registry/block_element_registry.py,sha256=MVL7SeUv5U2TzbqC5t9yDr1WQq7gOnQL2SnwSL-R478,8700
 notionary/core/converters/registry/block_element_registry_builder.py,sha256=D4GmIAdMoP7K1P78qlgN-GoDwtB_4dZTws049gtXQ5c,9457
+notionary/core/database/database_discovery.py,sha256=ViW3gcdujhmtwTa4HKv-bZOQXXbmBpZFLgzKT7vreXM,4625
 notionary/core/database/database_info_service.py,sha256=58k7om0UXP8w0jCJHewccG5UbOvELMBAbQvXOm7F1OM,1341
-notionary/core/database/notion_database_manager.py,sha256=cEQHf8bTcgA3hLMgsbMGSXhCmccmxWLQ6oOJiINR3ac,8257
-notionary/core/database/notion_database_manager_factory.py,sha256=SoWUiM5zdajmR1ppYHTdPgHrdZbwuTMdoXW3_tBffyU,6831
-notionary/core/database/notion_database_schema.py,sha256=WUIjG7I5kusk4GOOdmVSHIKc2Z8SeOgJ1FuGpTn4avQ,3304
+notionary/core/database/notion_database_manager.py,sha256=7xVJiR-7Kh2Wwoz1vMiOP5vfmNw_PoidnDqmjkHLxGA,7355
+notionary/core/database/notion_database_manager_factory.py,sha256=bJ_9AbKJnb1g--reo36I8Tlbt_pST5kCmKwlqtPOpq4,6921
 notionary/core/database/models/page_result.py,sha256=Vmm5_oYpYAkIIJVoTd1ZZGloeC3cmFLMYP255mAmtaw,233
-notionary/core/page/notion_page_manager.py,sha256=O5GBa2KzjAiqH_NDg4JpJbkNcfh3AD5uzTkhqHMr8XE,13635
-notionary/core/page/content/page_content_manager.py,sha256=GjgxVwi5NOMsvGwBNj-woq940ZupzALCQegDyIcsgMg,3358
-notionary/core/page/metadata/metadata_editor.py,sha256=U3Ff9GRk28dqT9M1xsl6Q3Cj47-hB1n2pNJzeDXy4ks,4938
-notionary/core/page/metadata/notion_icon_manager.py,sha256=v9pUG61TOT8x9UzDqBtQW6S5XQzWostq7IwrURnWvF4,1499
-notionary/core/page/metadata/notion_page_cover_manager.py,sha256=nDWXeEztKyPscq5dRxIZ6d6IqV7E3vR-Qg1N8KzP_fo,1831
-notionary/core/page/properites/database_property_service.py,sha256=z_HTt_HdB75ffYW5XNwfthZrjLEBXYqKrrK-iGHblek,12073
-notionary/core/page/properites/page_property_manager.py,sha256=jMiSt9uzr9bKXYhZMg60LVLewp03OFYCeD_qQhKmFT0,6806
-notionary/core/page/properites/property_formatter.py,sha256=N7GGf-ecUuMLvgt5T_KxabjmvUN7uJrMYFCL7438AZo,3665
-notionary/core/page/properites/property_operation_result.py,sha256=BVje4SnWf2EdWQYH8sv_6rGd2dL0Owsixfn9SuJY0bk,3961
-notionary/core/page/properites/property_value_extractor.py,sha256=IG8hKon83CZJ0zYJ-EtgHd2wbjoKOHdA3jB2vmR50Mw,2035
-notionary/core/page/relations/notion_page_relation_manager.py,sha256=EHavK75Semzh8d7edI1ubh0SJyD8E0loNWVIsfxGAY4,12685
-notionary/core/page/relations/notion_page_title_resolver.py,sha256=bV0ecP2dikr3vbTEXXsx_4jEtQtpQAHvG-wulASqj3o,1679
-notionary/core/page/relations/page_database_relation.py,sha256=2WO1HFyIMQwgYoxvxBDUa_iTnJu-Y3Wkzy4JGJ4loME,2420
-notionary/core/page/relations/relation_operation_result.py,sha256=XkO4rK0ha_FRsfq_Vlwp4a2cE-dGVPBrVxCXOlWqfwk,5258
+notionary/core/page/notion_page_manager.py,sha256=S3dPKK7YQ2VzNeQxyewkpkoyfuAwPiwjM_5pT7N8xms,23903
+notionary/core/page/content/notion_page_content_chunker.py,sha256=xRks74Dqec-De6-AVTxMPnXs-MSJBzSm1HfJfaHiKr8,3330
+notionary/core/page/content/page_content_manager.py,sha256=5qzpUFqMkOOqKWA6i6bWnGqbQyvdaEet0eNyerfFWck,3987
+notionary/core/page/metadata/metadata_editor.py,sha256=VUF5rQIo7DBKU3-Noa_Qifj3KQofc5ZAUZCCruCfx3g,4959
+notionary/core/page/metadata/notion_icon_manager.py,sha256=4CVahnmlf4m7nw5xBt_VC2Zuy1-tdC6aeLtf3vsFnPU,1431
+notionary/core/page/metadata/notion_page_cover_manager.py,sha256=g36tCRpOYLTzX6b7vbyPsz1tclDW9lB6rUobDcstR5c,1722
+notionary/core/page/properites/database_property_service.py,sha256=OJSfcXHRP5XGiMILcuvrnBKBbqz0kquMZVwp2i-wBtQ,11575
+notionary/core/page/properites/page_property_manager.py,sha256=SZmk2RPjraUyPb9lz2tX7hY5Vunjd85pftAwMeTdeL8,6949
+notionary/core/page/properites/property_formatter.py,sha256=d_Nr5XQxgjB6VIS0u3ey14MOUKY416o_BvdXjbkUNAQ,3667
+notionary/core/page/properites/property_operation_result.py,sha256=PhxHJJxxG2BdDl7aswhWnMSmf9RQtoinKkRHDoqxwCs,3913
+notionary/core/page/properites/property_value_extractor.py,sha256=1BfyCYrFzfIUmNTozavrLTjG--6P6Dy2tkewf6rHHwQ,2353
+notionary/core/page/relations/notion_page_relation_manager.py,sha256=A5bdJj_8fckTuXEMscuEcPwRs6S___tBz06ISN3Qh4Y,12697
+notionary/core/page/relations/notion_page_title_resolver.py,sha256=AcwQyji8WRysERXYXTFpl-kIz1yBxI4QF4HOWOqQWug,1727
+notionary/core/page/relations/page_database_relation.py,sha256=lhcRzh2kWFgUYofxznWTgbA-CjOpJudhroaWmf4WEs4,2318
+notionary/core/page/relations/relation_operation_result.py,sha256=NDxBzGntOxc_89ti-HG8xDSqfY6PwyGHKHrrKbCzNjM,5010
 notionary/exceptions/database_exceptions.py,sha256=I-Tx6bYRLpi5pjGPtbT-Mqxvz3BFgYTiuZxknJeLxtI,2638
 notionary/exceptions/page_creation_exception.py,sha256=4v7IuZD6GsQLrqhDLriGjuG3ML638gAO53zDCrLePuU,281
 notionary/util/logging_mixin.py,sha256=fKsx9t90bwvL74ZX3dU-sXdC4TZCQyO6qU9I8txkw_U,1369
-notionary/util/page_id_utils.py,sha256=9XexVGy8jY5iOlueS1MXFWHtRRmZ8js-EO3hT0_wg2E,1381
+notionary/util/page_id_utils.py,sha256=gMNhuD2qRZ7PT8MAxqPaTaM7dgT01H-YqNZjmJFbEDs,1359
 notionary/util/singleton_decorator.py,sha256=GTNMfIlVNRUVMw_c88xqd12-DcqZJjmyidN54yqiNVw,472
-notionary-0.1.11.dist-info/licenses/LICENSE,sha256=zOm3cRT1qD49eg7vgw95MI79rpUAZa1kRBFwL2FkAr8,1120
-notionary-0.1.11.dist-info/METADATA,sha256=3mCAD1Q1IlhUkPaf8NJAfDENEeZlZWjAmp1tN3e8F28,6154
-notionary-0.1.11.dist-info/WHEEL,sha256=CmyFI0kx5cdEMTLiONQRbGQwjIoR1aIYB7eCAQ4KPJ0,91
-notionary-0.1.11.dist-info/top_level.txt,sha256=fhONa6BMHQXqthx5PanWGbPL0b8rdFqhrJKVLf_adSs,10
-notionary-0.1.11.dist-info/RECORD,,
+notionary-0.1.12.dist-info/licenses/LICENSE,sha256=zOm3cRT1qD49eg7vgw95MI79rpUAZa1kRBFwL2FkAr8,1120
+notionary-0.1.12.dist-info/METADATA,sha256=FneQ0YUpzkxpWH05hySub93Q7Hzz3BeUzOubv90iWJg,6154
+notionary-0.1.12.dist-info/WHEEL,sha256=CmyFI0kx5cdEMTLiONQRbGQwjIoR1aIYB7eCAQ4KPJ0,91
+notionary-0.1.12.dist-info/top_level.txt,sha256=fhONa6BMHQXqthx5PanWGbPL0b8rdFqhrJKVLf_adSs,10
+notionary-0.1.12.dist-info/RECORD,,

notionary/core/database/notion_database_schema.py

@@ -1,104 +0,0 @@
-from typing import (
-    AsyncGenerator,
-    Dict,
-    Optional,
-    Any,
-)
-from notionary.core.notion_client import NotionClient
-from notionary.util.logging_mixin import LoggingMixin
-
-class NotionDatabaseAccessor(LoggingMixin):
-    """
-    A utility class that provides methods to access Notion databases.
-    Focused on efficient, paginated access to databases without unnecessary complexity.
-    """
-
-    def __init__(self, client: Optional[NotionClient] = None) -> None:
-        """
-        Initialize the accessor with a NotionClient.
-
-        Args:
-            client: NotionClient instance for API communication
-        """
-        self._client = client if client else NotionClient()
-        self.logger.info("NotionDatabaseAccessor initialized")
-
-    async def iter_databases(
-        self, page_size: int = 100
-    ) -> AsyncGenerator[Dict[str, Any], None]:
-        """
-        Asynchronous generator that yields Notion databases one by one.
-
-        Uses the Notion API to provide paginated access to all databases
-        without loading all of them into memory at once.
-
-        Args:
-            page_size: The number of databases to fetch per request
-
-        Yields:
-            Individual database objects from the Notion API
-        """
-        start_cursor: Optional[str] = None
-
-        while True:
-            body: Dict[str, Any] = {
-                "filter": {"value": "database", "property": "object"},
-                "page_size": page_size,
-            }
-
-            if start_cursor:
-                body["start_cursor"] = start_cursor
-
-            result = await self._client.post("search", data=body)
-
-            if not result or "results" not in result:
-                self.logger.error("Error fetching databases")
-                break
-
-            for database in result["results"]:
-                yield database
-
-            if "has_more" in result and result["has_more"] and "next_cursor" in result:
-                start_cursor = result["next_cursor"]
-            else:
-                break
-
-    async def get_database(self, database_id: str) -> Optional[Dict[str, Any]]:
-        """
-        Get the details for a specific database.
-
-        Args:
-            database_id: The ID of the database
-
-        Returns:
-            Database details or None if not found
-        """
-        db_details = await self._client.get(f"databases/{database_id}")
-        if not db_details:
-            self.logger.error("Failed to retrieve database %s", database_id)
-            return None
-
-        return db_details
-
-    def extract_database_title(self, database: Dict[str, Any]) -> str:
-        """
-        Extract the database title from a Notion API response.
-
-        Args:
-            database: The database object from the Notion API
-
-        Returns:
-            The extracted title or "Untitled" if no title is found
-        """
-        title = "Untitled"
-
-        if "title" in database:
-            title_parts = []
-            for text_obj in database["title"]:
-                if "plain_text" in text_obj:
-                    title_parts.append(text_obj["plain_text"])
-
-            if title_parts:
-                title = "".join(title_parts)
-
-        return title