Flask-Exts 0.2.7__tar.gz → 0.3.0__tar.gz

flask_exts-0.3.0/.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.0/.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.7 → flask_exts-0.3.0}/.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,5 +33,9 @@ docs/_build/
 # sqlite db
 *.sqlite
 
+# npm front-end deps (symlinked into src/flask_exts/static/vendor; install via `npm ci`)
+node_modules/
+package-lock.json
+
 # production config
 **/config_prod.py

flask_exts-0.3.0/.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.0/CHANGES.rst

@@ -0,0 +1,32 @@
+v0.3.0
+------
+
+Released 2026-10-07
+
+- usercenter
+- userstore
+- security
+- user view, authentication and authorization
+- 2FA with TOTP
+
+v0.2.0
+------
+
+Released 2026-01-07
+
+- extensions
+- admin
+- datastore
+- emailer
+- forms
+- frontend
+- babel
+
+v0.1.0
+------
+
+Released 2024-03-20
+
+- Init release
+- Init docs
+- .readthedocs.yaml

flask_exts-0.3.0/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
+
+pytest:
+	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.2.7 → flask_exts-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: Flask-Exts
-Version: 0.2.7
+Version: 0.3.0
 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
@@ -43,6 +43,7 @@ Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Software Development :: Build Tools
 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
@@ -61,6 +62,7 @@ Flask-Exts is mainly inspired by:
 - `Flask-Admin <https://github.com/pallets-eco/flask-admin/>`_
 - `Bootstrap <https://getbootstrap.com/>`_
 
+Flask-Exts is a Flask extension toolkit that combines SQLAlchemy, forms, Babel, and admin features to help developers build modern web applications quickly.
 
 License
 -------
@@ -77,19 +79,18 @@ Install and update using pip:
 
     $ pip install Flask-Exts
 
-Examples
+Example
 ----------
 
 .. code-block:: python
 
     from flask import Flask
-    from flask_exts import Exts
+    from flask_exts import ExtensionManager
 
     app = Flask(__name__)
     app.config["SECRET_KEY"] = "dev"
-    exts = Exts()
+    exts = ExtensionManager()
     exts.init_app(app)
 
     if __name__ == "__main__":
         app.run(debug=True)
-

{flask_exts-0.2.7 → flask_exts-0.3.0}/README.rst

@@ -6,6 +6,7 @@ Flask-Exts is mainly inspired by:
 - `Flask-Admin <https://github.com/pallets-eco/flask-admin/>`_
 - `Bootstrap <https://getbootstrap.com/>`_
 
+Flask-Exts is a Flask extension toolkit that combines SQLAlchemy, forms, Babel, and admin features to help developers build modern web applications quickly.
 
 License
 -------
@@ -22,19 +23,18 @@ Install and update using pip:
 
     $ pip install Flask-Exts
 
-Examples
+Example
 ----------
 
 .. code-block:: python
 
     from flask import Flask
-    from flask_exts import Exts
+    from flask_exts import ExtensionManager
 
     app = Flask(__name__)
     app.config["SECRET_KEY"] = "dev"
-    exts = Exts()
+    exts = ExtensionManager()
     exts.init_app(app)
 
     if __name__ == "__main__":
         app.run(debug=True)
-

{flask_exts-0.2.7 → flask_exts-0.3.0}/babel/messages.pot

@@ -8,235 +8,231 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Flask-Exts VERSION\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2026-05-24 22:01+0800\n"
+"POT-Creation-Date: 2026-10-03 19:07+0800\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language-Team: LANGUAGE <LL@li.org>\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=utf-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.17.0\n"
+"Generated-By: Babel 2.18.0\n"
 
-#: src/flask_exts/admin/model/actions.py:114
+#: src/flask_exts/admin/model/actions_mixin.py:113
 msgid "Delete"
 msgstr ""
 
-#: src/flask_exts/admin/model/actions.py:115
+#: src/flask_exts/admin/model/actions_mixin.py:114
 msgid "Are you sure you want to delete selected records?"
 msgstr ""
 
