tallyfy 1.0.7__py3-none-any.whl → 1.0.8__py3-none-any.whl

tallyfy/organization_management/__init__.py

@@ -0,0 +1,26 @@
+"""
+Organization management module for Tallyfy SDK
+"""
+
+from .base import OrganizationManagerBase
+from .retrieval import OrganizationRetrieval
+
+class OrganizationManager(OrganizationRetrieval):
+    """
+    Complete organization management interface combining all functionality.
+    
+    This class provides access to:
+    - Organization retrieval operations
+    
+    Example:
+        >>> from tallyfy import TallyfySDK
+        >>> sdk = TallyfySDK(api_key="your_api_key")
+        >>> orgs = sdk.organizations.get_current_user_organizations()
+        >>> print(f"User belongs to {len(orgs.data)} organizations")
+    """
+    pass
+
+# Maintain backward compatibility
+OrganizationManagement = OrganizationManager
+
+__all__ = ['OrganizationManager', 'OrganizationManagement', 'OrganizationRetrieval', 'OrganizationManagerBase']

tallyfy/organization_management/base.py

@@ -0,0 +1,76 @@
+"""
+Base class for organization management operations
+"""
+
+import logging
+from typing import Dict, Any, List, Optional
+from ..models import TallyfyError
+
+
+class OrganizationManagerBase:
+    """Base class providing common functionality for organization management operations"""
+
+    def __init__(self, sdk):
+        """
+        Initialize the organization manager base.
+        
+        Args:
+            sdk: The main Tallyfy SDK instance
+        """
+        self.sdk = sdk
+        self.logger = logging.getLogger(f"{__name__}.{self.__class__.__name__}")
+
+    def _extract_data(self, response_data: Dict[str, Any], default_empty: bool = True) -> Any:
+        """
+        Extract data from API response.
+        
+        Args:
+            response_data: Raw API response
+            default_empty: Return empty list if no data found
+            
+        Returns:
+            Extracted data
+        """
+        if not response_data:
+            return [] if default_empty else None
+            
+        # Handle direct data responses
+        if 'data' in response_data:
+            return response_data['data']
+        
+        # Handle responses where the main content is directly available
+        # This is common for single item responses
+        return response_data if not default_empty else []
+
+    def _handle_api_error(self, error: Exception, operation: str, **context) -> None:
+        """
+        Handle and log API errors consistently.
+        
+        Args:
+            error: The exception that occurred
+            operation: Description of the operation that failed
+            **context: Additional context for debugging
+        """
+        context_str = ", ".join([f"{k}={v}" for k, v in context.items()])
+        error_message = f"Failed to {operation}"
+        if context_str:
+            error_message += f" ({context_str})"
+        
+        self.logger.error(f"{error_message}: {str(error)}")
+        
+        if isinstance(error, TallyfyError):
+            raise error
+        else:
+            raise TallyfyError(f"{error_message}: {str(error)}")
+
+    def _build_query_params(self, **kwargs) -> Dict[str, Any]:
+        """
+        Build query parameters for API requests.
+        
+        Args:
+            **kwargs: Parameters to include in the query string
+            
+        Returns:
+            Dictionary of query parameters with None values filtered out
+        """
+        return {key: value for key, value in kwargs.items() if value is not None}

tallyfy/organization_management/retrieval.py

@@ -0,0 +1,39 @@
+"""
+Organization retrieval operations
+"""
+
+from typing import List, Optional
+from .base import OrganizationManagerBase
+from ..models import Organization, OrganizationsList, TallyfyError
+
+
+class OrganizationRetrieval(OrganizationManagerBase):
+    """Handles organization retrieval operations"""
+
+    def get_current_user_organizations(self, page: int = 1, per_page: int = 10) -> OrganizationsList:
+        """
+        Get all organizations the current member is a part of.
+
+        Args:
+            page: Page number (default: 1)
+            per_page: Number of results per page (default: 10, max: 100)
+
+        Returns:
+            OrganizationsList object containing organizations and pagination metadata
+
+        Raises:
+            TallyfyError: If the request fails
+        """
+        try:
+            endpoint = "me/organizations"
+            params = self._build_query_params(page=page, per_page=min(per_page, 100))
+            
+            response_data = self.sdk._make_request('GET', endpoint, params=params)
+
+            # Return the structured response with pagination
+            return OrganizationsList.from_dict(response_data)
+
+        except TallyfyError:
+            raise
+        except Exception as e:
+            self._handle_api_error(e, "get my organizations", page=page, per_page=per_page)

