Flask-Exts 0.2.8__tar.gz → 0.3.1__tar.gz

flask_exts-0.3.1/.editorconfig

@@ -0,0 +1,69 @@
+# EditorConfig is awesome: https://EditorConfig.org
+# Team style guide blending Google and Microsoft conventions
+
+# Mark as root so EditorConfig stops searching parent directories
+root = true
+
+# ============================================================
+# General defaults (common to Google and Microsoft)
+# ============================================================
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true
+indent_style = space
+indent_size = 4
+
+# ============================================================
+# JavaScript / TypeScript (Google style: 2 spaces)
+# Ref: Google JavaScript Style Guide - Block indentation
+# ============================================================
+[*.{js,jsx,mjs,cjs,ts,tsx,mts,cts}]
+indent_size = 2
+
+# ============================================================
+# JSON / YAML / HTML / CSS (industry common: 2 spaces)
+# ============================================================
+[*.{json,jsonc,yml,yaml,html,css,scss,less,vue,svelte}]
+indent_size = 2
+
+# ============================================================
+# Python (Google style: 4 spaces, never tabs)
+# Ref: Google Python Style Guide - Indentation
+# ============================================================
+[*.py]
+indent_size = 4
+
+# ============================================================
+# Go (gofmt enforces tabs)
+# Ref: gofmt specification
+# ============================================================
+[*.go]
+indent_style = tab
+
+# ============================================================
+# C# / .NET (Microsoft style: 4 spaces, UTF-8 BOM)
+# Ref: dotnet/roslyn .editorconfig
+# ============================================================
+[*.{cs,csx,vb,vbx}]
+indent_size = 4
+charset = utf-8-bom
+
+# ============================================================
+# Shell scripts
+# ============================================================
+[*.sh]
+indent_size = 2
+
+# ============================================================
+# Markdown (do not trim trailing whitespace; preserves line breaks)
+# ============================================================
+[*.md]
+trim_trailing_whitespace = false
+
+# ============================================================
+# Makefile (must use tabs)
+# ============================================================
+[Makefile]
+indent_style = tab

flask_exts-0.3.1/.github/workflows/docs.yml

@@ -0,0 +1,49 @@
+name: Documentation
+
+on:
+  push:
+    paths:
+      - "docs/**"
+      - "src/**"
+      - "examples/**"
+      - "CHANGES.rst"
+      - "pyproject.toml"
+      - ".github/workflows/docs.yml"
+  pull_request:
+    paths:
+      - "docs/**"
+      - "src/**"
+      - "examples/**"
+      - "CHANGES.rst"
+      - "pyproject.toml"
+      - ".github/workflows/docs.yml"
+
+permissions:
+  contents: read
+
+jobs:
+  build-docs:
+    name: Build Sphinx documentation
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+          cache: pip
+          cache-dependency-path: |
+            pyproject.toml
+            docs/requirements.txt
+
+      - name: Install project and documentation dependencies
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install -e .
+          python -m pip install -r docs/requirements.txt
+
+      - name: Build documentation
+        run: python -m sphinx -b html docs docs/_build/html -W -n --keep-going

{flask_exts-0.2.8 → flask_exts-0.3.1}/.gitignore

@@ -1,6 +1,3 @@
-### vscode
-.vscode
-
 ### JupyterNotebooks ###
 .ipynb_checkpoints
 */.ipynb_checkpoints/*
@@ -24,6 +21,9 @@ build/
 .coverage
 htmlcov/
 
+# djlint
+.djlint_cache/
+
 # Translations
 # *.mo
 
@@ -33,7 +33,7 @@ docs/_build/
 # sqlite db
 *.sqlite
 
-# npm front-end deps (symlinked into src/flask_exts/static/vendor; install via `npm ci`)
+# npm front-end deps
 node_modules/
 package-lock.json
 

flask_exts-0.3.1/.vscode/settings.json

@@ -0,0 +1,16 @@
+{
+  "files.eol": "\n",
+  "files.associations": {
+    "**/templates/**/*.html": "jinja-html"
+  },
+  "[jinja-html]": {
+    "editor.defaultFormatter": "monosans.djlint",
+    "editor.formatOnSave": true
+  },
+  "djlint.useEditorIndentation": false,
+  "python.testing.unittestEnabled": false,
+  "python.testing.pytestEnabled": true,
+  "python.testing.pytestArgs": [
+    "tests"
+  ],
+}

