WuttaWeb 0.25.1__tar.gz → 0.27.0__tar.gz

{wuttaweb-0.25.1 → wuttaweb-0.27.0}/CHANGELOG.md

@@ -5,6 +5,42 @@ All notable changes to wuttaweb will be documented in this file.
 The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/)
 and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.html).
 
+## v0.27.0 (2025-12-31)
+
+### Feat
+
+- add wizard for generating new master view code
+- add basic MasterView to show all registered master views
+- add MasterView registry/discovery mechanism
+
+### Fix
+
+- show db backend (dialect name) on App Info page
+- prevent whitespace wrap for tool panel header
+- render datetimes with tooltip showing time delta from now
+- fallback to default continuum plugin logic, when no request
+- flush session when creating new object via MasterView
+- fix page title for Alembic Dashboard
+
+## v0.26.0 (2025-12-28)
+
+### Feat
+
+- add "wizard" for creating new table/model/revision
+- add support for Create Alembic Migration
+- add CopyableTextWidget and `<wutta-copyable-text>` component
+- overhaul how form vue template is rendered
+- add basic views for Alembic Migrations, Dashboard
+- add basic Table views
+
+### Fix
+
+- let checkbox widget show static text instead of Yes/No
+- rename form-saving methods etc. for consistency in MasterView
+- temporarily avoid make_uuid()
+- remove password filter option for Users grid
+- use smarter default for `grid.sort_multiple` based on model class
+
 ## v0.25.1 (2025-12-20)
 
 ### Fix

