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

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

@@ -1,3 +1,22 @@
+v0.2.5
+------
+
+Released 2025-10-24
+
+- rewrite template structure
+- rewrite user view, user authentication and authorization
+
+v0.2.4
+------
+
+Released 2025-10-06
+
+- user change password
+- user forgot password
+- user 2FA with TOTP
+- user recovery codes
+- user recovery
+
 v0.2.3
 ------
 
@@ -7,7 +26,6 @@ Released 2025-08-28
 - add folder email
 - add security.email_verification
 
-
 v0.2.2
 ------
 
@@ -64,7 +82,7 @@ Released 2024-09-14
 
 - merge translations of wtforms, flask_exts and app into flask_babel.get_translations()
 - update FileField and ImageField
-- add url for template.static
+- add url for _template.static
 
 v0.1.5
 ------

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: Flask-Exts
-Version: 0.2.3
+Version: 0.2.5
 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
@@ -46,7 +46,10 @@ Requires-Dist: flask-babel>=4.0
 Requires-Dist: flask-login>=0.6
 Requires-Dist: flask-sqlalchemy>=3.0
 Requires-Dist: flask>=3.0
+Requires-Dist: pillow>=11.0
 Requires-Dist: pyjwt>=2.0
+Requires-Dist: pyotp>=2.0
+Requires-Dist: qrcode>=8.0
 Requires-Dist: tablib>=3.0
 Requires-Dist: webauthn>=2.0
 Requires-Dist: wtforms>=3.0

flask_exts-0.2.5/docs/api.rst

@@ -0,0 +1,9 @@
+API
+===
+
+views
+=======
+
+.. automodule:: flask_exts.views.user.view
+   :members:
+   :inherited-members:

{flask_exts-0.2.3 → flask_exts-0.2.5}/docs/configure.rst

@@ -6,6 +6,9 @@ Configuration
 ==============
 
 ========================== =====================================================================
+``ADMIN_ALL_ACCESSED``     Set to ``True`` to enable access within admin views for all users,
+                           otherwise, only the users with access role can access admin views.
+                           Default is ``False``.
 ``BABEL_ACCEPT_LANGUAGES`` Set to ``en;zh`` to bebel's accept languages.
                            Default is ``None``.
 ``BABEL_DEFAULT_TIMEZONE`` Set to ``Asia/Shanghai`` to babel's default timezone.
@@ -18,7 +21,7 @@ Configuration
                            Default is ``csrf_token``.
 ``CSRF_TIME_LIMIT``        Max age in seconds for CSRF tokens. 
                            Default is ``1800``. 
-``VERIFY_EMAIL_SENDER``    Email address used to send verification emails.
+``NOREPLY_EMAIL_SENDER``   Email address used to send emails.
                            It is a dict for smtp with keys: host,port,user,password.
                            Default is None.
 ========================== =====================================================================

{flask_exts-0.2.3 → flask_exts-0.2.5}/docs/develop.rst

@@ -69,28 +69,3 @@ pybabel
 
     $ pybabel compile -d src/flask_exts/translations -D messages 
 
-
-tests
------
-
-.. code-block:: console
-
-
-    cd tests/
-
-    # extract messages from source files and generate a POT file
-    pybabel extract -o translations/messages.pot .
-
-    # create new message catalogs from a POT file
-    pybabel init -i translations/messages.pot -d translations -l en
-    pybabel init -i translations/messages.pot -d translations -l zh_CN
-
-    # update existing message catalogs from a POT file
-    pybabel update -i translations/messages.pot -d translations
-
-    # edit
-    # open the '.po' file
-
-    # compile message catalogs to MO files
-
-    pybabel compile -d translations

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

@@ -45,6 +45,17 @@ More examples, please click :doc:`examples`.
    examples
    changes
 
+API Reference
+-------------
+
+If you are looking for information on a specific function, class or
+method, this part of the documentation is for you.
+
+.. toctree::
+   :maxdepth: 1
+
+   api
+
 Indices and tables
 ==================
 

{flask_exts-0.2.3 → flask_exts-0.2.5}/examples/README.rst

@@ -20,61 +20,61 @@ Run the examples
 
 Type the command in the terminal, then go to http://localhost:5000.
 
-Start
-----------
-
 simple 
 ---------
 
-run only one file.
-
 .. code-block:: bash
 
     $ python simple.py
 
-demo
+rediscli
 -----------------
 
-With sqlite db.
+Use with mock redis server.
 
 .. code-block:: bash
     
-    $ flask --app demo run --debug --port=5000
-
-fileadmin
------------------
+    $ python rediscli.py
 
-.. code-block:: bash
-    
-    $ flask --app fileadmin run
+go to http://localhost:5000/admin/rediscli/
 
-rediscli
------------------
+if you want to use real redis server, then do this:
 
-First install redis,
+1. First install redis,
 
 .. code-block:: bash
 
     $ pip install redis
 