-#: src/flask_exts/admin/model/actions.py:121
-#: src/flask_exts/admin/model/view.py:1417
+#: src/flask_exts/admin/model/actions_mixin.py:120
+#: src/flask_exts/admin/model/view.py:387
 #, python-format
 msgid "Record was successfully deleted."
 msgid_plural "%(count)s records were successfully deleted."
 msgstr[0] ""
 msgstr[1] ""
 
-#: src/flask_exts/admin/model/filter.py:88
-#: src/flask_exts/template/forms/widgets/xeditable.py:53
+#: src/flask_exts/admin/model/filter.py:124
+#: src/flask_exts/forms/widgets/editable.py:45
 msgid "Yes"
 msgstr ""
 
-#: src/flask_exts/admin/model/filter.py:88
-#: src/flask_exts/template/forms/widgets/xeditable.py:52
+#: src/flask_exts/admin/model/filter.py:124
+#: src/flask_exts/forms/widgets/editable.py:44
 msgid "No"
 msgstr ""
 
-#: src/flask_exts/admin/model/filter.py:178
+#: src/flask_exts/admin/model/filter.py:214
+#: src/flask_exts/admin/sqla/filter/filters.py:313
+#: src/flask_exts/admin/sqla/filter/filters.py:348
+#: src/flask_exts/admin/sqla/filter/filters.py:377
 msgid "between"
 msgstr ""
 
-#: src/flask_exts/admin/model/filter_mixin.py:182
+#: src/flask_exts/admin/model/filter_mixin.py:186
 #, python-format
 msgid "Invalid Filter Value: %(value)s"
 msgstr ""
 
-#: src/flask_exts/admin/model/rowaction.py:15
-#: src/flask_exts/admin/model/rowaction.py:22
+#: src/flask_exts/admin/model/row_actions.py:15
+#: src/flask_exts/admin/model/row_actions.py:22
 msgid "View Record"
 msgstr ""
 
-#: src/flask_exts/admin/model/rowaction.py:29
-#: src/flask_exts/admin/model/rowaction.py:36
+#: src/flask_exts/admin/model/row_actions.py:29
+#: src/flask_exts/admin/model/row_actions.py:36
 #: src/flask_exts/templates/admin/model/modals/edit.html:2
 msgid "Edit Record"
 msgstr ""
 
-#: src/flask_exts/admin/model/rowaction.py:43
+#: src/flask_exts/admin/model/row_actions.py:43
 msgid "Delete Record"
 msgstr ""
 
-#: src/flask_exts/admin/model/rowaction.py:45
+#: src/flask_exts/admin/model/row_actions.py:45
 msgid "Are you sure you want to delete this record?"
 msgstr ""
 
-#: src/flask_exts/admin/model/view.py:1295
+#: src/flask_exts/admin/model/view.py:271
 msgid "Record was successfully created."
 msgstr ""
 
-#: src/flask_exts/admin/model/view.py:1340
-#: src/flask_exts/admin/model/view.py:1383
-#: src/flask_exts/admin/model/view.py:1411
-#: src/flask_exts/admin/model/view.py:1595
+#: src/flask_exts/admin/model/view.py:312
+#: src/flask_exts/admin/model/view.py:353
+#: src/flask_exts/admin/model/view.py:380
+#: src/flask_exts/admin/model/view.py:440
 msgid "Record does not exist."
 msgstr ""
 
-#: src/flask_exts/admin/model/view.py:1347
-#: src/flask_exts/admin/model/view.py:1599
+#: src/flask_exts/admin/model/view.py:319
+#: src/flask_exts/admin/model/view.py:443
 msgid "Record was successfully saved."
 msgstr ""
 
-#: src/flask_exts/admin/model/view.py:1470
+#: src/flask_exts/admin/model/view.py:446
+#: src/flask_exts/admin/model/view.py:453
+#: src/flask_exts/admin/model/view.py:460 src/flask_exts/admin/sqla/view.py:482
+#, python-format
+msgid "Failed to update record. %(error)s"
+msgstr ""
+
+#: src/flask_exts/admin/model/view.py:464
+msgid "Validation failed."
+msgstr ""
+
+#: src/flask_exts/admin/model/operations/export.py:146
+#, python-format
+msgid "Export type \"%(type)s\" not supported."
+msgstr ""
+
+#: src/flask_exts/admin/model/operations/export.py:172
 msgid "Permission denied."
 msgstr ""
 
