WuttaWeb 0.5.0__tar.gz → 0.7.0__tar.gz

{wuttaweb-0.5.0 → wuttaweb-0.7.0}/CHANGELOG.md

@@ -5,6 +5,46 @@ 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.7.0 (2024-08-15)
+
+### Feat
+
+- add sane views for 403 Forbidden and 404 Not Found
+- add permission checks for menus, view routes
+- add first-time setup page to create admin user
+- expose User password for editing in master views
+- expose Role permissions for editing
+- expose User "roles" for editing
+- improve widget, rendering for Role notes
+
+### Fix
+
+- add stub for `PersonView.make_user()`
+- allow arbitrary kwargs for `Form.render_vue_field()`
+- make some tweaks for better tailbone compatibility
+- prevent delete for built-in roles
+
+## v0.6.0 (2024-08-13)
+
+### Feat
+
+- add basic Roles view
+- add Users view; improve CRUD master for SQLAlchemy models
+- add People view; improve CRUD master for SQLAlchemy models
+- add basic support for SQLAlchemy model in master view
+- add basic Create support for CRUD master view
+- add basic Delete support for CRUD master view
+- add basic Edit support for CRUD master view
+- add auto-link (to "View") behavior for grid columns
+- add basic support for "view" part of CRUD
+- add basic `Grid` class, and /settings master view
+
+### Fix
+
+- rename MasterView method to `configure_grid()`
+- replace default logo, favicon images
+- tweak labels for Web Libraries config
+
 ## v0.5.0 (2024-08-06)
 
 ### Feat

