tallyfy 1.0.6__tar.gz → 1.0.8__tar.gz

{tallyfy-1.0.6 → tallyfy-1.0.8}/CHANGELOG.md

@@ -5,7 +5,7 @@ All notable changes to the Tallyfy SDK will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## [1.0.6] - 2025-07-29
+## [1.0.8] - 2025-07-29
 
 ### Changed
 - **BREAKING**: Refactored user management from monolithic to modular architecture

{tallyfy-1.0.6/tallyfy.egg-info → tallyfy-1.0.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tallyfy
-Version: 1.0.6
+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.6
+**Version:** 1.0.8
 **Last Updated:** 2025

{tallyfy-1.0.6 → tallyfy-1.0.8}/README.md

@@ -693,5 +693,5 @@ For bugs, feature requests, or questions:
 2. Contact us at: support@tallyfy.com
 ---
 
-**Version:** 1.0.6
+**Version:** 1.0.8
 **Last Updated:** 2025

{tallyfy-1.0.6 → tallyfy-1.0.8}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "tallyfy"
-version = "1.0.6"
+version = "1.0.8"
 description = "A comprehensive Python SDK for interacting with the Tallyfy API"
 readme = "README.md"
 requires-python = ">=3.7"

{tallyfy-1.0.6 → tallyfy-1.0.8}/setup.py

@@ -17,7 +17,7 @@ def get_version():
         for line in f:
             if line.startswith('__version__'):
                 return line.split('=')[1].strip().strip('"').strip("'")
-    return '1.0.6'
+    return '1.0.8'
 
 setup(
     name='tallyfy',

{tallyfy-1.0.6 → tallyfy-1.0.8}/tallyfy/__init__.py

@@ -8,6 +8,7 @@ from .user_management import UserManager, UserManagement
 from .task_management import TaskManager, TaskManagement
 from .template_management import TemplateManager, TemplateManagement
 from .form_fields_management import FormFieldManager, FormFieldManagement
+from .organization_management import OrganizationManager, OrganizationManagement
 
 __version__ = "1.0.0"
 __all__ = [
@@ -20,5 +21,7 @@ __all__ = [
     "TemplateManager",
     "TemplateManagement",
     "FormFieldManager",
-    "FormFieldManagement"
+    "FormFieldManagement",
+    "OrganizationManager",
+    "OrganizationManagement"
 ]

{tallyfy-1.0.6 → tallyfy-1.0.8}/tallyfy/core.py

@@ -152,15 +152,21 @@ class TallyfySDK(BaseSDK):
         from .task_management import TaskManager  
         from .template_management import TemplateManager
         from .form_fields_management import FormFieldManager
+        from .organization_management import OrganizationManager
         
         self.users = UserManager(self)
         self.tasks = TaskManager(self)
         self.templates = TemplateManager(self)
         self.form_fields = FormFieldManager(self)
+        self.organizations = OrganizationManager(self)
 
     def get_current_user_info(self, org_id: str):
         """Get current user information."""
         return self.users.get_current_user_info(org_id)
+    
+    def get_current_user_organizations(self, page: int = 1, per_page: int = 10):
+        """Get all organizations the current member is a part of."""
+        return self.organizations.get_current_user_organizations(page, per_page)
     # Backward compatibility methods - delegate to management modules
     def get_organization_users(self, org_id: str, with_groups: bool = False):
         """Get all organization members with full profile data."""

{tallyfy-1.0.6 → tallyfy-1.0.8}/tallyfy/models.py

@@ -1056,6 +1056,246 @@ class PaginationMeta:
         )
 
 
+@dataclass
+class OrganizationWorkingDays:
+    """Organization working days configuration"""
+    Monday: Optional[Dict[str, Any]] = None
+    Tuesday: Optional[Dict[str, Any]] = None
+    Wednesday: Optional[Dict[str, Any]] = None
+    Thursday: Optional[Dict[str, Any]] = None
+    Friday: Optional[Dict[str, Any]] = None
+    Saturday: Optional[Dict[str, Any]] = None
+    Sunday: Optional[Dict[str, Any]] = None
+    
+    @classmethod
+    def from_dict(cls, data: Dict[str, Any]) -> 'OrganizationWorkingDays':
+        """Create OrganizationWorkingDays instance from dictionary"""
+        return cls(
+            Monday=data.get('Monday'),
+            Tuesday=data.get('Tuesday'),
+            Wednesday=data.get('Wednesday'),
+            Thursday=data.get('Thursday'),
+            Friday=data.get('Friday'),
+            Saturday=data.get('Saturday'),
+            Sunday=data.get('Sunday')
+        )
+
+
+@dataclass
+class OrganizationDefaultDeadline:
+    """Organization default deadline configuration"""
+    type: str = "days"
+    value: int = 5
+    
+    @classmethod
+    def from_dict(cls, data: Dict[str, Any]) -> 'OrganizationDefaultDeadline':
+        """Create OrganizationDefaultDeadline instance from dictionary"""
+        return cls(
+            type=data.get('type', 'days'),
+            value=data.get('value', 5)
+        )
+
+
+@dataclass
+class OrganizationAutoArchive:
+    """Organization auto archive configuration"""
+    unit: str = "weeks"
+    value: int = 52
+    
+    @classmethod
+    def from_dict(cls, data: Dict[str, Any]) -> 'OrganizationAutoArchive':
+        """Create OrganizationAutoArchive instance from dictionary"""
+        return cls(
+            unit=data.get('unit', 'weeks'),
+            value=data.get('value', 52)
+        )
+
+
+@dataclass
+class Organization:
+    """Organization data model"""
+    id: str
+    name: str
+    industry: Optional[str] = None
+    description: Optional[str] = None
+    address1: Optional[str] = None
+    address2: Optional[str] = None
+    created_on: Optional[str] = None
+    last_updated: Optional[str] = None
+    live_support_enabled: int = 0
+    org_logo: Optional[str] = None
+    settings: Optional[str] = None
+    country: Optional[str] = None
+    state: Optional[str] = None
+    city: Optional[str] = None
+    zipcode: Optional[str] = None
+    users_count: int = 0
+    payment_state: Optional[str] = None
+    team_size: Optional[List[int]] = None
+    signup_survey: Optional[str] = None
+    in_trial: bool = False
+    analytics_enabled: bool = True
+    limit_trial_features: bool = False
+    real_time_billing: bool = True
+    saml_enabled: bool = False
+    saml_login_url: Optional[str] = None
+    sso_default_role: Optional[str] = None
+    preferred_trial_plan: Optional[str] = None
+    google_analytics_id: Optional[str] = None
+    mixpanel_token: Optional[str] = None
+    plan_code: Optional[str] = None
+    auto_join_signups: bool = False
+    home_bg: Optional[str] = None
+    guest_onboarding_snippet: Optional[str] = None
+    maximum_group_assignment_limit: int = 0
+    allow_user_invite: bool = True
+    allow_manage_groups: bool = True
+    working_days: Optional[OrganizationWorkingDays] = None
+    deadline_setting: Optional[str] = None
+    wyiwyg: bool = True
+    cadence_days: Optional[List[str]] = None
+    guest_cadence_days: Optional[List[str]] = None
+    timezone: Optional[str] = None
+    default_deadline: Optional[OrganizationDefaultDeadline] = None
+    auto_archive: bool = False
+    auto_complete_tasks: bool = True
+    auto_complete_task_months: int = 18
+    light_role_error_snippet: Optional[str] = None
+    azure_cognitive_service: Optional[str] = None
+    global_css: Optional[str] = None
+    error_404_template: Optional[str] = None
+    enable_custom_404_error: bool = False
+    enable_custom_smtp: bool = False
+    onboarding_template_id: Optional[str] = None
+    enable_onboarding_template: bool = True
+    disable_min_members_billing: bool = False
+    enable_light_users_billing: bool = False
+    webhook_date_field_format: str = "yyyy-MM-ddTHH:mm:ssZ"
+    purpose: Optional[str] = None
+    process_today: Optional[str] = None
+    restrict_blueprint_permissions: bool = False
+    auto_archive_processes_after: Optional[OrganizationAutoArchive] = None
+    use_generative_ai: bool = True
+    homepage_snippet: Optional[str] = None
+    onboarding_snippet: Optional[str] = None
+    disabled_on: Optional[str] = None
+    last_accessed: Optional[str] = None
+    user_role: Optional[str] = None
+    
+    def __post_init__(self):
+        """Initialize empty lists if None"""
+        if self.team_size is None:
+            self.team_size = []
+        if self.cadence_days is None:
+            self.cadence_days = []
+        if self.guest_cadence_days is None:
+            self.guest_cadence_days = []
+    
+    @classmethod
+    def from_dict(cls, data: Dict[str, Any]) -> 'Organization':
+        """Create Organization instance from dictionary"""
+        working_days_data = data.get('working_days')
+        working_days = OrganizationWorkingDays.from_dict(working_days_data) if working_days_data else None
+        
+        default_deadline_data = data.get('default_deadline')
+        default_deadline = OrganizationDefaultDeadline.from_dict(default_deadline_data) if default_deadline_data else None
+        
+        auto_archive_processes_after_data = data.get('auto_archive_processes_after')
+        auto_archive_processes_after = OrganizationAutoArchive.from_dict(auto_archive_processes_after_data) if auto_archive_processes_after_data else None
+        
+        return cls(
+            id=data.get('id', ''),
+            name=data.get('name', ''),
+            industry=data.get('industry'),
+            description=data.get('description'),
+            address1=data.get('address1'),
+            address2=data.get('address2'),
+            created_on=data.get('created_on'),
+            last_updated=data.get('last_updated'),
+            live_support_enabled=data.get('live_support_enabled', 0),
+            org_logo=data.get('org_logo'),
+            settings=data.get('settings'),
+            country=data.get('country'),
+            state=data.get('state'),
+            city=data.get('city'),
+            zipcode=data.get('zipcode'),
+            users_count=data.get('users_count', 0),
+            payment_state=data.get('payment_state'),
+            team_size=data.get('team_size', []),
+            signup_survey=data.get('signup_survey'),
+            in_trial=data.get('in_trial', False),
+            analytics_enabled=data.get('analytics_enabled', True),
+            limit_trial_features=data.get('limit_trial_features', False),
+            real_time_billing=data.get('real_time_billing', True),
+            saml_enabled=data.get('saml_enabled', False),
+            saml_login_url=data.get('saml_login_url'),
+            sso_default_role=data.get('sso_default_role'),
+            preferred_trial_plan=data.get('preferred_trial_plan'),
+            google_analytics_id=data.get('google_analytics_id'),
+            mixpanel_token=data.get('mixpanel_token'),
+            plan_code=data.get('plan_code'),
+            auto_join_signups=data.get('auto_join_signups', False),
+            home_bg=data.get('home_bg'),
+            guest_onboarding_snippet=data.get('guest_onboarding_snippet'),
+            maximum_group_assignment_limit=data.get('maximum_group_assignment_limit', 0),
+            allow_user_invite=data.get('allow_user_invite', True),
+            allow_manage_groups=data.get('allow_manage_groups', True),
+            working_days=working_days,
+            deadline_setting=data.get('deadline_setting'),
+            wyiwyg=data.get('wyiwyg', True),
+            cadence_days=data.get('cadence_days', []),
+            guest_cadence_days=data.get('guest_cadence_days', []),
+            timezone=data.get('timezone'),
+            default_deadline=default_deadline,
+            auto_archive=data.get('auto_archive', False),
+            auto_complete_tasks=data.get('auto_complete_tasks', True),
+            auto_complete_task_months=data.get('auto_complete_task_months', 18),
+            light_role_error_snippet=data.get('light_role_error_snippet'),
+            azure_cognitive_service=data.get('azure_cognitive_service'),
+            global_css=data.get('global_css'),
+            error_404_template=data.get('error_404_template'),
+            enable_custom_404_error=data.get('enable_custom_404_error', False),
+            enable_custom_smtp=data.get('enable_custom_smtp', False),
+            onboarding_template_id=data.get('onboarding_template_id'),
+            enable_onboarding_template=data.get('enable_onboarding_template', True),
+            disable_min_members_billing=data.get('disable_min_members_billing', False),
+            enable_light_users_billing=data.get('enable_light_users_billing', False),
+            webhook_date_field_format=data.get('webhook_date_field_format', 'yyyy-MM-ddTHH:mm:ssZ'),
+            purpose=data.get('purpose'),
+            process_today=data.get('process_today'),
+            restrict_blueprint_permissions=data.get('restrict_blueprint_permissions', False),
+            auto_archive_processes_after=auto_archive_processes_after,
+            use_generative_ai=data.get('use_generative_ai', True),
+            homepage_snippet=data.get('homepage_snippet'),
+            onboarding_snippet=data.get('onboarding_snippet'),
+            disabled_on=data.get('disabled_on'),
+            last_accessed=data.get('last_accessed'),
+            user_role=data.get('user_role')
+        )
+
+
+@dataclass
+class OrganizationsList:
+    """Organizations list response with pagination"""
+    data: List[Organization]
+    meta: PaginationMeta
+    
+    @classmethod
+    def from_dict(cls, data: Dict[str, Any]) -> 'OrganizationsList':
+        """Create OrganizationsList instance from dictionary"""
+        organizations_data = data.get('data', [])
+        organizations = [Organization.from_dict(org_data) for org_data in organizations_data]
+        
+        meta_data = data.get('meta', {})
+        pagination_meta = meta_data.get('pagination', {})
+        meta = PaginationMeta.from_dict(pagination_meta)
+        
+        return cls(
+            data=organizations,
+            meta=meta
+        )
+
+
 @dataclass
 class TemplatesList:
     """Templates list response with pagination"""

tallyfy-1.0.8/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-1.0.8/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-1.0.8/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.6 → tallyfy-1.0.8/tallyfy.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tallyfy
-Version: 1.0.6
+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.6
+**Version:** 1.0.8
 **Last Updated:** 2025

{tallyfy-1.0.6 → tallyfy-1.0.8}/tallyfy.egg-info/SOURCES.txt

@@ -18,6 +18,9 @@ tallyfy/form_fields_management/base.py
 tallyfy/form_fields_management/crud_operations.py
 tallyfy/form_fields_management/options_management.py
 tallyfy/form_fields_management/suggestions.py
+tallyfy/organization_management/__init__.py
+tallyfy/organization_management/base.py
+tallyfy/organization_management/retrieval.py
 tallyfy/task_management/__init__.py
 tallyfy/task_management/base.py
 tallyfy/task_management/creation.py