-#: src/flask_exts/admin/model/view.py:1549
+#: src/flask_exts/admin/sqla/view.py:461
 #, python-format
-msgid "Export type \"%(type)s not supported."
+msgid "Failed to create record. %(error)s"
 msgstr ""
 
-#: src/flask_exts/admin/model/view.py:1603
-#: src/flask_exts/admin/model/view.py:1610
-#: src/flask_exts/admin/model/view.py:1617
-#: src/flask_exts/admin/sqla/view.py:474
+#: src/flask_exts/admin/sqla/view.py:495
 #, python-format
-msgid "Failed to update record. %(error)s"
+msgid "Failed to delete record. %(error)s"
 msgstr ""
 
-#: src/flask_exts/admin/sqla/filter.py:43
+#: src/flask_exts/admin/sqla/filter/filters.py:59
 msgid "equals"
 msgstr ""
 
-#: src/flask_exts/admin/sqla/filter.py:51
+#: src/flask_exts/admin/sqla/filter/filters.py:69
 msgid "not equal"
 msgstr ""
 
-#: src/flask_exts/admin/sqla/filter.py:59
+#: src/flask_exts/admin/sqla/filter/filters.py:79
 msgid "greater than"
 msgstr ""
 
-#: src/flask_exts/admin/sqla/filter.py:67
+#: src/flask_exts/admin/sqla/filter/filters.py:89
 msgid "smaller than"
 msgstr ""
 
-#: src/flask_exts/admin/sqla/filter.py:75
+#: src/flask_exts/admin/sqla/filter/filters.py:99
 msgid "contains"
 msgstr ""
 
-#: src/flask_exts/admin/sqla/filter.py:83
+#: src/flask_exts/admin/sqla/filter/filters.py:109
 msgid "not contains"
 msgstr ""
 
-#: src/flask_exts/admin/sqla/filter.py:91
+#: src/flask_exts/admin/sqla/filter/filters.py:119
 msgid "empty"
 msgstr ""
 
-#: src/flask_exts/admin/sqla/filter.py:105
+#: src/flask_exts/admin/sqla/filter/filters.py:135
 msgid "in list"
 msgstr ""
 
-#: src/flask_exts/admin/sqla/filter.py:116
+#: src/flask_exts/admin/sqla/filter/filters.py:148
 msgid "not in list"
 msgstr ""
 
-#: src/flask_exts/admin/sqla/filter.py:204
-#: src/flask_exts/admin/sqla/filter.py:236
-#: src/flask_exts/admin/sqla/filter.py:268
+#: src/flask_exts/admin/sqla/filter/filters.py:323
+#: src/flask_exts/admin/sqla/filter/filters.py:358
+#: src/flask_exts/admin/sqla/filter/filters.py:387
 msgid "not between"
 msgstr ""
 
-#: src/flask_exts/admin/sqla/view.py:453
-#, python-format
-msgid "Failed to create record. %(error)s"
-msgstr ""
-
-#: src/flask_exts/admin/sqla/view.py:487
-#, python-format
-msgid "Failed to delete record. %(error)s"
-msgstr ""
-
-#: src/flask_exts/template/forms/fields/ajax_select.py:60
-#: src/flask_exts/template/forms/fields/ajax_select.py:110
-#: src/flask_exts/template/forms/fields/sqla.py:118
-#: src/flask_exts/template/forms/fields/sqla.py:170
-#: src/flask_exts/template/forms/fields/sqla.py:175
+#: src/flask_exts/forms/fields/ajax_select.py:60
+#: src/flask_exts/forms/fields/ajax_select.py:109
+#: src/flask_exts/forms/fields/sqla.py:120
+#: src/flask_exts/forms/fields/sqla.py:172
+#: src/flask_exts/forms/fields/sqla.py:177
 msgid "Not a valid choice"
 msgstr ""
 
-#: src/flask_exts/template/forms/fields/datetime.py:102
+#: src/flask_exts/forms/fields/datetime.py:103
 msgid "Invalid time format"
 msgstr ""
 
