splent-framework 1.4.3__tar.gz → 1.4.4__tar.gz

{splent_framework-1.4.3/src/splent_framework.egg-info → splent_framework-1.4.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: splent_framework
-Version: 1.4.3
+Version: 1.4.4
 Summary: SPLENT-FRAMEWORK is a set of libraries for agile product development within SPLENT.
 Author-email: DiversoLab <diversolab@us.es>
 Project-URL: Homepage, https://github.com/diverso-lab/splent_framework

{splent_framework-1.4.3 → splent_framework-1.4.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "splent_framework"
-version = "1.4.3"
+version = "1.4.4"
 description = "SPLENT-FRAMEWORK is a set of libraries for agile product development within SPLENT."
 readme = "README.md"
 requires-python = ">=3.13"

{splent_framework-1.4.3 → splent_framework-1.4.4}/src/splent_framework/blueprints/base_blueprint.py

@@ -5,6 +5,35 @@ import sys
 import importlib
 
 
+def create_blueprint(import_name: str, **kwargs) -> "BaseBlueprint":
+    """Create a BaseBlueprint with the name inferred from the module.
+
+    Extracts the short name from the module path::
+
+        "splent_io.splent_feature_notes_tags" → "notes_tags"
+        "splent_io.splent_feature_auth"       → "auth"
+
+    Parameters
+    ----------
+    import_name : str
+        Pass ``__name__`` from the feature's ``__init__.py``.
+    **kwargs
+        Extra arguments forwarded to :class:`BaseBlueprint`
+        (e.g. ``url_prefix``, ``static_folder``).
+
+    Returns
+    -------
+    BaseBlueprint
+    """
+    # "splent_io.splent_feature_notes_tags" → "splent_feature_notes_tags"
+    pkg = import_name.rsplit(".", 1)[-1]
+    # "splent_feature_notes_tags" → "notes_tags"
+    short = (
+        pkg.replace("splent_feature_", "") if pkg.startswith("splent_feature_") else pkg
+    )
+    return BaseBlueprint(short, import_name, **kwargs)
+
+
 class BaseBlueprint(Blueprint):
     def __init__(
         self,

splent_framework-1.4.4/src/splent_framework/refinement/__init__.py

@@ -0,0 +1,73 @@
+"""
+SPLENT Refinement API.
+
+High-level helpers for refinement features. Use these in your
+``init_feature(app)`` instead of calling the lower-level internals directly.
+
+Usage::
+
+    from splent_framework.refinement import refine_model, refine_service
+
+    from .models import NotesTagsMixin
+    from .services import NotesServiceWithTags
+
+    def init_feature(app):
+        refine_model("Notes", NotesTagsMixin)
+        refine_service(app, "NotesService", NotesServiceWithTags)
+"""
+
+from splent_framework.refinement.model_extender import apply_model_mixin
+from splent_framework.services.service_locator import (
+    get_service_class,
+    register_service,
+)
+
+
+def refine_model(model_name: str, mixin_cls: type) -> bool:
+    """Extend an existing model with a mixin.
+
+    Injects columns and methods from ``mixin_cls`` into the model
+    registered under ``model_name`` in SQLAlchemy's mapper registry.
+
+    Parameters
+    ----------
+    model_name : str
+        Name of the base model class (e.g. ``"Notes"``).
+    mixin_cls : type
+        Mixin class containing ``db.Column`` attributes and/or methods.
+
+    Returns
+    -------
+    bool
+        True if the mixin was applied successfully.
+    """
+    return apply_model_mixin(model_name, mixin_cls)
+
+
+def refine_service(app, service_name: str, replacement_cls: type) -> None:
+    """Override a registered service with a replacement class.
+
+    Automatically resolves the base service, sets ``replacement_cls``
+    to inherit from it, and registers the replacement under the same name.
+
+    Parameters
+    ----------
+    app : Flask
+        The Flask application instance.
+    service_name : str
+        Name of the service to override (e.g. ``"NotesService"``).
+    replacement_cls : type
+        Replacement class. Will inherit from the base service at runtime.
+    """
+    base_cls = get_service_class(app, service_name)
+
+    # Build a class that inherits from the replacement first (so its
+    # methods win) and then from the base (so super() chains correctly).
+    # This preserves Python 3 implicit super() because the original
+    # replacement_cls stays in the MRO.
+    merged = type(
+        replacement_cls.__name__,
+        (replacement_cls, base_cls),
+        {},
+    )
+    register_service(app, service_name, merged)

{splent_framework-1.4.3 → splent_framework-1.4.4}/src/splent_framework/services/service_locator.py

@@ -59,3 +59,31 @@ def get_service_class(app: Flask, name: str) -> type:
 def get_all_services(app: Flask) -> dict[str, type]:
     """Return the full service registry (read-only snapshot)."""
     return dict(_ensure_registry(app))
+
+
+def service_proxy(name: str):
+    """Return a proxy that resolves the service from the locator on every access.
+
+    Usage in routes::
+
+        from splent_framework.services.service_locator import service_proxy
+
+        notes_service = service_proxy("NotesService")
+
+        @bp.route("/notes/")
+        def index():
+            notes = notes_service.get_by_user(current_user.id)
+            ...
+
+    The proxy instantiates a fresh service on each attribute access,
+    so it always reflects the current registered class (including
+    refinement overrides). It only works inside a Flask request context.
+    """
+    from werkzeug.local import LocalProxy
+    from flask import current_app
+
+    def _lookup():
+        cls = get_service_class(current_app._get_current_object(), name)
+        return cls()
+
+    return LocalProxy(_lookup)

{splent_framework-1.4.3 → splent_framework-1.4.4/src/splent_framework.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: splent_framework
-Version: 1.4.3
+Version: 1.4.4
 Summary: SPLENT-FRAMEWORK is a set of libraries for agile product development within SPLENT.
 Author-email: DiversoLab <diversolab@us.es>
 Project-URL: Homepage, https://github.com/diverso-lab/splent_framework