component-local 0.0.1b3800__py3-none-any.whl

component_local/src/component_local.py

@@ -0,0 +1,54 @@
+import json
+from pathlib import Path
+from typing import Optional, Union
+
+from database_mysql_local.generic_crud import GenericCRUD
+from logger_local.MetaLogger import MetaLogger
+
+from .constants_src_component_local import ConstantsSrcComponent
+
+
+# TODO When reading components.json5, We should get the componentId from component_table using a function wrapped with a script in component-main-local-python-package (so we can also use it in TypeScript and Powershell)  # noqa E501
+class ComponentLocal(GenericCRUD, metaclass=MetaLogger,
+                     object=ConstantsSrcComponent.COMPONENT_LOCAL_PYTHON_CODE_LOGGER_OBJECT):  # noqa E501
+    def __init__(self, is_test_data: bool = False) -> None:
+        GenericCRUD.__init__(
+            self,
+            default_schema_name=ConstantsSrcComponent.COMPONENT_SCHEMA_NAME,
+            default_table_name=ConstantsSrcComponent.COMPONENT_TABLE_NAME,
+            default_view_table_name=ConstantsSrcComponent.COMPONENT_VIEW_NAME,
+            default_column_name=ConstantsSrcComponent.COMPONENT_COLUMN_NAME,
+            is_test_data=is_test_data)
+
+    def get_component_id(self, component_name: str,
+                         json_path: Union[str, Path, None] = None) -> Optional[int]:
+        """Returns the component_id of component_name.
+        1st priority: the componentId in the JSON file (if json_path was given and it has the component).
+        2nd priority: the component_id from component.component_table."""
+        if json_path is not None:
+            component_id = self.get_component_id_from_json(component_name=component_name, json_path=json_path)
+            if component_id is not None:
+                return component_id
+        return self.get_component_id_by_name(component_name=component_name)
+
+    def get_component_id_by_name(self, component_name: str) -> Optional[int]:
+        """Returns the component_id with this name in component.component_table, None if there is no such component.
+        If more than one component has this name, the one with the lowest component_id is returned."""
+        if not component_name:
+            raise ValueError("component_name is required")
+        component_id = self.select_one_value_by_column_and_value(
+            select_clause_value=ConstantsSrcComponent.COMPONENT_COLUMN_NAME,
+            column_name="name", column_value=component_name,
+            order_by=ConstantsSrcComponent.COMPONENT_COLUMN_NAME)
+        return component_id
+
+    @staticmethod
+    def get_component_id_from_json(component_name: str, json_path: Union[str, Path]) -> Optional[int]:
+        """Returns the componentId of component_name from a JSON file in the format of component.json.example,
+        None if the component or its componentId are not in the file."""
+        with open(json_path, encoding="utf-8") as json_file:
+            components = json.load(json_file)
+        component = components.get(component_name)
+        if not isinstance(component, dict):
+            return None
+        return component.get("componentId")

component_local/src/constants_src_component_local.py

@@ -0,0 +1,26 @@
+from typing import Any
+from logger_local.LoggerComponentEnum import LoggerComponentEnum
+
+
+class ConstantsSrcComponent:
+    """This is a class of all the constants of Component"""
+
+    COMPONENT_LOCAL_PYTHON_DEVELOPER_EMAIL_ADDRESS: str = 'shirlee.g@circ.zone'
+
+    # The CODE component_id of component-local in component.component_table
+    COMPONENT_LOCAL_PYTHON_CODE_COMPONENT_ID: int = 306
+
+    COMPONENT_LOCAL_PYTHON_COMPONENT_NAME = 'Component local Python package'
+    COMPONENT_LOCAL_PYTHON_CODE_LOGGER_OBJECT: dict[str, Any] = {
+        'component_id': COMPONENT_LOCAL_PYTHON_CODE_COMPONENT_ID,
+        'component_name': COMPONENT_LOCAL_PYTHON_COMPONENT_NAME,
+        'component_category': LoggerComponentEnum.ComponentCategory.Code.value,
+        'developer_email_address': COMPONENT_LOCAL_PYTHON_DEVELOPER_EMAIL_ADDRESS  # noqa E501
+    }
+
+    UNKNOWN_COMPONENT_ID = 0
+
+    COMPONENT_SCHEMA_NAME = 'component'
+    COMPONENT_TABLE_NAME = 'component_table'
+    COMPONENT_VIEW_NAME = 'component_view'
+    COMPONENT_COLUMN_NAME = 'component_id'