-then run:
+2. Modify code in ``rediscli.py``
+
+.. code-block:: python
+
+    # from flask_exts.views.rediscli.mock_redis import MockRedis as Redis
+    from redis import Redis
+
+3. At last, run  ``python rediscli.py``
+
+demo
+-----------------
+
+Default admin user is ``admin``, password is ``admin``.
 
 .. code-block:: bash
     
-    $ flask --app rediscli run
+    $ flask --app demo run
 
-Bootstrap 4
+fileadmin
 -----------------
 
 .. code-block:: bash
+    
+    $ flask --app fileadmin run
 
-    $ flask --app bootstrap4/app.py run
-
-Bootstrap 5
+Bootstrap
 -----------------
 
 .. code-block:: bash
-    
-    $ flask --app bootstrap5/app.py run
 
+    $ flask --app bootstrap run
 

flask_exts-0.2.5/examples/bootstrap/forms.py

@@ -0,0 +1,113 @@
+from wtforms.validators import DataRequired, Length, Regexp
+from wtforms.fields import *
+from flask_exts.template.fields import SwitchField
+from flask_exts.template.form.flask_form import FlaskForm
+
+
+class ExampleForm(FlaskForm):
+    """An example form that contains all the supported bootstrap style form fields."""
+
+    date = DateField(
+        description="We'll never share your email with anyone else."
+    )  # add help text with `description`
+    datetime = DateTimeField(
+        render_kw={"placeholder": "this is a placeholder"}
+    )  # add HTML attribute with `render_kw`
+    datetime_local = DateTimeLocalField()
+    time = TimeField()
+    month = MonthField()
+    color = ColorField()
+    floating = FloatField()
+    integer = IntegerField()
+    decimal_slider = DecimalRangeField()
+    integer_slider = IntegerRangeField(render_kw={"min": "0", "max": "4"})
+    email = EmailField()
+    url = URLField()
+    telephone = TelField()
+    image = FileField(
+        render_kw={"class": "my-class"}, validators=[Regexp(r".+\.jpg$")]
+    )  # add your class
+    option = RadioField(
+        choices=[("dog", "Dog"), ("cat", "Cat"), ("bird", "Bird"), ("alien", "Alien")]
+    )
+    select = SelectField(
+        choices=[("dog", "Dog"), ("cat", "Cat"), ("bird", "Bird"), ("alien", "Alien")]
+    )
+    select_multiple = SelectMultipleField(
+        choices=[("dog", "Dog"), ("cat", "Cat"), ("bird", "Bird"), ("alien", "Alien")]
+    )
+    bio = TextAreaField()
+    search = SearchField()  # will autocapitalize on mobile
+    title = StringField()  # will not autocapitalize on mobile
+    secret = PasswordField()
+    remember = BooleanField("Remember me")
+    submit = SubmitField()
+
+
+class HelloForm(FlaskForm):
+    username = StringField("Username", validators=[DataRequired(), Length(1, 20)])
+    password = PasswordField("Password", validators=[DataRequired(), Length(8, 150)])
+    remember = BooleanField("Remember me")
+    submit = SubmitField()
+
+
+class ButtonForm(FlaskForm):
+    username = StringField("Username", validators=[DataRequired(), Length(1, 20)])
+    confirm = SwitchField("Confirmation")
+    submit = SubmitField()
+    delete = SubmitField()
+    cancel = SubmitField()
+
+
+class TelephoneForm(FlaskForm):
+    country_code = IntegerField("Country Code")
+    area_code = IntegerField("Area Code/Exchange")
+    number = StringField("Number")
+
+
+class IMForm(FlaskForm):
+    protocol = SelectField(choices=[("aim", "AIM"), ("msn", "MSN")])
+    username = StringField()
+
+
+class ContactForm(FlaskForm):
+    first_name = StringField()
+    last_name = StringField()
+    mobile_phone = FormField(TelephoneForm)
+    office_phone = FormField(TelephoneForm)
+    emails = FieldList(StringField("Email"), min_entries=3)
+    im_accounts = FieldList(FormField(IMForm), min_entries=2)
+
+
+class BootswatchForm(FlaskForm):
+    """Form to test Bootswatch."""
+
+    # DO NOT EDIT! Use list-bootswatch.py to generate the Radiofield below.
+    theme_name = RadioField(
+        default="default",
+        choices=[
+            ("default", "none"),
+            ("cerulean", "Cerulean 4.6.1"),
+            ("cosmo", "Cosmo 4.6.1"),
+            ("cyborg", "Cyborg 4.6.1"),
+            ("darkly", "Darkly 4.6.1"),
+            ("flatly", "Flatly 4.6.1"),
+            ("journal", "Journal 4.6.1"),
+            ("litera", "Litera 4.6.1"),
+            ("lumen", "Lumen 4.6.1"),
+            ("lux", "Lux 4.6.1"),
+            ("materia", "Materia 4.6.1"),
+            ("minty", "Minty 4.6.1"),
+            ("pulse", "Pulse 4.6.1"),
+            ("sandstone", "Sandstone 4.6.1"),
+            ("simplex", "Simplex 4.6.1"),
+            ("sketchy", "Sketchy 4.6.1"),
+            ("slate", "Slate 4.6.1"),
+            ("solar", "Solar 4.6.1"),
+            ("spacelab", "Spacelab 4.6.1"),
+            ("superhero", "Superhero 4.6.1"),
+            ("united", "United 4.6.1"),
+            ("yeti", "Yeti 4.6.1"),
+        ],
+    )
+    submit = SubmitField()