flask_exts-0.3.1/CHANGES.rst

@@ -0,0 +1,39 @@
+v0.3.1
+------
+
+Released 2026-10-11
+
+- Improve SQLAlchemy lifecycle management, session configuration, and in-memory SQLite support.
+- Add reusable modal form flows and improve two-factor authentication setup.
+- Allow extensions to provide admin views for automatic registration, and clarify duplicate extension-name errors.
+
+v0.3.0
+------
+
+Released 2026-10-07
+
+- Add user registration, login, logout, profile management, and user-center views.
+- Add email verification, email change, password reset, and recovery workflows.
+- Add a SQLAlchemy-backed user store with user profiles and role management.
+- Add authentication and role-based authorization.
+- Add TOTP-based two-factor authentication and recovery codes.
+
+v0.2.0
+------
+
+Released 2026-01-07
+
+- Add an extension system with registration, dependency management, and lifecycle hooks.
+- Add an admin interface with model views, CRUD operations, filtering, sorting, pagination, and data export.
+- Add SQLAlchemy integration for database access, model forms, relationships, and queries.
+- Add form fields, widgets, validators, and CSRF protection.
+- Add email delivery and notification support.
+- Add frontend plugin management and Bootstrap-based components.
+- Add Babel integration for localization.
+
+v0.1.0
+------
+
+Released 2024-03-20
+
+- Initial release of the Flask-Exts package and documentation.

flask_exts-0.3.1/Makefile

@@ -0,0 +1,31 @@
+.PHONY: docs-build docs-serve docs-clean
+
+docs-build:
+	python -m sphinx -b html docs docs/_build/html -W -n --keep-going
+
+docs-serve:
+	python -m http.server -d docs/_build/html 8000
+
+docs-clean:
+	rm -rf docs/_build
+
+test:
+	pytest
+
+pytest-last:
+	pytest --lf --last-failed-no-failures=none
+
+pytest-clean:
+	rm -rf .pytest_cache
+
+pytest-warn:
+	pytest -W error
+
+pytest-print:
+	pytest -s
+
+coverage:
+	coverage run -m pytest
+
+coverage-report:
+	coverage report -m

flask_exts-0.3.1/PKG-INFO

@@ -0,0 +1,111 @@
+Metadata-Version: 2.5
+Name: Flask-Exts
+Version: 0.3.1
+Summary: Flask extensions with admin, SQLAlchemy, Babel, forms, fields, widgets, and more.
+Project-URL: Documentation, https://flask-exts.readthedocs.io
+Project-URL: Source, https://github.com/ojso/flask-exts
+Project-URL: Homepage, https://github.com/ojso/flask-exts
+Project-URL: Issues, https://github.com/ojso/flask-exts/issues
+Project-URL: Changelog, https://flask-exts.readthedocs.io/en/latest/changes.html
+Author-email: David Hua <david.dong.hua@gmail.com>
+License-Expression: MIT
+License-File: LICENSE.rst
+Keywords: admin,babel,flask,form,sqlalchemy,widget
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Web Environment
+Classifier: Framework :: Flask
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.10
+Requires-Dist: email-validator>=2.0
+Requires-Dist: flask-babel>=4.0
+Requires-Dist: flask-login>=0.6
+Requires-Dist: flask>=3.0
+Requires-Dist: pyjwt>=2.0
+Requires-Dist: pyotp>=2.0
+Requires-Dist: sqlalchemy>=2.0
+Requires-Dist: tablib>=3.0
+Requires-Dist: wtforms>=3.0
+Provides-Extra: dev
+Requires-Dist: djlint; extra == 'dev'
+Requires-Dist: pytest; extra == 'dev'
+Requires-Dist: ruff; extra == 'dev'
+Description-Content-Type: text/x-rst
+
+Flask-Exts
+==========
+
+Flask-Exts is a toolkit for building Flask applications with an integrated
+admin interface, SQLAlchemy support, forms, localization, and user-account
+features. It brings common application components together behind a
+dependency-aware extension system. The project is inspired by
+`Flask-Admin <https://github.com/pallets-eco/flask-admin/>`_ and
+`Bootstrap <https://getbootstrap.com/>`_.
+
+Highlights
+----------
+
+- **Modern frontend:** Uses Bootstrap 5 and native browser APIs, with no
+  jQuery dependency or Bootstrap 4 frontend.
+- **Composable extensions:** Initializes extensions in dependency order and
+  lets extensions contribute views to the admin interface.
+- **Built-in account features:** Provides authentication, email verification
+  and recovery flows, TOTP-based two-factor authentication, and recovery
+  codes.
+- **Integrated admin and data tools:** Includes SQLAlchemy integration,
+  model management, forms, filtering, and data export.
+- **Localization support:** Integrates Babel for translating application
+  interfaces.
+
+Installation
+------------
+
+Flask-Exts requires Python 3.10 or later. Install it with pip:
+
+.. code-block:: console
+
+   pip install flask-exts
+
+Quick start
+-----------
+
+Create a Flask application and initialize the extension manager:
+
+.. code-block:: python
+
+   from flask import Flask
+   from flask_exts import ExtensionManager
+
+   app = Flask(__name__)
+   app.config["SECRET_KEY"] = "change-this-for-local-development"
+   app.config["SQLALCHEMY_DATABASE_URI"] = "sqlite:///app.sqlite"
+
+   extensions = ExtensionManager()
+   extensions.init_app(app)
+
+   if __name__ == "__main__":
+       app.run(debug=True)
+
+For a complete example with a custom admin view and database setup, see
+``examples/simple``.
+
+Documentation
+-------------
+
+- `Documentation <https://flask-exts.readthedocs.io/>`_
+- `Runnable examples <https://github.com/ojso/flask-exts/tree/main/examples>`_
+- `Changelog <https://flask-exts.readthedocs.io/en/latest/changes.html>`_
+
+License
+-------
+
+Flask-Exts is distributed under the terms of the
+`MIT License <https://opensource.org/licenses/MIT>`_.