{wuttaweb-0.5.0 → wuttaweb-0.7.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: WuttaWeb
-Version: 0.5.0
+Version: 0.7.0
 Summary: Web App for Wutta Framework
 Project-URL: Homepage, https://wuttaproject.org/
 Project-URL: Repository, https://forgejo.wuttaproject.org/wutta/wuttaweb
@@ -24,6 +24,7 @@ Classifier: Programming Language :: Python :: 3.11
 Classifier: Topic :: Internet :: WWW/HTTP
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Requires-Python: >=3.8
+Requires-Dist: colanderalchemy
 Requires-Dist: pyramid-beaker
 Requires-Dist: pyramid-deform
 Requires-Dist: pyramid-fanstatic
@@ -32,7 +33,7 @@ Requires-Dist: pyramid-tm
 Requires-Dist: pyramid>=2
 Requires-Dist: waitress
 Requires-Dist: webhelpers2
-Requires-Dist: wuttjamaican[db]>=0.10.0
+Requires-Dist: wuttjamaican[db]>=0.11.1
 Requires-Dist: zope-sqlalchemy>=1.5
 Provides-Extra: docs
 Requires-Dist: furo; extra == 'docs'

wuttaweb-0.7.0/docs/api/wuttaweb/forms.schema.rst

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

wuttaweb-0.7.0/docs/api/wuttaweb/forms.widgets.rst

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

wuttaweb-0.7.0/docs/api/wuttaweb/grids.base.rst

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

wuttaweb-0.7.0/docs/api/wuttaweb/grids.rst

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

{wuttaweb-0.5.0 → wuttaweb-0.7.0}/docs/api/wuttaweb/index.rst

@@ -12,6 +12,10 @@
    db
    forms
    forms.base
+   forms.schema
+   forms.widgets
+   grids
+   grids.base
    handler
    helpers
    menus
@@ -24,4 +28,7 @@
    views.common
    views.essential
    views.master
+   views.people
+   views.roles
    views.settings
+   views.users

wuttaweb-0.7.0/docs/api/wuttaweb/views.people.rst

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

wuttaweb-0.7.0/docs/api/wuttaweb/views.roles.rst

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

wuttaweb-0.7.0/docs/api/wuttaweb/views.users.rst

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

{wuttaweb-0.5.0 → wuttaweb-0.7.0}/pyproject.toml

@@ -6,7 +6,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "WuttaWeb"
-version = "0.5.0"
+version = "0.7.0"
 description = "Web App for Wutta Framework"
 readme = "README.md"
 authors = [{name = "Lance Edgar", email = "lance@edbob.org"}]
@@ -30,6 +30,7 @@ classifiers = [
 ]
 requires-python = ">= 3.8"
 dependencies = [
+        "ColanderAlchemy",
         "pyramid>=2",
         "pyramid_beaker",
         "pyramid_deform",
@@ -38,7 +39,7 @@ dependencies = [
         "pyramid_tm",
         "waitress",
         "WebHelpers2",
-        "WuttJamaican[db]>=0.10.0",
+        "WuttJamaican[db]>=0.11.1",
         "zope.sqlalchemy>=1.5",
 ]
 

{wuttaweb-0.5.0 → wuttaweb-0.7.0}/src/wuttaweb/app.py

@@ -135,6 +135,12 @@ def make_pyramid_config(settings):
     pyramid_config.include('pyramid_mako')
     pyramid_config.include('pyramid_tm')
 
+    # add some permissions magic
+    pyramid_config.add_directive('add_wutta_permission_group',
+                                 'wuttaweb.auth.add_permission_group')
+    pyramid_config.add_directive('add_wutta_permission',
+                                 'wuttaweb.auth.add_permission')
+
     return pyramid_config
 
 

{wuttaweb-0.5.0 → wuttaweb-0.7.0}/src/wuttaweb/auth.py

@@ -148,3 +148,93 @@ class WuttaSecurityPolicy:
         auth = app.get_auth_handler()
         user = self.identity(request)
         return auth.has_permission(self.db_session, user, permission)
+
+
+def add_permission_group(pyramid_config, key, label=None, overwrite=True):
+    """
+    Pyramid directive to add a "permission group" to the app's
+    awareness.
+
+    The app must be made aware of all permissions, so they are exposed
+    when editing a
+    :class:`~wuttjamaican:wuttjamaican.db.model.auth.Role`.  The logic
+    for discovering permissions is in
+    :meth:`~wuttaweb.views.roles.RoleView.get_available_permissions()`.
+
+    This is usually called from within a master view's
+    :meth:`~wuttaweb.views.master.MasterView.defaults()` to establish
+    the permission group which applies to the view model.
+
+    A simple example of usage::
+
+       pyramid_config.add_permission_group('widgets', label="Widgets")
+
+    :param key: Unique key for the permission group.  In the context
+       of a master view, this will be the same as
+       :attr:`~wuttaweb.views.master.MasterView.permission_prefix`.
+
+    :param label: Optional label for the permission group.  If not
+       specified, it is derived from ``key``.
+
+    :param overwrite: If the permission group was already established,
+       this flag controls whether the group's label should be
+       overwritten (with ``label``).
+
+    See also :func:`add_permission()`.
+    """
+    config = pyramid_config.get_settings()['wutta_config']
+    app = config.get_app()
+    def action():
+        perms = pyramid_config.get_settings().get('wutta_permissions', {})
+        if overwrite or key not in perms:
+            group = perms.setdefault(key, {'key': key})
+            group['label'] = label or app.make_title(key)
+        pyramid_config.add_settings({'wutta_permissions': perms})
+    pyramid_config.action(None, action)
+
+
+def add_permission(pyramid_config, groupkey, key, label=None):
+    """
+    Pyramid directive to add a single "permission" to the app's
+    awareness.
+
+    The app must be made aware of all permissions, so they are exposed
+    when editing a
+    :class:`~wuttjamaican:wuttjamaican.db.model.auth.Role`.  The logic
+    for discovering permissions is in
+    :meth:`~wuttaweb.views.roles.RoleView.get_available_permissions()`.
+
+    This is usually called from within a master view's
+    :meth:`~wuttaweb.views.master.MasterView.defaults()` to establish
+    "known" permissions based on master view feature flags
+    (:attr:`~wuttaweb.views.master.MasterView.viewable`,
+    :attr:`~wuttaweb.views.master.MasterView.editable`, etc.).
+
+    A simple example of usage::
+
+       pyramid_config.add_permission('widgets', 'widgets.polish',
+                                     label="Polish all the widgets")
+
+    :param key: Unique key for the permission group.  In the context
+       of a master view, this will be the same as
+       :attr:`~wuttaweb.views.master.MasterView.permission_prefix`.
+
+    :param key: Unique key for the permission.  This should be the
+       "complete" permission name which includes the permission
+       prefix.
+
+    :param label: Optional label for the permission.  If not
+       specified, it is derived from ``key``.
+
+    See also :func:`add_permission_group()`.
+    """
+    def action():
+        config = pyramid_config.get_settings()['wutta_config']
+        app = config.get_app()
+        perms = pyramid_config.get_settings().get('wutta_permissions', {})
+        group = perms.setdefault(groupkey, {'key': groupkey})
+        group.setdefault('label', app.make_title(groupkey))
+        perm = group.setdefault('perms', {}).setdefault(key, {'key': key})
+        perm['label'] = label or app.make_title(key)
+        pyramid_config.add_settings({'wutta_permissions': perms})
+    pyramid_config.action(None, action)

{wuttaweb-0.5.0 → wuttaweb-0.7.0}/src/wuttaweb/forms/__init__.py

@@ -26,6 +26,7 @@ Forms Library
 The ``wuttaweb.forms`` namespace contains the following:
 
 * :class:`~wuttaweb.forms.base.Form`
+* :class:`~wuttaweb.forms.base.FieldList`
 """
 
-from .base import Form
+from .base import Form, FieldList