exabel 8.0.0__py3-none-any.whl

exabel/__init__.py

@@ -0,0 +1 @@
+from .client.exabel_client import ExabelClient

exabel/client/api/api_client/calendar_api_client.py

@@ -0,0 +1,43 @@
+from abc import ABC, abstractmethod
+
+from exabel.stubs.exabel.api.data.v1.calendar_service_pb2 import (
+    BatchCreateFiscalPeriodsRequest,
+    BatchCreateFiscalPeriodsResponse,
+    CompanyCalendar,
+    DeleteFiscalPeriodRequest,
+    GetCompanyCalendarRequest,
+    ListCompaniesWithFiscalPeriodsRequest,
+    ListCompaniesWithFiscalPeriodsResponse,
+    ListFiscalPeriodsRequest,
+    ListFiscalPeriodsResponse,
+)
+
+
+class CalendarApiClient(ABC):
+    """Superclass for clients that send calendar requests to the Exabel Data API."""
+
+    @abstractmethod
+    def get_company_calendar(self, request: GetCompanyCalendarRequest) -> CompanyCalendar:
+        """Get the fiscal calendar for a company."""
+
+    @abstractmethod
+    def batch_create_fiscal_periods(
+        self, request: BatchCreateFiscalPeriodsRequest
+    ) -> BatchCreateFiscalPeriodsResponse:
+        """Add fiscal periods for a company."""
+
+    @abstractmethod
+    def list_company_fiscal_periods(
+        self, request: ListFiscalPeriodsRequest
+    ) -> ListFiscalPeriodsResponse:
+        """List the fiscal periods for a company."""
+
+    @abstractmethod
+    def delete_fiscal_periods(self, request: DeleteFiscalPeriodRequest) -> None:
+        """Delete fiscal periods for a company."""
+
+    @abstractmethod
+    def list_companies_with_fiscal_periods(
+        self, request: ListCompaniesWithFiscalPeriodsRequest
+    ) -> ListCompaniesWithFiscalPeriodsResponse:
+        """List the companies for which there are uploaded fiscal periods."""

exabel/client/api/api_client/data_set_api_client.py

@@ -0,0 +1,37 @@
+from abc import ABC, abstractmethod
+
+from exabel.stubs.exabel.api.data.v1.all_pb2 import (
+    CreateDataSetRequest,
+    DataSet,
+    DeleteDataSetRequest,
+    GetDataSetRequest,
+    ListDataSetsRequest,
+    ListDataSetsResponse,
+    UpdateDataSetRequest,
+)
+
+
+class DataSetApiClient(ABC):
+    """
+    Superclass for clients that send data set requests to the Exabel Data API.
+    """
+
+    @abstractmethod
+    def list_data_sets(self, request: ListDataSetsRequest) -> ListDataSetsResponse:
+        """List all data sets."""
+
+    @abstractmethod
+    def get_data_set(self, request: GetDataSetRequest) -> DataSet:
+        """Get a data set."""
+
+    @abstractmethod
+    def create_data_set(self, request: CreateDataSetRequest) -> DataSet:
+        """Create a data set."""
+
+    @abstractmethod
+    def update_data_set(self, request: UpdateDataSetRequest) -> DataSet:
+        """Update a data set."""
+
+    @abstractmethod
+    def delete_data_set(self, request: DeleteDataSetRequest) -> None:
+        """Delete a data set."""

exabel/client/api/api_client/derived_signal_api_client.py

@@ -0,0 +1,31 @@
+from abc import ABC, abstractmethod
+
+from exabel.stubs.exabel.api.analytics.v1.all_pb2 import (
+    CreateDerivedSignalRequest,
+    DeleteDerivedSignalRequest,
+    DerivedSignal,
+    GetDerivedSignalRequest,
+    UpdateDerivedSignalRequest,
+)
+
+
+class DerivedSignalApiClient(ABC):
+    """
+    Superclass for clients that send derived signal requests to the Exabel Analytics API.
+    """
+
+    @abstractmethod
+    def create_derived_signal(self, request: CreateDerivedSignalRequest) -> DerivedSignal:
+        """Create a derived signal."""
+
+    @abstractmethod
+    def get_derived_signal(self, request: GetDerivedSignalRequest) -> DerivedSignal:
+        """Get a derived signal."""
+
+    @abstractmethod
+    def update_derived_signal(self, request: UpdateDerivedSignalRequest) -> DerivedSignal:
+        """Update a derived signal."""
+
+    @abstractmethod
+    def delete_derived_signal(self, request: DeleteDerivedSignalRequest) -> None:
+        """Delete a derived signal."""