{wuttaweb-0.25.1 → wuttaweb-0.27.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: WuttaWeb
-Version: 0.25.1
+Version: 0.27.0
 Summary: Web App for Wutta Framework
 Project-URL: Homepage, https://wuttaproject.org/
 Project-URL: Repository, https://forgejo.wuttaproject.org/wutta/wuttaweb
@@ -37,9 +37,10 @@ Requires-Dist: pyramid-fanstatic
 Requires-Dist: pyramid-mako
 Requires-Dist: pyramid-tm
 Requires-Dist: pyramid>=2
+Requires-Dist: sqlalchemy-utils
 Requires-Dist: waitress
 Requires-Dist: webhelpers2
-Requires-Dist: wuttjamaican[db]>=0.27.0
+Requires-Dist: wuttjamaican[db]>=0.28.1
 Requires-Dist: zope-sqlalchemy>=1.5
 Provides-Extra: continuum
 Requires-Dist: wutta-continuum>=0.3.0; extra == 'continuum'
@@ -52,6 +53,7 @@ Requires-Dist: pylint; extra == 'tests'
 Requires-Dist: pytest; extra == 'tests'
 Requires-Dist: pytest-cov; extra == 'tests'
 Requires-Dist: tox; extra == 'tests'
+Requires-Dist: webtest; extra == 'tests'
 Description-Content-Type: text/markdown
 
 

wuttaweb-0.27.0/docs/api/wuttaweb.views.alembic.rst

@@ -0,0 +1,6 @@
+
+``wuttaweb.views.alembic``
+==========================
+
+.. automodule:: wuttaweb.views.alembic
+   :members:

wuttaweb-0.27.0/docs/api/wuttaweb.views.tables.rst

@@ -0,0 +1,6 @@
+
+``wuttaweb.views.tables``
+=========================
+
+.. automodule:: wuttaweb.views.tables
+   :members:

wuttaweb-0.27.0/docs/api/wuttaweb.views.views.rst

@@ -0,0 +1,6 @@
+
+``wuttaweb.views.views``
+========================
+
+.. automodule:: wuttaweb.views.views
+   :members:

{wuttaweb-0.25.1 → wuttaweb-0.27.0}/docs/conf.py

@@ -28,6 +28,7 @@ templates_path = ["_templates"]
 exclude_patterns = ["_build", "Thumbs.db", ".DS_Store"]
 
 intersphinx_mapping = {
+    "alembic": ("https://alembic.sqlalchemy.org/en/latest/", None),
     "colander": ("https://docs.pylonsproject.org/projects/colander/en/latest/", None),
     "deform": ("https://docs.pylonsproject.org/projects/deform/en/latest/", None),
     "fanstatic": ("https://www.fanstatic.org/en/latest/", None),

{wuttaweb-0.25.1 → wuttaweb-0.27.0}/docs/index.rst

@@ -58,6 +58,7 @@ the narrative docs are pretty scant.  That will eventually change.
    api/wuttaweb.subscribers
    api/wuttaweb.util
    api/wuttaweb.views
+   api/wuttaweb.views.alembic
    api/wuttaweb.views.auth
    api/wuttaweb.views.base
    api/wuttaweb.views.batch
@@ -70,8 +71,10 @@ the narrative docs are pretty scant.  That will eventually change.
    api/wuttaweb.views.reports
    api/wuttaweb.views.roles
    api/wuttaweb.views.settings
+   api/wuttaweb.views.tables
    api/wuttaweb.views.upgrades
    api/wuttaweb.views.users
+   api/wuttaweb.views.views
 
 
 Indices and tables

{wuttaweb-0.25.1 → wuttaweb-0.27.0}/pyproject.toml

@@ -6,7 +6,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "WuttaWeb"
-version = "0.25.1"
+version = "0.27.0"
 description = "Web App for Wutta Framework"
 readme = "README.md"
 authors = [{name = "Lance Edgar", email = "lance@wuttaproject.org"}]
@@ -42,9 +42,10 @@ dependencies = [
         "pyramid_fanstatic",
         "pyramid_mako",
         "pyramid_tm",
+        "SQLAlchemy-Utils",
         "waitress",
         "WebHelpers2",
-        "WuttJamaican[db]>=0.27.0",
+        "WuttJamaican[db]>=0.28.1",
         "zope.sqlalchemy>=1.5",
 ]
 
@@ -52,7 +53,7 @@ dependencies = [
 [project.optional-dependencies]
 continuum = ["Wutta-Continuum>=0.3.0"]
 docs = ["Sphinx", "furo", "sphinxcontrib-programoutput"]
-tests = ["pylint", "pytest", "pytest-cov", "tox"]
+tests = ["pylint", "pytest", "pytest-cov", "tox", "WebTest"]
 
 
 [project.entry-points."fanstatic.libraries"]

{wuttaweb-0.25.1 → wuttaweb-0.27.0}/src/wuttaweb/app.py

@@ -164,6 +164,11 @@ def make_pyramid_config(settings):
     )
     pyramid_config.add_directive("add_wutta_permission", "wuttaweb.auth.add_permission")
 
+    # add some more config magic
+    pyramid_config.add_directive(
+        "add_wutta_master_view", "wuttaweb.conf.add_master_view"
+    )
+
     return pyramid_config
 
 

wuttaweb-0.27.0/src/wuttaweb/code-templates/new-master-view.mako

@@ -0,0 +1,116 @@
+## -*- coding: utf-8; mode: python; -*-
+# -*- coding: utf-8; -*-
+"""
+Master view for ${model_title_plural}
+"""
+
+% if model_option == "model_class":
+from ${model_module} import ${model_name}
+% endif
+
+from wuttaweb.views import MasterView
+
+
+class ${class_name}(MasterView):
+    """
+    Master view for ${model_title_plural}
+    """
+    % if model_option == "model_class":
+    model_class = ${model_name}
+    % else:
+    model_name = "${model_name}"
+    % endif
+    model_title = "${model_title}"
+    model_title_plural = "${model_title_plural}"
+
+    route_prefix = "${route_prefix}"
+    % if permission_prefix != route_prefix:
+    permission_prefix = "${permission_prefix}"
+    % endif
+    url_prefix = "${url_prefix}"
+    % if template_prefix != url_prefix:
+    template_prefix = "${template_prefix}"
+    % endif
+
+    % if not listable:
+    listable = False
+    % endif
+    creatable = ${creatable}
+    % if not viewable:
+    viewable = ${viewable}
+    % endif
+    editable = ${editable}
+    deletable = ${deletable}
+
+    % if listable and model_option == "model_name":
+    filterable = False
+    sort_on_backend = False
+    paginate_on_backend = False
+    % endif
+
+    % if grid_columns:
+    grid_columns = [
+        % for field in grid_columns:
+        "${field}",
+        % endfor
+    ]
+    % elif model_option == "model_name":
+    # TODO: must specify grid columns before the list view will work:
+    # grid_columns = [
+    #     "foo",
+    #     "bar",
+    # ]
+    % endif
+
+    % if form_fields:
+    form_fields = [
+        % for field in form_fields:
+        "${field}",
+        % endfor
+    ]
+    % elif model_option == "model_name":
+    # TODO: must specify form fields before create/view/edit/delete will work:
+    # form_fields = [
+    #     "foo",
+    #     "bar",
+    # ]
+    % endif
+
+    % if listable and model_option == "model_name":
+    def get_grid_data(self, columns=None, session=None):
+        data = []
+
+        # TODO: you should return whatever data is needed for the grid.
+        # it is expected to be a list of dicts, with keys corresponding
+        # to grid columns.
+        # 
+        #     data = [
+        #         {"foo": 1, "bar": "abc"},
+        #         {"foo": 2, "bar": "def"},
+        #     ]
+
+        return data
+    % endif
+
+    % if listable:
+    def configure_grid(self, grid):
+        g = grid
+        super().configure_grid(g)
+
+        # TODO: tweak grid however you need here
+        #
+        #     g.set_label("foo", "FOO")
+        #     g.set_link("foo")
+        #     g.set_renderer("foo", self.render_special_field)
+    % endif
+
+
+def defaults(config, **kwargs):
+    base = globals()
+
+    ${class_name} = kwargs.get('${class_name}', base['${class_name}'])
+    ${class_name}.defaults(config)
+
+
+def includeme(config):
+    defaults(config)

wuttaweb-0.27.0/src/wuttaweb/code-templates/new-table.mako

@@ -0,0 +1,68 @@
+## -*- coding: utf-8; mode: python; -*-
+# -*- coding: utf-8; -*-
+"""
+Model definition for ${model_title_plural}
+"""
+
+import sqlalchemy as sa
+from sqlalchemy import orm
+
+from wuttjamaican.db import model
+
+
+class ${model_name}(model.Base):
+    """
+    ${description}
+    """
+    __tablename__ = "${table_name}"
+    % if any([c["data_type"]["type"] == "_fk_uuid_" for c in columns]):
+    __table_args__ = (
+        % for column in columns:
+        % if column["data_type"]["type"] == "_fk_uuid_":
+        sa.ForeignKeyConstraint(["${column['name']}"], ["${column['data_type']['reference']}.uuid"],
+                                name="${table_name}_fk_${column['data_type']['reference']}"),
+        % endif
+        % endfor
+    )
+    % endif
+    % if versioned:
+    % if all([c["versioned"] for c in columns]):
+    __versioned__ = {}
+    % else:
+    __versioned__ = {
+        "exclude": [
+            % for column in columns:
+            % if not column["versioned"]:
+            "${column['name']}",
+            % endif
+            % endfor
+        ],
+    }
+    % endif
+    % endif
+    __wutta_hint__ = {
+        "model_title": "${model_title}",
+        "model_title_plural": "${model_title_plural}",
+    }
+    % for column in columns:
+
+    % if column["name"] == "uuid":
+    uuid = model.uuid_column()
+    % else:
+    ${column["name"]} = sa.Column(${column["formatted_data_type"]}, nullable=${column["nullable"]}, doc="""
+    ${column["description"] or ""}
+    """)
+    % if column["data_type"]["type"] == "_fk_uuid_" and column["relationship"]:
+    ${column["relationship"]["name"]} = orm.relationship(
+        "${column['relationship']['reference_model']}",
+        doc="""
+        ${column["description"] or ""}
+        """)
+    % endif
+    % endif
+    % endfor
+
+    # TODO: you usually should define the __str__() method
+
+    # def __str__(self):
+    #     return self.name or ""

wuttaweb-0.27.0/src/wuttaweb/conf.py

@@ -0,0 +1,89 @@
+# -*- coding: utf-8; -*-
+################################################################################
+#
+#  wuttaweb -- Web App for Wutta Framework
+#  Copyright © 2024-2025 Lance Edgar
+#
+#  This file is part of Wutta Framework.
+#
+#  Wutta Framework is free software: you can redistribute it and/or modify it
+#  under the terms of the GNU General Public License as published by the Free
+#  Software Foundation, either version 3 of the License, or (at your option) any
+#  later version.
+#
+#  Wutta Framework is distributed in the hope that it will be useful, but
+#  WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#  FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for
+#  more details.
+#
+#  You should have received a copy of the GNU General Public License along with
+#  Wutta Framework.  If not, see <http://www.gnu.org/licenses/>.
+#
+################################################################################
+"""
+Config Extension
+"""
+
+from wuttjamaican.conf import WuttaConfigExtension
+
+
+class WuttaWebConfigExtension(WuttaConfigExtension):
+    """
+    Config extension for WuttaWeb.
+
+    This sets the default plugin used for SQLAlchemy-Continuum, to
+    :class:`~wuttaweb.db.continuum.WuttaWebContinuumPlugin`.  Which is
+    only relevant if Wutta-Continuum is installed and enabled.  For
+    more info see :doc:`wutta-continuum:index`.
+    """
+
+    key = "wuttaweb"
+
+    def configure(self, config):  # pylint: disable=empty-docstring
+        """ """
+        config.setdefault(
+            "wutta_continuum.wutta_plugin_spec",
+            "wuttaweb.db.continuum:WuttaWebContinuumPlugin",
+        )
+
+
+def add_master_view(config, master):
+    """
+    Pyramid directive to add the given ``MasterView`` subclass to the
+    app's registry.
+
+    This allows the app to dynamically present certain options for
+    admin features etc.
+
+    This is normally called automatically for all master views, within
+    the :meth:`~wuttaweb.views.master.MasterView.defaults()` method.
+
+    Should you need to call this yourself, do not call it directly but
+    instead make a similar call via the Pyramid config object::
+
+       pyramid_config.add_wutta_master_view(PoserWidgetView)
+
+    :param config: Reference to the Pyramid config object.
+
+    :param master: Reference to a
+       :class:`~wuttaweb.views.master.MasterView` subclass.
+
+    This function is involved in app startup; once that phase is
+    complete you can inspect the master views like so::
+
+       master_views = request.registry.settings["wuttaweb_master_views"]
+
+       # find master views for given model class
+       user_views = master_views.get(model.User, [])
+
+       # some master views are registered by model name instead (if no class)
+       email_views = master_views.get("email_setting", [])
+    """
+    key = master.get_model_class() or master.get_model_name()
+
+    def action():
+        master_views = config.get_settings().get("wuttaweb_master_views", {})
+        master_views.setdefault(key, []).append(master)
+        config.add_settings({"wuttaweb_master_views": master_views})
+
+    config.action(None, action)

{wuttaweb-0.25.1 → wuttaweb-0.27.0}/src/wuttaweb/db/continuum.py

@@ -48,11 +48,15 @@ else:
             request = get_current_request()
             if request:
                 return request.client_addr
-            return None
+
+            # nb. no request presumably means running as cli
+            return super().get_remote_addr(uow, session)
 
         def get_user_id(self, uow, session):  # pylint: disable=empty-docstring
             """ """
             request = get_current_request()
-            if request and request.user:
-                return request.user.uuid
-            return None
+            if request:
+                return request.user.uuid if request.user else None
+
+            # nb. no request presumably means running as cli
+            return super().get_user_id(uow, session)