iatoolkit 2.57.0__tar.gz → 2.58.0__tar.gz

{iatoolkit-2.57.0/src/iatoolkit.egg-info → iatoolkit-2.58.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: iatoolkit
-Version: 2.57.0
+Version: 2.58.0
 Summary: IAToolkit
 Author: Fernando Libedinsky
 License-Expression: MIT

{iatoolkit-2.57.0 → iatoolkit-2.58.0}/src/iatoolkit/__init__.py

@@ -3,7 +3,7 @@
 #
 # IAToolkit is open source software.
 
-__version__ = "2.57.0"
+__version__ = "2.58.0"
 
 # Expose main classes and functions at the top level of the package
 

iatoolkit-2.58.0/src/iatoolkit/base_company.py

@@ -0,0 +1,48 @@
+# Copyright (c) 2024 Fernando Libedinsky
+# Product: IAToolkit
+#
+# IAToolkit is open source software.
+
+# companies/base_company.py
+from abc import ABC, abstractmethod
+from pathlib import Path
+from typing import Optional
+
+from flask import Blueprint
+
+class BaseCompany(ABC):
+
+    @abstractmethod
+    # execute the specific action configured in the intent table
+    def handle_request(self, tag: str, params: dict) -> dict:
+        raise NotImplementedError("La subclase debe implementar el método handle_request()")
+
+    def register_cli_commands(self, app):
+        # Optional extension point. Community/Enterprise can override as needed.
+        return None
+
+    def get_blueprint(self) -> Optional[Blueprint]:
+        """
+        Optional extension point: the web routes, templates and static files this
+        company owns. The core registers the blueprint at boot for every company
+        that is loaded, so the host application never imports a company's views.
+
+        The blueprint must be named after the company short name: that name is
+        the namespace of its endpoints (``url_for('<company>.<endpoint>')``).
+        URLs are not prefixed by the core; the company chooses them.
+        """
+        return None
+
+    @classmethod
+    def get_resource_root(cls) -> Optional[Path]:
+        """
+        Directory that holds this company's files (config, prompts, schemas,
+        context, templates). ``None`` keeps the classic layout,
+        ``companies/<company_short_name>`` under the working directory. A company
+        installed as a package returns its own directory, usually
+        ``Path(__file__).resolve().parent``.
+        """
+        return None
+
+    def unsupported_operation(self, tag):
+        raise NotImplementedError(f"La operación '{tag}' no está soportada por esta empresa.")

iatoolkit-2.58.0/src/iatoolkit/common/company_paths.py

@@ -0,0 +1,25 @@
+# Copyright (c) 2024 Fernando Libedinsky
+# Product: IAToolkit
+#
+# IAToolkit is open source software.
+
+from pathlib import Path
+
+
+def get_company_root(company_short_name: str) -> Path:
+    """
+    Directory that holds a company's files: config, prompts, schemas, context,
+    templates.
+
+    A company module installed as a package declares it through
+    ``BaseCompany.get_resource_root()``. Every other company keeps the classic
+    layout, ``companies/<company_short_name>`` relative to the working directory,
+    which is why that is the fallback and not an error.
+    """
+    from iatoolkit.company_registry import get_registered_companies
+
+    company_class = get_registered_companies().get((company_short_name or "").lower())
+    root = company_class.get_resource_root() if company_class else None
+    if root:
+        return Path(root)
+    return Path("companies") / company_short_name

{iatoolkit-2.57.0 → iatoolkit-2.58.0}/src/iatoolkit/common/util.py

@@ -98,7 +98,8 @@ class Utility:
 
     def get_company_template(self, company_short_name: str, template_name: str) -> str:
         # 1. get the path to the company specific template
-        template_path = os.path.join(os.getcwd(), f'companies/{company_short_name}/templates/{template_name}')
+        from iatoolkit.common.company_paths import get_company_root
+        template_path = os.path.join(os.getcwd(), str(get_company_root(company_short_name) / 'templates' / template_name))
         if not os.path.exists(template_path):
             return None
 

{iatoolkit-2.57.0 → iatoolkit-2.58.0}/src/iatoolkit/core.py

@@ -114,6 +114,9 @@ class IAToolkit:
         # Step 7: load company configuration file
         self._hydrate_company_configuration()
 
+        # Step 7b: web routes, templates and static files owned by each company
+        self._register_company_blueprints()
+
         # Step 8: Finalize setup within the application context
         self._setup_redis_sessions()
 
@@ -560,6 +563,31 @@ class IAToolkit:
                 logging.error(f"❌ Failed to register configuration for '{company_short_name}': {e}")
                 raise e
 
+    def _register_company_blueprints(self):
+        from iatoolkit.company_registry import get_company_registry
+
+        registered = []
+        for company_short_name, company_instance in get_company_registry().get_all_company_instances().items():
+            blueprint = company_instance.get_blueprint()
+            if blueprint is None:
+                continue
+            # The blueprint name is the namespace of the company's endpoints, so
+            # it must be the company itself: anything else could collide with
+            # another tenant or with the platform.
+            if blueprint.name != company_short_name:
+                raise RuntimeError(
+                    f"Company '{company_short_name}' returned a blueprint named "
+                    f"'{blueprint.name}'; it must be named '{company_short_name}'."
+                )
+            self.app.register_blueprint(blueprint)
+            registered.append(company_short_name)
+
+        if registered:
+            # FlaskInjector wraps the views that exist when it runs, and the first
+            # pass ran before any company was loaded.
+            FlaskInjector(app=self.app, injector=self._injector)
+            logging.info(f"✅ Company blueprints registered: {', '.join(registered)}")
+
     def _setup_cli_commands(self):
         from iatoolkit.cli_commands import register_core_commands
         from iatoolkit.company_registry import get_company_registry

{iatoolkit-2.57.0 → iatoolkit-2.58.0}/src/iatoolkit/repositories/filesystem_asset_repository.py

@@ -1,10 +1,11 @@
 from iatoolkit.common.interfaces.asset_storage import AssetRepository, AssetType
+from iatoolkit.common.company_paths import get_company_root
 from pathlib import Path
 
 
 class FileSystemAssetRepository(AssetRepository):
     def _get_path(self, company_short_name: str, asset_type: AssetType, filename: str = "") -> Path:
-        return Path("companies") / company_short_name / asset_type.value / filename
+        return get_company_root(company_short_name) / asset_type.value / filename
 
     def exists(self, company_short_name: str, asset_type: AssetType, filename: str) -> bool:
         return self._get_path(company_short_name, asset_type, filename).is_file()

{iatoolkit-2.57.0 → iatoolkit-2.58.0/src/iatoolkit.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: iatoolkit
-Version: 2.57.0
+Version: 2.58.0
 Summary: IAToolkit
 Author: Fernando Libedinsky
 License-Expression: MIT

{iatoolkit-2.57.0 → iatoolkit-2.58.0}/src/iatoolkit.egg-info/SOURCES.txt

@@ -15,6 +15,7 @@ src/iatoolkit.egg-info/requires.txt
 src/iatoolkit.egg-info/top_level.txt
 src/iatoolkit/common/__init__.py
 src/iatoolkit/common/bridge_validation.py
+src/iatoolkit/common/company_paths.py
 src/iatoolkit/common/exceptions.py
 src/iatoolkit/common/model_registry.py
 src/iatoolkit/common/routes.py

iatoolkit-2.57.0/src/iatoolkit/base_company.py

@@ -1,21 +0,0 @@
-# Copyright (c) 2024 Fernando Libedinsky
-# Product: IAToolkit
-#
-# IAToolkit is open source software.
-
-# companies/base_company.py
-from abc import ABC, abstractmethod
-
-class BaseCompany(ABC):
-
-    @abstractmethod
-    # execute the specific action configured in the intent table
-    def handle_request(self, tag: str, params: dict) -> dict:
-        raise NotImplementedError("La subclase debe implementar el método handle_request()")
-
-    def register_cli_commands(self, app):
-        # Optional extension point. Community/Enterprise can override as needed.
-        return None
-
-    def unsupported_operation(self, tag):
-        raise NotImplementedError(f"La operación '{tag}' no está soportada por esta empresa.")