exabel/client/api/api_client/entity_api_client.py

@@ -0,0 +1,75 @@
+from abc import ABC, abstractmethod
+
+from exabel.stubs.exabel.api.data.v1.all_pb2 import (
+    CreateEntityRequest,
+    CreateEntityTypeRequest,
+    DeleteEntitiesRequest,
+    DeleteEntityRequest,
+    DeleteEntityTypeRequest,
+    Entity,
+    EntityType,
+    GetEntityRequest,
+    GetEntityTypeRequest,
+    ListEntitiesRequest,
+    ListEntitiesResponse,
+    ListEntityTypesRequest,
+    ListEntityTypesResponse,
+    SearchEntitiesRequest,
+    SearchEntitiesResponse,
+    UpdateEntityRequest,
+    UpdateEntityTypeRequest,
+)
+
+
+class EntityApiClient(ABC):
+    """
+    Superclass for clients that send entity requests to the Exabel Data API.
+    """
+
+    @abstractmethod
+    def list_entity_types(self, request: ListEntityTypesRequest) -> ListEntityTypesResponse:
+        """List all known entity types."""
+
+    @abstractmethod
+    def get_entity_type(self, request: GetEntityTypeRequest) -> EntityType:
+        """Get an entity type."""
+
+    @abstractmethod
+    def create_entity_type(self, request: CreateEntityTypeRequest) -> EntityType:
+        """Create an entity type."""
+
+    @abstractmethod
+    def update_entity_type(self, request: UpdateEntityTypeRequest) -> EntityType:
+        """Update an entity type."""
+
+    @abstractmethod
+    def delete_entity_type(self, request: DeleteEntityTypeRequest) -> None:
+        """Delete an entity type."""
+
+    @abstractmethod
+    def list_entities(self, request: ListEntitiesRequest) -> ListEntitiesResponse:
+        """List all entities of a given entity type."""
+
+    @abstractmethod
+    def get_entity(self, request: GetEntityRequest) -> Entity:
+        """Get an entity."""
+
+    @abstractmethod
+    def create_entity(self, request: CreateEntityRequest) -> Entity:
+        """Create an entity."""
+
+    @abstractmethod
+    def update_entity(self, request: UpdateEntityRequest) -> Entity:
+        """Update an entity."""
+
+    @abstractmethod
+    def delete_entity(self, request: DeleteEntityRequest) -> None:
+        """Delete an entity."""
+
+    @abstractmethod
+    def delete_entities(self, request: DeleteEntitiesRequest) -> None:
+        """Delete all entities of a given entity type."""
+
+    @abstractmethod
+    def search_entities(self, request: SearchEntitiesRequest) -> SearchEntitiesResponse:
+        """Search for entities."""

exabel/client/api/api_client/exabel_api_group.py

@@ -0,0 +1,38 @@
+from enum import Enum, auto
+
+from exabel.client.client_config import ClientConfig
+
+
+class ExabelApiGroup(Enum):
+    """
+    Exabel API groups.
+    """
+
+    # Data API.
+    DATA_API = auto()
+
+    # Analytics API.
+    ANALYTICS_API = auto()
+
+    # Management API.
+    MANAGEMENT_API = auto()
+
+    def get_host(self, config: ClientConfig) -> str:
+        """Return the API host for this API group."""
+        if self == ExabelApiGroup.DATA_API:
+            return config.data_api_host
+        if self == ExabelApiGroup.ANALYTICS_API:
+            return config.analytics_api_host
+        if self == ExabelApiGroup.MANAGEMENT_API:
+            return config.management_api_host
+        raise ValueError(f"Unknown ExabelApiGroup: {self.name}")
+
+    def get_port(self, config: ClientConfig) -> int:
+        """Return the API port for this API group."""
+        if self == ExabelApiGroup.DATA_API:
+            return config.data_api_port
+        if self == ExabelApiGroup.ANALYTICS_API:
+            return config.analytics_api_port
+        if self == ExabelApiGroup.MANAGEMENT_API:
+            return config.management_api_port
+        raise ValueError(f"Unknown ExabelApiGroup: {self.name}")

exabel/client/api/api_client/grpc/base_grpc_client.py

