geobox 1.4.1__py3-none-any.whl → 2.0.0__py3-none-any.whl

geobox/aio/route.py

@@ -0,0 +1,63 @@
+from typing import Dict, TYPE_CHECKING
+from urllib.parse import urljoin, urlencode
+
+from ..enums import RoutingGeometryType, RoutingOverviewLevel
+from ..utils import clean_data
+
+if TYPE_CHECKING:
+    from . import AsyncGeoboxClient
+
+class Routing:
+
+    BASE_ENDPOINT = 'routing/'
+
+    @classmethod
+    async def route(cls, api: 'AsyncGeoboxClient', stops: str, **kwargs) -> Dict:
+        """
+        Find best driving routes between coordinates and return results.
+
+        Args:
+            api (AsyncGeoboxClient): The AsyncGeoboxClient instance for making requests.
+            stops (str): Comma-separated list of stop coordinates in the format lon,lat;lon,lat.
+
+        Keyword Args:
+            alternatives (bool): Whether to return alternative routes. Default value : False.
+            steps (bool): Whether to include step-by-step navigation instructions. Default value : False.
+            geometries (RoutingGeometryType): Format of the returned geometry.
+            overview (RoutingOverviewLevel): Level of detail in the returned geometry.
+            annotations (bool): Whether to include additional metadata like speed, weight, etc.
+
+        Returns:
+            Dict: the routing output
+
+        Example:
+            >>> from geobox.aio import AsyncGeoboxClient
+            >>> from geobox.aio.route import Routing
+            >>> async with AsyncGeoboxClient() as client:
+            >>>     route = await routing.route(client,
+            ...                             stops="53,33;56,36",
+            ...                             alternatives=True,
+            ...                             steps=True,
+            ...                             geometries=RoutingGeometryType.geojson,
+            ...                             overview=RoutingOverviewLevel.full,
+            ...                             annotations=True)
+            or  
+            >>>     route = await client.route(stops="53,33;56,36",
+            ...                             alternatives=True,
+            ...                             steps=True,
+            ...                             geometries=RoutingGeometryType.geojson,
+            ...                             overview=RoutingOverviewLevel.full,
+            ...                             annotations=True)
+        """
+        params = clean_data({
+            'stops': stops,
+            'alternatives': kwargs.get('alternatives'),
+            'steps': kwargs.get('steps'),
+            'geometries': kwargs.get('geometries').value if kwargs.get('geometries') else None,
+            'overview': kwargs.get('overview').value if kwargs.get('geometries') else None,
+            'annotaions': kwargs.get('annotations')
+        })
+        query_string = urlencode(params)
+        endpoint = f"{cls.BASE_ENDPOINT}route?{query_string}"
+        return await api.get(endpoint)
+    

geobox/aio/scene.py