component_local/tests/component_local_test.py

@@ -0,0 +1,107 @@
+# So we can run debugger without launch.json in VSCode
+from dotenv import load_dotenv
+load_dotenv()  # Load environment variables before any imports that need them
+
+import json
+import sys
+from unittest.mock import MagicMock
+
+import pytest
+
+from logger_local.LoggerLocal import Logger
+
+from ..src.component_local import ComponentLocal
+from ..src.constants_src_component_local import ConstantsSrcComponent
+from .constants_tests_component_local import ComponentTestsConstants
+
+logger = Logger.create_logger(object=ComponentTestsConstants.COMPONENT_LOCAL_PYTHON_TEST_LOGGER_OBJECT)  # noqa E501
+
+# Local test values, not real component ids (the real ones are in component.component_table)
+EVENT_COMPONENT_ID = 247
+UNKNOWN_COMPONENT_NAME = "no-such-component"
+
+
+@pytest.fixture(name="component_local")
+def component_local_fixture() -> ComponentLocal:
+    # Skips __init__ so these tests don't need a database connection
+    component_local = ComponentLocal.__new__(ComponentLocal)
+    component_local.select_one_value_by_column_and_value = MagicMock(return_value=EVENT_COMPONENT_ID)
+    return component_local
+
+
+@pytest.fixture(name="json_path")
+def json_path_fixture(tmp_path):
+    path = tmp_path / "component.json"
+    path.write_text(json.dumps({
+        "event": {"componentId": EVENT_COMPONENT_ID, "environmentName": "local"},
+        "group": {"environmentName": "local", "port": 3001}}), encoding="utf-8")
+    return path
+
+
+def test_component_table_constants():
+    logger.start("test component table constants")
+    assert ConstantsSrcComponent.COMPONENT_SCHEMA_NAME == 'component'
+    assert ConstantsSrcComponent.COMPONENT_TABLE_NAME == 'component_table'
+    assert ConstantsSrcComponent.COMPONENT_COLUMN_NAME == 'component_id'
+    logger.end("test successful")
+
+
+def test_get_component_id_from_json(json_path):
+    logger.start("test get_component_id_from_json")
+    assert ComponentLocal.get_component_id_from_json("event", json_path) == EVENT_COMPONENT_ID
+    logger.end("test successful")
+
+
+def test_get_component_id_from_json_without_component_id(json_path):
+    logger.start("test get_component_id_from_json without componentId")
+    assert ComponentLocal.get_component_id_from_json("group", json_path) is None
+    logger.end("test successful")
+
+
+def test_get_component_id_from_json_unknown_component(json_path):
+    logger.start("test get_component_id_from_json unknown component")
+    assert ComponentLocal.get_component_id_from_json(UNKNOWN_COMPONENT_NAME, json_path) is None
+    logger.end("test successful")
+
+
+def test_get_component_id_by_name(component_local):
+    logger.start("test get_component_id_by_name")
+    assert component_local.get_component_id_by_name("event") == EVENT_COMPONENT_ID
+    component_local.select_one_value_by_column_and_value.assert_called_once_with(
+        select_clause_value='component_id', column_name='name', column_value="event", order_by='component_id')
+    logger.end("test successful")
+
+
+def test_get_component_id_by_name_empty_name(component_local):
+    logger.start("test get_component_id_by_name empty name")
+    with pytest.raises(ValueError):
+        component_local.get_component_id_by_name("")
+    logger.end("test successful")
+
+
+def test_get_component_id_prefers_json(component_local, json_path):
+    logger.start("test get_component_id prefers the JSON")
+    assert component_local.get_component_id("event", json_path=json_path) == EVENT_COMPONENT_ID
+    component_local.select_one_value_by_column_and_value.assert_not_called()
+    logger.end("test successful")
+
+
+def test_get_component_id_falls_back_to_database(component_local, json_path):
+    logger.start("test get_component_id falls back to the database")
+    assert component_local.get_component_id("group", json_path=json_path) == EVENT_COMPONENT_ID
+    component_local.select_one_value_by_column_and_value.assert_called_once()
+    logger.end("test successful")
+
+
+def test_get_component_id_unknown_component(component_local):
+    logger.start("test get_component_id unknown component")
+    component_local.select_one_value_by_column_and_value.return_value = None
+    assert component_local.get_component_id(UNKNOWN_COMPONENT_NAME) is None
+    logger.end("test successful")
+
+
+# If we use only a call to some_test(), this can cause unexpected behavior, for example
+# it can cause the test to be run multiple times simultaneously. This is why we use the following
+# Which cause the test to be run only once with pytest:
+if __name__ == "__main__":
+    pytest.main(sys.argv[1:])