@@ -0,0 +1,85 @@
+import json
+
+import grpc
+
+from exabel.client.api.api_client.exabel_api_group import ExabelApiGroup
+from exabel.client.client_config import ClientConfig
+
+SIXTEEN_MEGABYTES_IN_BYTES = 16 * 1024 * 1024
+
+# Retry parameters
+DEFAULT_MAX_ATTEMPTS = 5
+DEFAULT_INITIAL_BACKOFF_SECONDS = 0.1
+DEFAULT_MAX_BACKOFF_SECONDS = 5
+DEFAULT_BACKOFF_MULTIPLIER = 2
+
+
+class BaseGrpcClient:
+    """
+    Base class for clients that access the Exabel API with gRPC.
+    """
+
+    def __init__(self, config: ClientConfig, api_group: ExabelApiGroup):
+        self.config = config
+        self.metadata = [("x-client-name", config.client_name)]
+        common_kwargs = {
+            "target": f"{api_group.get_host(config)}:{api_group.get_port(config)}",
+            # When importing time series, we may receive a large amount of precondition failure
+            # violations in the trailing metadata, therefore we increase the maximum metadata size.
+            "options": (
+                ("grpc.max_metadata_size", SIXTEEN_MEGABYTES_IN_BYTES),
+                ("grpc.service_config", self._get_service_config()),
+            ),
+        }
+        if config.api_key == "NO_KEY":
+            # Use an insecure channel. This can be used for local testing.
+            self.channel = grpc.insecure_channel(**common_kwargs)
+        else:
+            if config.access_token is not None:
+                self.metadata.append(("authorization", "Bearer " + config.access_token))
+            else:
+                assert config.api_key is not None
+                self.metadata.append(("x-api-key", config.api_key))
+            self.channel = grpc.secure_channel(
+                credentials=grpc.ssl_channel_credentials(
+                    root_certificates=config.root_certificates
+                ),
+                **common_kwargs,
+            )
+        for header in self.config.extra_headers:
+            self.metadata.append(header)
+
+    def _get_service_config(
+        self,
+        max_attempts: int = DEFAULT_MAX_ATTEMPTS,
+        initial_backoff: float = DEFAULT_INITIAL_BACKOFF_SECONDS,
+        max_backoff: float = DEFAULT_MAX_BACKOFF_SECONDS,
+        backoff_multiplier: int = DEFAULT_BACKOFF_MULTIPLIER,
+    ) -> str:
+        """
+        Returns a JSON string to use for grpc.service_config option when creating a grpc channel
+        """
+        return json.dumps(
+            {
+                "methodConfig": [
+                    {
+                        "name": [{}],
+                        "retryPolicy": {
+                            "maxAttempts": max_attempts,
+                            "initialBackoff": f"{initial_backoff}s",
+                            "maxBackoff": f"{max_backoff}s",
+                            "backoffMultiplier": backoff_multiplier,
+                            "retryableStatusCodes": [
+                                "CANCELLED",
+                                "UNKNOWN",
+                                "DEADLINE_EXCEEDED",
+                                "RESOURCE_EXHAUSTED",
+                                "ABORTED",
+                                "INTERNAL",
+                                "UNAVAILABLE",
+                            ],
+                        },
+                    }
+                ]
+            }
+        )

exabel/client/api/api_client/grpc/calendar_grpc_client.py