@@ -0,0 +1,342 @@
+from typing import List, Dict, Optional, TYPE_CHECKING, Union
+from urllib.parse import urljoin
+
+from .base import AsyncBase
+
+if TYPE_CHECKING:
+    from . import AsyncGeoboxClient
+    from .user import User
+    from ..api import GeoboxClient as SyncGeoboxClient
+    from ..scene import Scene as SyncScene
+
+class Scene(AsyncBase):
+
+    BASE_ENDPOINT = 'scenes/'
+
+    def __init__(self, 
+                 api: 'AsyncGeoboxClient', 
+                 uuid: str,
+                 data: Optional[Dict] = {}):
+        """
+        Initialize a Scene instance.
+
+        Args:
+            api (AsyncGeoboxClient): The AsyncGeoboxClient instance for making requests.
+            uuid (str): The unique identifier for the Scene.
+            data (Dict): The data of the Scene.
+        """
+        super().__init__(api, uuid=uuid, data=data)
+
+
+    @classmethod
+    async def get_scenes(cls, api: 'AsyncGeoboxClient', **kwargs) -> Union[List['Scene'], int]:
+        """
+        [async] Get list of scenes with optional filtering and pagination.
+
+        Args:
+            api (AsyncGeoboxClient): The AsyncGeoboxClient instance for making requests.
+
+        Keyword Args:
+            q (str): query filter based on OGC CQL standard. e.g. "field1 LIKE '%GIS%' AND created_at > '2021-01-01'"
+            search (str): search term for keyword-based searching among search_fields or all textual fields if search_fields does not have value. NOTE: if q param is defined this param will be ignored.
+            search_fields (str): comma separated list of fields for searching.
+            order_by (str): comma separated list of fields for sorting results [field1 A|D, field2 A|D, …]. e.g. name A, type D. NOTE: "A" denotes ascending order and "D" denotes descending order.
+            return_count (bool): Whether to return total count. default is False.
+            skip (int): Number of items to skip. default is 0.
+            limit (int): Number of items to return. default is 10.
+            user_id (int): Specific user. privileges required.
+            shared (bool): Whether to return shared scenes. default is False.
+
+        Returns:
+            List[Scene] | int: A list of scene instances or the total number of scenes.
+
+        Example:
+            >>> from geobox.aio import AsyncGeoboxClient
+            >>> from geobox.aio.scene import Scene
+            >>> async with AsyncGeoboxClient() as client:
+            >>>     scenes = await Scene.get_scenes(client, q="name LIKE '%My scene%'")
+            or  
+            >>>     scenes = await client.get_scenes(q="name LIKE '%My scene%'")
+        """
+        params = {
+           'f': 'json',
+           'q': kwargs.get('q'),
+           'search': kwargs.get('search'),
+           'search_fields': kwargs.get('search_fields'),
+           'order_by': kwargs.get('order_by'),
+           'return_count': kwargs.get('return_count', False),
+           'skip': kwargs.get('skip', 0),
+           'limit': kwargs.get('limit', 10),
+           'user_id': kwargs.get('user_id'),
+           'shared': kwargs.get('shared', False)
+        }
+        return await super()._get_list(api, cls.BASE_ENDPOINT, params, factory_func=lambda api, item: Scene(api, item['uuid'], item))
+    
+
+    @classmethod
+    async def create_scene(cls, 
+                     api: 'AsyncGeoboxClient', 
+                     name: str, 
+                     display_name: str = None, 
+                     description: str = None, 
+                     settings: Dict = {}, 
+                     thumbnail: str = None, 
+                     user_id: int = None) -> 'Scene':
+        """
+        [async] Create a new scene.
+
+        Args:
+            api (AsyncGeoboxClient): The AsyncGeoboxClient instance for making requests.
+            name (str): The name of the scene.
+            display_name (str, optional): The display name of the scene.
+            description (str, optional): The description of the scene.
+            settings (Dict,optional): The settings of the scene.
+            thumbnail (str, optional): The thumbnail of the scene.
+            user_id (int, optional): Specific user. privileges required.
+
+        Returns:
+            Scene: The newly created scene instance.
+
+        Raises:
+            ValidationError: If the scene data is invalid.
+
+        Example:
+            >>> from geobox.aio import AsyncGeoboxClient
+            >>> from geobox.aio.scene import Scene
+            >>> async with AsyncGeoboxClient() as client:
+            >>>     scene = await Scene.create_scene(client, name="my_scene")
+            or  
+            >>>     scene = await client.create_scene(name="my_scene")
+        """
+        data = {
+            "name": name,
+            "display_name": display_name,
+            "description": description,
+            "settings": settings,
+            "thumbnail": thumbnail,
+            "user_id": user_id,
+        }
+        return await super()._create(api, cls.BASE_ENDPOINT, data, factory_func=lambda api, item: Scene(api, item['uuid'], item))
+
+    
+    @classmethod
+    async def get_scene(cls, api: 'AsyncGeoboxClient', uuid: str, user_id: int = None) -> 'Scene':
+        """
+        [async] Get a scene by its UUID.
+
+        Args:
+            api (AsyncGeoboxClient): The AsyncGeoboxClient instance for making requests.
+            uuid (str): The UUID of the scene to get.
+            user_id (int, optional): Specific user. privileges required.
+
+        Returns:
+            Scene: The scene object.
+
+        Raises:
+            NotFoundError: If the scene with the specified UUID is not found.
+
+        Example:
+            >>> from geobox.aio import AsyncGeoboxClient
+            >>> from geobox.aio.scene import Scene
+            >>> async with AsyncGeoboxClient() as client:
+            >>>     scene = await Scene.get_scene(client, uuid="12345678-1234-5678-1234-567812345678")
+            or  
+            >>>     scene = await client.get_scene(uuid="12345678-1234-5678-1234-567812345678")
+        """
+        params = {
+            'f': 'json',
+            'user_id': user_id,
+        }
+        return await super()._get_detail(api, cls.BASE_ENDPOINT, uuid, params, factory_func=lambda api, item: Scene(api, item['uuid'], item))
+
+
+    @classmethod
+    async def get_scene_by_name(cls, api: 'AsyncGeoboxClient', name: str, user_id: int = None) -> Union['Scene', None]:
+        """
+        [async] Get a scene by name
+
+        Args:
+            api (AsyncGeoboxClient): The AsyncGeoboxClient instance for making requests.
+            name (str): the name of the scene to get
+            user_id (int, optional): specific user. privileges required.
+
+        Returns:
+            Scene | None: returns the scene if a scene matches the given name, else None
+
+        Example:
+            >>> from geobox.aio import AsyncGeoboxClient
+            >>> from geobox.aio.scene import Scene
+            >>> async with AsyncGeoboxClient() as client:
+            >>>     scene = await Scene.get_scene_by_name(client, name='test')
+            or  
+            >>>     scene = await client.get_scene_by_name(name='test')
+        """
+        scenes = await cls.get_scenes(api, q=f"name = '{name}'", user_id=user_id)
+        if scenes and scenes[0].name == name:
+            return scenes[0]
+        else:
+            return None
+
+
+    async def update(self, **kwargs) -> Dict:
+        """
+        [async] Update the scene.
+
+        Keyword Args:
+            name (str): The name of the scene.
+            display_name (str): The display name of the scene.
+            description (str): The description of the scene.
+            settings (Dict): The settings of the scene.
+            thumbnail (str): The thumbnail of the scene.
+
+        Returns:
+            Dict: The updated scene data.
+
+        Raises:
+            ApiRequestError: If the API request fails.
+            ValidationError: If the scene data is invalid.
+
+        Example:
+            >>> from geobox.aio import AsyncGeoboxClient
+            >>> from geobox.aio.scene import Scene
+            >>> async with AsyncGeoboxClient() as client:
+            >>>     scene = await Scene.get_scene(client, uuid="12345678-1234-5678-1234-567812345678")
+            >>>     await scene.update(display_name="New Display Name")
+        """
+        data = {
+            "name": kwargs.get('name'),
+            "display_name": kwargs.get('display_name'),   
+            "description": kwargs.get('description'),
+            "settings": kwargs.get('settings'),
+            "thumbnail": kwargs.get('thumbnail')
+        }
+        return await super()._update(self.endpoint, data)
+    
+
+    async def delete(self) -> None:
+        """
+        [async] Delete the scene.
+
+        Returns:
+            None
+
+        Example:
+            >>> from geobox.aio import AsyncGeoboxClient
+            >>> from geobox.aio.scene import Scene
+            >>> async with AsyncGeoboxClient() as client:
+            >>>     scene = await Scene.get_scene(client, uuid="12345678-1234-5678-1234-567812345678")
+            >>>     await scene.delete()
+        """
+        await super().delete(self.endpoint)
+
+
+    @property
+    def thumbnail(self) -> str:
+        """
+        Get the thumbnail URL of the scene.
+
+        Returns:
+            str: The thumbnail of the scene.
+
+        Example:
+            >>> from geobox.aio import AsyncGeoboxClient
+            >>> from geobox.aio.scene import Scene
+            >>> async with AsyncGeoboxClient() as client:
+            >>>     scene = await Scene.get_scene(client, uuid="12345678-1234-5678-1234-567812345678")
+            >>>     scene.thumbnail
+            'https://example.com/thumbnail.png'
+        """
+        return super().thumbnail()
+    
+
+    async def share(self, users: List['User']) -> None:
+        """
+        [async] Shares the scene with specified users.
+
+        Args:
+            users (List[User]): The list of user objects to share the scene with.
+
+        Returns:
+            None
+
+        Example:
+            >>> from geobox.aio import AsyncGeoboxClient
+            >>> from geobox.aio.scene import Scene
+            >>> async with AsyncGeoboxClient() as client:
+            >>>     scene = await Scene.get_scene(client, uuid="12345678-1234-5678-1234-567812345678")
+            >>>     users = await client.search_users(search='John')
+            >>>     await scene.share(users=users)
+        """
+        await super()._share(self.endpoint, users)
+    
+
+    async def unshare(self, users: List['User']) -> None:
+        """
+        [async] Unshares the scene with specified users.
+
+        Args:
+            users (List[User]): The list of user objects to unshare the scene with.
+
+        Returns:
+            None
+
+        Example:
+            >>> from geobox.aio import AsyncGeoboxClient
+            >>> from geobox.aio.scene import Scene
+            >>> async with AsyncGeoboxClient() as client:
+            >>>     scene = await Scene.get_scene(client, uuid="12345678-1234-5678-1234-567812345678")
+            >>>     users = await client.search_users(search='John')
+            >>>     await scene.unshare(users=users)
+        """
+        await super()._unshare(self.endpoint, users)
+
+
+    async def get_shared_users(self, search: str = None, skip: int = 0, limit: int = 10) -> List['User']:
+        """
+        [async] Retrieves the list of users the scene is shared with.
+
+        Args:
+            search (str, optional): The search query.
+            skip (int, optional): The number of users to skip.
+            limit (int, optional): The maximum number of users to retrieve.
+
+        Returns:
+            List[User]: The list of shared users.
+
+        Example:
+            >>> from geobox.aio import AsyncGeoboxClient
+            >>> from geobox.aio.scene import Scene
+            >>> async with AsyncGeoboxClient() as client:
+            >>>     scene = await Scene.get_scene(client, uuid="12345678-1234-5678-1234-567812345678")
+            >>>     await scene.get_shared_users(search='John', skip=0, limit=10)
+        """
+        params = {
+            'search': search,
+            'skip': skip,
+            'limit': limit
+        }
+        return await super()._get_shared_users(self.endpoint, params)
+
+
+    def to_sync(self, sync_client: 'SyncGeoboxClient') -> 'SyncScene':
+        """
+        Switch to sync version of the scene instance to have access to the sync methods
+
+        Args:
+            sync_client (SyncGeoboxClient): The sync version of the GeoboxClient instance for making requests.
+
+        Returns:
+            geobox.scene.Scene: the sync instance of the scene.
+
+        Example:
+            >>> from geobox import Geoboxclient
+            >>> from geobox.aio import AsyncGeoboxClient
+            >>> from geobox.aio.scene import Scene
+            >>> client = GeoboxClient()
+            >>> async with AsyncGeoboxClient() as async_client:
+            >>>     scene = await Scene.get_scene(async_client, uuid="12345678-1234-5678-1234-567812345678")
+            >>>     sync_scene = scene.to_sync(client)
+        """
+        from ..scene import Scene as SyncScene
+
+        return SyncScene(api=sync_client, uuid=self.uuid, data=self.data)