flask_exts-0.2.5/examples/bootstrap/make_app.py

@@ -0,0 +1,46 @@
+from flask import Flask
+from flask_exts import Manager
+from .models import db, Message, MyCategory
+from .view import BootstrapView
+
+def create_app():
+    app = Flask(__name__)
+    app.config["SECRET_KEY"] = "dev"
+    init_app(app)
+    return app
+
+
+def init_app(app: Flask):
+    manager = Manager()
+    manager.init_app(app)
+    manager.admin.add_view(BootstrapView())
+
+    with app.app_context():
+        db.drop_all()
+        db.create_all()
+
+        for i in range(20):
+            url = 'mailto:x@t.me'
+            if i % 7 == 0:
+                url = 'www.t.me'
+            elif i % 7 == 1:
+                url = 'https://t.me'
+            elif i % 7 == 2:
+                url = 'http://t.me'
+            elif i % 7 == 3:
+                url = 'http://t'
+            elif i % 7 == 4:
+                url = 'http://'
+            elif i % 7 == 5:
+                url = 'x@t.me'
+            m = Message(
+                text=f'Message {i+1} {url}',
+                author=f'Author {i+1}',
+                create_time=4321*(i+1)
+                )
+            if i % 2:
+                m.category = MyCategory.CAT2
+            if i % 4:
+                m.draft = True
+            db.session.add(m)
+        db.session.commit()

flask_exts-0.2.5/examples/bootstrap/models.py

@@ -0,0 +1,19 @@
+from enum import Enum
+from sqlalchemy.orm import Mapped
+from sqlalchemy.orm import mapped_column
+from flask_exts.datastore.sqla import db
+
+
+class MyCategory(Enum):
+    CAT1 = "Category 1"
+    CAT2 = "Category 2"
+
+
+class Message(db.Model):
+    id: Mapped[int] = mapped_column(primary_key=True)
+    text: Mapped[str] = mapped_column(nullable=False)
+    author: Mapped[str] = mapped_column(nullable=False)
+    category: Mapped[MyCategory] = mapped_column(default=MyCategory.CAT1, nullable=False)
+    draft: Mapped[bool] = mapped_column(default=False, nullable=False)
+    create_time: Mapped[int] = mapped_column(nullable=False, unique=True)
+

{flask_exts-0.2.3/examples/bootstrap4/templates → flask_exts-0.2.5/examples/bootstrap/templates/bootstrap}/flash.html

@@ -2,5 +2,5 @@
 
 {% block content %}
 The messages above were rendered with the following code:
-<pre>{% raw %}{{ render_messages(container=False, dismissible=True) }}{% endraw %}</pre>
+<pre>{% raw %}{{ render_messages() }}{% endraw %}</pre>
 {% endblock %}

{flask_exts-0.2.3/examples/bootstrap4/templates → flask_exts-0.2.5/examples/bootstrap/templates/bootstrap}/icon.html

@@ -11,14 +11,14 @@ Output: {{ render_icon('heart-fill') }}
 
 <h2>Icon with custom size</h2>
 <pre>{% raw %}{{ render_icon('heart', 32) }}{% endraw %}</pre>
-Output: {{ render_icon('heart', 'h1', size=32) }}
+Output: {{ render_icon('heart', size=32) }}
 
 <h2>Icon with custom size and Bootstrap color</h2>
 <pre>{% raw %}{{ render_icon('heart', 25, 'primary') }}{% endraw %}</pre>
-Output: {{ render_icon('heart', size=25, icon_class='text-primary') }}
+Output: {{ render_icon('heart', size=25, color='primary') }}
 
-<pre>{% raw %}{{ render_icon('heart-fill', 25, icon_class='text-primary') }}{% endraw %}</pre>
-Output: {{ render_icon('heart-fill', size=25, icon_class='text-primary') }}
+<pre>{% raw %}{{ render_icon('heart-fill', 25, color='primary') }}{% endraw %}</pre>
+Output: {{ render_icon('heart-fill', size=25, color='primary') }}
 
 <h2>Icon with custom size and custom color</h2>
 <pre>{% raw %}{{ render_icon('heart', '2em', 'red') }}{% endraw %}</pre>