@@ -0,0 +1,61 @@
+from exabel.client.api.api_client.calendar_api_client import CalendarApiClient
+from exabel.client.api.api_client.exabel_api_group import ExabelApiGroup
+from exabel.client.api.api_client.grpc.base_grpc_client import BaseGrpcClient
+from exabel.client.api.error_handler import handle_grpc_error
+from exabel.client.client_config import ClientConfig
+from exabel.stubs.exabel.api.data.v1.calendar_service_pb2 import (
+    BatchCreateFiscalPeriodsRequest,
+    BatchCreateFiscalPeriodsResponse,
+    CompanyCalendar,
+    DeleteFiscalPeriodRequest,
+    GetCompanyCalendarRequest,
+    ListCompaniesWithFiscalPeriodsRequest,
+    ListCompaniesWithFiscalPeriodsResponse,
+    ListFiscalPeriodsRequest,
+    ListFiscalPeriodsResponse,
+)
+from exabel.stubs.exabel.api.data.v1.calendar_service_pb2_grpc import CalendarServiceStub
+
+
+class CalendarGrpcClient(CalendarApiClient, BaseGrpcClient):
+    """
+    Client which sends calendar requests to the Exabel Data API with gRPC.
+    """
+
+    def __init__(self, config: ClientConfig):
+        super().__init__(config, ExabelApiGroup.DATA_API)
+        self.stub = CalendarServiceStub(self.channel)
+
+    @handle_grpc_error
+    def get_company_calendar(self, request: GetCompanyCalendarRequest) -> CompanyCalendar:
+        return self.stub.GetCompanyCalendar(
+            request, metadata=self.metadata, timeout=self.config.timeout
+        )
+
+    @handle_grpc_error
+    def batch_create_fiscal_periods(
+        self, request: BatchCreateFiscalPeriodsRequest
+    ) -> BatchCreateFiscalPeriodsResponse:
+        return self.stub.BatchCreateFiscalPeriods(
+            request, metadata=self.metadata, timeout=self.config.timeout
+        )
+
+    @handle_grpc_error
+    def list_company_fiscal_periods(
+        self, request: ListFiscalPeriodsRequest
+    ) -> ListFiscalPeriodsResponse:
+        return self.stub.ListFiscalPeriods(
+            request, metadata=self.metadata, timeout=self.config.timeout
+        )
+
+    @handle_grpc_error
+    def delete_fiscal_periods(self, request: DeleteFiscalPeriodRequest) -> None:
+        self.stub.DeleteFiscalPeriod(request, metadata=self.metadata, timeout=self.config.timeout)
+
+    @handle_grpc_error
+    def list_companies_with_fiscal_periods(
+        self, request: ListCompaniesWithFiscalPeriodsRequest
+    ) -> ListCompaniesWithFiscalPeriodsResponse:
+        return self.stub.ListCompaniesWithFiscalPeriods(
+            request, metadata=self.metadata, timeout=self.config.timeout
+        )

exabel/client/api/api_client/grpc/data_set_grpc_client.py

@@ -0,0 +1,45 @@
+from exabel.client.api.api_client.data_set_api_client import DataSetApiClient
+from exabel.client.api.api_client.exabel_api_group import ExabelApiGroup
+from exabel.client.api.api_client.grpc.base_grpc_client import BaseGrpcClient
+from exabel.client.api.error_handler import handle_grpc_error
+from exabel.client.client_config import ClientConfig
+from exabel.stubs.exabel.api.data.v1.all_pb2 import (
+    CreateDataSetRequest,
+    DataSet,
+    DeleteDataSetRequest,
+    GetDataSetRequest,
+    ListDataSetsRequest,
+    ListDataSetsResponse,
+    UpdateDataSetRequest,
+)
+from exabel.stubs.exabel.api.data.v1.all_pb2_grpc import DataSetServiceStub
+
+
+class DataSetGrpcClient(DataSetApiClient, BaseGrpcClient):
+    """
+    Client which sends data set requests to the Exabel Data API with gRPC.
+    """
+
+    def __init__(self, config: ClientConfig):
+        super().__init__(config, ExabelApiGroup.DATA_API)
+        self.stub = DataSetServiceStub(self.channel)
+
+    @handle_grpc_error
+    def list_data_sets(self, request: ListDataSetsRequest) -> ListDataSetsResponse:
+        return self.stub.ListDataSets(request, metadata=self.metadata, timeout=self.config.timeout)
+
+    @handle_grpc_error
+    def get_data_set(self, request: GetDataSetRequest) -> DataSet:
+        return self.stub.GetDataSet(request, metadata=self.metadata, timeout=self.config.timeout)
+
+    @handle_grpc_error
+    def create_data_set(self, request: CreateDataSetRequest) -> DataSet:
+        return self.stub.CreateDataSet(request, metadata=self.metadata, timeout=self.config.timeout)
+
+    @handle_grpc_error
+    def update_data_set(self, request: UpdateDataSetRequest) -> DataSet:
+        return self.stub.UpdateDataSet(request, metadata=self.metadata, timeout=self.config.timeout)
+
+    @handle_grpc_error
+    def delete_data_set(self, request: DeleteDataSetRequest) -> None:
+        return self.stub.DeleteDataSet(request, metadata=self.metadata, timeout=self.config.timeout)

exabel/client/api/api_client/grpc/derived_signal_grpc_client.py