component_local/tests/constants_tests_component_local.py

@@ -0,0 +1,17 @@
+from logger_local.LoggerComponentEnum import LoggerComponentEnum
+
+
+class ComponentTestsConstants:
+    # The TEST component_id of component-local in component.component_table
+    COMPONENT_TEST_COMPONENT_ID: int = 307
+    COMPONENT_TEST_COMPONENT_NAME = "Component Tests"
+    COMPONENT_DEVELOPER_EMAIL_ADDRESS = "shirlee.g@circ.zone"
+
+    COMPONENT_LOCAL_PYTHON_TEST_LOGGER_OBJECT = {
+        # At this point of time we do not support camelCase in logger-local
+        'component_id': COMPONENT_TEST_COMPONENT_ID,
+        'component_name': COMPONENT_TEST_COMPONENT_NAME,
+        'component_category': LoggerComponentEnum.ComponentCategory.Unit_Test.value,  # noqa E501
+        'testing_framework': LoggerComponentEnum.testingFramework.pytest.value,
+        'developer_email_address': COMPONENT_DEVELOPER_EMAIL_ADDRESS
+    }

component_local-0.0.1b3800.dist-info/METADATA

@@ -0,0 +1,26 @@
+Metadata-Version: 2.4
+Name: component-local
+Version: 0.0.1b3800
+Summary: PyPI component-local Python Package owned by Circlez.ai
+Home-page: https://github.com/circles-zone/component-main-local-python-restapi-serverless-com
+Author: Circles
+Author-email: info@circlez.ai
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Description-Content-Type: text/markdown
+Requires-Dist: python-sdk-remote
+Requires-Dist: logger-local
+Requires-Dist: database-mysql-local
+Requires-Dist: smart-datastore-local
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: requires-dist
+Dynamic: summary
+
+PyPI component-local Python Package owned by Circlez.ai
+JIRA Work Item: https://circles-zone.atlassian.net/browse/BU-3800
+GHA: https://github.com/circles-zone/component-main-local-python-restapi-serverless-com/actions

component_local-0.0.1b3800.dist-info/RECORD

@@ -0,0 +1,11 @@
+component_local/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+component_local/src/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+component_local/src/component_local.py,sha256=H5QKoZD0HcH8rGuMM5XckSqaLyoq19XIwUjAv6bHIZI,3031
+component_local/src/constants_src_component_local.py,sha256=Po_goI1J8Cr-RJHCGOY8ETbrjzrTYOiksTcGzkyRXmU,1051
+component_local/tests/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+component_local/tests/component_local_test.py,sha256=5NRKCWrpWgGarOk3_G0krAdoF8xPfq0pLc6iOX9Zawg,4493
+component_local/tests/constants_tests_component_local.py,sha256=HZ_mmNQ74iKzpq_EClmjz1uI063vm-vVVKXw61p8uGI,823
+component_local-0.0.1b3800.dist-info/METADATA,sha256=V-HLicXGTy_kL70gKqxj-eGuy7P6KPyB9sieF-qEJIA,929
+component_local-0.0.1b3800.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+component_local-0.0.1b3800.dist-info/top_level.txt,sha256=pCrhck9pWML37LaFnDbl_cl09wFYZSr2oB47x-skF8U,16
+component_local-0.0.1b3800.dist-info/RECORD,,

component_local-0.0.1b3800.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

component_local-0.0.1b3800.dist-info/top_level.txt

@@ -0,0 +1 @@
+component_local