geobox/aio/settings.py

@@ -0,0 +1,194 @@
+from typing import List, Dict, Optional, TYPE_CHECKING
+from urllib.parse import urljoin, urlencode
+
+from .base import AsyncBase
+from ..utils import clean_data
+from ..enums import MaxLogPolicy, InvalidDataPolicy, LoginFailurePolicy, MaxConcurrentSessionPolicy
+
+if TYPE_CHECKING:
+    from . import AsyncGeoboxClient
+    from ..api import GeoboxClient as SyncGeoboxClient
+    from ..settings import SystemSettings as SyncSystemSettings
+
+
+class SystemSettings(AsyncBase):
+
+    BASE_ENDPOINT = 'settings/'
+
+    def __init__(self, 
+                 api: 'AsyncGeoboxClient', 
+                 data: Optional[Dict] = {}):
+        """
+        Initialize a System Settings instance.
+
+        Args:
+            api (AsyncGeoboxClient): The AsyncGeoboxClient instance for making requests.
+            data (Dict, optional): The data of the Setting.
+        """
+        super().__init__(api, data=data)
+
+
+    @property
+    def max_log_policy(self) -> 'MaxLogPolicy':
+        """
+        Get max log policy
+
+        Returns:
+            MaxLogPolicy: max log policy
+        """
+        return MaxLogPolicy(self.data.get('max_log_policy'))
+    
+
+    @property
+    def invalid_data_policy(self) -> 'InvalidDataPolicy':
+        """
+        Get invalid data policy
+
+        Returns:
+            InvalidDataPolicy: invalid data policy
+        """
+        return InvalidDataPolicy(self.data.get('invalid_data_policy'))
+    
+
+    @property
+    def login_failure_policy(self) -> 'LoginFailurePolicy':
+        """
+        Get login failure policy
+
+        Returns:
+            LoginFailurePolicy: login failure policy
+        """
+        return LoginFailurePolicy(self.data.get('login_failure_policy'))
+    
+
+    @property
+    def max_concurrent_session_policy(self) -> 'MaxConcurrentSessionPolicy':
+        """
+        Get max concurrent sessions
+
+        Returns:
+            MaxConcurrentSessionPolicy: max concurrent sessions
+        """
+        return MaxConcurrentSessionPolicy(self.data.get('max_concurrent_session_policy'))
+
+
+    def __repr__(self) -> str:
+        """
+        Return a string representation of the system setting instance.
+
+        Returns:
+            str: A string representation of the system setting instance.
+        """
+        return "SystemSettings()"
+
+
+    @classmethod
+    async def get_system_settings(cls, api: 'AsyncGeoboxClient') -> 'SystemSettings':
+        """
+        [async] Get System Settings object (Permission Required).
+
+        Args: 
+            api (AsyncGeoboxClient): The AsyncGeoboxClient instance for making requests.
+
+        Returns:
+            SystemSetting: the system settings object.
+
+        Example:
+            >>> from geobox.aio import AsyncGeoboxClient
+            >>> from geobox.aio.setting import SystemSettings
+            >>> async with AsyncGeoboxClient() as client:
+            >>>     setting = await SystemSettings.get_system_settings(client)
+            or  
+            >>>     setting = await client.get_system_settings()
+        """
+        params = clean_data({
+            'f': 'json'
+        })
+        query_string = urlencode(params)
+        endpoint = urljoin(cls.BASE_ENDPOINT, f"?{query_string}")
+        response = await api.get(endpoint)
+        return SystemSettings(api, response)
+
+
+    async def update(self, **kwargs) -> Dict:
+        """
+        [async] Update the system settings.
+
+        Keyword Args:
+            brand_name (str)
+            brand_website (str)
+            max_log (int)
+            max_log_policy (MaxLogPolicy)
+            users_can_view_their_own_logs (bool)
+            max_upload_file_size (int)
+            invalid_data_policy (InvalidDataPolicy)
+            max_login_attempts (int)
+            login_failure_policy (LoginFailurePolicy)
+            login_attempts_duration (int)
+            min_password_length (int)
+            max_concurrent_session (int)
+            max_concurrent_session_policy (MaxConcurrentSessionPolicy)
+            session_timeout (int)
+            allowed_ip_addresses (Dict)
+            blocked_ip_addresses (Dict)
+
+        Returns:
+            Dict: The updated system settings data.
+
+        Raises:
+            ValidationError: If the system settings data is invalid.
+
+        Example:
+            >>> from geobox.aio import AsyncGeoboxClient
+            >>> from geobox.aio.setting import SystemSettings
+            >>> async with AsyncGeoboxClient() as client:
+            >>>     settings = await SystemSetting.get_system_settings(client)
+            or  
+            >>>     settings = await client.get_system_settings()
+            >>>     await settings.update(max_log=100000)
+        """
+        data = {
+            "brand_name": kwargs.get('brand_name'),
+            "brand_website": kwargs.get('brand_website'),
+            "max_log": kwargs.get('max_log'),
+            "max_log_policy": kwargs.get('max_log_policy').value if kwargs.get('max_log_policy') else None,
+            "max_upload_file_size": kwargs.get('max_upload_file_size'),
+            "invalid_data_policy": kwargs.get('invalid_data_policy').value if kwargs.get('invalid_data_policy') else None,
+            "max_login_attempts": kwargs.get('max_login_attempts'),
+            "login_failure_policy": kwargs.get('login_failure_policy').value if kwargs.get('login_failure_policy') else None,
+            "login_attempts_duration": kwargs.get('login_attempts_duration'),
+            "min_password_length": kwargs.get('min_password_length'),
+            "max_concurrent_session": kwargs.get('max_concurrent_session'),
+            "max_concurrent_session_policy": kwargs.get('max_concurrent_session_policy').value if kwargs.get('max_concurrent_session_policy') else None,
+            "session_timeout": kwargs.get('session_timeout'),
+            "allowed_ip_addresses": kwargs.get('allowed_ip_addresses'),
+            "blocked_ip_addresses": kwargs.get('blocked_ip_addresses'),
+            
+        }
+        return await super()._update(self.BASE_ENDPOINT, data)
+
+
+    def to_sync(self, sync_client: 'SyncGeoboxClient') -> 'SyncSystemSettings':
+        """
+        Switch to sync version of the system settings instance to have access to the sync methods
+
+        Args:
+            sync_client (SyncGeoboxClient): The sync version of the GeoboxClient instance for making requests.
+
+        Returns:
+            geobox.settings.SystemSettings: the sync instance of the system settings.
+
+        Example:
+            >>> from geobox import Geoboxclient
+            >>> from geobox.aio import AsyncGeoboxClient
+            >>> from geobox.aio.setting import SystemSettings
+            >>> client = GeoboxClient()
+            >>> async with AsyncGeoboxClient() as async_client:
+            >>>     settings = await SystemSetting.get_system_settings(async_client)
+            or  
+            >>>     settings = await async_client.get_system_settings()
+            >>>     sync_settings = settings.to_sync(client)
+        """
+        from ..task import Task as SyncTask
+
+        return SyncTask(api=sync_client, uuid=self.uuid, data=self.data)