@@ -0,0 +1,47 @@
+from exabel.client.api.api_client.derived_signal_api_client import DerivedSignalApiClient
+from exabel.client.api.api_client.exabel_api_group import ExabelApiGroup
+from exabel.client.api.api_client.grpc.base_grpc_client import BaseGrpcClient
+from exabel.client.api.error_handler import handle_grpc_error
+from exabel.client.client_config import ClientConfig
+from exabel.stubs.exabel.api.analytics.v1.all_pb2 import (
+    CreateDerivedSignalRequest,
+    DeleteDerivedSignalRequest,
+    DerivedSignal,
+    GetDerivedSignalRequest,
+    UpdateDerivedSignalRequest,
+)
+from exabel.stubs.exabel.api.analytics.v1.all_pb2_grpc import DerivedSignalServiceStub
+
+
+class DerivedSignalGrpcClient(DerivedSignalApiClient, BaseGrpcClient):
+    """
+    Client which sends derived signal requests to the Exabel Analytics API with gRPC.
+    """
+
+    def __init__(self, config: ClientConfig):
+        super().__init__(config, ExabelApiGroup.ANALYTICS_API)
+        self.stub = DerivedSignalServiceStub(self.channel)
+
+    @handle_grpc_error
+    def create_derived_signal(self, request: CreateDerivedSignalRequest) -> DerivedSignal:
+        return self.stub.CreateDerivedSignal(
+            request, metadata=self.metadata, timeout=self.config.timeout
+        )
+
+    @handle_grpc_error
+    def get_derived_signal(self, request: GetDerivedSignalRequest) -> DerivedSignal:
+        return self.stub.GetDerivedSignal(
+            request, metadata=self.metadata, timeout=self.config.timeout
+        )
+
+    @handle_grpc_error
+    def update_derived_signal(self, request: UpdateDerivedSignalRequest) -> DerivedSignal:
+        return self.stub.UpdateDerivedSignal(
+            request, metadata=self.metadata, timeout=self.config.timeout
+        )
+
+    @handle_grpc_error
+    def delete_derived_signal(self, request: DeleteDerivedSignalRequest) -> None:
+        return self.stub.DeleteDerivedSignal(
+            request, metadata=self.metadata, timeout=self.config.timeout
+        )

exabel/client/api/api_client/grpc/entity_grpc_client.py

@@ -0,0 +1,91 @@
+from exabel.client.api.api_client.entity_api_client import EntityApiClient
+from exabel.client.api.api_client.exabel_api_group import ExabelApiGroup
+from exabel.client.api.api_client.grpc.base_grpc_client import BaseGrpcClient
+from exabel.client.api.error_handler import handle_grpc_error
+from exabel.client.client_config import ClientConfig
+from exabel.stubs.exabel.api.data.v1.all_pb2 import (
+    CreateEntityRequest,
+    CreateEntityTypeRequest,
+    DeleteEntitiesRequest,
+    DeleteEntityRequest,
+    DeleteEntityTypeRequest,
+    Entity,
+    EntityType,
+    GetEntityRequest,
+    GetEntityTypeRequest,
+    ListEntitiesRequest,
+    ListEntitiesResponse,
+    ListEntityTypesRequest,
+    ListEntityTypesResponse,
+    SearchEntitiesRequest,
+    SearchEntitiesResponse,
+    UpdateEntityRequest,
+    UpdateEntityTypeRequest,
+)
+from exabel.stubs.exabel.api.data.v1.all_pb2_grpc import EntityServiceStub
+
+
+class EntityGrpcClient(EntityApiClient, BaseGrpcClient):
+    """
+    Client which sends entity requests to the Exabel Data API with gRPC.
+    """
+
+    def __init__(self, config: ClientConfig):
+        super().__init__(config, ExabelApiGroup.DATA_API)
+        self.stub = EntityServiceStub(self.channel)
+
+    @handle_grpc_error
+    def list_entity_types(self, request: ListEntityTypesRequest) -> ListEntityTypesResponse:
+        return self.stub.ListEntityTypes(
+            request, metadata=self.metadata, timeout=self.config.timeout
+        )
+
+    @handle_grpc_error
+    def get_entity_type(self, request: GetEntityTypeRequest) -> EntityType:
+        return self.stub.GetEntityType(request, metadata=self.metadata, timeout=self.config.timeout)
+
+    @handle_grpc_error
+    def create_entity_type(self, request: CreateEntityTypeRequest) -> EntityType:
+        return self.stub.CreateEntityType(
+            request, metadata=self.metadata, timeout=self.config.timeout
+        )
+
+    @handle_grpc_error
+    def update_entity_type(self, request: UpdateEntityTypeRequest) -> EntityType:
+        return self.stub.UpdateEntityType(
+            request, metadata=self.metadata, timeout=self.config.timeout
+        )
+
+    @handle_grpc_error
+    def delete_entity_type(self, request: DeleteEntityTypeRequest) -> None:
+        self.stub.DeleteEntityType(request, metadata=self.metadata, timeout=self.config.timeout)
+
+    @handle_grpc_error
+    def list_entities(self, request: ListEntitiesRequest) -> ListEntitiesResponse:
+        return self.stub.ListEntities(request, metadata=self.metadata, timeout=self.config.timeout)
+
+    @handle_grpc_error
+    def get_entity(self, request: GetEntityRequest) -> Entity:
+        return self.stub.GetEntity(request, metadata=self.metadata, timeout=self.config.timeout)
+
+    @handle_grpc_error
+    def create_entity(self, request: CreateEntityRequest) -> Entity:
+        return self.stub.CreateEntity(request, metadata=self.metadata, timeout=self.config.timeout)
+
+    @handle_grpc_error
+    def update_entity(self, request: UpdateEntityRequest) -> Entity:
+        return self.stub.UpdateEntity(request, metadata=self.metadata, timeout=self.config.timeout)
+
+    @handle_grpc_error
+    def delete_entity(self, request: DeleteEntityRequest) -> None:
+        self.stub.DeleteEntity(request, metadata=self.metadata, timeout=self.config.timeout)
+
+    @handle_grpc_error
+    def delete_entities(self, request: DeleteEntitiesRequest) -> None:
+        self.stub.DeleteEntities(request, metadata=self.metadata, timeout=self.config.timeout)
+
+    @handle_grpc_error
+    def search_entities(self, request: SearchEntitiesRequest) -> SearchEntitiesResponse:
+        return self.stub.SearchEntities(
+            request, metadata=self.metadata, timeout=self.config.timeout
+        )

