Flask-Exts 0.2.5__tar.gz → 0.2.6__tar.gz

{flask_exts-0.2.5 → flask_exts-0.2.6}/.readthedocs.yaml

@@ -7,9 +7,9 @@ version: 2
 
 # Set the OS, Python version and other tools you might need
 build:
-  os: "ubuntu-22.04"
+  os: "ubuntu-24.04"
   tools:
-    python: "3.12"
+    python: "3.13"
     # You can also specify other tool versions:
     # nodejs: "19"
     # rust: "1.64"

{flask_exts-0.2.5 → flask_exts-0.2.6}/CHANGES.rst

@@ -1,3 +1,11 @@
+v0.2.6
+------
+
+Released 2025-11-16
+
+- rename manager.py to exts.py
+- rename Class Manager to Exts
+
 v0.2.5
 ------
 

{flask_exts-0.2.5 → flask_exts-0.2.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: Flask-Exts
-Version: 0.2.5
+Version: 0.2.6
 Summary: Flask extensions with admin, SQLAlchemy, babel, forms, fields, widgets, and so on.
 Project-URL: Documentation, https://flask-exts.readthedocs.io
 Project-URL: Source, https://github.com/ojso/flask-exts
@@ -62,6 +62,7 @@ Flask Exts
 
 Flask-Exts is mainly inspired by:
 
+- `Bootstrap <https://getbootstrap.com/>`_
 - `Flask-Admin <https://github.com/pallets-eco/flask-admin/>`_
 - `Flask-Security <https://github.com/pallets-eco/flask-security/>`_
 
@@ -88,13 +89,13 @@ Examples
 .. code-block:: python
 
     from flask import Flask
-    from flask_exts import Manager
+    from flask_exts import Exts
 
     app = Flask(__name__)
     app.config["SECRET_KEY"] = "dev"
-    # Manager init
-    manager = Manager()
-    manager.init_app(app)
+    # Exts init
+    exts = Exts()
+    exts.init_app(app)
 
     if __name__ == "__main__":
         app.run(debug=True)

{flask_exts-0.2.5 → flask_exts-0.2.6}/README.rst

@@ -3,6 +3,7 @@ Flask Exts
 
 Flask-Exts is mainly inspired by:
 
+- `Bootstrap <https://getbootstrap.com/>`_
 - `Flask-Admin <https://github.com/pallets-eco/flask-admin/>`_
 - `Flask-Security <https://github.com/pallets-eco/flask-security/>`_
 
@@ -29,13 +30,13 @@ Examples
 .. code-block:: python
 
     from flask import Flask
-    from flask_exts import Manager
+    from flask_exts import Exts
 
     app = Flask(__name__)
     app.config["SECRET_KEY"] = "dev"
-    # Manager init
-    manager = Manager()
-    manager.init_app(app)
+    # Exts init
+    exts = Exts()
+    exts.init_app(app)
 
     if __name__ == "__main__":
         app.run(debug=True)

{flask_exts-0.2.5 → flask_exts-0.2.6}/docs/conf.py

@@ -32,12 +32,12 @@ extensions = [
     "sphinx.ext.intersphinx",
 ]
 
-intersphinx_mapping = {
-    "rtd": ("https://docs.readthedocs.io/en/stable/", None),
-    "python": ("https://docs.python.org/3/", None),
-    "sphinx": ("https://www.sphinx-doc.org/en/master/", None),
-}
-intersphinx_disabled_domains = ["std"]
+# intersphinx_mapping = {
+#     "rtd": ("https://docs.readthedocs.io/en/stable/", None),
+#     "python": ("https://docs.python.org/3/", None),
+#     "sphinx": ("https://www.sphinx-doc.org/en/master/", None),
+# }
+# intersphinx_disabled_domains = ["std"]
 
 templates_path = ["_templates"]
 

{flask_exts-0.2.5 → flask_exts-0.2.6}/docs/index.rst

@@ -10,6 +10,7 @@ Welcome to Flask-Exts's documentation!
 
 Flask-Exts is mainly inspired by:
 
+- `Bootstrap <https://getbootstrap.com/>`_
 - `Flask-Admin <https://github.com/pallets-eco/flask-admin/>`_
 - `Flask-Security <https://github.com/pallets-eco/flask-security/>`_
 

{flask_exts-0.2.5 → flask_exts-0.2.6}/examples/bootstrap/make_app.py

@@ -1,5 +1,5 @@
 from flask import Flask
-from flask_exts import Manager
+from flask_exts import Exts
 from .models import db, Message, MyCategory
 from .view import BootstrapView
 
@@ -11,9 +11,9 @@ def create_app():
 
 
 def init_app(app: Flask):
-    manager = Manager()
-    manager.init_app(app)
-    manager.admin.add_view(BootstrapView())
+    exts = Exts()
+    exts.init_app(app)
+    exts.admin.add_view(BootstrapView())
 
     with app.app_context():
         db.drop_all()

{flask_exts-0.2.5 → flask_exts-0.2.6}/examples/demo/admin_views.py

@@ -10,7 +10,7 @@ from flask_exts.admin.menu import MenuLink
 
 
 def add_views(app):
-    admin = app.extensions["manager"].admin
+    admin = app.extensions["exts"].admin
 
     admin.add_view(myview)
     admin.add_view(userview)

{flask_exts-0.2.5 → flask_exts-0.2.6}/examples/demo/make_app.py

@@ -1,6 +1,6 @@
 import os.path as op
 from flask import Flask
-from flask_exts import Manager
+from flask_exts import Exts
 
 
 def get_sqlite_path():
@@ -25,8 +25,8 @@ def create_app():
 
 
 def init_app(app: Flask):
-    manager = Manager()
-    manager.init_app(app)
+    exts = Exts()
+    exts.init_app(app)
 
     from .models import init_models
 

{flask_exts-0.2.5 → flask_exts-0.2.6}/examples/fileadmin/make_app.py

@@ -1,5 +1,5 @@
 from flask import Flask
-from flask_exts import Manager
+from flask_exts import Exts
 from .file_view import file_view
 from flask_exts.datastore.sqla import db
 
@@ -18,6 +18,6 @@ def create_app():
 
 
 def init_app(app: Flask):
-    manager = Manager()
-    manager.init_app(app)
-    manager.admin.add_view(file_view)
+    exts = Exts()
+    exts.init_app(app)
+    exts.admin.add_view(file_view)

{flask_exts-0.2.5 → flask_exts-0.2.6}/examples/rediscli.py

@@ -1,5 +1,5 @@
 from flask import Flask
-from flask_exts import Manager
+from flask_exts import Exts
 from flask_exts.datastore.sqla import db
 from flask_exts.views.rediscli.view import RedisCli
 
@@ -9,14 +9,14 @@ from flask_exts.views.rediscli.mock_redis import MockRedis as Redis
 app = Flask(__name__)
 app.config["SECRET_KEY"] = "dev"
 
-# Manager init
-manager = Manager()
-manager.init_app(app)
+# Exts init
+exts = Exts()
+exts.init_app(app)
 
 # add rediscli view
 # redis_view = RedisCli(Redis())
 redis_view = RedisCli(Redis())
-manager.admin.add_view(redis_view)
+exts.admin.add_view(redis_view)
 
 with app.app_context():
     db.drop_all()

{flask_exts-0.2.5 → flask_exts-0.2.6}/examples/simple.py

@@ -2,7 +2,7 @@
 
 from flask import Flask
 from flask import render_template_string
-from flask_exts import Manager
+from flask_exts import Exts
 from flask_exts.admin import expose
 from flask_exts.admin import BaseView
 from flask_exts.datastore.sqla import db
@@ -19,10 +19,10 @@ class MockView(BaseView):
 
 app = Flask(__name__)
 app.config["SECRET_KEY"] = "dev"
-manager = Manager()
-manager.init_app(app)
+exts = Exts()
+exts.init_app(app)
 # Register a mock view
-manager.admin.add_view(MockView())
+exts.admin.add_view(MockView())
 
 with app.app_context():
     db.drop_all()

flask_exts-0.2.6/src/flask_exts/__about__.py

@@ -0,0 +1 @@
+__version__ = "0.2.6"

flask_exts-0.2.6/src/flask_exts/__init__.py

@@ -0,0 +1 @@
+from .exts import Exts

flask_exts-0.2.5/src/flask_exts/manager.py → flask_exts-0.2.6/src/flask_exts/exts.py

@@ -9,7 +9,7 @@ from .views.index.view import IndexView
 from .views.user.view import UserView
 
 
-class Manager:
+class Exts:
     """This is used to manager babel,template,admin, and so on..."""
 
     def __init__(self, app=None):
@@ -29,10 +29,10 @@ class Manager:
         if not hasattr(app, "extensions"):
             app.extensions = {}
 
-        if "manager" in app.extensions:
-            raise Exception("manager extension already exists in app.extensions.")
+        if "exts" in app.extensions:
+            raise Exception("exts extension already exists in app.extensions.")
 
-        app.extensions["manager"] = self
+        app.extensions["exts"] = self
 
         # init sqlalchemy db
         if app.config.get("SQLALCHEMY_DATABASE_URI", None) is None:

flask_exts-0.2.6/src/flask_exts/proxies.py

@@ -0,0 +1,19 @@
+import typing as t
+
+from flask import current_app
+from werkzeug.local import LocalProxy
+
+if t.TYPE_CHECKING:
+    from .exts import Exts
+    from .template.base import Template
+    from .usercenter.base_user_store import BaseUserStore
+    from .security.core import Security
+
+
+_exts: "Exts" = LocalProxy(lambda: current_app.extensions["exts"])
+
+_template: "Template" = LocalProxy(lambda: _exts.template)
+
+_userstore: "BaseUserStore" = LocalProxy(lambda: _exts.usercenter.userstore)
+
+_security: "Security" = LocalProxy(lambda: _exts.security)

flask_exts-0.2.6/src/flask_exts/themes/plugins/detail_filter_plugin.py

@@ -0,0 +1,10 @@
+from flask import url_for
+from .base_plugin import BasePlugin
+
+
+class DetailFilterPlugin(BasePlugin):
+    def __init__(self):
+        super().__init__("detail_filter")
+
+    def js(self):
+        return url_for("_template.static", filename="js/detail_filter.js")

flask_exts-0.2.6/src/flask_exts/themes/plugins/list_action_plugin.py

@@ -0,0 +1,10 @@
+from flask import url_for
+from .base_plugin import BasePlugin
+
+
+class ListActionPlugin(BasePlugin):
+    def __init__(self):
+        super().__init__("model_action")
+
+    def js(self):
+        return url_for("_template.static", filename="js/model_action.js")

flask_exts-0.2.6/src/flask_exts/themes/plugins/plugin_manager.py

@@ -0,0 +1,83 @@
+from markupsafe import Markup
+import os
+import sys
+import importlib.util
+import inspect
+from .base_plugin import BasePlugin
+
+
+class PluginManager:
+    def __init__(self):
+        self.registered_plugins = {}
+        self.enabled_plugins = []
+
+    def register_plugin(self, plugin):
+        self.registered_plugins[plugin.name] = plugin
+
+    def enable_plugin(self, names):
+        if isinstance(names, str):
+            names = [names]
+        for name in names:
+            if name not in self.enabled_plugins and name in self.registered_plugins:
+                self.enabled_plugins.append(name)
+
+    def init_app(self, app):
+        # Register plugins
+        plugins_directory = os.path.dirname(__file__)
+        self.load_plugins_in_directory(plugins_directory, BasePlugin)
+        # print("registered plugins:", [k for k in self.registered_plugins])
+
+    def load_css(self):
+        css_links = [
+            f'<link rel="stylesheet" href="{css}">'
+            for name in self.enabled_plugins
+            if (plugin := self.registered_plugins.get(name)) and (css := plugin.css())
+        ]
+        css = "\n".join(css_links)
+        return Markup(css)
+
+    def load_js(self):
+        js_links = [
+            f'<script src="{js}"></script>'
+            for name in self.enabled_plugins
+            if (plugin := self.registered_plugins.get(name)) and (js := plugin.js())
+        ]
+        js = "\n".join(js_links)
+        return Markup(js)
+
+    def load_plugins_in_directory(self, directory, base_class):
+        """
+        Scans the specified directory for Python files, imports them,
+        and returns a list of subclasses of the specified base class.
+
+        :param directory: The directory to scan for Python files.
+        :param base_class: The base class to find subclasses of.
+        :return: A list of subclasses of the specified base class.
+        """
+        subclasses = []
+
+        for filename in os.listdir(directory):
+            if (
+                filename.endswith("plugin.py")
+                and not filename.startswith("__")
+                and filename != "base_plugin.py"
+            ):
+                module_name = filename[:-3]
+                try:
+                    module = importlib.import_module(f"{__package__}.{module_name}")
+                except:
+                    module_path = os.path.join(directory, filename)
+                    spec = importlib.util.spec_from_file_location(
+                        module_name, module_path
+                    )
+                    module = importlib.util.module_from_spec(spec)
+                    # sys.modules[module_name] = module
+                    spec.loader.exec_module(module)
+
+                for name, obj in inspect.getmembers(module, inspect.isclass):
+                    if issubclass(obj, base_class) and obj is not base_class:
+                        subclasses.append((name, obj))
+                        plugin_instance = obj()
+                        self.register_plugin(plugin_instance)
+
+        # print(subclasses)

{flask_exts-0.2.5 → flask_exts-0.2.6}/src/flask_exts/themes/static/css/admin.css

@@ -99,7 +99,7 @@ body.modal-open {
 }
 
 /* Details View - add space between navbar and results */
-.fa_filter_container {
+.detail_filter_container {
     margin-top: 20px;
     margin-bottom: 10px;
 }

flask_exts-0.2.6/src/flask_exts/themes/static/js/detail_filter.js

@@ -0,0 +1,55 @@
+class SearchDetail {
+  constructor(searchId) {
+    this.searchInput = document.getElementById(searchId);
+    this.timeoutId = null;
+    this.delay = 500; // 500ms delay
+    this.lastValue = '';
+    this.searchableRows = null; // no query at constructor
+    if (this.searchInput) {
+      this.searchInput.addEventListener('input', this.handleInput);
+    }
+  }
+
+  handleInput = (event) => {
+    const value = event.target.value.trim();
+    if (value === this.lastValue) {
+      return;
+    }
+    this.clearTimeout();
+    this.timeoutId = setTimeout(() => {
+      this.lastValue = value;
+      this.performSearch(value);
+    }, this.delay);
+  }
+
+  clearTimeout() {
+    if (this.timeoutId) {
+      clearTimeout(this.timeoutId);
+      this.timeoutId = null;
+    }
+  }
+
+  performSearch(value) {
+    const rex = new RegExp(value, 'i');
+    if (this.searchableRows == null) {
+      this.searchableRows = document.querySelectorAll('.searchable tr');
+    }
+    this.searchableRows.forEach(function (row) {
+      const rowText = row.textContent;
+      if (rex.test(rowText)) {
+        row.style.display = '';
+      } else {
+        row.style.display = 'none';
+      }
+    })
+  }
+
+  destroy() {
+    this.clearTimeout();
+    if (this.searchInput) {
+      this.searchInput.removeEventListener('input', this.handleInput);
+    }
+  }
+  
+}
+

flask_exts-0.2.6/src/flask_exts/themes/static/js/model_action.js

@@ -0,0 +1,70 @@
+class ModelAction {
+    constructor(actionErrorMessage, actionConfirmations) {
+        this.actionErrorMessage = actionErrorMessage;
+        this.actionConfirmations = actionConfirmations;
+        this.init();
+    }
+
+    init = () => {
+        this.rowToggle = document.querySelector('.action-rowtoggle');
+        this.inputs = document.querySelectorAll('input.action-checkbox');
+        this.setupEventListeners();
+    }
+
+    setupEventListeners() {
+        // Master toggle functionality: when master checkbox changes
+        this.rowToggle.addEventListener('change', (event) => {
+            // Set all individual checkboxes to match master checkbox state
+            this.inputs.forEach(input => {
+                input.checked = event.target.checked;
+            });
+        });
+
+        // Individual checkbox functionality: when any individual checkbox changes
+        this.inputs.forEach(input => {
+            input.addEventListener('change', () => {
+                // Check if all individual checkboxes are checked
+                const allInputsChecked = Array.from(this.inputs).every(input => input.checked);
+                // Update master checkbox to reflect the overall state
+                this.rowToggle.checked = allInputsChecked;
+            });
+        });
+    }
+
+    execute(name) {
+        if (document.querySelectorAll('input.action-checkbox:checked').length === 0) {
+            alert(this.actionErrorMessage);
+            return false;
+        }
+
+        const msg = this.actionConfirmations[name];
+        if (msg) {
+            if (!confirm(msg)) {
+                return false;
+            }
+        }
+
+        // Update hidden form and submit it
+        const form = document.getElementById('action_form');
+
+        // Remove existing action checkboxes from form
+        const formCheckboxes = form.querySelectorAll('input.action-checkbox');
+        formCheckboxes.forEach(checkbox => {
+            checkbox.remove();
+        });
+
+        // Add cloned copies of checked checkboxes to form
+        const checkedCheckboxes = document.querySelectorAll('input.action-checkbox:checked');
+        checkedCheckboxes.forEach(checkbox => {
+            form.appendChild(checkbox.cloneNode(true));
+        });
+
+        // Set action value and submit form
+        form.querySelector('input[name="action"]').value = name;
+        form.submit();
+        return false;
+    };
+}
+
+
+

{flask_exts-0.2.5 → flask_exts-0.2.6}/src/flask_exts/themes/templates/default/admin/master.html

@@ -45,8 +45,3 @@
 </div>
 
 {%- endblock -%}
-
-{% block tail %}
-  {{ super() }}
-  <script src="{{ url_for('_template.static',filename='js/helper.js') }}"></script>
-{% endblock %}

{flask_exts-0.2.5 → flask_exts-0.2.6}/src/flask_exts/themes/templates/default/admin/model/details.html

@@ -1,5 +1,7 @@
 {% extends 'admin/master.html' %}
 
+{%- set _none = _template.theme.plugin.enable_plugin(['detail_filter']) -%}
+
 {% block main %}
   {% block navlinks %}
   <ul class="nav nav-tabs">
@@ -23,9 +25,9 @@
   {% endblock %}
 
   {% block details_search %}
-    <div class="form-inline fa_filter_container col-lg-6">
-      <label for="fa_filter">{{ gettext('Filter') }}</label>
-      <input id="fa_filter" type="text" class="ml-3 form-control">
+    <div class="form-inline detail_filter_container col-lg-6">
+      <label for="detail_filter">{{ gettext('Filter') }}</label>
+      <input id="detail_filter" type="text" class="ml-3 form-control">
     </div>
   {% endblock %}
 
@@ -47,5 +49,9 @@
 
 {% block tail %}
   {{ super() }}
-  <script src="{{ url_for('_template.static',filename='js/details_filter.js') }}"></script>
+  <script>
+    document.addEventListener("DOMContentLoaded",()=>{
+      new SearchDetail('detail_filter')
+    });
+  </script>  
 {% endblock %}

{flask_exts-0.2.5 → flask_exts-0.2.6}/src/flask_exts/themes/templates/default/admin/model/list.html

@@ -6,6 +6,10 @@
 {% import 'macro/actions.html' as actionlib with context %}
 {% from 'macro/row_actions.html' import render_row_action with context %}
 
+{% if actions %}
+  {%- set _none = _template.theme.plugin.enable_plugin(['model_action']) -%}
+{% endif %}
+
 {% block styles -%}
   {{ super() }}
   {{ form_css(xeditable=editable_columns) }}
@@ -180,13 +184,22 @@
 {% block tail %}
     {{ super() }}
     {% if filter_groups %}
-      <div id="filter-groups-data" class="d-none">{{ filter_groups|tojson|safe }}</div>
-      <div id="active-filters-data" class="d-none">{{ active_filters|tojson|safe }}</div>
+      <div id="filter-groups-data" class="d-none">{{ filter_groups|tojson }}</div>
+      <div id="active-filters-data" class="d-none">{{ active_filters|tojson }}</div>
     {% endif %}
     {{ form_js(xeditable=editable_columns) }}
     <script src="{{ url_for('_template.static',filename='js/modal.js') }}"></script>
     <script src="{{ url_for('_template.static',filename='js/filters.js') }}"></script>
     {% if actions %}
-      {{ actionlib.add_action_js(gettext('Please select at least one record.'), actions, actions_confirmation) }}
+        <script>
+            const actionErrorMessage = "{{ _('Please select at least one record.') }}";
+            const actionConfirmations = {{ actions_confirmation|tojson }};
+            let modelActions;
+            document.addEventListener("DOMContentLoaded",()=>{
+                modelActions = new ModelAction(actionErrorMessage, actionConfirmations);
+            });
+        </script>
     {% endif %}
+    
+
 {% endblock %}

{flask_exts-0.2.5 → flask_exts-0.2.6}/src/flask_exts/themes/templates/default/admin/model/modals/details.html

@@ -1,3 +1,5 @@
+{%- set _none = _template.theme.plugin.enable_plugin(['detail_filter']) -%}
+
 {% block body %}
   <div class="modal-header">
     {% block header_text %}
@@ -7,9 +9,9 @@
   </div>
   <div class="modal-body">
   {% block details_search %}
-    <div class="form-inline fa_filter_container col-lg-6">
-      <label for="fa_filter">{{ gettext('Filter') }}</label>
-      <input id="fa_filter" type="text" class="ml-3 form-control">
+    <div class="form-inline detail_filter_container col-lg-6">
+      <label for="detail_filter">{{ gettext('Filter') }}</label>
+      <input id="detail_filter" type="text" class="ml-3 form-control">
     </div>
   {% endblock %}  
   {% block details_table %}
@@ -30,7 +32,11 @@
 {% endblock %}
 
 {% block tail %}
-  <script src="{{ url_for('_template.static',filename='js/details_filter.js') }}"></script>
+  <script>
+    document.addEventListener("DOMContentLoaded",()=>{
+      new SearchDetail('detail_filter')
+    });
+  </script>
 {% endblock %}
 
 

{flask_exts-0.2.5 → flask_exts-0.2.6}/src/flask_exts/themes/templates/default/macro/actions.html

@@ -20,12 +20,6 @@
   </form>
 {% endmacro %}
 
-{% macro add_action_js(message, actions, actions_confirmation) %}
-  <div id="actions-confirmation-data" class="d-none">{{ actions_confirmation|tojson|safe }}</div>
-  <div id="message-data" class="d-none">{{ message|tojson|safe }}</div>
-  <script src="{{ url_for('_template.static',filename='js/actions.js') }}"></script>
-{% endmacro %}
-
 {# ---------------------- Modal Window ------------------- #}
 
 {% macro add_modal_button(url='', title='', content='', modal_window_id='fa_modal_window', btn_class='icon') %}

{flask_exts-0.2.5 → flask_exts-0.2.6}/src/flask_exts/themes/templates/default/macro/row_actions.html

@@ -33,7 +33,7 @@
   {% elif _template.funcs.csrf_token %}
   <input type="hidden" name="csrf_token" value="{{ _template.funcs.csrf_token() }}"/>
   {% endif %}
-  <button onclick="return formHelper.confirm('{{ gettext('Are you sure you want to delete this record?') }}');" title="{{ gettext('Delete Record') }}">
+  <button onclick="return confirm('{{ gettext('Are you sure you want to delete this record?') }}');" title="{{ gettext('Delete Record') }}">
     {{ render_icon(action.icon) }}
   </button>
 </form>