{tallyfy-1.0.7.dist-info → tallyfy-1.0.8.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tallyfy
-Version: 1.0.7
+Version: 1.0.8
 Summary: A comprehensive Python SDK for interacting with the Tallyfy API
 Home-page: https://github.com/tallyfy/tallyfy-sdk
 Author: Tallyfy
@@ -738,5 +738,5 @@ For bugs, feature requests, or questions:
 2. Contact us at: support@tallyfy.com
 ---
 
-**Version:** 1.0.7
+**Version:** 1.0.8
 **Last Updated:** 2025

{tallyfy-1.0.7.dist-info → tallyfy-1.0.8.dist-info}/RECORD

@@ -6,6 +6,9 @@ tallyfy/form_fields_management/base.py,sha256=6YH5wGTlG1EDEuEFxROz4CPadNHOVX1UZY
 tallyfy/form_fields_management/crud_operations.py,sha256=3XCJunGwMo8z4we8fva8zRryKajBcQMt9Jgg_Y_QM5Q,8877
 tallyfy/form_fields_management/options_management.py,sha256=cZWGBkR3770NEDQYDj9I1ug5lhGQ4tH482sZW6qkapk,8640
 tallyfy/form_fields_management/suggestions.py,sha256=4XaYG7SHAXjjxnVLDGtd0FGOxPrBzPnp4fTjd-Iuj34,16866
+tallyfy/organization_management/__init__.py,sha256=JvDHaULXypNW19UT0Dd3khcPAEh3CM7S9eo0TbutBoU,820
+tallyfy/organization_management/base.py,sha256=CMhLYarx7085A1pDUhGIHSMuYq1lAJEDzst8IT0F9k4,2477
+tallyfy/organization_management/retrieval.py,sha256=q3tZp1r7Sq0qBKru-dzxpmjGN46NDi6ZPp26-gdwgyM,1314
 tallyfy/task_management/__init__.py,sha256=5pknQarjvQZtv3Sa2GXxlMqSZ9skCIE6DsJwaGBQWU4,2963
 tallyfy/task_management/base.py,sha256=lHYvdFQh0YlFYawDnApZVU37UWnPkePFcYqFK1QLS1c,4027
 tallyfy/task_management/creation.py,sha256=reaiAFWH7GIlNLTzGwqgJX5iXbHUROXh5oFgEXv-bX4,9012
@@ -21,8 +24,8 @@ tallyfy/user_management/__init__.py,sha256=LTyxJ7i4JrsUMf8QMdtrLdwbgtv8_mmMi8eUm
 tallyfy/user_management/base.py,sha256=jD5jOAu3y0K7fumSH65t9zFRDLriOV-YYPZSuJzYuTE,4681
 tallyfy/user_management/invitation.py,sha256=Ss1Gtii-sS02GuY-XUPYi7dHwAKWMkaG_tRFVOfS_2Q,11395
 tallyfy/user_management/retrieval.py,sha256=M5xFlY2IPIR2b5TUbF0YF2Cm12Mdnu5ZU1iahBFI1vA,11696
-tallyfy-1.0.7.dist-info/licenses/LICENSE,sha256=8HUsrXnc3l2sZxhPV9Z1gYinq76Q2Ym7ahYJy57QlLc,1063
-tallyfy-1.0.7.dist-info/METADATA,sha256=ubTQlHzZnNEbfGa2dDYSFQHmnF9JnYSYoRwjF_iMsCo,26359
-tallyfy-1.0.7.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-tallyfy-1.0.7.dist-info/top_level.txt,sha256=yIycWbR61EZJD0MYRPwUQjOS2XZw5B5jCWx1IP73KcM,8
-tallyfy-1.0.7.dist-info/RECORD,,
+tallyfy-1.0.8.dist-info/licenses/LICENSE,sha256=8HUsrXnc3l2sZxhPV9Z1gYinq76Q2Ym7ahYJy57QlLc,1063
+tallyfy-1.0.8.dist-info/METADATA,sha256=qGTkAQyLP2o_1AEfgjFM_-zCmTLhVvkAd3q7KOOaEzs,26359
+tallyfy-1.0.8.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+tallyfy-1.0.8.dist-info/top_level.txt,sha256=yIycWbR61EZJD0MYRPwUQjOS2XZw5B5jCWx1IP73KcM,8
+tallyfy-1.0.8.dist-info/RECORD,,