exabel/client/api/api_client/grpc/holiday_grpc_client.py

@@ -0,0 +1,63 @@
+from exabel.client.api.api_client.exabel_api_group import ExabelApiGroup
+from exabel.client.api.api_client.grpc.base_grpc_client import BaseGrpcClient
+from exabel.client.api.api_client.holiday_api_client import HolidayApiClient
+from exabel.client.api.error_handler import handle_grpc_error
+from exabel.client.client_config import ClientConfig
+from exabel.stubs.exabel.api.data.v1.holiday_messages_pb2 import HolidaySpecification
+from exabel.stubs.exabel.api.data.v1.holiday_service_pb2 import (
+    CreateHolidaySpecificationRequest,
+    DeleteHolidaySpecificationRequest,
+    GetHolidaySpecificationRequest,
+    ListHolidaySpecificationsRequest,
+    ListHolidaySpecificationsResponse,
+    UpdateHolidaySpecificationRequest,
+)
+from exabel.stubs.exabel.api.data.v1.holiday_service_pb2_grpc import HolidayServiceStub
+
+
+class HolidayGrpcClient(HolidayApiClient, BaseGrpcClient):
+    """
+    Client which sends holiday requests to the Exabel Data API with gRPC.
+    """
+
+    def __init__(self, config: ClientConfig):
+        super().__init__(config, ExabelApiGroup.DATA_API)
+        self.stub = HolidayServiceStub(self.channel)
+
+    @handle_grpc_error
+    def list_holiday_specifications(
+        self, request: ListHolidaySpecificationsRequest
+    ) -> ListHolidaySpecificationsResponse:
+        return self.stub.ListHolidaySpecifications(
+            request, metadata=self.metadata, timeout=self.config.timeout
+        )
+
+    @handle_grpc_error
+    def get_holiday_specification(
+        self, request: GetHolidaySpecificationRequest
+    ) -> HolidaySpecification:
+        return self.stub.GetHolidaySpecification(
+            request, metadata=self.metadata, timeout=self.config.timeout
+        )
+
+    @handle_grpc_error
+    def create_holiday_specification(
+        self, request: CreateHolidaySpecificationRequest
+    ) -> HolidaySpecification:
+        return self.stub.CreateHolidaySpecification(
+            request, metadata=self.metadata, timeout=self.config.timeout
+        )
+
+    @handle_grpc_error
+    def update_holiday_specification(
+        self, request: UpdateHolidaySpecificationRequest
+    ) -> HolidaySpecification:
+        return self.stub.UpdateHolidaySpecification(
+            request, metadata=self.metadata, timeout=self.config.timeout
+        )
+
+    @handle_grpc_error
+    def delete_holiday_specification(self, request: DeleteHolidaySpecificationRequest) -> None:
+        self.stub.DeleteHolidaySpecification(
+            request, metadata=self.metadata, timeout=self.config.timeout
+        )