geobox 2.2.6__py3-none-any.whl → 2.4.0__py3-none-any.whl

geobox/table.py

@@ -0,0 +1,1719 @@
+from typing import List, Dict, Optional, TYPE_CHECKING, Union, Any
+from urllib.parse import urljoin
+from dataclasses import dataclass
+
+from .base import Base
+from .task import Task
+from .field import Field
+from .vectorlayer import VectorLayer
+from .enums import FieldType, TableExportFormat, RelationshipCardinality
+from .exception import NotFoundError
+from .utils import clean_data
+
+if TYPE_CHECKING:
+    from . import GeoboxClient
+    from .user import User
+    from .file import File
+    from .feature import Feature
+
+
+@dataclass(frozen=True)
+class RelationshipEndpoint:
+    """
+    Represents one endpoint (source or target) of a relationship
+
+    Args:
+        table (Table | VectorLayer): The source or target table or vector layer
+        field (TableField | Field | str): The field name or object on the source/target entity
+        fk_field (TableField | Field | str, optional): The foreign key field name or object on the relation table. (Required for Many-to-Many relationships)
+    """
+    table: Union['Table', 'VectorLayer']
+    field: Union['TableField', 'Field', str]
+    fk_field: Optional[Union['TableField', 'Field', str]] = None
+
+
+class TableRow(Base):
+
+    def __init__(self, 
+        table: 'Table',
+        data: Optional[Dict] = {},
+    ):
+        """
+        Constructs all the necessary attributes for the TableRow object.
+
+        Args:
+            table (Table): The table that the row belongs to.
+            data (Dict, optional): The data of the field.
+        """
+        super().__init__(api=table.api, data=data)
+        self.table = table
+        self.endpoint = urljoin(table.endpoint, f'rows/{self.id}/') if self.data.get('id') else None
+
+
+    def __repr__(self) -> str:
+        """
+        Return a string representation of the TableRow.
+
+        Returns:
+            str: The string representation of the TableRow.
+        """
+        return f"TableRow(id={self.id}, table_name={self.table.data.get('name', 'None')})"
+
+
+    @classmethod
+    def create_row(cls, table: 'Table', **kwargs) -> 'TableRow':
+        """
+        Create a new row in the table.
+
+        Each keyword argument represents a field value for the row, where:
+            - The keyword is the field name
+            - The value is the field value
+
+        Args:
+            table (Table): table instance
+
+        Keyword Args: 
+            **kwargs: Arbitrary field values matching the table schema.
+
+        Returns:
+            TableRow: created table row instance
+
+        Example:
+            >>> from geobox import GeoboxClient
+            >>> from geobox.table import Table, TableRow
+            >>> client = GeoboxClient()
+            >>> table = client.get_table(uuid="12345678-1234-5678-1234-567812345678")
+            or
+            >>> table = Table.get_table(client, uuid="12345678-1234-5678-1234-567812345678")
+            >>> row_data = {
+                'field1': 'value1'
+            }
+            >>> row = TableRow.create_row(table, row_data)
+        """
+        endpoint = urljoin(table.endpoint, 'rows/')
+        return cls._create(table.api, endpoint, kwargs, factory_func=lambda api, item: TableRow(table, data=item))
+
+
+    @classmethod
+    def get_row(cls, 
+        table: 'Table', 
+        row_id: int,
+        user_id: Optional[int],
+    ) -> 'TableRow':
+        """
+        Get a row by its id
+
+        Args:
+            table (Table): the table instance
+            row_id (int): the row id
+            user_id (int, optional): specific user. privileges required.
+
+        Returns:
+            TanbleRow: the table row instance
+
+        Example:
+            >>> from geobox import GeoboxClient
+            >>> from geobox.table import Table, TableRow
+            >>> client = GeoboxClient()
+            >>> table = client.get_table(uuid="12345678-1234-5678-1234-567812345678")
+            or
+            >>> table = Table.get_table(client, uuid="12345678-1234-5678-1234-567812345678")
+
+            >>> row = TableRow.get_row(table, row_id=1)
+        """
+        param = {
+            'f': 'json',
+            'user_id': user_id
+        }
+        endpoint = urljoin(table.endpoint, f'rows/')
+        return cls._get_detail(table.api, endpoint, uuid=row_id, params=param, factory_func=lambda api, item: TableRow(table, data=item))
+
+
+    def update(self, **kwargs) -> Dict:
+        """
+        Update a row
+
+        Keyword Args:
+            fields to update
+
+        Returns:
+            Dict: updated row data
+
+        Example:
+            >>> from geobox import GeoboxClient
+            >>> client = GeoboxClient()
+            >>> table = client.get_table(uuid="12345678-1234-5678-1234-567812345678")
+            >>> row = table.get_row(row_id=1)
+            >>> row.update(field1='new_value')
+        """
+        super()._update(self.endpoint, self.data, clean=False)
+        return self.data
+
+
+    def delete(self) -> None:
+        """
+        Delete a row
+
+        Returns: 
+            None
+
+        Example:
+            >>> from geobox import GeoboxClient
+            >>> client = GeoboxClient()
+            >>> table = client.get_table(uuid="12345678-1234-5678-1234-567812345678")
+            >>> row = table.get_row(row_id=1)
+            >>> row.delete()
+        """
+        super()._delete(self.endpoint)
+
+
+    def _get_other_side_of_relationship(
+        self, 
+        relationship: 'Relationship',
+    ) -> Union['Table', 'VectorLayer']:
+        """
+        Determine which side of a relationship this table is on and return the opposite side.
+        
+        Used internally to navigate bidirectional relationships.
+        
+        Args:
+            relationship (Relationship): The relationship to examine.
+            
+        Returns:
+            Table | VectorLayer: The endpoint (table or layer) on the opposite side
+            of the relationship from this table.
+            
+        Raises:
+            ValueError: If this table is not part of the given relationship.
+            
+        Note:
+            This method assumes the table is either the source or target,
+            not the relation table in Many-to-Many relationships.
+        """
+        if relationship.source_id == self.table.id:
+            return relationship.get_target()
+
+        if relationship.target_id == self.table.id:
+            return relationship.get_source()
+
+        raise ValueError("Relationship does not involve this table.")
+
+
+    def _fetch_related_from_target(
+        self, 
+        target: Union['Table', 'VectorLayer'], 
+        relationship_uuid: str,
+    ) -> Union[List['TableRow'], List['Feature']]:
+        """
+        Fetch related rows/features from a relationship target.
+        
+        Internal helper that dispatches to the appropriate API method
+        based on target type.
+        
+        Args:
+            target (Table | VectorLayer): The target endpoint (Table or VectorLayer) to query.
+            relationship_uuid (str): UUID of the relationship to traverse.
+            
+        Raises:
+            TypeError: If target is not a Table or VectorLayer.
+
+        Returns:
+            List[TableRow] | List[Feature]: Related rows or features.
+        """
+        if isinstance(target, Table):
+            return target.get_rows(
+                relationship_uuid=relationship_uuid,
+                related_record_id=self.id,
+            )
+
+        if isinstance(target, VectorLayer):
+            return target.get_features(
+                relationship_uuid=relationship_uuid,
+                related_record_id=self.id,
+            )
+
+        raise TypeError(f"Unsupported target type: {type(target)}")
+
+
+    def get_related_records(self,
+        relationship_uuid: str,
+    ) -> Union[List['TableRow'], List['Feature']]:
+        """
+        Get the related records on the *other side* of the relationship that are linked to this row
+
+        Args:
+            relationship_uuid (str): The uuid of relationship
+
+        Returns:
+            List[TableRow] | List[Feature]: a list of the related records
+
+        Raises:
+            ValueError:
+                If the given relationship does not involve the current table
+                (i.e., this row is neither the source nor the target of the relationship).
+
+            TypeError:
+                If the relationship target type is not supported for fetching
+                related records.
+
+        Example:
+            >>> from geobox import GeoboxClient
+            >>> client = GeoboxClient()
+            >>> table = client.get_table(uuid="12345678-1234-5678-1234-567812345678")
+            >>> row = table.get_row(row_id=1)
+            >>> related_records = row.get_related_records(relationship_uuid="12345678-1234-5678-1234-567812345678")
+        """
+        relationship = self.api.get_relationship(relationship_uuid)
+
+        other_side = self._get_other_side_of_relationship(relationship)
+
+        return self._fetch_related_from_target(
+            target=other_side,
+            relationship_uuid=relationship_uuid,
+        )
+
+
+    def associate_with(
+        self,
+        relationship_uuid: str,
+        *,
+        target_ids: Optional[List[int]] = None,
+        q: Optional[str] = None,
+    ) -> Dict:
+        """
+        Create relationships between the source record and target records
+
+        Args:
+            relationship_uuid (str): the relationship uuid
+            target_ids (List[int], optional): a list of target record ids to be associated with the current record
+            q (str, optional): query filter on target layer or table to select which target features or rows that are going to be related to the current record
+
+        Returns:
+            Dict: the record association result
+
+        Example:
+            >>> from geobox import GeoboxClient
+            >>> client = GeoboxClient()
+            >>> table = client.get_table(uuid="12345678-1234-5678-1234-567812345678")
+            >>> row = table.get_row(row_id=1)
+            >>> row.associate_with(
+            ...     relationship_uuid="12345678-1234-5678-1234-567812345678",
+            ...     target_ids=[1, 2, 3],
+            ... )
+        """
+        relationship = self.api.get_relationship(uuid=relationship_uuid)
+        return relationship.associate_records(
+            source_id=self.id,
+            target_ids=target_ids,
+            q=q,
+        )
+
+
+    def disassociate_with(
+        self,
+        relationship_uuid: str,
+        *,
+        target_ids: Optional[List[int]] = None,
+        q: Optional[str] = None,
+    ) -> Dict:
+        """
+        Remove relationships between the source record and target records
+
+        Args:
+            relationship_uuid (str): the relationship uuid
+            target_ids (List[int], optional): a list of target record ids to be disassociated with the current record
+            q (str, optional): query filter on target layer or table to select which target features or rows that are going to be related to the current 
+            
+        Returns:
+            Dict: the record disassociation result
+
+        Example:
+            >>> from geobox import GeoboxClient
+            >>> client = GeoboxClient()
+            >>> table = client.get_table(uuid="12345678-1234-5678-1234-567812345678")
+            >>> row = table.get_row(row_id=1)
+            >>> row.disassociate_with(
+            ...     relationship_uuid="12345678-1234-5678-1234-567812345678",
+            ...     target_ids=[1, 2, 3],
+            ... )
+        """
+        relationship = self.api.get_relationship(uuid=relationship_uuid)
+        return relationship.disassociate_records(
+            source_id=self.id,
+            target_ids=target_ids,
+            q=q,
+        )
+
+
+class TableField(Base):
+
+    def __init__(self, 
+        table: 'Table',
+        data_type: 'FieldType',
+        field_id: int = None,
+        data: Optional[Dict] = {},
+    ):
+        """
+        Constructs all the necessary attributes for the Field object.
+
+        Args:
+            table (Table): The table that the field belongs to.
+            data_type (FieldType): type of the field
+            field_id (int): the id of the field
+            data (Dict, optional): The data of the field.
+        """
+        super().__init__(api=table.api, data=data)
+        self.table = table
+        self.field_id = field_id
+        if not isinstance(data_type, FieldType):
+            raise ValueError("data_type must be a FieldType instance")
+        self.data_type = data_type
+        self.endpoint = urljoin(table.endpoint, f'fields/{self.id}/') if self.data.get('id') else None
+
+
+    def __repr__(self) -> str:
+        """
+        Return a string representation of the field.
+
+        Returns:
+            str: The string representation of the field.
+        """
+        return f"TableField(id={self.id}, name={self.name}, data_type={self.data_type})"
+
+        
+    def __getattr__(self, name: str) -> Any:
+        """
+        Get an attribute from the resource.
+
+        Args:
+            name (str): The name of the attribute
+        """
+        if name == 'datatype':
+            return FieldType(self.data['datatype'])
+        return super().__getattr__(name)
+
+
+    @property
+    def domain(self) -> Dict:
+        """
+        Domain property
+
+        Returns:
+            Dict: domain data
+        """
+        return self.data.get('domain')
+
+
+    @domain.setter
+    def domain(self, value: Dict) -> None:
+        """
+        Domain property setter
+
+        Returns:
+            None
+        """
+        self.data['domain'] = value
+        
+
+    @classmethod
+    def create_field(cls, 
+        table: 'Table', 
+        name: str, 
+        data_type: 'FieldType', 
+        data: Dict = {},
+    ) -> 'TableField':
+        """
+        Create a new field
+
+        Args:
+            table (Table): field's table
+            name (str): name of the field
+            data_type (FieldType): type of the field
+            data (Dict, optional): the data of the field
+
+        Returns:
+            Field: the created field object
+
+        Example:
+            >>> from geobox import GeoboxClient
+            >>> from geobox.table import Table
+            >>> from geobox.field import Field
+            >>> client = GeoboxClient()
+            >>> table = client.get_table(uuid="12345678-1234-5678-1234-567812345678")
+            >>> field = Field.create_field(client, table=table, name='test', data_type=FieldType.Integer)
+        """
+        data.update({
+            "name": name,
+            "datatype": data_type.value
+        })
+        endpoint = urljoin(table.endpoint, 'fields/')
+        return super()._create(table.api, endpoint, data, factory_func=lambda api, item: TableField(table, data_type, item['id'], item))
+
+
+    def delete(self) -> None:
+        """
+        Delete the field.
+
+        Returns:
+            None
+
+        Example:
+            >>> from geobox import GeoboxClient
+            >>> from geobox.field import TableField
+            >>> client = GeoboxClient()
+            >>> table = client.get_table(uuid="12345678-1234-5678-1234-567812345678")
+            >>> field = table.get_field(name='test')
+            >>> field.delete()
+        """
+        super()._delete(self.endpoint)
+        self.field_id = None
+
+
+    def update(self, **kwargs) -> Dict:
+        """
+        Update the field.
+
+        Keyword Args:
+            name (str): The name of the field.
+            display_name (str): The display name of the field.
+            description (str): The description of the field.
+            domain (Dict): the domain of the field
+            hyperlink (bool): the hyperlink field.
+
+        Returns:
+            Dict: The updated data.
+
+        Example:
+            >>> from geobox import GeoboxClient
+            >>> from geobox.field import TableField
+            >>> client = GeoboxClient()
+            >>> table = client.get_table(uuid="12345678-1234-5678-1234-567812345678")
+            >>> field = table.get_field(name='test')
+            >>> field.update(name="my_field", display_name="My Field", description="My Field Description")
+        """       
+        data = {
+            "name": kwargs.get('name'),
+            "display_name": kwargs.get('display_name'),
+            "description": kwargs.get('description'),
+            "domain": kwargs.get('domain'),
+            "hyperlink": kwargs.get('hyperlink')
+        }
+        return super()._update(self.endpoint, data)
+
+
+    def update_domain(self, 
+        range_domain: Dict = None, 
+        list_domain: Dict = None,
+    ) -> Dict:
+        """
+        Update field domian values
+
+        Args:
+            range_domain (Dict): a dictionary with min and max keys.
+            list_domain (Dict): a dictionary containing the domain codes and values.
+
+        Returns:
+            Dict: the updated field domain
+
+        Example:
+            >>> from geobox import GeoboxClient
+            >>> client = GeoboxClient()
+            >>> field = client.get_table(uuid="12345678-1234-5678-1234-567812345678").get_fields()[0]
+            >>> range_d = {'min': 1, 'max': 10}
+            >>> field.update_domain(range_domain = range_d)
+            or 
+            >>> list_d = {'1': 'value1', '2': 'value2'}
+            >>> field.update_domain(list_domain=list_d)
+        """
+        if not self.domain:
+            self.domain = {'min': None, 'max': None, 'items': {}}
+
+        if range_domain:
+            self.domain['min'] = range_domain['min']
+            self.domain['max'] = range_domain['max']
+
+        if list_domain:
+            self.domain['items'] = {**self.domain['items'], **list_domain}
+
+        self.update(domain=self.domain)
+        return self.domain
+
+
+class Relationship(Base):
+    BASE_ENDPOINT = 'relationships/'
+
+    def __init__(self, 
+        api: 'GeoboxClient',
+        uuid: str,
+        data: Optional[Dict] = {},
+    ):
+        """
+        Initialize a relationship instance.
+
+        Args:
+            api (GeoboxClient): The GeoboxClient instance for making requests.
+            uuid (str): The unique identifier for the relationship.
+            data (Dict): The response data of the table.
+        """
+        super().__init__(api=api, uuid=uuid, data=data)
+
+
+    def __repr__(self) -> str:
+        """
+        Return a string representation of the Relationship.
+
+        Returns:
+            str: The string representation of the Relationship.
+        """
+        return f"Relationship(uuid={self.uuid}, name={self.relation_name}, cardinality={self.relation_cardinality})"
+
+
+    @classmethod
+    def get_relationships(
+        cls, 
+        api: 'GeoboxClient', 
+        **kwargs,
+    ) -> Union[List['Relationship'], int]:
+        """
+        Get a list of relationships with optional filtering and pagination.
+
+        Args:
+            api (GeoboxClient): The GeoboxClient 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: False.
+            skip (int): Number of items to skip. default: 0
+            limit (int): Number of items to return. default: 10
+            user_id (int): Specific user. privileges required
+            shared (bool): Whether to return shared tables. default: False
+
+        Returns:
+            List[Relationship] | int: A list of relationship instances or the total number of relationships.
+
+        Example:
+            >>> from geobox import GeoboxClient
+            >>> from geobox.table import Relatinship
+            >>> client = GeoboxClient()
+            >>> relationships = client.get_relationships(q="name LIKE '%My relationship%'")
+            or
+            >>> relationships = Table.get_relationships(client, q="name LIKE '%My relationship%'")
+        """
+        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 super()._get_list(api, cls.BASE_ENDPOINT, params, factory_func=lambda api, item: Relationship(api, item['uuid'], item))
+
+
+    @classmethod
+    def create_relationship(
+        cls,
+        api: 'GeoboxClient',
+        name: str,
+        cardinality: RelationshipCardinality,
+        *,
+        source: 'RelationshipEndpoint',
+        target: 'RelationshipEndpoint',
+        relation_table: Optional['Table'] = None,
+        display_name: Optional[str] = None,
+        description: Optional[str] = None,
+        user_id: Optional[int] = None,
+    ) -> 'Relationship':
+        """
+        Create a new Relationship
+
+        Args:
+            api (GeoboxClient): The GeoboxClient instance for making requests.
+            name (str): name of the relationship
+            cardinality (RelationshipCardinality): One to One, One to Many, or Many to Many
+            
+        Keyword Args:
+            source (RelationshipEndpoint): Definition of the source side of the relationship, including the table (or layer), field, and foreign-key field
+            target (RelationshipEndpoint): Definition of the target side of the relationship, including the table (or layer), field, and foreign-key field
+            relation_table (Table, optional): The table that stores the relationship metadata or join records. (Required for Many-to-Many relationships)
+            display_name (str, optional): Human-readable name for the relationship
+            description (str, optional): the description of the relationship
+            user_id (int, optional): Specific user. privileges required.
+
+        Returns:
+            Relationship: a relationship instance
+
+        Example:
+            >>> from geobox import GeoboxClient
+            >>> from geobox.table import Relationship, RelationshipEndpoint, RelationshipCardinality
+            >>> client = GeoboxClient()
+            >>> source = RelationshipEndpoint(
+            ...     table=client.get_table_by_name('owner'),
+            ...     field="name", # on source table
+            ...     fk_field="book_name", # on relation table
+            ... )
+            >>> target = RelationshipEndpoint(
+            ...     table=client.get_table_by_name('parcel'),
+            ...     field="name", # on target table
+            ...     fk_field="author_name", # on relation table
+            ... )
+            >>> relationship = client.create_relationship(
+            ...     name="book_author",
+            ...     cardinality=RelationshipCardinality.ManytoMany,
+            ...     source=source,
+            ...     target=target,
+            ...     relation_table=client.get_table_by_name('owner_parcel'),
+            ... )
+            or
+            >>> relationship = Relationsh.create_relationship(
+            ...     client,
+            ...     name="owner_parcel",
+            ...     cardinality=RelationshipCardinality.ManytoMany,
+            ...     source=source,
+            ...     target=target,
+            ...     relation_table=client.get_table_by_name('owner_parcel'),
+            ... )   
+        """
+        data = {
+            "relation_name": name,
+            "display_name": display_name,
+            "description": description,
+            "relation_cardinality": cardinality.value,
+            "relation_table_id": relation_table.id if relation_table else None,
+            "relation_table_search": f"{relation_table.__class__.__name__}/{relation_table.name}" if relation_table else None,
+            "source_field_name": source.field if type(source.field) == str else source.field.name,
+            "source_fk_name": (source.fk_field if not source.fk_field or type(source.fk_field) == str else source.fk_field.name) if relation_table else None,
+            "source_id": source.table.id,
+            "source_search": f"{source.table.__class__.__name__}/{source.table.name}",
+            "source_type": str(source.table.__class__.__name__),
+            "target_field_name": target.field if type(target.field) == str else target.field.name,
+            "target_fk_name": (target.fk_field if not target.fk_field or type(target.fk_field) == str else target.fk_field.name) if relation_table else None,
+            "target_id": target.table.id,
+            "target_search": f"{target.table.__class__.__name__}/{target.table.name}",
+            "target_type": str(target.table.__class__.__name__),
+            "user_id": user_id,
+        }
+        return super()._create(api, cls.BASE_ENDPOINT, data, factory_func=lambda api, item: Relationship(api, item['uuid'], item))
+
+
+    @classmethod
+    def get_relationship(
+        cls, 
+        api: 'GeoboxClient', 
+        uuid: str, 
+        user_id: Optional[int] = None,
+    ) -> 'Relationship':
+        """
+        Get a relationship by UUID.
+
+        Args:
+            api (GeoboxClient): The GeoboxClient instance for making requests.
+            uuid (str): The UUID of the relationship to get.
+            user_id (int, optional): Specific user. privileges required.
+
+        Returns:
+            Relationship: The Relationship object.
+
+        Raises:
+            NotFoundError: If the Relationship with the specified UUID is not found.
+
+        Example:
+            >>> from geobox import GeoboxClient
+            >>> from geobox.table import Relationship
+            >>> client = GeoboxClient()
+            >>> relationship = client.get_relationship(uuid="12345678-1234-5678-1234-567812345678")
+            or
+            >>> relationship = Relationship.get_relationship(client, uuid="12345678-1234-5678-1234-567812345678")
+        """
+        params = {
+            'f': 'json',
+            'user_id': user_id,
+        }
+        return super()._get_detail(api, cls.BASE_ENDPOINT, uuid, params, factory_func=lambda api, item: Relationship(api, item['uuid'], item))
+
+
+    @classmethod
+    def get_relationship_by_name(
+        cls, 
+        api: 'GeoboxClient', 
+        name: str, 
+        user_id: Optional[int] = None,
+    ) -> Union['Relationship', None]:
+        """
+        Get a relationship by name
+
+        Args:
+            api (GeoboxClient): The GeoboxClient instance for making requests.
+            name (str): the name of the relationship to get
+            user_id (int, optional): specific user. privileges required.
+
+        Returns:
+            Relationship | None: returns the relationship if a relationship matches the given name, else None
+
+        Example:
+            >>> from geobox import GeoboxClient
+            >>> from geobox.relationship import Relationship
+            >>> client = GeoboxClient()
+            >>> relationship = client.get_relationship_by_name(name='test')
+            or
+            >>> relationship = Relationship.get_relationship_by_name(client, name='test')
+        """
+        relationships = cls.get_relationships(api, q=f"name = '{name}'", user_id=user_id)
+        if relationships and relationships[0].relation_name == name:
+            return relationships[0]
+        else:
+            return None
+
+
+    def update(self, **kwargs) -> Dict:
+        """
+        Update the relationship.
+
+        Keyword Args:
+            name (str): The name of the relationship.
+            display_name (str): The display name of the relationship.
+            description (str): The description of the relationship.
+
+        Returns:
+            Dict: The updated relationship data.
+
+        Raises:
+            ValidationError: If the relationship data is invalid.
+
+        Example:
+            >>> from geobox import GeoboxClient
+            >>> from geobox.table import Relationship
+            >>> client = GeoboxClient()
+            >>> relationship = Relationship.get_relationship(client, uuid="12345678-1234-5678-1234-567812345678")
+            >>> relationship.update(display_name="New Display Name")
+        """
+        data = {
+            "name": kwargs.get('name'),
+            "display_name": kwargs.get('display_name'),   
+            "description": kwargs.get('description'),
+        }
+        return super()._update(self.endpoint, data)
+
+
+    def delete(self) -> None:
+        """
+        Delete the Relationship
+
+        Returns:
+            None
+
+        Example:
+            >>> from geobox import GeoboxClient
+            >>> from geobox.table import Relationship
+            >>> client = GeoboxClient()
+            >>> relationship = Relationship.get_relationship(client, uuid="12345678-1234-5678-1234-567812345678")
+            >>> relationship.delete()
+        """
+        super()._delete(self.endpoint)
+
+
+    def get_source(self) -> Union['Table', 'VectorLayer']:
+        """
+        Get the source table or layer
+
+        Returns:
+            Table | VectorLayer: the source table or layer
+
+        Raises:
+            NotFoundError: if the table or layer has been deleted
+
+        Example:
+            >>> from geobox import GeoboxClient
+            >>> client = GeoboxClient()
+            >>> relationship = client.get_relationship(uuid="12345678-1234-5678-1234-567812345678")
+            >>> source = relationship.get_source()
+        """
+        try:
+            result = []
+            if self.source_type == 'Table':
+                result = self.api.get_tables(
+                    q=f"id = {self.source_id}"
+                )
+            elif self.source_type == 'VectorLayer':
+                result = self.api.get_vector(
+                    q=f"id = {self.source_id}"
+                )
+            source = next(source for source in result if source.id == self.source_id)
+            return source
+            
+        except StopIteration:
+            raise NotFoundError("Source dataset not found!")
+
+
+    def get_target(self) -> Union['Table', 'VectorLayer']:
+        """
+        Get the target table or layer
+
+        Returns:
+            Table | VectorLayer: the target table or layer
+
+        Raises:
+            NotFoundError: if the table or layer has been deleted
+
+        Example:
+            >>> from geobox import GeoboxClient
+            >>> client = GeoboxClient()
+            >>> relationship = client.get_relationship(uuid="12345678-1234-5678-1234-567812345678")
+            >>> target_table = relationship.get_target()
+        """
+        try:
+            result = []
+            if self.target_type == 'Table':
+                result = self.api.get_tables(
+                    q=f"id = {self.target_id}"
+                )
+            elif self.target_type == 'VectorLayer':
+                result = self.api.get_vectors(
+                    q=f"id = {self.target_id}"
+                )
+            target = next(target for target in result if target.id == self.target_id)
+            return target
+            
+        except StopIteration:
+            raise NotFoundError("Table not found!")
+
+
+    def get_relation_table(self) -> 'Table':
+        """
+        Get the relation table
+
+        Returns:
+            Table: the relation table
+
+        Raises:
+            ValueError: If the relationship is not Many-to-Many and thus has no relation table
+            NotFoundError: if the table has been deleted
+
+        Example:
+            >>> from geobox import GeoboxClient
+            >>> client = GeoboxClient()
+            >>> relationship = client.get_relationship(uuid="12345678-1234-5678-1234-567812345678")
+            >>> relation_table = relationship.get_relation_table()
+        """
+        try:
+            if not self.relation_table_id:
+                raise ValueError(
+                    "Relationship is not Many-to-Many. "
+                    "Relation tables are only used for Many-to-Many cardinality."
+                )
+
+            result = self.api.get_tables(
+                q=f"id = {self.relation_table_id}"
+            )
+            table = next(table for table in result if table.id == self.relation_table_id)
+            return table
+            
+        except StopIteration:
+            raise NotFoundError("Table not found!")
+
+
+    def associate_records(
+        self,
+        source_id: int,
+        *,
+        target_ids: Optional[List[int]] = None,
+        q: Optional[str] = None,
+    ) -> Dict:
+        """
+        Create relationships between the source record and target records
+
+        Args:
+            source_id (int): the id of feature/row in the source layer/table
+            target_ids (List[int], optional): a list of target record ids to be associated with the current record
+            q (str, optional): query filter on target layer or table to select which target features or rows that are going to be related to the current record
+        
+        Returns:
+            Dict: the record association result
+
+        Example:
+            >>> from geobox import GeoboxClient
+            >>> client = GeoboxClient()
+            >>> relationship = client.get_relationship(uuid="12345678-1234-5678-1234-567812345678")
+            >>> result = relationship.associate_records(
+            ...     source_id=1,
+            ...     target_ids=[1, 2, 3],
+            ...     q="name LIKE '%_school'",
+            ... )
+        """
+        data = {
+            'source_id': source_id,
+            'target_ids': ', '.join([str(i) for i in target_ids]),
+            'q': q,
+        }
+
+        endpoint = f"{self.endpoint}associateRecords/"
+        return self.api.post(
+            endpoint,
+            clean_data(data),
+            is_json=False,
+        )
+
+
+    def disassociate_records(
+        self,
+        source_id: int,
+        *,
+        target_ids: Optional[List[int]] = None,
+        q: Optional[str] = None,
+    ) -> Dict:
+        """
+        Remove relationships between the source record and target records
+
+        Args:
+            source_id (int): the id of feature/row in the source layer/table
+            target_ids (List[int], optional): a list of target record ids to be disassociated with the current record
+            q (str, optional): query filter on target layer or table to select which target features or rows that are going to be related to the current record
+        
+        Returns:
+            Dict: the record disassociation result
+
+        Example:
+            >>> from geobox import GeoboxClient
+            >>> client = GeoboxClient()
+            >>> relationship = client.get_relationship(uuid="12345678-1234-5678-1234-567812345678")
+            >>> result = relationship.disassociate_records(
+            ...     source_id=1,
+            ...     target_ids=[1, 2, 3],
+            ...     q="name LIKE '%_school'",
+            ... )
+        """
+        data = {
+            'source_id': source_id,
+            'target_ids': ', '.join([str(i) for i in target_ids]),
+            'q': q,
+        }
+
+        endpoint = f"{self.endpoint}disassociateRecords/"
+        return self.api.post(
+            endpoint,
+            clean_data(data),
+            is_json=False,
+        )
+
+
+class Table(Base):
+
+    BASE_ENDPOINT = 'tables/'
+
+    def __init__(self, 
+        api: 'GeoboxClient', 
+        uuid: str,
+        data: Optional[Dict] = {}):
+        """
+        Initialize a table instance.
+
+        Args:
+            api (GeoboxClient): The GeoboxClient instance for making requests.
+            uuid (str): The unique identifier for the table.
+            data (Dict): The response data of the table.
+        """
+        super().__init__(api, uuid=uuid, data=data)
+
+
+    @classmethod
+    def get_tables(cls, api: 'GeoboxClient', **kwargs) -> Union[List['Table'], int]:
+        """
+        Get a list of tables with optional filtering and pagination.
+
+        Args:
+            api (GeoboxClient): The GeoboxClient instance for making requests.
+
+        Keyword Args:
+            include_settings (bool): Whether to include table settings. default: False
+            temporary (bool): Whether to return temporary tables. default: False
+            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: False.
+            skip (int): Number of items to skip. default: 0
+            limit (int): Number of items to return. default: 10
+            user_id (int): Specific user. privileges required
+            shared (bool): Whether to return shared tables. default: False
+
+        Returns:
+            List[Table] | int: A list of table instances or the total number of tables.
+
+        Example:
+            >>> from geobox import GeoboxClient
+            >>> from geobox.table import Table
+            >>> client = GeoboxClient()
+            >>> tables = client.get_tables(q="name LIKE '%My table%'")
+            or
+            >>> tables = Table.get_tables(client, q="name LIKE '%My table%'")
+        """
+        params = {
+           'f': 'json',
+           'include_settings': kwargs.get('include_settings', False),
+           'temporary': kwargs.get('temporary'),
+           '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 super()._get_list(api, cls.BASE_ENDPOINT, params, factory_func=lambda api, item: Table(api, item['uuid'], item))
+    
+
+    @classmethod
+    def create_table(cls,
+        api: 'GeoboxClient', 
+        name: str, 
+        display_name: Optional[str] = None, 
+        description: Optional[str] = None, 
+        temporary: bool = False,
+        fields: Optional[List[Dict]] = None,
+    ) -> 'Table':
+        """
+        Create a new table.
+
+        Args:
+            api (GeoboxClient): The GeoboxClient instance for making requests.
+            name (str): The name of the Table.
+            display_name (str, optional): The display name of the table.
+            description (str, optional): The description of the table.
+            temporary (bool, optional): Whether to create a temporary tables. default: False
+            fields (List[Dict], optional): raw table fields. you can use create_field method for simpler and safer field addition. required dictionary keys: name, datatype
+
+        Returns:
+            Table: The newly created table instance.
+
+        Raises:
+            ValidationError: If the table data is invalid.
+
+        Example:
+            >>> from geobox import GeoboxClient
+            >>> from geobox.table import Table
+            >>> client = GeoboxClient()
+            >>> table = client.create_table(name="my_table")
+            or
+            >>> table = Table.create_table(client, name="my_table")            
+        """
+        data = {
+            "name": name,
+            "display_name": display_name,
+            "description": description,
+            "temporary": temporary,
+            "fields": fields,
+        }
+        return super()._create(api, cls.BASE_ENDPOINT, data, factory_func=lambda api, item: Table(api, item['uuid'], item))
+
+    
+    @classmethod
+    def get_table(cls, api: 'GeoboxClient', uuid: str, user_id: int = None) -> 'Table':
+        """
+        Get a table by UUID.
+
+        Args:
+            api (GeoboxClient): The GeoboxClient instance for making requests.
+            uuid (str): The UUID of the table to get.
+            user_id (int): Specific user. privileges required.
+
+        Returns:
+            Table: The Table object.
+
+        Raises:
+            NotFoundError: If the table with the specified UUID is not found.
+
+        Example:
+            >>> from geobox import GeoboxClient
+            >>> from geobox.table import Table
+            >>> client = GeoboxClient()
+            >>> table = client.get_table(uuid="12345678-1234-5678-1234-567812345678")
+            or
+            >>> table = Table.get_table(client, uuid="12345678-1234-5678-1234-567812345678")
+        """
+        params = {
+            'f': 'json',
+            'user_id': user_id,
+        }
+        return super()._get_detail(api, cls.BASE_ENDPOINT, uuid, params, factory_func=lambda api, item: Table(api, item['uuid'], item))
+
+
+    @classmethod
+    def get_table_by_name(cls, api: 'GeoboxClient', name: str, user_id: int = None) -> Union['Table', None]:
+        """
+        Get a table by name
+
+        Args:
+            api (GeoboxClient): The GeoboxClient instance for making requests.
+            name (str): the name of the table to get
+            user_id (int, optional): specific user. privileges required.
+
+        Returns:
+            Table | None: returns the table if a table matches the given name, else None
+
+        Example:
+            >>> from geobox import GeoboxClient
+            >>> from geobox.table import Table
+            >>> client = GeoboxClient()
+            >>> table = client.get_table_by_name(name='test')
+            or
+            >>> table = Table.get_table_by_name(client, name='test')
+        """
+        tables = cls.get_tables(api, q=f"name = '{name}'", user_id=user_id)
+        if tables and tables[0].name == name:
+            return tables[0]
+        else:
+            return None
+
+
+    def update(self, **kwargs) -> Dict:
+        """
+        Update the table.
+
+        Keyword Args:
+            name (str): The name of the table.
+            display_name (str): The display name of the table.
+            description (str): The description of the table.
+
+        Returns:
+            Dict: The updated table data.
+
+        Raises:
+            ValidationError: If the table data is invalid.
+
+        Example:
+            >>> from geobox import GeoboxClient
+            >>> from geobox.table import Table
+            >>> client = GeoboxClient()
+            >>> table = Table.get_table(client, uuid="12345678-1234-5678-1234-567812345678")
+            >>> table.update(display_name="New Display Name")
+        """
+        data = {
+            "name": kwargs.get('name'),
+            "display_name": kwargs.get('display_name'),   
+            "description": kwargs.get('description'),
+        }
+        return super()._update(self.endpoint, data)
+    
+
+    def delete(self) -> None:
+        """
+        Delete the Table.
+
+        Returns:
+            None
+
+        Example:
+            >>> from geobox import GeoboxClient
+            >>> from geobox.table import Table
+            >>> client = GeoboxClient()
+            >>> table = Table.get_table(client, uuid="12345678-1234-5678-1234-567812345678")
+            >>> table.delete()
+        """
+        super()._delete(self.endpoint)
+
+
+    @property
+    def settings(self) -> Dict:
+        """
+        Get the table's settings.
+        
+        Returns:
+            Dict: The table settings.
+
+        Example:
+            >>> from geobox import GeoboxClient
+            >>> from geobox.table import Table
+            >>> client = GeoboxClient()
+            >>> table = Table.get_table(api=client, uuid="12345678-1234-5678-1234-567812345678")
+            >>> setting = table.setting
+        """
+        return super()._get_settings(endpoint=self.endpoint)
+    
+
+    def update_settings(self, settings: Dict) -> Dict:
+        """
+        Update the settings
+
+        settings (Dict): settings dictionary
+
+        Returns:
+            Dict: updated settings
+
+        Example:
+            >>> from geobox import GeoboxClient
+            >>> client = GeoboxClient()
+            >>> table1 = client.get_table(uuid="12345678-1234-5678-1234-567812345678")
+            >>> table2 = client.get_table(uuid="12345678-1234-5678-1234-567812345678")
+            >>> table1.update_settings(table2.settings)
+        """
+        return super()._set_settings(self.endpoint, settings)
+
+
+    def get_fields(self) -> List['TableField']:
+        """
+        Get all fields of the table.
+        
+        Returns:
+            List[TableField]: A list of Field instances representing the table's fields.
+
+        Example:
+            >>> from geobox import GeoboxClient
+            >>> from geobox.table import Table
+            >>> client = GeoboxClient()
+            >>> table = Table.get_table(api=client, uuid="12345678-1234-5678-1234-567812345678")
+            >>> fields = table.get_fields()
+        """
+        endpoint = urljoin(self.endpoint, 'fields/')
+        return super()._get_list(api=self.api, 
+            endpoint=endpoint,
+            factory_func=lambda api, item: TableField(table=self, data_type=FieldType(item['datatype']), field_id=item['id'], data=item))
+
+
+    def get_field(self, field_id: int) -> 'TableField':
+        """
+        Get a specific field by ID.
+        
+        Args:
+            field_id (int, optional): The ID of the field to retrieve.
+
+        Returns:
+            TableField: The requested field instance.
+            
+        Raises:
+            NotFoundError: If the field with the specified ID is not found. 
+
+        Example:
+            >>> from geobox import GeoboxClient
+            >>> from geobox.table import Table
+            >>> client = GeoboxClient()
+            >>> table = Table.get_table(api=client, uuid="12345678-1234-5678-1234-567812345678")
+            >>> field = table.get_field(field_id=1)
+        """        
+        field = next((f for f in self.get_fields() if f.id == field_id), None)
+        if not field:
+            raise NotFoundError(f'Field with ID {field_id} not found in table {self.name}')
+            
+        return field
+
+
+    def get_field_by_name(self, name: str) -> 'TableField':
+        """
+        Get a specific field by name.
+        
+        Args:
+            name (str): The name of the field to retrieve.
+
+        Returns:
+            TableField: The requested field instance.
+            
+        Raises:
+            NotFoundError: If the field with the specified name is not found. 
+
+        Example:
+            >>> from geobox import GeoboxClient
+            >>> from geobox.table import Table
+            >>> client = GeoboxClient()
+            >>> table = Table.get_table(api=client, uuid="12345678-1234-5678-1234-567812345678")
+            >>> field = table.get_field_by_name(name='test')
+        """        
+        field = next((f for f in self.get_fields() if f.name == name), None)
+        if not field:
+            raise NotFoundError(f"Field with name '{name}' not found in table {self.name}")
+            
+        return field
+
+
+    def add_field(self, name: str, data_type: 'FieldType', data: Dict = {}) -> 'TableField':
+        """
+        Add a new field to the table.
+        
+        Args:
+            name (str): The name of the new field.
+            data_type (FieldType): The data type of the new field.
+            data (Dict, optional): Additional field properties (display_name, description, etc.).
+            
+        Returns:
+            TableField: The newly created field instance.
+            
+        Raises:
+            ValidationError: If the field data is invalid.
+
+        Example:
+            >>> from geobox import GeoboxClient
+            >>> from geobox.table import Table
+            >>> client = GeoboxClient()
+            >>> table = Table.get_table(api=client, uuid="12345678-1234-5678-1234-567812345678")
+            >>> field = table.add_field(name="new_field", data_type=FieldType.String)
+        """
+        return TableField.create_field(table=self, name=name, data_type=data_type, data=data)
+
+
+    def calculate_field(self, 
+        target_field: str, 
+        expression: str, 
+        q: Optional[str] = None, 
+        search: Optional[str] = None, 
+        search_fields: Optional[str] = None, 
+        row_ids: Optional[str] = None, 
+        run_async: bool = True, 
+        user_id: Optional[int] = None,
+    ) -> Union['Task', Dict]:
+        """
+        Calculate values for a field based on an expression.
+        
+        Args:
+            target_field (str): The field to calculate values for.
+            expression (str): The expression to use for calculation.
+            q (str, optional): Query to filter features. default: None.
+            search (str, optional): search term for keyword-based searching among search_fields or all textual fields if search_fields does not have value
+            search_fields (str, optional): comma separated list of fields for searching
+            row_ids (str, optional): List of specific row IDs to include. default: None
+            run_async (bool, optional): Whether to run the calculation asynchronously. default: True.
+            user_id (int, optional): Specific user. privileges required.
+            
+        Returns:
+            Task | Dict: The task instance of the calculation operation or the api response if the run_async=False.
+
+        Example:
+            >>> from geobox import GeoboxClient
+            >>> from geobox.table import Table
+            >>> client = GeoboxClient()
+            >>> table = Table.get_table(api=client, uuid="12345678-1234-5678-1234-567812345678")
+            >>> task = table.calculate_field(target_field="target_field", 
+            ...     expression="expression", 
+            ...     q="name like 'my_layer'", 
+            ...     row_ids=[1, 2, 3], 
+            ...     run_async=True)
+        """
+        data = clean_data({
+            "target_field": target_field,
+            "expression": expression,
+            "q": q,
+            "search": search,
+            "search_fields": search_fields,
+            "row_ids": row_ids,
+            "run_async": run_async,
+            "user_id": user_id
+        })
+        
+        endpoint = urljoin(self.endpoint, 'calculateField/')
+        response = self.api.post(endpoint, data, is_json=False)
+        if run_async:
+            task = Task.get_task(self.api, response.get('task_id'))
+            return task
+
+        return response
+
+
+    def get_rows(self, **kwargs) -> List['TableRow']:
+        """
+        Query rows of a table
+
+        Keyword Args:
+            relationship_uuid (str): The uuid of relationship
+            related_record_id (int): This is the id of the feature/row that these rows are related to. This id belongs to the related layer/table not this table
+            q (str): Advanced filtering expression, e.g., 'status = "active" and age > 20'
+            search (str): Search term for keyword-based searching among fields/columns
+            search_fields (str): Comma separated column names to search in
+            row_ids (str): Comma separated list of row ids to filter for
+            fields (str): Comma separated column names to include in results, or [ALL]
+            exclude (str): Comma separated column names to exclude from result
+            order_by (str): Comma separated list for ordering, e.g., 'name A, id D'
+            skip (int): Number of records to skip for pagination. default: 0
+            limit (int): Maximum number of records to return. default: 100
+            return_count (bool): If true, returns only the count of matching rows
+            user_id (int): Specific user. privileges required
+
+        Returns:
+            List[TableRow]: list of table rows objects
+
+        Example:
+            >>> from geobox import GeoboxClient
+            >>> from geobox.table import Table
+            >>> client = GeoboxClient()
+            >>> table = client.get_table(uuid="12345678-1234-5678-1234-567812345678")
+            or
+            >>> table = Table.get_table(client, uuid="12345678-1234-5678-1234-567812345678")
+
+            >>> rows = table.get_rows()
+        """
+        params = {
+            'f': 'json',
+            'relationship_uuid': kwargs.get('relationship_uuid'),
+            'related_record_id': kwargs.get('related_record_id'),
+            'q': kwargs.get('q'),
+            'search': kwargs.get('search'),
+            'search_fields': kwargs.get('search_fields'),
+            'row_ids': kwargs.get('row_ids'),
+            'fields': kwargs.get('fields'),
+            'exclude': kwargs.get('exclude'),
+            'order_by': kwargs.get('order_by'),
+            'skip': kwargs.get('skip', 0),
+            'limit': kwargs.get('limit', 100),
+            'return_count': kwargs.get('return_count', False),
+            'user_id': kwargs.get('user_id'),
+        }
+
+        endpoint = f'{self.endpoint}rows/'
+
+        return super()._get_list(api=self.api,
+            endpoint=endpoint,
+            params=params,
+            factory_func=lambda api, item: TableRow(self, item))
+
+
+    def get_row(self, 
+        row_id: int, 
+        user_id: Optional[int] = None,
+    ) -> 'TableRow':
+        """
+        Get a row by its id
+
+        Args:
+            row_id (int): the row id
+            user_id (int, optional): specific user. privileges required.
+
+        Returns:
+            TanbleRow: the table row instance
+
+        Example:
+            >>> from geobox import GeoboxClient
+            >>> from geobox.table import Table
+            >>> client = GeoboxClient()
+            >>> table = client.get_table(uuid="12345678-1234-5678-1234-567812345678")
+            or
+            >>> table = Table.get_table(client, uuid="12345678-1234-5678-1234-567812345678")
+
+            >>> row = table.get_row(row_id=1)
+        """
+        return TableRow.get_row(self, row_id, user_id)
+
+
+    def create_row(self, **kwargs) -> 'TableRow':
+        """
+        Create a new row in the table.
+
+        Each keyword argument represents a field value for the row, where:
+            - The keyword is the field name
+            - The value is the field value
+
+        Keyword Args: 
+            **kwargs: Arbitrary field values matching the table schema.
+
+        Returns:
+            TableRow: created table row instance
+
+        Example:
+            >>> from geobox import GeoboxClient
+            >>> from geobox.table import Table
+            >>> client = GeoboxClient()
+            >>> table = client.get_table(uuid="12345678-1234-5678-1234-567812345678")
+            or
+            >>> table = Table.get_table(client, uuid="12345678-1234-5678-1234-567812345678")
+
+            >>> row = table.create_row(
+            ...     field1=value1
+            ... )
+        """
+        return TableRow.create_row(self, **kwargs)
+
+
+    def import_rows(self, 
+        file: 'File',
+        *,
+        file_encoding: str = "utf-8",
+        input_dataset: Optional[str] = None,
+        delimiter: str = ',',
+        has_header: bool = True,
+        report_errors: bool = False,
+        bulk_insert: bool = True,
+    ) -> 'Task':
+        """
+        Import rows from a CSV file into a table
+        
+        Args:
+            file (File): file object to import.
+            file_encoding (str, optional): Character encoding of the input file. default: utf-8
+            input_dataset (str, optional): Name of the dataset in the input file.
+            delimiter (str, optional): the delimiter of the dataset. default: ,
+            has_header (bool, optional): Whether the file has header or not. default: True
+            report_errors (bool, optional): Whether to report import errors. default: False
+            bulk_insert (bool, optional): 
+            
+        Returns:
+            Task: The task instance of the import operation.
+            
+        Raises:
+            ValidationError: If the import parameters are invalid.
+
+        Example:
+            >>> from geobox import GeoboxClient
+            >>> from geobox.table import Table
+            >>> client = GeoboxClient()
+            >>> table = Table.get_table(api=client, uuid="12345678-1234-5678-1234-567812345678")
+            >>> file = client.get_file(uuid="12345678-1234-5678-1234-567812345678")
+            >>> task = table.import_rows(
+            ...     file=file,
+            ... )
+        """
+        data = clean_data({
+            "file_uuid": file.uuid,
+            "file_encoding": file_encoding,
+            "input_dataset": file.name if not input_dataset else input_dataset,
+            "delimiter": delimiter,
+            "has_header": has_header,
+            "report_errors": report_errors,
+            "bulk_insert": bulk_insert,
+        })
+
+        endpoint = urljoin(self.endpoint, 'import-csv/')
+        response = self.api.post(endpoint, data, is_json=False)
+        task = Task.get_task(self.api, response.get('task_id'))
+        return task
+
+
+    def export_rows(self,
+        out_filename: str,
+        *,
+        out_format: 'TableExportFormat' = TableExportFormat.CSV, 
+        q: Optional[str] = None,
+        search: Optional[str] = None,
+        search_fields: Optional[str] = None,
+        row_ids: Optional[str] = None,
+        fields: Optional[str] = None,
+        exclude: Optional[str] = None,
+        order_by: Optional[str] = None,
+        zipped: bool = False,
+        run_async: bool = True,
+    ) -> Union['Task', str]:
+        """
+        Export rows of a table to a file
+        
+        Args:
+            out_filename (str): Name of the output file without the format (.csv) 
+            out_format (TableExportFormat, optional): Format of the output file
+            q (str, optional): query filter based on OGC CQL standard. e.g. "field1 LIKE '%GIS%' AND created_at > '2021-01-01'"
+            search (str, optional): search term for keyword-based searching among search_fields or all textual fields if search_fields does not have value
+            search_fields (str, optional): comma separated list of fields for searching
+            row_ids (str, optional): List of specific row IDs to include
+            fields (str, optional): List of specific field names to include
+            exclude (str, optional): List of specific field names to exclude
+            order_by (str, optional): 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.
+            zipped (str, optional): Whether to compress the output file
+            run_async (bool, optional): Whether to run the export asynchronously. default: True
+            
+        Returns:
+            Task | Dict: The task instance of the export operation (run_async=True) or the export result (run_async=False)
+            
+        Raises:
+            ValidationError: If the export parameters are invalid.
+
+        Example:
+            >>> from geobox import GeoboxClient
+            >>> from geobox.table import Table
+            >>> client = GeoboxClient()
+            >>> table = Table.get_table(api=client, uuid="12345678-1234-5678-1234-567812345678")
+            >>> file = client.get_file(uuid="12345678-1234-5678-1234-567812345678")
+            >>> task = table.export_rows(
+            ...     file=file,
+            ... )
+        """
+        data = clean_data({
+            "out_filename": out_filename,
+            "out_format": out_format.value if out_format else None,
+            "q": q,
+            "search": search,
+            "search_fields": search_fields,
+            "row_ids": row_ids,
+            "fields": fields,
+            "exclude": exclude,
+            "order_by": order_by,
+            "zipped": zipped,
+            "run_async": run_async,
+        })
+
+        endpoint = urljoin(self.endpoint, 'export/')
+        response = self.api.post(endpoint, data, is_json=False)
+        if run_async:
+            task = Task.get_task(self.api, response.get('task_id'))
+            return task
+
+        return response
+
+
+    def share(self, users: List['User']) -> None:
+        """
+        Shares the table with specified users.
+
+        Args:
+            users (List[User]): The list of user objects to share the table with.
+
+        Returns:
+            None
+
+        Example:
+            >>> from geobox import GeoboxClient             
+            >>> from geobox.table import Table
+            >>> client = GeoboxClient()
+            >>> table = Table.get_table(client, uuid="12345678-1234-5678-1234-567812345678")
+            >>> users = client.search_users(search='John')
+            >>> table.share(users=users)
+        """
+        super()._share(self.endpoint, users)
+    
+
+    def unshare(self, users: List['User']) -> None:
+        """
+        Unshares the table with specified users.
+
+        Args:
+            users (List[User]): The list of user objects to unshare the table with.
+
+        Returns:
+            None
+
+        Example:
+            >>> from geobox import GeoboxClient             
+            >>> from geobox.table import Table
+            >>> client = GeoboxClient()
+            >>> table = Table.get_table(client, uuid="12345678-1234-5678-1234-567812345678")
+            >>> users = client.search_users(search='John')
+            >>> table.unshare(users=users)
+        """
+        super()._unshare(self.endpoint, users)
+
+
+    def get_shared_users(self, search: str = None, skip: int = 0, limit: int = 10) -> List['User']:
+        """
+        Retrieves the list of users the table 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 import GeoboxClient
+            >>> from geobox.table import Table
+            >>> client = GeoboxClient()
+            >>> table = Table.get_table(client, uuid="12345678-1234-5678-1234-567812345678")
+            >>> table.get_shared_users(search='John', skip=0, limit=10)
+        """
+        params = {
+            'search': search,
+            'skip': skip,
+            'limit': limit
+        }
+        return super()._get_shared_users(self.endpoint, params)