castor-extractor 0.24.9__py3-none-any.whl → 0.24.13__py3-none-any.whl

CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## 0.24.13 - 2025-05-05
+
+* Rollback cloud-storage version as it's not compatible with Keboola
+
+## 0.24.12 - 2025-05-05
+
+* Redshift - fix query definition of materialized views
+
+## 0.24.11 - 2025-05-05
+
+* add support for Strategy (formerly MicroStrategy)
+
+## 0.24.10 - 2025-04-30
+
+* Tableau - skip warnings instead of raising an error
+
 ## 0.24.9 - 2025-04-16
 
 * Introduce API client for **Coalesce**

README.md

@@ -37,6 +37,8 @@ It also embeds utilities to help you push your metadata to Castor:
 Requirements: **python3.9+**
 <img src="https://upload.wikimedia.org/wikipedia/commons/c/c3/Python-logo-notext.svg" width=20 />
 
+**Note:** The Strategy command requires **python3.10+**. All other modules work with python3.9+.
+
 ### Create castor-env
 
 We advise to create a dedicated [Python environment](https://docs.python.org/3/library/venv.html).
@@ -115,6 +117,7 @@ pip install castor-extractor[postgres]
 pip install castor-extractor[redshift]
 pip install castor-extractor[snowflake]
 pip install castor-extractor[sqlserver]
+pip install castor-extractor[strategy]
 pip install castor-extractor[tableau]
 ```
 
@@ -138,6 +141,6 @@ export CASTOR_OUTPUT_DIRECTORY="/tmp/castor"
 
 ## Contact
 
-For any questions or bug report, contact us at [support@castordoc.com](mailto:support@castordoc.com)
+For any questions or bug report, contact us at [support@coalesce.io](mailto:support@coalesce.io)
 
-[Castor](https://castordoc.com) helps you find, understand, use your data assets
+[Catalog from Coalesce](https://castordoc.com) helps you find, understand, use your data assets

castor_extractor/commands/extract_strategy.py

@@ -0,0 +1,26 @@
+import logging
+from argparse import ArgumentParser
+
+from castor_extractor.utils import parse_filled_arguments  # type: ignore
+from castor_extractor.visualization import strategy  # type: ignore
+
+logging.basicConfig(level=logging.INFO, format="%(levelname)s - %(message)s")
+
+
+def main():
+    parser = ArgumentParser()
+
+    parser.add_argument("-u", "--username", help="Strategy username")
+    parser.add_argument("-p", "--password", help="Strategy password")
+    parser.add_argument("-b", "--base-url", help="Strategy instance URL")
+    parser.add_argument("-o", "--output", help="Directory to write to")
+
+    parser.add_argument(
+        "-i",
+        "--project-ids",
+        nargs="*",
+        help="Optional list of project IDs",
+        default=None,
+    )
+
+    strategy.extract_all(**parse_filled_arguments(parser))

castor_extractor/visualization/strategy/__init__.py

@@ -0,0 +1,3 @@
+from .assets import StrategyAsset
+from .client import StrategyClient, StrategyCredentials
+from .extract import extract_all

castor_extractor/visualization/strategy/assets.py

@@ -0,0 +1,14 @@
+from ...types import ExternalAsset
+
+
+class StrategyAsset(ExternalAsset):
+    """Strategy assets that can be extracted"""
+
+    ATTRIBUTE = "attribute"
+    CUBE = "cube"
+    DASHBOARD = "dashboard"
+    DOCUMENT = "document"
+    FACT = "fact"
+    METRIC = "metric"
+    REPORT = "report"
+    USER = "user"

castor_extractor/visualization/strategy/client/__init__.py

@@ -0,0 +1,2 @@
+from .client import StrategyClient
+from .credentials import StrategyCredentials

castor_extractor/visualization/strategy/client/client.py

@@ -0,0 +1,313 @@
+import logging
+from collections.abc import Iterator
+from enum import Enum
+from typing import Any, Callable, Optional
+from urllib.parse import urlparse
+
+from mstrio.connection import Connection  # type: ignore
+from mstrio.helpers import IServerError  # type: ignore
+from mstrio.modeling import (  # type: ignore
+    list_attributes,
+    list_facts,
+    list_metrics,
+)
+from mstrio.project_objects import (  # type: ignore
+    Report,
+    list_dashboards,
+    list_documents,
+    list_olap_cubes,
+    list_reports,
+)
+from mstrio.server import Environment  # type: ignore
+from mstrio.types import ObjectSubTypes, ObjectTypes  # type: ignore
+from mstrio.users_and_groups import User, list_users  # type: ignore
+from mstrio.utils.entity import Entity  # type: ignore
+from mstrio.utils.helper import is_dashboard  # type: ignore
+from pydantic import BaseModel, ConfigDict
+
+from ..assets import StrategyAsset
+from .credentials import StrategyCredentials
+
+logger = logging.getLogger(__name__)
+
+_BATCH_SIZE: int = 100
+
+
+class URLTemplates(Enum):
+    DASHBOARD = (
+        "https://{hostname}/MicroStrategyLibrarySTD/app/{project_id}/{id_}"
+    )
+    DOCUMENT = "https://{hostname}/MicroStrategy/servlet/mstrWeb?documentID={id_}&projectID={project_id}"
+    REPORT = "https://{hostname}/MicroStrategy/servlet/mstrWeb?reportID={id_}&projectID={project_id}"
+    FOLDER = "https://{hostname}/MicroStrategy/servlet/mstrWeb?folderID={id_}&projectID={project_id}"
+
+
+def _is_dashboard(entity: Entity) -> bool:
+    """
+    Returns True if the entity is a Dashboard. They can only be distinguished
+    from Documents by checking the `view_media` property.
+    """
+    is_type_document = entity.type == ObjectTypes.DOCUMENT_DEFINITION
+    return is_type_document and is_dashboard(entity.view_media)
+
+
+def _is_report(entity: Entity) -> bool:
+    """
+    Returns True if the entity is a Report. Cubes share the same type as Reports,
+    so the subtype must be checked.
+    """
+    is_type_report = entity.type == ObjectTypes.REPORT_DEFINITION
+    is_subtype_cube = entity.subtype == ObjectSubTypes.OLAP_CUBE.value
+    return is_type_report and not is_subtype_cube
+
+
+def _safe_get_attribute(entity: Entity, attribute: str) -> Optional[str]:
+    """
+    Some properties may raise an error. Example: retrieving a Report's `sql` fails if the Report has not been published.
+    This safely returns the attribute value, or None if the retrieval fails.
+    """
+    try:
+        value = getattr(entity, attribute)
+    except IServerError as e:
+        logger.error(f"Could not get {attribute} for entity {entity.id}: {e}")
+        value = None
+    return value
+
+
+class Dependency(BaseModel):
+    id: str
+    name: str
+    subtype: int
+    type: int
+
+    model_config = ConfigDict(extra="ignore")
+
+
+def _list_dependencies(entity: Entity) -> list[dict]:
+    """Lists the entity's dependencies, keeping only relevant fields."""
+    dependencies: list[dict] = []
+
+    offset = 0
+    while True:
+        batch = entity.list_dependencies(offset=offset, limit=_BATCH_SIZE)
+        dependencies.extend(batch)
+        if len(batch) < _BATCH_SIZE:
+            break
+        offset += _BATCH_SIZE
+
+    return [
+        Dependency(**dependency).model_dump() for dependency in dependencies
+    ]
+
+
+def _level_1_folder_id(folders: list[dict]) -> str:
+    """Searches for the first enclosing folder and returns its ID."""
+    for folder in folders:
+        if folder["level"] == 1:
+            return folder["id"]
+
+    raise ValueError("No level 1 folder found")
+
+
+class StrategyClient:
+    """Connect to Strategy through mstrio-py and fetch main assets."""
+
+    def __init__(self, credentials: StrategyCredentials):
+        self.base_url = credentials.base_url
+        self.connection = Connection(
+            base_url=self.base_url,
+            username=credentials.username,
+            password=credentials.password,
+        )
+
+        self.hostname = urlparse(self.base_url).hostname
+
+        if credentials.project_ids:
+            self.project_ids = credentials.project_ids
+        else:
+            env = Environment(connection=self.connection)
+            self.project_ids = [project.id for project in env.list_projects()]
+
+    def close(self):
+        self.connection.close()
+
+    def _url(self, entity: Entity) -> str:
+        """
+        Formats the right URL.
+        * Dashboards : viewed in MicroStrategy
+        * Reports and Documents : viewed in MicroStrategy Web
+        * other (i.e. Cubes): the URL leads to the folder in MicroStrategy Web
+        """
+        if _is_dashboard(entity):
+            id_ = entity.id
+            template = URLTemplates.DASHBOARD
+
+        elif entity.type == ObjectTypes.DOCUMENT_DEFINITION:
+            id_ = entity.id
+            template = URLTemplates.DOCUMENT
+
+        elif _is_report(entity):
+            id_ = entity.id
+            template = URLTemplates.REPORT
+
+        else:
+            # default to folder URL
+            id_ = _level_1_folder_id(entity.ancestors)
+            template = URLTemplates.FOLDER
+
+        return template.value.format(
+            hostname=self.hostname,
+            id_=id_,
+            project_id=entity.project_id,
+        )
+
+    def _common_entity_properties(
+        self,
+        entity: Entity,
+        with_url: bool = True,
+        with_description: bool = True,
+    ) -> dict:
+        """
+        Returns the entity's properties, including its dependencies
+        and optional URL and/or description.
+        """
+        dependencies = _list_dependencies(entity)
+        owner_id = entity.owner.id if isinstance(entity.owner, User) else None
+        properties = {
+            "dependencies": dependencies,
+            "id": entity.id,
+            "location": entity.location,
+            "name": entity.name,
+            "owner_id": owner_id,
+            "subtype": entity.subtype,
+            "type": entity.type.value,
+        }
+
+        if with_url:
+            properties["url"] = self._url(entity)
+
+        if with_description:
+            properties["description"] = _safe_get_attribute(
+                entity, "description"
+            )
+
+        return properties
+
+    def _report_properties(self, report: Report) -> dict[str, Any]:
+        """
+        Report properties contain an optional SQL source query. Due to a typing
+        bug in the mstrio package, the typing must be ignored.
+        """
+        properties = self._common_entity_properties(report)  # type: ignore
+        properties["url"] = self._url(report)  # type: ignore
+        properties["sql"] = _safe_get_attribute(report, "sql")  # type: ignore
+        return properties
+
+    @staticmethod
+    def _user_properties(user: User) -> dict[str, Any]:
+        return {
+            "id": user.id,
+            "name": user.name,
+            "username": user.username,
+            "email": user.default_email_address,
+        }
+
+    def _fetch_entities(
+        self,
+        extract_callback: Callable,
+        with_url: bool = True,
+        with_description: bool = True,
+        custom_property_extractor: Optional[Callable] = None,
+    ) -> Iterator[dict[str, Any]]:
+        """
+        Yields all entities across all projects using the given retrieval function from the mstrio package.
+        """
+        for project_id in self.project_ids:
+            self.connection.select_project(project_id=project_id)
+
+            entities = extract_callback(connection=self.connection)
+
+            for entity in entities:
+                try:
+                    if custom_property_extractor:
+                        yield custom_property_extractor(entity)
+                    else:
+                        yield self._common_entity_properties(
+                            entity,
+                            with_url=with_url,
+                            with_description=with_description,
+                        )
+                except IServerError as e:
+                    logger.error(
+                        f"Could not fetch attributes for entity {entity.id}: {e}"
+                    )
+
+    def _fetch_attributes(self) -> Iterator[dict[str, Any]]:
+        return self._fetch_entities(
+            list_attributes,
+            with_url=False,
+        )
+
+    def _fetch_cubes(self) -> Iterator[dict[str, Any]]:
+        return self._fetch_entities(list_olap_cubes)
+
+    def _fetch_dashboards(self) -> Iterator[dict[str, Any]]:
+        return self._fetch_entities(list_dashboards)
+
+    def _fetch_documents(self) -> Iterator[dict[str, Any]]:
+        return self._fetch_entities(list_documents)
+
+    def _fetch_facts(self) -> Iterator[dict[str, Any]]:
+        """Yields all facts. Descriptions are not needed for this entity type."""
+        return self._fetch_entities(
+            list_facts,
+            with_url=False,
+            with_description=False,
+        )
+
+    def _fetch_metrics(self) -> Iterator[dict[str, Any]]:
+        return self._fetch_entities(
+            list_metrics,
+            with_url=False,
+        )
+
+    def _fetch_reports(self) -> Iterator[dict[str, Any]]:
+        return self._fetch_entities(
+            list_reports,
+            custom_property_extractor=self._report_properties,
+        )
+
+    def _fetch_users(self) -> Iterator[dict[str, Any]]:
+        return self._fetch_entities(
+            list_users,
+            custom_property_extractor=self._user_properties,
+        )
+
+    def fetch(self, asset: StrategyAsset):
+        """Fetch the given asset type from Strategy"""
+        if asset == StrategyAsset.ATTRIBUTE:
+            yield from self._fetch_attributes()
+
+        elif asset == StrategyAsset.CUBE:
+            yield from self._fetch_cubes()
+
+        elif asset == StrategyAsset.DASHBOARD:
+            yield from self._fetch_dashboards()
+
+        elif asset == StrategyAsset.DOCUMENT:
+            yield from self._fetch_documents()
+
+        elif asset == StrategyAsset.FACT:
+            yield from self._fetch_facts()
+
+        elif asset == StrategyAsset.METRIC:
+            yield from self._fetch_metrics()
+
+        elif asset == StrategyAsset.REPORT:
+            yield from self._fetch_reports()
+
+        elif asset == StrategyAsset.USER:
+            yield from self._fetch_users()
+
+        else:
+            raise NotImplementedError(f"Asset type {asset} not implemented yet")

castor_extractor/visualization/strategy/client/credentials.py

@@ -0,0 +1,38 @@
+from typing import Any, Optional
+
+from pydantic import Field, field_validator
+from pydantic_settings import BaseSettings, SettingsConfigDict
+
+STRATEGY_ENV_PREFIX = "CATALOG_STRATEGY_"
+
+
+class StrategyCredentials(BaseSettings):
+    model_config = SettingsConfigDict(
+        env_prefix=STRATEGY_ENV_PREFIX,
+        extra="ignore",
+        populate_by_name=True,
+    )
+
+    base_url: str
+    password: str = Field(repr=False)
+    username: str
+
+    project_ids: Optional[list[str]] = None
+
+    @field_validator("project_ids", mode="before")
+    @classmethod
+    def _check_project_ids(cls, project_ids: Any) -> Optional[list[str]]:
+        """
+        The project IDs are optional and can be either a list of strings
+        or single string with project IDs separated by commas.
+        """
+        if project_ids is None:
+            return None
+
+        if isinstance(project_ids, str):
+            return [item.strip() for item in project_ids.split(",")]
+
+        if isinstance(project_ids, list):
+            return project_ids
+
+        raise ValueError(f"Unexpected type for project_id: {type(project_ids)}")

castor_extractor/visualization/strategy/extract.py

@@ -0,0 +1,43 @@
+import logging
+from collections.abc import Iterable
+from typing import Union
+
+from ...utils import (
+    OUTPUT_DIR,
+    current_timestamp,
+    deep_serialize,
+    from_env,
+    get_output_filename,
+    write_json,
+    write_summary,
+)
+from .assets import StrategyAsset
+from .client import StrategyClient, StrategyCredentials
+
+logger = logging.getLogger(__name__)
+
+
+def iterate_all_data(
+    client: StrategyClient,
+) -> Iterable[tuple[str, Union[list, dict]]]:
+    """Iterate over the extracted data from Strategy"""
+
+    for asset in StrategyAsset:
+        logger.info(f"Extracting {asset.value.upper()} from REST API")
+        data = client.fetch(asset)
+        yield asset.name.lower(), list(deep_serialize(data))
+
+
+def extract_all(**kwargs) -> None:
+    _output_directory = kwargs.get("output") or from_env(OUTPUT_DIR)
+    credentials = StrategyCredentials(**kwargs)
+
+    client = StrategyClient(credentials=credentials)
+    ts = current_timestamp()
+
+    for key, data in iterate_all_data(client):
+        filename = get_output_filename(key, _output_directory, ts)
+        write_json(filename, data)
+
+    client.close()
+    write_summary(_output_directory, ts)

castor_extractor/visualization/tableau/client/client_metadata_api.py

@@ -29,24 +29,62 @@ _RETRY_BASE_MS = 10_000
 _RETRY_COUNT = 4
 
 
+def _is_timeout(error: dict) -> bool:
+    error_message = error.get("message")
+    return error_message == _TIMEOUT_MESSAGE
+
+
+def _is_warning(error: dict) -> bool:
+    extensions = error.get("extensions")
+    if not extensions:
+        return False
+
+    severity = extensions.get("severity")
+    if not severity:
+        return False
+
+    return severity.lower() == "warning"
+
+
 def _check_errors(answer: dict) -> None:
     """
-    handle errors in graphql response:
+    Handle errors in graphql response:
     - return None when there's no errors in the answer
-    - TableauApiTimeout if any of the errors is a timeout
-    - TableauApiError (generic) otherwise
+    - raise TableauApiTimeout if any of the errors is a timeout
+    - else raise TableauApiError if any of the errors is critical
+    - return None otherwise
+    More info about Tableau errors:
+    https://help.tableau.com/current/api/metadata_api/en-us/docs/meta_api_errors.html#other-errors
     """
     if "errors" not in answer:
         return
 
     errors = answer["errors"]
 
-    for error in errors:
-        if error.get("message") == _TIMEOUT_MESSAGE:
-            # we need specific handling for timeout issues (retry strategy)
-            raise TableauApiTimeout(errors)
+    has_timeout_errors = False
+    has_critical_errors = False
 
-    raise TableauApiError(answer["errors"])
+    for error in errors:
+        if _is_timeout(error):
+            has_timeout_errors = True
+            continue
+
+        if _is_warning(error):
+            # in this case, the answer contains the data anyway
+            # just display the warning
+            logger.warning(error)
+            continue
+
+        # at this point, it's not a timeout error
+        # besides, it's not a warning (severity is either "error" or Unknown)
+        has_critical_errors = True
+
+    if has_timeout_errors:
+        raise TableauApiTimeout(errors)
+    if has_critical_errors:
+        raise TableauApiError(errors)
+
+    return None
 
 
 def gql_query_scroll(

castor_extractor/visualization/tableau/client/client_metadata_api_test.py

@@ -1,4 +1,7 @@
-from .client_metadata_api import _deduplicate
+import pytest
+
+from .client_metadata_api import _TIMEOUT_MESSAGE, _check_errors, _deduplicate
+from .errors import TableauApiError, TableauApiTimeout
 
 
 def test__deduplicate():
@@ -29,3 +32,80 @@ def test__deduplicate():
     assert len(deduplicated) == 5
     deduplicated_keys = {item["id"] for item in deduplicated}
     assert deduplicated_keys == {1, 2, 3, 4, 5}
+
+
+def _timeout_error():
+    return {"message": _TIMEOUT_MESSAGE}
+
+
+def _critical_error():
+    return {
+        "message": "critical error",
+        "extensions": {"severity": "Error"},
+    }
+
+
+def _unknown_severity_error():
+    return {
+        "message": "unknown severity error",
+        "extensions": {"severity": None},
+    }
+
+
+def _warning():
+    return {
+        "message": "critical error",
+        "extensions": {"severity": "Warning"},
+    }
+
+
+def test__check_errors():
+    answer = {"data": []}  # no errors
+    assert _check_errors(answer) is None
+
+    # only warnings
+    answer = {
+        "data": [],
+        "errors": [
+            _warning(),
+            _warning(),
+            _warning(),
+        ],
+    }
+    assert _check_errors(answer) is None
+
+    # timeout issues should be prio (because they can be retried)
+    answer = {
+        "data": [],
+        "errors": [
+            _warning(),
+            _critical_error(),
+            _timeout_error(),
+            _warning(),
+        ],
+    }
+    with pytest.raises(TableauApiTimeout):
+        _check_errors(answer)
+
+    # expect critical error
+    answer = {
+        "data": [],
+        "errors": [
+            _warning(),
+            _warning(),
+            _critical_error(),
+        ],
+    }
+    with pytest.raises(TableauApiError):
+        _check_errors(answer)
+
+    # unknown severity is considered as critical
+    answer = {
+        "data": [],
+        "errors": [
+            _unknown_severity_error(),
+            _warning(),
+        ],
+    }
+    with pytest.raises(TableauApiError):
+        _check_errors(answer)

castor_extractor/warehouse/redshift/queries/view_ddl.sql

@@ -1,13 +1,27 @@
--- This query was inspired from this thread:
--- https://github.com/awslabs/amazon-redshift-utils/blob/master/src/AdminViews/v_generate_view_ddl.sql
+/*
+This query was inspired from this thread:
+https://github.com/awslabs/amazon-redshift-utils/blob/master/src/AdminViews/v_generate_view_ddl.sql
+
+Notable differences:
+* There is no "--DROP" statement/comment here
+* Left-trimming the view definition is necessary to capture "CREATE" statements starting with whitespaces or line breaks.
+ */
+
 SELECT
     CURRENT_DATABASE() AS database_name,
     n.nspname AS schema_name,
     c.relname AS view_name,
     CASE
-     	WHEN c.relnatts > 0 THEN 'CREATE OR REPLACE VIEW ' + QUOTE_IDENT(n.nspname) + '.' + QUOTE_IDENT(c.relname) + ' AS\n' + COALESCE(pg_get_viewdef(c.oid, TRUE), '')
-     	ELSE COALESCE(pg_get_viewdef(c.oid, TRUE), '')
-     END AS view_definition
+        WHEN c.relnatts > 0 THEN
+            CASE
+                STRPOS(LOWER(LTRIM(pg_get_viewdef(c.oid, TRUE), '\t\r\n ')), 'create')
+                WHEN 1 THEN '' -- CREATE statement already present
+                ELSE           -- No CREATE statement present, so no materialized view anyway
+                    'CREATE OR REPLACE VIEW ' || QUOTE_IDENT(n.nspname) || '.' || QUOTE_IDENT(c.relname) || ' AS\n'
+            END
+            || COALESCE(pg_get_viewdef(c.oid, TRUE), '')
+        ELSE COALESCE(pg_get_viewdef(c.oid, TRUE), '')
+    END AS view_definition
 FROM
     pg_catalog.pg_class AS c
 INNER JOIN

{castor_extractor-0.24.9.dist-info → castor_extractor-0.24.13.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: castor-extractor
-Version: 0.24.9
+Version: 0.24.13
 Summary: Extract your metadata assets.
 Home-page: https://www.castordoc.com/
 License: EULA
@@ -28,6 +28,7 @@ Provides-Extra: qlik
 Provides-Extra: redshift
 Provides-Extra: snowflake
 Provides-Extra: sqlserver
+Provides-Extra: strategy
 Provides-Extra: tableau
 Requires-Dist: cryptography (>=43.0.0,<44.0.0) ; extra == "snowflake"
 Requires-Dist: databricks-sql-connector (==3.6.0) ; extra == "databricks" or extra == "all"
@@ -35,11 +36,12 @@ Requires-Dist: google-api-core (>=2.1.1,<3.0.0)
 Requires-Dist: google-api-python-client (>=2.121.0,<3.0.0) ; extra == "lookerstudio" or extra == "all"
 Requires-Dist: google-auth (>=2,<3)
 Requires-Dist: google-cloud-core (>=2.1.0,<3.0.0)
-Requires-Dist: google-cloud-storage (>=3.1.0,<4.0.0)
+Requires-Dist: google-cloud-storage (>=2,<3)
 Requires-Dist: google-resumable-media (>=2.0.3,<3.0.0)
 Requires-Dist: googleapis-common-protos (>=1.53.0,<2.0.0)
 Requires-Dist: looker-sdk (>=25.0.0,<26.0.0) ; extra == "looker" or extra == "all"
 Requires-Dist: msal (>=1.20.0,<2.0.0) ; extra == "powerbi" or extra == "all"
+Requires-Dist: mstrio-py (>=11.5.3.101,<12.0.0.0) ; (python_version >= "3.10") and (extra == "strategy" or extra == "all")
 Requires-Dist: numpy (<2) ; extra == "bigquery" or extra == "databricks" or extra == "all"
 Requires-Dist: numpy (>=1.26) ; (python_version >= "3.12" and python_version < "3.13") and (extra == "bigquery" or extra == "databricks" or extra == "all")
 Requires-Dist: pandas (>=2.1) ; (python_version >= "3.12" and python_version < "3.13") and (extra == "databricks" or extra == "all")
@@ -103,6 +105,8 @@ It also embeds utilities to help you push your metadata to Castor:
 Requirements: **python3.9+**
 <img src="https://upload.wikimedia.org/wikipedia/commons/c/c3/Python-logo-notext.svg" width=20 />
 
+**Note:** The Strategy command requires **python3.10+**. All other modules work with python3.9+.
+
 ### Create castor-env
 
 We advise to create a dedicated [Python environment](https://docs.python.org/3/library/venv.html).
@@ -181,6 +185,7 @@ pip install castor-extractor[postgres]
 pip install castor-extractor[redshift]
 pip install castor-extractor[snowflake]
 pip install castor-extractor[sqlserver]
+pip install castor-extractor[strategy]
 pip install castor-extractor[tableau]
 ```
 
@@ -204,12 +209,28 @@ export CASTOR_OUTPUT_DIRECTORY="/tmp/castor"
 
 ## Contact
 
-For any questions or bug report, contact us at [support@castordoc.com](mailto:support@castordoc.com)
+For any questions or bug report, contact us at [support@coalesce.io](mailto:support@coalesce.io)
 
-[Castor](https://castordoc.com) helps you find, understand, use your data assets
+[Catalog from Coalesce](https://castordoc.com) helps you find, understand, use your data assets
 
 # Changelog
 
+## 0.24.13 - 2025-05-05
+
+* Rollback cloud-storage version as it's not compatible with Keboola
+
+## 0.24.12 - 2025-05-05
+
+* Redshift - fix query definition of materialized views
+
+## 0.24.11 - 2025-05-05
+
+* add support for Strategy (formerly MicroStrategy)
+
+## 0.24.10 - 2025-04-30
+
+* Tableau - skip warnings instead of raising an error
+
 ## 0.24.9 - 2025-04-16
 
 * Introduce API client for **Coalesce**

{castor_extractor-0.24.9.dist-info → castor_extractor-0.24.13.dist-info}/RECORD

@@ -1,8 +1,8 @@
-CHANGELOG.md,sha256=UKD2ldg9s00KOoVfWjnyB_m50R0fnpPLbpmkZHKoOQM,16821
+CHANGELOG.md,sha256=u3BUqDPLtQ7K1RytlxEmtcSy4kJG1qhPtmrimODTYZU,17156
 Dockerfile,sha256=xQ05-CFfGShT3oUqaiumaldwA288dj9Yb_pxofQpufg,301
 DockerfileUsage.md,sha256=2hkJQF-5JuuzfPZ7IOxgM6QgIQW7l-9oRMFVwyXC4gE,998
 LICENCE,sha256=sL-IGa4hweyya1HgzMskrRdybbIa2cktzxb5qmUgDg8,8254
-README.md,sha256=GlhxZBs3fkeyYUPjrB4_EGDY8_E0vvnftsaqtgv08vs,3718
+README.md,sha256=C6hTyZO60T7z7xwHbspHlii384Jn02k0Rycxu3bCX0o,3866
 castor_extractor/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 castor_extractor/commands/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 castor_extractor/commands/extract_bigquery.py,sha256=dU4OiYO1V0n32orvZnMh1_xtFKF_VxHNXcVsH3otY-g,1269
@@ -25,6 +25,7 @@ castor_extractor/commands/extract_salesforce_reporting.py,sha256=FdANTNiLkIPdm80
 castor_extractor/commands/extract_sigma.py,sha256=sxewHcZ1Doq35V2qnpX_zCKKXkrb1_9bYjUMg7BOW-k,643
 castor_extractor/commands/extract_snowflake.py,sha256=GwlrRxwEBjHqGs_3bs5vM9fzmv61_iwvBr1KcIgFgWM,2161
 castor_extractor/commands/extract_sqlserver.py,sha256=lwhbcNChaXHZgMgSOch3faVr7WJw-sDU6GHl3lzBt_0,1141
+castor_extractor/commands/extract_strategy.py,sha256=Q-pUymatPrBFGXobhyUPzFph0-t774-XOpjdCFF1dYo,821
 castor_extractor/commands/extract_tableau.py,sha256=xXlLKLN8Eu_a8Kt2F4E-C5D-gq8SUmvoxJcdR_thKKY,1365
 castor_extractor/commands/extract_thoughtspot.py,sha256=caAYJlH-vK7u5IUB6OKXxcaWfLgc7d_XqnFDWK6YNS4,639
 castor_extractor/commands/file_check.py,sha256=TJx76Ymd0QCECmq35zRJMkPE8DJtSInB28MuSXWk8Ao,2644
@@ -272,12 +273,18 @@ castor_extractor/visualization/sigma/client/credentials.py,sha256=XddAuQSmCKpxJ7
 castor_extractor/visualization/sigma/client/endpoints.py,sha256=DBFphbgoH78_MZUGM_bKBAq28Nl7LWSZ6VRsbxrxtDg,1162
 castor_extractor/visualization/sigma/client/pagination.py,sha256=kNEhNq08tTGbypyMjxs0w4uvDtQc_iaWpOZweaa_FsU,690
 castor_extractor/visualization/sigma/extract.py,sha256=XIT1qsj6g6dgBWP8HPfj_medZexu48EaY9tUwi14gzM,2298
+castor_extractor/visualization/strategy/__init__.py,sha256=HOMv4JxqF5ZmViWi-pDE-PSXJRLTdXal_jtpHG_rlR8,123
+castor_extractor/visualization/strategy/assets.py,sha256=tqB3GOtp-r7IOnYO8UxZgrldoSMImJnv5KeIwDFxg68,302
+castor_extractor/visualization/strategy/client/__init__.py,sha256=XWP0yF5j6JefDJkDfX-RSJn3HF2ceQ0Yx1PLCfB3BBo,80
+castor_extractor/visualization/strategy/client/client.py,sha256=F7taX0jSQpM8R3GOGeUQ7U_bJKkoHTwAc9oyc3ZDxbM,10261
+castor_extractor/visualization/strategy/client/credentials.py,sha256=urFfNxWX1JG6wwFMYImufQzHa5g-sgjdlVGzi63owwg,1113
+castor_extractor/visualization/strategy/extract.py,sha256=2fBuvS2xiOGXRpxXnZsE_C3en6t1-BlM5TbusjHyEkg,1166
 castor_extractor/visualization/tableau/__init__.py,sha256=eFI_1hjdkxyUiAYiy3szwyuwn3yJ5C_KbpBU0ySJDcQ,138
 castor_extractor/visualization/tableau/assets.py,sha256=HbCRd8VCj1WBEeqg9jwnygnT7xOFJ6PQD7Lq7sV-XR0,635
 castor_extractor/visualization/tableau/client/__init__.py,sha256=P8RKFKOC63WkH5hdEytJOwHS9vzQ8GXreLfXZetmMP8,78
 castor_extractor/visualization/tableau/client/client.py,sha256=zzqhzIqKyJygo4ZNGk6cZh0e6Z9R1W5T0P9un52KC1M,7626
-castor_extractor/visualization/tableau/client/client_metadata_api.py,sha256=fARj7xroHfMd4nlo5CJK5jPok5UsHznOQpIpNaECVHw,5274
-castor_extractor/visualization/tableau/client/client_metadata_api_test.py,sha256=lbsq5mLtqeNc5EsmCw9Mvl8qcvMsTcJTepHwy1ToyvA,969
+castor_extractor/visualization/tableau/client/client_metadata_api.py,sha256=ryRq4_qUok8vvWGhj5CNWXtwR2JlUsu1qjsov2KhQTE,6286
+castor_extractor/visualization/tableau/client/client_metadata_api_test.py,sha256=rikyQKDLFYHLJhHJTF3LwWhKJ80svtTsYp5n7n9oTU8,2665
 castor_extractor/visualization/tableau/client/client_rest_api.py,sha256=x4dNw4PPJdalTlGowwkANwqiS2ZhGxzpQytkHq3KbpY,3988
 castor_extractor/visualization/tableau/client/client_tsc.py,sha256=VI_PJyd1ty3HSYXHHQjshmG2ziowIbrwJRonRPCHbks,1820
 castor_extractor/visualization/tableau/client/credentials.py,sha256=uQICIgeXmLZfOroTgZt7PuKNKTyqQllRGSTcOmIfrKU,1893
@@ -375,7 +382,7 @@ castor_extractor/warehouse/redshift/queries/schema.sql,sha256=Mf6nooi2w2PhGxM2_k
 castor_extractor/warehouse/redshift/queries/table.sql,sha256=y8CGOwPHH_Mr8g1Zvuz2U5ldL8zuPm5v3M5RPZqIhsE,2645
 castor_extractor/warehouse/redshift/queries/table_freshness.sql,sha256=l61_ysmTEtuMwK9RmYmD5cu0HmD1RXwTEhX0ytBeyxg,726
 castor_extractor/warehouse/redshift/queries/user.sql,sha256=sEXveJAuNvZacvpI6WfwsX6VavoMb2VqYA32f6Dt-_Y,170
-castor_extractor/warehouse/redshift/queries/view_ddl.sql,sha256=Pkyh_QT6d4rhTeyiVcqw6O8CRl7NEhk2p7eM5YIn5kg,719
+castor_extractor/warehouse/redshift/queries/view_ddl.sql,sha256=VxrZ6VFHQy46AoIuLTwb2DZ8CWbUM9JLzyfp5jc3m6E,1232
 castor_extractor/warehouse/redshift/query.py,sha256=hQaBHj0OvoEQ_HehU-vPyd5JH7YgndbzVi9-pyA5k_U,1054
 castor_extractor/warehouse/salesforce/__init__.py,sha256=NR4aNea5jeE1xYqeZ_29deeN84CkN0_D_Z7CLQdJvFY,137
 castor_extractor/warehouse/salesforce/client.py,sha256=067ZyccmIYoY6VwLTSneefOJqUpobtnoEzxJMY2oSPs,3268
@@ -416,8 +423,8 @@ castor_extractor/warehouse/sqlserver/queries/table.sql,sha256=kbBQP-TdG5px1IVgyx
 castor_extractor/warehouse/sqlserver/queries/user.sql,sha256=gOrZsMVypusR2dc4vwVs4E1a-CliRsr_UjnD2EbXs-A,94
 castor_extractor/warehouse/sqlserver/query.py,sha256=g0hPT-RmeGi2DyenAi3o72cTlQsLToXIFYojqc8E5fQ,533
 castor_extractor/warehouse/synapse/queries/column.sql,sha256=lNcFoIW3Y0PFOqoOzJEXmPvZvfAsY0AP63Mu2LuPzPo,1351
-castor_extractor-0.24.9.dist-info/LICENCE,sha256=sL-IGa4hweyya1HgzMskrRdybbIa2cktzxb5qmUgDg8,8254
-castor_extractor-0.24.9.dist-info/METADATA,sha256=JDqbNB2dwsOO7_5PKUWP0r4FL217fi7OIEbVaOPljDQ,23985
-castor_extractor-0.24.9.dist-info/WHEEL,sha256=Nq82e9rUAnEjt98J6MlVmMCZb-t9cYE2Ir1kpBmnWfs,88
-castor_extractor-0.24.9.dist-info/entry_points.txt,sha256=FQNShG4w4nRO95_bZnagh7FQ2oiZ-40bdt8ZdTW1-uI,1731
-castor_extractor-0.24.9.dist-info/RECORD,,
+castor_extractor-0.24.13.dist-info/LICENCE,sha256=sL-IGa4hweyya1HgzMskrRdybbIa2cktzxb5qmUgDg8,8254
+castor_extractor-0.24.13.dist-info/METADATA,sha256=TBjkOLzvfC6wrL6Myv0N7IkcNXzkQDTqdd8QdbNpbxU,24609
+castor_extractor-0.24.13.dist-info/WHEEL,sha256=Nq82e9rUAnEjt98J6MlVmMCZb-t9cYE2Ir1kpBmnWfs,88
+castor_extractor-0.24.13.dist-info/entry_points.txt,sha256=_F-qeZCybjoMkNb9ErEhnyqXuG6afHIFQhakdBHZsr4,1803
+castor_extractor-0.24.13.dist-info/RECORD,,

{castor_extractor-0.24.9.dist-info → castor_extractor-0.24.13.dist-info}/entry_points.txt

@@ -19,6 +19,7 @@ castor-extract-salesforce-viz=castor_extractor.commands.extract_salesforce_repor
 castor-extract-sigma=castor_extractor.commands.extract_sigma:main
 castor-extract-snowflake=castor_extractor.commands.extract_snowflake:main
 castor-extract-sqlserver=castor_extractor.commands.extract_sqlserver:main
+castor-extract-strategy=castor_extractor.commands.extract_strategy:main
 castor-extract-tableau=castor_extractor.commands.extract_tableau:main
 castor-extract-thoughtspot=castor_extractor.commands.extract_thoughtspot:main
 castor-file-check=castor_extractor.commands.file_check:main