crypticorn 2.10.0__tar.gz → 2.10.2__tar.gz

{crypticorn-2.10.0 → crypticorn-2.10.2}/CHANGELOG.md

@@ -1,6 +1,37 @@
 # CHANGELOG
 
 
+## v2.10.2 (2025-05-12)
+
+### Bug Fixes
+
+- Convert market metrics service models to use unix ts
+  ([`d6c9564`](https://github.com/crypticorn-ai/api-client/commit/d6c95644aea7a239a8ffc91afb3d48db3f56b03c))
+
+### Chores
+
+- Add --url flag to client generation scripts
+  ([`a8ebed2`](https://github.com/crypticorn-ai/api-client/commit/a8ebed2ded196ea132db236417c6c6962f4dbeb2))
+
+
+## v2.10.1 (2025-05-12)
+
+### Bug Fixes
+
+- Fixes optional symbol in get_marketcap_symbols function
+  ([`3522a09`](https://github.com/crypticorn-ai/api-client/commit/3522a097cb159d638c717b26f9d607e813d210a9))
+
+### Build System
+
+- Include static files in the structure in the distribution
+  ([`eb87ab4`](https://github.com/crypticorn-ai/api-client/commit/eb87ab44edb7558b09835ffe092d4a4d9517b79d))
+
+### Refactoring
+
+- Remove usage of deprecated `ExcludeEnumMixin`
+  ([`bf4f4fb`](https://github.com/crypticorn-ai/api-client/commit/bf4f4fb4dc092a9909a6e536c5e5455244e13aac))
+
+
 ## v2.10.0 (2025-05-09)
 
 ### Build System

{crypticorn-2.10.0 → crypticorn-2.10.2}/MANIFEST.in

@@ -1,4 +1,5 @@
 graft crypticorn/cli/templates
 include CHANGELOG.md
 include README.md
-include LICENSE
+include LICENSE
+include static

{crypticorn-2.10.0/crypticorn.egg-info → crypticorn-2.10.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: crypticorn
-Version: 2.10.0
+Version: 2.10.2
 Summary: Maximise Your Crypto Trading Profits with Machine Learning
 Author-email: Crypticorn <timon@crypticorn.com>
 License: Copyright © 2025 Crypticorn
@@ -50,8 +50,6 @@ Requires-Dist: tqdm<5.0.0,>=4.67.0
 Provides-Extra: dev
 Requires-Dist: build; extra == "dev"
 Requires-Dist: twine; extra == "dev"
-Requires-Dist: streamlit; extra == "dev"
-Requires-Dist: httpx; extra == "dev"
 Requires-Dist: black; extra == "dev"
 Requires-Dist: ruff; extra == "dev"
 Requires-Dist: isort; extra == "dev"
@@ -100,7 +98,7 @@ from crypticorn import ApiClient
 ```
 The ApiClient serves as the central interface for API operations. It instantiates multiple API wrappers corresponding to our micro services. These are structured the following:
 
-<img src="../static/pip-structure.svg" alt="pip package structure" />
+<img src="pip-structure.svg" alt="pip package structure" />
 
 You can either explore each API by clicking through the library or checkout the [API Documentation](https://docs.crypticorn.com/api).
 

{crypticorn-2.10.0 → crypticorn-2.10.2}/README.md

@@ -29,7 +29,7 @@ from crypticorn import ApiClient
 ```
 The ApiClient serves as the central interface for API operations. It instantiates multiple API wrappers corresponding to our micro services. These are structured the following:
 
-<img src="../static/pip-structure.svg" alt="pip package structure" />
+<img src="pip-structure.svg" alt="pip package structure" />
 
 You can either explore each API by clicking through the library or checkout the [API Documentation](https://docs.crypticorn.com/api).
 

{crypticorn-2.10.0 → crypticorn-2.10.2}/crypticorn/cli/init.py

@@ -4,6 +4,7 @@ import subprocess
 import importlib.resources
 import crypticorn.cli.templates as templates
 
+
 def get_git_root() -> Path:
     """Get the root directory of the git repository."""
     try:
@@ -29,6 +30,7 @@ def copy_template(template_name: str, target_path: Path):
 
     click.secho(f"✅ Created: {target_path}", fg="green")
 
+
 def check_file_exists(path: Path, force: bool):
     if path.exists() and not force:
         click.secho(f"File already exists, use --force / -f to overwrite", fg="red")
@@ -113,6 +115,7 @@ def init_dependabot(force):
         return
     copy_template("dependabot.yml", target)
 
+
 @init_group.command("merge-env")
 @click.option("-f", "--force", is_flag=True, help="Force overwrite the .env file")
 def init_merge_env(force):

{crypticorn-2.10.0 → crypticorn-2.10.2}/crypticorn/cli/templates/merge-env.sh

@@ -1,7 +1,11 @@
 #!/usr/bin/env bash
+
 # this script merges the env variables from the environment and the .env.example file into the .env file
 # the appended variables take precedence over the .env.example variables (if both are set)
 
+# Make executable before running in github actions
+# chmod +x scripts/merge-env.sh
+
 # Usage in a github action:
 # - name: Generate .env
 #   run: ./scripts/merge-env.sh

{crypticorn-2.10.0 → crypticorn-2.10.2}/crypticorn/cli/version.py

@@ -1,6 +1,7 @@
 import importlib.metadata
 import click
 
+
 @click.command("version")
 def version():
     """Print the version of the crypticorn package"""

{crypticorn-2.10.0 → crypticorn-2.10.2}/crypticorn/common/decorators.py

@@ -1,7 +1,8 @@
+from datetime import datetime
 from typing import Optional, Type, Any, Tuple
 from copy import deepcopy
 
-from pydantic import BaseModel, create_model
+from pydantic import BaseModel, create_model, field_validator, BeforeValidator
 from pydantic.fields import FieldInfo
 
 

{crypticorn-2.10.0 → crypticorn-2.10.2}/crypticorn/common/enums.py

@@ -1,17 +1,17 @@
 """Defines common enumerations used throughout the codebase for type safety and consistency."""
 
 from enum import StrEnum
-from crypticorn.common.mixins import ValidateEnumMixin, ExcludeEnumMixin
+from crypticorn.common.mixins import ValidateEnumMixin
 
 
-class Exchange(ValidateEnumMixin, ExcludeEnumMixin, StrEnum):
+class Exchange(ValidateEnumMixin, StrEnum):
     """Supported exchanges for trading"""
 
     KUCOIN = "kucoin"
     BINGX = "bingx"
 
 
-class InternalExchange(ValidateEnumMixin, ExcludeEnumMixin, StrEnum):
+class InternalExchange(ValidateEnumMixin, StrEnum):
     """All exchanges we are using, including public (Exchange)"""
 
     KUCOIN = "kucoin"
@@ -22,7 +22,7 @@ class InternalExchange(ValidateEnumMixin, ExcludeEnumMixin, StrEnum):
     BITGET = "bitget"
 
 
-class MarketType(ValidateEnumMixin, ExcludeEnumMixin, StrEnum):
+class MarketType(ValidateEnumMixin, StrEnum):
     """
     Market types
     """

{crypticorn-2.10.0 → crypticorn-2.10.2}/crypticorn/common/errors.py

@@ -2,10 +2,10 @@
 
 from enum import Enum, StrEnum
 from fastapi import status
-from crypticorn.common.mixins import ExcludeEnumMixin, ApiErrorFallback
+from crypticorn.common.mixins import ApiErrorFallback
 
 
-class ApiErrorType(ExcludeEnumMixin, StrEnum):
+class ApiErrorType(StrEnum):
     """Type of the API error."""
 
     USER_ERROR = "user error"
@@ -18,7 +18,7 @@ class ApiErrorType(ExcludeEnumMixin, StrEnum):
     """error that does not need to be handled or does not affect the program or is a placeholder."""
 
 
-class ApiErrorIdentifier(ExcludeEnumMixin, StrEnum):
+class ApiErrorIdentifier(StrEnum):
     """Unique identifier of the API error."""
 
     ALLOCATION_BELOW_EXPOSURE = "allocation_below_current_exposure"
@@ -98,13 +98,12 @@ class ApiErrorIdentifier(ExcludeEnumMixin, StrEnum):
     UNKNOWN_ERROR = "unknown_error_occurred"
     URL_NOT_FOUND = "requested_resource_not_found"
 
-    @property
     def get_error(self) -> "ApiError":
         """Get the corresponding ApiError."""
-        return ApiError[self.value]
+        return getattr(ApiError, self.name)
 
 
-class ApiErrorLevel(ExcludeEnumMixin, StrEnum):
+class ApiErrorLevel(StrEnum):
     """Level of the API error."""
 
     ERROR = "error"
@@ -113,7 +112,7 @@ class ApiErrorLevel(ExcludeEnumMixin, StrEnum):
     WARNING = "warning"
 
 
-class ApiError(ExcludeEnumMixin, Enum, metaclass=ApiErrorFallback):
+class ApiError(Enum, metaclass=ApiErrorFallback):
     # Fallback to UNKNOWN_ERROR for error codes not yet published to PyPI.
     """Crypticorn API error enumeration."""
 

{crypticorn-2.10.0 → crypticorn-2.10.2}/crypticorn/common/mixins.py

@@ -39,10 +39,13 @@ class ValidateEnumMixin:
 class ExcludeEnumMixin:
     """(deprecated) Mixin to exclude enum from OpenAPI schema. We use this to avoid duplicating enums when generating client code from the openapi spec."""
 
-    warnings.warn(
-        "The `ExcludeEnumMixin` class is deprecated. Should be removed from enums inheriting this class.",
-        category=CrypticornDeprecatedSince28,
-    )
+    def __init_subclass__(cls, **kwargs):
+        super().__init_subclass__(**kwargs)
+        if cls.__name__.startswith("ExcludeEnumMixin"):
+            warnings.warn(
+                "The `ExcludeEnumMixin` class is deprecated. Should be removed from enums inheriting this class.",
+                category=CrypticornDeprecatedSince28,
+            )
 
     @classmethod
     def __get_pydantic_json_schema__(cls, core_schema, handler):
@@ -56,7 +59,7 @@ class ApiErrorFallback(EnumMeta):
 
     def __getattr__(cls, name):
         # Let Pydantic/internal stuff pass silently ! fragile
-        if name.startswith("__"):
+        if name.startswith("__") or name.startswith("_pytest"):
             raise AttributeError(name)
         _logger.warning(
             f"Unknown enum member '{name}' - update crypticorn package or check for typos"

{crypticorn-2.10.0 → crypticorn-2.10.2}/crypticorn/common/utils.py

@@ -1,5 +1,6 @@
 """General utility functions and helper methods used across the codebase."""
 
+from datetime import datetime
 from typing import Any
 from decimal import Decimal
 import string
@@ -74,3 +75,19 @@ def optional_import(module_name: str, extra_name: str) -> Any:
             f"Optional dependency '{module_name}' is required for this feature. "
             f"Install it with: pip install crypticorn[{extra_name}]"
         ) from e
+
+
+def datetime_to_timestamp(v: Any):
+    """Converts a datetime to a timestamp.
+    Can be used as a pydantic validator.
+    >>> from pydantic import BeforeValidator, BaseModel
+    >>> class MyModel(BaseModel):
+    ...     timestamp: Annotated[int, BeforeValidator(datetime_to_timestamp)]
+    """
+    if isinstance(v, list):
+        return [
+            int(item.timestamp()) if isinstance(item, datetime) else item for item in v
+        ]
+    elif isinstance(v, datetime):
+        return int(v.timestamp())
+    return v

{crypticorn-2.10.0 → crypticorn-2.10.2}/crypticorn/metrics/client/api/admin_api.py

@@ -271,7 +271,7 @@ class AdminApi:
         include: Annotated[
             Optional[List[StrictStr]],
             Field(
-                description="List of dependencies to include in the response. If not provided, all installed packages will be returned."
+                description="List of regex patterns to match against package names. If not provided, all installed packages will be returned."
             ),
         ] = None,
         _request_timeout: Union[
@@ -285,12 +285,12 @@ class AdminApi:
         _content_type: Optional[StrictStr] = None,
         _headers: Optional[Dict[StrictStr, Any]] = None,
         _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
-    ) -> List[object]:
+    ) -> Dict[str, str]:
         """List Installed Packages
 
-        Return a list of installed packages and versions.
+        Return a list of installed packages and versions.  The include parameter accepts regex patterns to match against package names. For example: - crypticorn.* will match all packages starting with 'crypticorn' - .*tic.* will match all packages containing 'tic' in their name
 
-        :param include: List of dependencies to include in the response. If not provided, all installed packages will be returned.
+        :param include: List of regex patterns to match against package names. If not provided, all installed packages will be returned.
         :type include: List[str]
         :param _request_timeout: timeout setting for this request. If one
                                  number provided, it will be total request
@@ -323,7 +323,7 @@ class AdminApi:
         )
 
         _response_types_map: Dict[str, Optional[str]] = {
-            "200": "List[object]",
+            "200": "Dict[str, str]",
         }
         response_data = await self.api_client.call_api(
             *_param, _request_timeout=_request_timeout
@@ -340,7 +340,7 @@ class AdminApi:
         include: Annotated[
             Optional[List[StrictStr]],
             Field(
-                description="List of dependencies to include in the response. If not provided, all installed packages will be returned."
+                description="List of regex patterns to match against package names. If not provided, all installed packages will be returned."
             ),
         ] = None,
         _request_timeout: Union[
@@ -354,12 +354,12 @@ class AdminApi:
         _content_type: Optional[StrictStr] = None,
         _headers: Optional[Dict[StrictStr, Any]] = None,
         _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
-    ) -> ApiResponse[List[object]]:
+    ) -> ApiResponse[Dict[str, str]]:
         """List Installed Packages
 
-        Return a list of installed packages and versions.
+        Return a list of installed packages and versions.  The include parameter accepts regex patterns to match against package names. For example: - crypticorn.* will match all packages starting with 'crypticorn' - .*tic.* will match all packages containing 'tic' in their name
 
-        :param include: List of dependencies to include in the response. If not provided, all installed packages will be returned.
+        :param include: List of regex patterns to match against package names. If not provided, all installed packages will be returned.
         :type include: List[str]
         :param _request_timeout: timeout setting for this request. If one
                                  number provided, it will be total request
@@ -392,7 +392,7 @@ class AdminApi:
         )
 
         _response_types_map: Dict[str, Optional[str]] = {
-            "200": "List[object]",
+            "200": "Dict[str, str]",
         }
         response_data = await self.api_client.call_api(
             *_param, _request_timeout=_request_timeout
@@ -409,7 +409,7 @@ class AdminApi:
         include: Annotated[
             Optional[List[StrictStr]],
             Field(
-                description="List of dependencies to include in the response. If not provided, all installed packages will be returned."
+                description="List of regex patterns to match against package names. If not provided, all installed packages will be returned."
             ),
         ] = None,
         _request_timeout: Union[
@@ -426,9 +426,9 @@ class AdminApi:
     ) -> RESTResponseType:
         """List Installed Packages
 
-        Return a list of installed packages and versions.
+        Return a list of installed packages and versions.  The include parameter accepts regex patterns to match against package names. For example: - crypticorn.* will match all packages starting with 'crypticorn' - .*tic.* will match all packages containing 'tic' in their name
 
-        :param include: List of dependencies to include in the response. If not provided, all installed packages will be returned.
+        :param include: List of regex patterns to match against package names. If not provided, all installed packages will be returned.
         :type include: List[str]
         :param _request_timeout: timeout setting for this request. If one
                                  number provided, it will be total request
@@ -461,7 +461,7 @@ class AdminApi:
         )
 
         _response_types_map: Dict[str, Optional[str]] = {
-            "200": "List[object]",
+            "200": "Dict[str, str]",
         }
         response_data = await self.api_client.call_api(
             *_param, _request_timeout=_request_timeout

{crypticorn-2.10.0 → crypticorn-2.10.2}/crypticorn/metrics/client/api/status_api.py

@@ -17,7 +17,7 @@ from typing import Any, Dict, List, Optional, Tuple, Union
 from typing_extensions import Annotated
 
 from pydantic import StrictStr, field_validator
-from typing import Any, Dict, Optional
+from typing import Optional
 
 from crypticorn.metrics.client.api_client import ApiClient, RequestSerialized
 from crypticorn.metrics.client.api_response import ApiResponse
@@ -294,7 +294,7 @@ class StatusApi:
         _content_type: Optional[StrictStr] = None,
         _headers: Optional[Dict[StrictStr, Any]] = None,
         _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
-    ) -> Dict[str, object]:
+    ) -> str:
         """Ping
 
         Returns 'OK' if the API is running.
@@ -329,7 +329,7 @@ class StatusApi:
         )
 
         _response_types_map: Dict[str, Optional[str]] = {
-            "200": "Dict[str, object]",
+            "200": "str",
         }
         response_data = await self.api_client.call_api(
             *_param, _request_timeout=_request_timeout
@@ -354,7 +354,7 @@ class StatusApi:
         _content_type: Optional[StrictStr] = None,
         _headers: Optional[Dict[StrictStr, Any]] = None,
         _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
-    ) -> ApiResponse[Dict[str, object]]:
+    ) -> ApiResponse[str]:
         """Ping
 
         Returns 'OK' if the API is running.
@@ -389,7 +389,7 @@ class StatusApi:
         )
 
         _response_types_map: Dict[str, Optional[str]] = {
-            "200": "Dict[str, object]",
+            "200": "str",
         }
         response_data = await self.api_client.call_api(
             *_param, _request_timeout=_request_timeout
@@ -449,7 +449,7 @@ class StatusApi:
         )
 
         _response_types_map: Dict[str, Optional[str]] = {
-            "200": "Dict[str, object]",
+            "200": "str",
         }
         response_data = await self.api_client.call_api(
             *_param, _request_timeout=_request_timeout

{crypticorn-2.10.0 → crypticorn-2.10.2}/crypticorn/metrics/client/configuration.py

@@ -215,9 +215,7 @@ class Configuration:
         debug: Optional[bool] = None,
     ) -> None:
         """Constructor"""
-        self._base_path = (
-            "https://api.crypticorn.dev/v1/metrics" if host is None else host
-        )
+        self._base_path = "http://127.0.0.1:8000/v1/metrics" if host is None else host
         """Default Base url
         """
         self.server_index = 0 if server_index is None and host is None else server_index
@@ -559,7 +557,7 @@ class Configuration:
         """
         return [
             {
-                "url": "https://api.crypticorn.dev/v1/metrics",
+                "url": "http://127.0.0.1:8000/v1/metrics",
                 "description": "No description provided",
             }
         ]

{crypticorn-2.10.0 → crypticorn-2.10.2}/crypticorn/metrics/client/models/api_error_identifier.py

@@ -20,7 +20,7 @@ from typing_extensions import Self
 
 class ApiErrorIdentifier(str, Enum):
     """
-    API error identifiers
+    Unique identifier of the API error.
     """
 
     """

{crypticorn-2.10.0 → crypticorn-2.10.2}/crypticorn/metrics/client/models/api_error_level.py

@@ -20,7 +20,7 @@ from typing_extensions import Self
 
 class ApiErrorLevel(str, Enum):
     """
-    API error levels
+    Level of the API error.
     """
 
     """

{crypticorn-2.10.0 → crypticorn-2.10.2}/crypticorn/metrics/client/models/api_error_type.py

@@ -20,7 +20,7 @@ from typing_extensions import Self
 
 class ApiErrorType(str, Enum):
     """
-    Type of API error
+    Type of the API error.
     """
 
     """

{crypticorn-2.10.0 → crypticorn-2.10.2}/crypticorn/metrics/client/models/exception_detail.py

@@ -28,7 +28,7 @@ from typing_extensions import Self
 
 class ExceptionDetail(BaseModel):
     """
-    This is the detail of the exception. It is used to enrich the exception with additional information by unwrapping the ApiError into its components.
+    Exception details returned to the client.
     """  # noqa: E501
 
     message: Optional[StrictStr] = None

{crypticorn-2.10.0 → crypticorn-2.10.2}/crypticorn/metrics/client/models/marketcap_ranking.py

@@ -17,9 +17,8 @@ import pprint
 import re  # noqa: F401
 import json
 
-from datetime import datetime
-from pydantic import BaseModel, ConfigDict, StrictStr
-from typing import Any, ClassVar, Dict, List
+from pydantic import BaseModel, ConfigDict, StrictInt, StrictStr
+from typing import Any, ClassVar, Dict, List, Optional
 from typing import Optional, Set
 from typing_extensions import Self
 
@@ -29,8 +28,8 @@ class MarketcapRanking(BaseModel):
     MarketcapRanking
     """  # noqa: E501
 
-    timestamp: datetime
-    symbols: List[StrictStr]
+    timestamp: StrictInt
+    symbols: List[Optional[StrictStr]]
     __properties: ClassVar[List[str]] = ["timestamp", "symbols"]
 
     model_config = ConfigDict(

{crypticorn-2.10.0 → crypticorn-2.10.2}/crypticorn/metrics/client/models/ohlcv.py

@@ -17,7 +17,6 @@ import pprint
 import re  # noqa: F401
 import json
 
-from datetime import datetime
 from pydantic import BaseModel, ConfigDict, StrictFloat, StrictInt
 from typing import Any, ClassVar, Dict, List, Optional, Union
 from typing import Optional, Set
@@ -29,7 +28,7 @@ class OHLCV(BaseModel):
     OHLCV
     """  # noqa: E501
 
-    timestamp: datetime
+    timestamp: StrictInt
     open: Union[StrictFloat, StrictInt]
     high: Union[StrictFloat, StrictInt]
     low: Union[StrictFloat, StrictInt]

{crypticorn-2.10.0 → crypticorn-2.10.2/crypticorn.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: crypticorn
-Version: 2.10.0
+Version: 2.10.2
 Summary: Maximise Your Crypto Trading Profits with Machine Learning
 Author-email: Crypticorn <timon@crypticorn.com>
 License: Copyright © 2025 Crypticorn
@@ -50,8 +50,6 @@ Requires-Dist: tqdm<5.0.0,>=4.67.0
 Provides-Extra: dev
 Requires-Dist: build; extra == "dev"
 Requires-Dist: twine; extra == "dev"
-Requires-Dist: streamlit; extra == "dev"
-Requires-Dist: httpx; extra == "dev"
 Requires-Dist: black; extra == "dev"
 Requires-Dist: ruff; extra == "dev"
 Requires-Dist: isort; extra == "dev"
@@ -100,7 +98,7 @@ from crypticorn import ApiClient
 ```
 The ApiClient serves as the central interface for API operations. It instantiates multiple API wrappers corresponding to our micro services. These are structured the following:
 
-<img src="../static/pip-structure.svg" alt="pip package structure" />
+<img src="pip-structure.svg" alt="pip package structure" />
 
 You can either explore each API by clicking through the library or checkout the [API Documentation](https://docs.crypticorn.com/api).
 

{crypticorn-2.10.0 → crypticorn-2.10.2}/crypticorn.egg-info/requires.txt

@@ -14,8 +14,6 @@ tqdm<5.0.0,>=4.67.0
 [dev]
 build
 twine
-streamlit
-httpx
 black
 ruff
 isort

{crypticorn-2.10.0 → crypticorn-2.10.2}/pyproject.toml

@@ -5,7 +5,7 @@ readme = "README.md"
 license = {file = 'LICENSE'}
 requires-python = ">=3.10"
 authors = [{name = "Crypticorn", email = "timon@crypticorn.com"}]
-version = "2.10.0"
+version = "2.10.2"
 keywords = ["machine learning", "data science", "crypto", "modelling"]
 dynamic = ["dependencies", "optional-dependencies"]
 

{crypticorn-2.10.0 → crypticorn-2.10.2}/requirements/dev.txt

@@ -1,7 +1,5 @@
 build
 twine
-streamlit
-httpx
 black
 ruff
 isort

{crypticorn-2.10.0 → crypticorn-2.10.2}/tests/test_errors.py

@@ -52,3 +52,12 @@ async def test_fallback():
     assert (
         ApiError.NOT_EXISTING_ERROR == ApiError.UNKNOWN_ERROR
     ), "Fallback error is not used"
+
+
+@pytest.mark.asyncio
+async def test_error_from_identifier():
+    """Checks that the error can be retrieved from the identifier"""
+    assert (
+        ApiErrorIdentifier.ALLOCATION_BELOW_EXPOSURE.get_error()
+        == ApiError.ALLOCATION_BELOW_EXPOSURE
+    )