flask_exts-0.3.1/README.rst

@@ -0,0 +1,69 @@
+Flask-Exts
+==========
+
+Flask-Exts is a toolkit for building Flask applications with an integrated
+admin interface, SQLAlchemy support, forms, localization, and user-account
+features. It brings common application components together behind a
+dependency-aware extension system. The project is inspired by
+`Flask-Admin <https://github.com/pallets-eco/flask-admin/>`_ and
+`Bootstrap <https://getbootstrap.com/>`_.
+
+Highlights
+----------
+
+- **Modern frontend:** Uses Bootstrap 5 and native browser APIs, with no
+  jQuery dependency or Bootstrap 4 frontend.
+- **Composable extensions:** Initializes extensions in dependency order and
+  lets extensions contribute views to the admin interface.
+- **Built-in account features:** Provides authentication, email verification
+  and recovery flows, TOTP-based two-factor authentication, and recovery
+  codes.
+- **Integrated admin and data tools:** Includes SQLAlchemy integration,
+  model management, forms, filtering, and data export.
+- **Localization support:** Integrates Babel for translating application
+  interfaces.
+
+Installation
+------------
+
+Flask-Exts requires Python 3.10 or later. Install it with pip:
+
+.. code-block:: console
+
+   pip install flask-exts
+
+Quick start
+-----------
+
+Create a Flask application and initialize the extension manager:
+
+.. code-block:: python
+
+   from flask import Flask
+   from flask_exts import ExtensionManager
+
+   app = Flask(__name__)
+   app.config["SECRET_KEY"] = "change-this-for-local-development"
+   app.config["SQLALCHEMY_DATABASE_URI"] = "sqlite:///app.sqlite"
+
+   extensions = ExtensionManager()
+   extensions.init_app(app)
+
+   if __name__ == "__main__":
+       app.run(debug=True)
+
+For a complete example with a custom admin view and database setup, see
+``examples/simple``.
+
+Documentation
+-------------
+
+- `Documentation <https://flask-exts.readthedocs.io/>`_
+- `Runnable examples <https://github.com/ojso/flask-exts/tree/main/examples>`_
+- `Changelog <https://flask-exts.readthedocs.io/en/latest/changes.html>`_
+
+License
+-------
+
+Flask-Exts is distributed under the terms of the
+`MIT License <https://opensource.org/licenses/MIT>`_.