-#: src/flask_exts/template/forms/fields/file.py:66
-#: src/flask_exts/template/forms/fields/file.py:76
+#: src/flask_exts/forms/fields/file.py:68
+#: src/flask_exts/forms/fields/file.py:78
 #, python-format
 msgid "File \"%s\" already exists."
 msgstr ""
 
-#: src/flask_exts/template/forms/fields/json.py:13
+#: src/flask_exts/forms/fields/json.py:15
 msgid "Invalid JSON"
 msgstr ""
 
-#: src/flask_exts/template/forms/fields/select.py:62
+#: src/flask_exts/forms/fields/select.py:64
 msgid "Invalid Choice: could not coerce"
 msgstr ""
 
-#: src/flask_exts/template/forms/form/csrf.py:57
+#: src/flask_exts/forms/form/csrf.py:54
 msgid "CSRF token expired."
 msgstr ""
 
-#: src/flask_exts/template/forms/validators/field_list.py:11
+#: src/flask_exts/forms/validators/field_list.py:13
 msgid "This field requires at least one item."
 msgstr ""
 
-#: src/flask_exts/template/forms/validators/file.py:18
+#: src/flask_exts/forms/validators/file.py:18
 msgid "This field is required."
 msgstr ""
 
-#: src/flask_exts/template/forms/validators/file.py:50
+#: src/flask_exts/forms/validators/file.py:50
 #, python-brace-format
 msgid "File does not have an approved extension: {extensions}"
 msgstr ""
 
-#: src/flask_exts/template/forms/validators/file.py:85
+#: src/flask_exts/forms/validators/file.py:85
 #, python-brace-format
 msgid "File must be between {min_size} and {max_size} bytes."
 msgstr ""
 
-#: src/flask_exts/template/forms/validators/sqla.py:38
+#: src/flask_exts/forms/validators/sqla.py:38
 msgid "Already exists."
 msgstr ""
 
-#: src/flask_exts/template/forms/validators/sqla.py:56
+#: src/flask_exts/forms/validators/sqla.py:56
 #, python-format
 msgid "At least %(num)d item is required"
 msgid_plural "At least %(num)d items are required"
 msgstr[0] ""
 msgstr[1] ""
 
-#: src/flask_exts/template/forms/widgets/select.py:72
+#: src/flask_exts/forms/widgets/select.py:71
 msgid "Please select model"
 msgstr ""
 
 #: src/flask_exts/templates/admin/model/create.html:8
-#: src/flask_exts/templates/admin/model/edit.html:7
 msgid "List"
 msgstr ""
 
 #: src/flask_exts/templates/admin/model/create.html:11
-#: src/flask_exts/templates/admin/model/edit.html:11
 msgid "Create"
 msgstr ""
 
-#: src/flask_exts/templates/admin/model/edit.html:15
-msgid "Edit"
-msgstr ""
-
-#: src/flask_exts/templates/admin/model/edit.html:18
-msgid "Details"
-msgstr ""
-
 #: src/flask_exts/templates/admin/model/modals/create.html:2
 msgid "Create New Record"
 msgstr ""

flask_exts-0.3.0/docs/advanced/database.rst

@@ -0,0 +1,10 @@
+Database
+========
+
+This page documents the database helpers and SQLAlchemy integration used by
+Flask-Exts.
+
+.. automodule:: flask_exts.datastore.sqla._db
+
+.. automodule:: flask_exts.datastore.sqla.database
+   :members:

flask_exts-0.3.0/docs/advanced/index.rst

@@ -0,0 +1,13 @@
+Advanced usage
+==============
+
+This section covers advanced patterns for using Flask-Exts in larger projects,
+including database configuration and application lifecycle management.
+
+Use the pages in this section when you need more control over how extensions are
+initialized, configured, or integrated with your application structure.
+
+.. toctree::
+   :maxdepth: 2
+
+   database

{flask_exts-0.2.7 → flask_exts-0.3.0}/docs/api.rst

@@ -1,17 +1,17 @@
-===
 API
 ===
 
+Admin
+-----
+
+.. automodule:: flask_exts.admin.base
+    :members:
+    :inherited-members:
+
 view
-====
+-----
 
 .. autoclass:: flask_exts.admin.view.View
     :members:
 
-Admin
-=====
 
-.. automodule:: flask_exts.admin.admin
-    :members:
-    :inherited-members:
-