port-ocean 0.5.5__tar.gz → 0.5.7__tar.gz

{port_ocean-0.5.5 → port_ocean-0.5.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: port-ocean
-Version: 0.5.5
+Version: 0.5.7
 Summary: Port Ocean is a CLI tool for managing your Port projects.
 Home-page: https://app.getport.io
 Keywords: ocean,port-ocean,port
@@ -42,8 +42,7 @@ Requires-Dist: werkzeug (>=2.3.4,<4.0.0)
 Project-URL: Repository, https://github.com/port-labs/Port-Ocean
 Description-Content-Type: text/markdown
 
-<img src="./assets/Thumbnail.jpg" alt="Ocean">
-
+<img src="./assets/Thumbnail.png" alt="Ocean">
 
 # Ocean <img src="./assets/OceanSymbol.svg" alt="Ocean" width="100" height="100" align="right">
 
@@ -56,9 +55,8 @@ empowering engineers to effortlessly prioritize key features and streamline the
 
 - Python 3.11
 
-
-
 ## Installation
+
 In order to install the Ocean Framework, run the following command:
 
 ```bash
@@ -73,7 +71,7 @@ poetry add port-ocean[cli]
 
 ## Run Integration
 
-1. source the integration venv 
+1. source the integration venv
 
    ```bash
    . .venv/bin/activate
@@ -91,14 +89,15 @@ poetry add port-ocean[cli]
 ![image](./assets/ExportArchitecture.svg)
 
 ## Real-Time updates Architecture
+
 ![image](./assets/RealTimeUpdatesArchitecture.svg)
 
 ## Integration Lifecycle
 
 ![image](./assets/LifecycleOfIntegration.svg)
 
-
 ## Folder Structure
+
 The Ocean Integration Framework follows a specific folder structure within this mono repository. This structure ensures proper organization and easy identification of integration modules. The suggested folder structure is as follows:
 
 ```
@@ -122,9 +121,11 @@ port-ocean/
 - The `pyproject.toml` file inside each integration folder lists the required dependencies for that integration.
 
 ## Configuration
+
 The Integration Framework utilizes a `config.yaml` file for its configuration. This file defines both the framework configuration and the integration configuration within it. Each integration is identified by its type and unique identifier, which are utilized during initialization to appropriately update Port.
 
 Example `config.yaml`:
+
 ```yaml
 # This is an example configuration file for the integration service.
 # Please copy this file to config.yaml file in the integration folder and edit it to your needs.
@@ -153,6 +154,7 @@ The reason Ocean is open source is that we aim for the Port integration library
 In order to learn how you can contribute to Ocean, read our [contributing guide](./CONTRIBUTING.md)
 
 ### Local Development (Framework)
+
 1. Clone the repository
 
 2. Install dependencies:
@@ -174,6 +176,7 @@ In order to learn how you can contribute to Ocean, read our [contributing guide]
    ```
 
 ### Local Development (Integration)
+
 1. Clone the repository
 
 2. For new integration run
@@ -209,7 +212,10 @@ In order to learn how you can contribute to Ocean, read our [contributing guide]
    ```
 
 ## License
+
 The Ocean Framework is open-source software licensed under the [Apache 2.0 License](https://www.apache.org/licenses/LICENSE-2.0). See the [LICENSE](./LICENSE) file for more information.
 
 ## Contact
+
 For any questions or inquiries, please reach out to our team at support@getport.io
+

{port_ocean-0.5.5 → port_ocean-0.5.7}/README.md

@@ -1,5 +1,4 @@
-<img src="./assets/Thumbnail.jpg" alt="Ocean">
-
+<img src="./assets/Thumbnail.png" alt="Ocean">
 
 # Ocean <img src="./assets/OceanSymbol.svg" alt="Ocean" width="100" height="100" align="right">
 
@@ -12,9 +11,8 @@ empowering engineers to effortlessly prioritize key features and streamline the
 
 - Python 3.11
 
-
-
 ## Installation
+
 In order to install the Ocean Framework, run the following command:
 
 ```bash
@@ -29,7 +27,7 @@ poetry add port-ocean[cli]
 
 ## Run Integration
 
-1. source the integration venv 
+1. source the integration venv
 
    ```bash
    . .venv/bin/activate
@@ -47,14 +45,15 @@ poetry add port-ocean[cli]
 ![image](./assets/ExportArchitecture.svg)
 
 ## Real-Time updates Architecture
+
 ![image](./assets/RealTimeUpdatesArchitecture.svg)
 
 ## Integration Lifecycle
 
 ![image](./assets/LifecycleOfIntegration.svg)
 
-
 ## Folder Structure
+
 The Ocean Integration Framework follows a specific folder structure within this mono repository. This structure ensures proper organization and easy identification of integration modules. The suggested folder structure is as follows:
 
 ```
@@ -78,9 +77,11 @@ port-ocean/
 - The `pyproject.toml` file inside each integration folder lists the required dependencies for that integration.
 
 ## Configuration
+
 The Integration Framework utilizes a `config.yaml` file for its configuration. This file defines both the framework configuration and the integration configuration within it. Each integration is identified by its type and unique identifier, which are utilized during initialization to appropriately update Port.
 
 Example `config.yaml`:
+
 ```yaml
 # This is an example configuration file for the integration service.
 # Please copy this file to config.yaml file in the integration folder and edit it to your needs.
@@ -109,6 +110,7 @@ The reason Ocean is open source is that we aim for the Port integration library
 In order to learn how you can contribute to Ocean, read our [contributing guide](./CONTRIBUTING.md)
 
 ### Local Development (Framework)
+
 1. Clone the repository
 
 2. Install dependencies:
@@ -130,6 +132,7 @@ In order to learn how you can contribute to Ocean, read our [contributing guide]
    ```
 
 ### Local Development (Integration)
+
 1. Clone the repository
 
 2. For new integration run
@@ -165,7 +168,9 @@ In order to learn how you can contribute to Ocean, read our [contributing guide]
    ```
 
 ## License
+
 The Ocean Framework is open-source software licensed under the [Apache 2.0 License](https://www.apache.org/licenses/LICENSE-2.0). See the [LICENSE](./LICENSE) file for more information.
 
 ## Contact
-For any questions or inquiries, please reach out to our team at support@getport.io
+
+For any questions or inquiries, please reach out to our team at support@getport.io

{port_ocean-0.5.5 → port_ocean-0.5.7}/port_ocean/config/dynamic.py

@@ -46,6 +46,8 @@ def default_config_factory(configurations: Any) -> Type[BaseModel]:
                 field_type = int
             case "boolean":
                 field_type = bool
+            case "array":
+                field_type = list
             case _:
                 raise ValueError(f"Unknown type: {config.type}")
 

{port_ocean-0.5.5 → port_ocean-0.5.7}/port_ocean/core/handlers/entity_processor/jq_entity_processor.py

@@ -2,6 +2,7 @@ import asyncio
 import functools
 from functools import lru_cache
 from typing import Any
+from loguru import logger
 
 import pyjq as jq  # type: ignore
 
@@ -67,25 +68,74 @@ class JQEntityProcessor(BaseEntityProcessor):
 
         return result
 
+    async def _get_entity_if_passed_selector(
+        self,
+        data: dict[str, Any],
+        raw_entity_mappings: dict[str, Any],
+        selector_query: str,
+    ) -> dict[str, Any]:
+        should_run = await self._search_as_bool(data, selector_query)
+        if should_run:
+            return await self._search_as_object(data, raw_entity_mappings)
+        return {}
+
+    async def _calculate_entity(
+        self,
+        data: dict[str, Any],
+        raw_entity_mappings: dict[str, Any],
+        items_to_parse: str | None,
+        selector_query: str,
+    ) -> list[dict[str, Any]]:
+        if items_to_parse:
+            items = await self._search(data, items_to_parse)
+            if isinstance(items, list):
+                return await asyncio.gather(
+                    *[
+                        self._get_entity_if_passed_selector(
+                            {"item": item, **data},
+                            raw_entity_mappings,
+                            selector_query,
+                        )
+                        for item in items
+                    ]
+                )
+            logger.warning(
+                f"Failed to parse items for JQ expression {items_to_parse}, Expected list but got {type(items)}."
+                f" Skipping..."
+            )
+        else:
+            return [
+                await self._get_entity_if_passed_selector(
+                    data, raw_entity_mappings, selector_query
+                )
+            ]
+        return [{}]
+
     async def _calculate_entities(
         self, mapping: ResourceConfig, raw_data: list[dict[str, Any]]
     ) -> list[Entity]:
-        async def calculate_raw(data: dict[str, Any]) -> dict[str, Any]:
-            should_run = await self._search_as_bool(data, mapping.selector.query)
-            if should_run and mapping.port.entity:
-                return await self._search_as_object(
-                    data, mapping.port.entity.mappings.dict(exclude_unset=True)
+        raw_entity_mappings: dict[str, Any] = mapping.port.entity.mappings.dict(
+            exclude_unset=True
+        )
+        entities_tasks = [
+            asyncio.create_task(
+                self._calculate_entity(
+                    data,
+                    raw_entity_mappings,
+                    mapping.port.items_to_parse,
+                    mapping.selector.query,
                 )
-            return {}
-
-        entities_tasks = [asyncio.create_task(calculate_raw(data)) for data in raw_data]
+            )
+            for data in raw_data
+        ]
         entities = await asyncio.gather(*entities_tasks)
 
         return [
             Entity.parse_obj(entity_data)
+            for flatten in entities
             for entity_data in filter(
                 lambda entity: entity.get("identifier") and entity.get("blueprint"),
-                entities,
+                flatten,
             )
         ]
 

{port_ocean-0.5.5 → port_ocean-0.5.7}/port_ocean/core/handlers/port_app_config/models.py

@@ -19,6 +19,7 @@ class PortResourceConfig(BaseModel):
         mappings: EntityMapping
 
     entity: MappingsConfig
+    items_to_parse: str | None = Field(alias="itemsToParse")
 
 
 class Selector(BaseModel):

{port_ocean-0.5.5 → port_ocean-0.5.7}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "port-ocean"
-version = "0.5.5"
+version = "0.5.7"
 description = "Port Ocean is a CLI tool for managing your Port projects."
 readme = "README.md"
 homepage = "https://app.getport.io"