WuttaWeb 0.17.1__tar.gz → 0.18.0__tar.gz

{wuttaweb-0.17.1 → wuttaweb-0.18.0}/CHANGELOG.md

@@ -5,6 +5,20 @@ 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.18.0 (2024-12-18)
+
+### Feat
+
+- add basic support for running in ASGI context
+- add support for running via uvicorn; `wutta webapp` command
+
+## v0.17.2 (2024-12-17)
+
+### Fix
+
+- add basic support for grid filters for Date fields
+- fix style bug for grid "add filter" autocomplete
+
 ## v0.17.1 (2024-12-16)
 
 ### Fix

{wuttaweb-0.17.1 → wuttaweb-0.18.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: WuttaWeb
-Version: 0.17.1
+Version: 0.18.0
 Summary: Web App for Wutta Framework
 Project-URL: Homepage, https://wuttaproject.org/
 Project-URL: Repository, https://forgejo.wuttaproject.org/wutta/wuttaweb
@@ -25,6 +25,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: asgiref
 Requires-Dist: colanderalchemy
 Requires-Dist: humanize
 Requires-Dist: markdown
@@ -38,13 +39,14 @@ Requires-Dist: pyramid-tm
 Requires-Dist: pyramid>=2
 Requires-Dist: waitress
 Requires-Dist: webhelpers2
-Requires-Dist: wuttjamaican[db]>=0.18.0
+Requires-Dist: wuttjamaican[db]>=0.18.1
 Requires-Dist: zope-sqlalchemy>=1.5
 Provides-Extra: continuum
 Requires-Dist: wutta-continuum; extra == 'continuum'
 Provides-Extra: docs
 Requires-Dist: furo; extra == 'docs'
 Requires-Dist: sphinx; extra == 'docs'
+Requires-Dist: sphinxcontrib-programoutput; extra == 'docs'
 Provides-Extra: tests
 Requires-Dist: pytest-cov; extra == 'tests'
 Requires-Dist: tox; extra == 'tests'

wuttaweb-0.18.0/docs/api/wuttaweb.cli.rst

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

wuttaweb-0.18.0/docs/api/wuttaweb.cli.webapp.rst

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

{wuttaweb-0.17.1 → wuttaweb-0.18.0}/docs/conf.py

@@ -21,6 +21,7 @@ extensions = [
     'sphinx.ext.intersphinx',
     'sphinx.ext.viewcode',
     'sphinx.ext.todo',
+    'sphinxcontrib.programoutput',
 ]
 
 templates_path = ['_templates']

{wuttaweb-0.17.1 → wuttaweb-0.18.0}/docs/index.rst

@@ -19,6 +19,7 @@ the narrative docs are pretty scant.  That will eventually change.
    :caption: Documentation:
 
    glossary
+   narr/cli/index
    narr/templates/index
 
 .. toctree::
@@ -28,6 +29,8 @@ the narrative docs are pretty scant.  That will eventually change.
    api/wuttaweb
    api/wuttaweb.app
    api/wuttaweb.auth
+   api/wuttaweb.cli
+   api/wuttaweb.cli.webapp
    api/wuttaweb.conf
    api/wuttaweb.db
    api/wuttaweb.db.continuum

wuttaweb-0.18.0/docs/narr/cli/builtin.rst

@@ -0,0 +1,28 @@
+
+===================
+ Built-in Commands
+===================
+
+Below are the :term:`subcommands <subcommand>` which come with
+WuttaWeb.
+
+
+.. _wutta-webapp:
+
+``wutta webapp``
+----------------
+
+Run the web app, according to config file(s).
+
+This command is a convenience only; under the hood it can run `uvicorn
+<https://www.uvicorn.org/#uvicornrun>`_ but by default will run
+whatever :ref:`pserve <pyramid:pserve_script>` is setup to do (which
+usually is `waitress
+<https://docs.pylonsproject.org/projects/waitress/en/latest/index.html>`_).
+
+Ultimately it's all up to config, so run different web apps with
+different config files.
+
+Defined in: :mod:`wuttaweb.cli.webapp`
+
+.. program-output:: wutta webapp --help

wuttaweb-0.18.0/docs/narr/cli/index.rst

@@ -0,0 +1,14 @@
+
+==============
+ Command Line
+==============
+
+There isn't much to the command line for WuttaWeb, but here it is.
+
+For more general info about CLI see
+:doc:`wuttjamaican:narr/cli/index`.
+
+.. toctree::
+   :maxdepth: 2
+
+   builtin

{wuttaweb-0.17.1 → wuttaweb-0.18.0}/pyproject.toml

@@ -6,7 +6,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "WuttaWeb"
-version = "0.17.1"
+version = "0.18.0"
 description = "Web App for Wutta Framework"
 readme = "README.md"
 authors = [{name = "Lance Edgar", email = "lance@wuttaproject.org"}]
@@ -30,6 +30,7 @@ classifiers = [
 ]
 requires-python = ">= 3.8"
 dependencies = [
+        "asgiref",
         "ColanderAlchemy",
         "humanize",
         "markdown",
@@ -43,32 +44,32 @@ dependencies = [
         "pyramid_tm",
         "waitress",
         "WebHelpers2",
-        "WuttJamaican[db]>=0.18.0",
+        "WuttJamaican[db]>=0.18.1",
         "zope.sqlalchemy>=1.5",
 ]
 
 
 [project.optional-dependencies]
 continuum = ["Wutta-Continuum"]
-docs = ["Sphinx", "furo"]
+docs = ["Sphinx", "furo", "sphinxcontrib-programoutput"]
 tests = ["pytest-cov", "tox"]
 
 
 [project.entry-points."fanstatic.libraries"]
 wuttaweb_img = "wuttaweb.static:img"
 
-
 [project.entry-points."paste.app_factory"]
 main = "wuttaweb.app:main"
 
-
 [project.entry-points."wutta.app.providers"]
 wuttaweb = "wuttaweb.app:WebAppProvider"
 
-
 [project.entry-points."wutta.config.extensions"]
 wuttaweb = "wuttaweb.conf:WuttaWebConfigExtension"
 
+[project.entry-points."wutta.typer_imports"]
+wuttaweb = "wuttaweb.cli"
+
 
 [project.urls]
 Homepage = "https://wuttaproject.org/"

{wuttaweb-0.17.1 → wuttaweb-0.18.0}/src/wuttaweb/app.py

@@ -24,17 +24,22 @@
 Application
 """
 
+import logging
 import os
 
 from wuttjamaican.app import AppProvider
 from wuttjamaican.conf import make_config
 
+from asgiref.wsgi import WsgiToAsgi
 from pyramid.config import Configurator
 
 import wuttaweb.db
 from wuttaweb.auth import WuttaSecurityPolicy
 
 
+log = logging.getLogger(__name__)
+
+
 class WebAppProvider(AppProvider):
     """
     The :term:`app provider` for WuttaWeb.  This adds some methods to
@@ -87,17 +92,20 @@ def make_wutta_config(settings, config_maker=None, **kwargs):
 
     If this config file path cannot be discovered, an error is raised.
     """
-    # validate config file path
-    path = settings.get('wutta.config')
-    if not path or not os.path.exists(path):
-        raise ValueError("Please set 'wutta.config' in [app:main] "
-                         "section of config to the path of your "
-                         "config file.  Lame, but necessary.")
-
-    # make config, add to settings
-    config_maker = config_maker or make_config
-    wutta_config = config_maker(path, **kwargs)
-    settings['wutta_config'] = wutta_config
+    wutta_config = settings.get('wutta_config')
+    if not wutta_config:
+
+        # validate config file path
+        path = settings.get('wutta.config')
+        if not path or not os.path.exists(path):
+            raise ValueError("Please set 'wutta.config' in [app:main] "
+                             "section of config to the path of your "
+                             "config file.  Lame, but necessary.")
+
+        # make config, add to settings
+        config_maker = config_maker or make_config
+        wutta_config = config_maker(path, **kwargs)
+        settings['wutta_config'] = wutta_config
 
     # configure database sessions
     if hasattr(wutta_config, 'appdb_engine'):
@@ -148,19 +156,18 @@ def make_pyramid_config(settings):
 
 def main(global_config, **settings):
     """
-    This function returns a Pyramid WSGI application.
-
-    Typically there is no need to call this function directly, but it
-    may be configured as the web app entry point like so:
-
-    .. code-block:: ini
-
-       [app:main]
-       use = egg:wuttaweb
-
-    The app returned by this function is quite minimal, so most apps
-    will need to define their own ``main()`` function, and use that
-    instead.
+    Make and return the WSGI application, per given settings.
+
+    This function is designed to be called via Paste, hence it does
+    require params and therefore can't be used directly as app factory
+    for general WSGI servers.  For the latter see
+    :func:`make_wsgi_app()` instead.
+
+    And this *particular* function is not even that useful, it only
+    constructs an app with minimal views built-in to WuttaWeb.  Most
+    apps will define their own ``main()`` function (e.g.  as
+    ``poser.web.app:main``), similar to this one but with additional
+    views and other config.
     """
     wutta_config = make_wutta_config(settings)
     pyramid_config = make_pyramid_config(settings)
@@ -170,3 +177,71 @@ def main(global_config, **settings):
     pyramid_config.include('wuttaweb.views')
 
     return pyramid_config.make_wsgi_app()
+
+
+def make_wsgi_app(main_app=None, config=None):
+    """
+    Make and return a WSGI app, using the given Paste app factory.
+
+    See also :func:`make_asgi_app()` for the ASGI equivalent.
+
+    This function could be used directly for general WSGI servers
+    (e.g. uvicorn), ***if*** you just want the built-in :func:`main()`
+    app factory.
+
+    But most likely you do not, in which case you must define your own
+    function and call this one with your preferred app factory::
+
+       from wuttaweb.app import make_wsgi_app
+
+       def my_main(global_config, **settings):
+           # TODO: build your app
+           pass
+
+       def make_my_wsgi_app():
+           return make_wsgi_app(my_main)
+
+    So ``make_my_wsgi_app()`` could then be used as-is for general
+    WSGI servers.  However, note that this approach will require
+    setting the ``WUTTA_CONFIG_FILES`` environment variable, unless
+    running via :ref:`wutta-webapp`.
+
+    :param main_app: Either a Paste-compatible app factory, or
+       :term:`spec` for one.  If not specified, the built-in
+       :func:`main()` is assumed.
+
+    :param config: Optional :term:`config object`.  If not specified,
+       one is created based on ``WUTTA_CONFIG_FILES`` environment
+       variable.
+    """
+    if not config:
+        config = make_config()
+    app = config.get_app()
+
+    # extract pyramid settings
+    settings = config.get_dict('app:main')
+
+    # keep same config object
+    settings['wutta_config'] = config
+
+    # determine the app factory
+    if isinstance(main_app, str):
+        make_wsgi_app = app.load_object(main_app)
+    elif callable(main_app):
+        make_wsgi_app = main_app
+    else:
+        raise ValueError("main_app must be spec or callable")
+
+    # construct a pyramid app "per usual"
+    return make_wsgi_app({}, **settings)
+
+
+def make_asgi_app(main_app=None, config=None):
+    """
+    Make and return a ASGI app, using the given Paste app factory.
+
+    This works the same as :func:`make_wsgi_app()` and should be
+    called in the same way etc.
+    """
+    wsgi_app = make_wsgi_app(main_app, config=config)
+    return WsgiToAsgi(wsgi_app)

wuttaweb-0.18.0/src/wuttaweb/cli/__init__.py

@@ -0,0 +1,28 @@
+# -*- coding: utf-8; -*-
+################################################################################
+#
+#  wuttaweb -- Web App for Wutta Framework
+#  Copyright © 2024 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/>.
+#
+################################################################################
+"""
+WuttaWeb - ``wutta`` subcommands
+"""
+
+# nb. must bring in all modules for discovery to work
+from . import webapp

wuttaweb-0.18.0/src/wuttaweb/cli/webapp.py

@@ -0,0 +1,88 @@
+# -*- coding: utf-8; -*-
+################################################################################
+#
+#  wuttaweb -- Web App for Wutta Framework
+#  Copyright © 2024 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/>.
+#
+################################################################################
+"""
+See also: :ref:`wutta-webapp`
+"""
+
+import os
+import sys
+from typing_extensions import Annotated
+
+import typer
+from pyramid.scripts import pserve
+
+from wuttjamaican.cli import wutta_typer
+
+
+@wutta_typer.command()
+def webapp(
+        ctx: typer.Context,
+        auto_reload: Annotated[
+            bool,
+            typer.Option('--reload', '-r',
+                         help="Auto-reload web app when files change.")] = False,
+):
+    """
+    Run the configured web app
+    """
+    config = ctx.parent.wutta_config
+
+    # we'll need config file(s) to specify for web app
+    if not config.files_read:
+        sys.stderr.write("no config files found!\n")
+        sys.exit(1)
+
+    runner = config.get(f'{config.appname}.web.app.runner', default='pserve')
+    if runner == 'pserve':
+
+        # run pserve
+        argv = ['pserve', f'file+ini:{config.files_read[0]}']
+        if ctx.params['auto_reload']:
+            argv.append('--reload')
+        pserve.main(argv=argv)
+
+    elif runner == 'uvicorn':
+
+        import uvicorn
+
+        # need service details from config
+        spec = config.require(f'{config.appname}.web.app.spec')
+        kw = {
+            'host': config.get(f'{config.appname}.web.app.host', default='127.0.0.1'),
+            'port': config.get_int(f'{config.appname}.web.app.port', default=8000),
+            'reload': ctx.params['auto_reload'],
+            'reload_dirs': config.get_list(f'{config.appname}.web.app.reload_dirs'),
+            'factory': config.get_bool(f'{config.appname}.web.app.factory', default=False),
+            'interface': config.get(f'{config.appname}.web.app.interface', default='auto'),
+        }
+
+        # also must inject our config files to env, since there is no
+        # other way to specify when running via uvicorn
+        os.environ['WUTTA_CONFIG_FILES'] = os.pathsep.join(config.files_read)
+
+        # run uvicorn
+        uvicorn.run(spec, **kw)
+
+    else:
+        sys.stderr.write(f"unknown web app runner: {runner}\n")
+        sys.exit(2)

{wuttaweb-0.17.1 → wuttaweb-0.18.0}/src/wuttaweb/grids/base.py

@@ -1976,6 +1976,7 @@ class Grid:
         for filtr in self.filters.values():
             filters.append({
                 'key': filtr.key,
+                'data_type': filtr.data_type,
                 'active': filtr.active,
                 'visible': filtr.active,
                 'verbs': filtr.get_verbs(),

{wuttaweb-0.17.1 → wuttaweb-0.18.0}/src/wuttaweb/grids/filters.py

@@ -24,6 +24,7 @@
 Grid Filters
 """
 
+import datetime
 import logging
 
 import sqlalchemy as sa
@@ -69,6 +70,18 @@ class GridFilter:
 
        Display label for the filter field.
 
+    .. attribute:: data_type
+
+       Simplistic "data type" which the filter supports.  So far this
+       will be one of:
+
+       * ``'string'``
+       * ``'date'``
+
+       Note that this mainly applies to the "value input" used by the
+       filter.  There is no data type for boolean since it does not
+       need a value input; the verb is enough.
+
     .. attribute:: active
 
        Boolean indicating whether the filter is currently active.
@@ -110,12 +123,18 @@ class GridFilter:
 
        See also :attr:`default_verb`.
     """
+    data_type = 'string'
     default_verbs = ['equal', 'not_equal']
 
     default_verb_labels = {
         'is_any':               "is any",
         'equal':                "equal to",
         'not_equal':            "not equal to",
+        'greater_than':         "greater than",
+        'greater_equal':        "greater than or equal to",
+        'less_than':            "less than",
+        'less_equal':           "less than or equal to",
+        # 'between':              "between",
         'is_true':              "is true",
         'is_false':             "is false",
         'is_false_null':        "is false or null",
@@ -343,6 +362,42 @@ class AlchemyFilter(GridFilter):
             self.model_property != value,
         ))
 
+    def filter_greater_than(self, query, value):
+        """
+        Filter data with a greater than (``>``) condition.
+        """
+        value = self.coerce_value(value)
+        if value is None:
+            return query
+        return query.filter(self.model_property > value)
+
+    def filter_greater_equal(self, query, value):
+        """
+        Filter data with a greater than or equal (``>=``) condition.
+        """
+        value = self.coerce_value(value)
+        if value is None:
+            return query
+        return query.filter(self.model_property >= value)
+
+    def filter_less_than(self, query, value):
+        """
+        Filter data with a less than (``<``) condition.
+        """
+        value = self.coerce_value(value)
+        if value is None:
+            return query
+        return query.filter(self.model_property < value)
+
+    def filter_less_equal(self, query, value):
+        """
+        Filter data with a less than or equal (``<=``) condition.
+        """
+        value = self.coerce_value(value)
+        if value is None:
+            return query
+        return query.filter(self.model_property <= value)
+
     def filter_is_null(self, query, value):
         """
         Filter data with an ``IS NULL`` query.  The value is ignored.
@@ -467,9 +522,52 @@ class BooleanAlchemyFilter(AlchemyFilter):
                                    self.model_property == None))
 
 
+class DateAlchemyFilter(AlchemyFilter):
+    """
+    SQLAlchemy filter option for a
+    :class:`sqlalchemy:sqlalchemy.types.Date` column.
+
+    Subclass of :class:`AlchemyFilter`.
+    """
+    data_type = 'date'
+    default_verbs = [
+        'equal',
+        'not_equal',
+        'greater_than',
+        'greater_equal',
+        'less_than',
+        'less_equal',
+        # 'between',
+    ]
+
+    default_verb_labels = {
+        'equal':                "on",
+        'not_equal':            "not on",
+        'greater_than':         "after",
+        'greater_equal':        "on or after",
+        'less_than':            "before",
+        'less_equal':           "on or before",
+        # 'between':              "between",
+    }
+
+    def coerce_value(self, value):
+        """ """
+        if value:
+            if isinstance(value, datetime.date):
+                return value
+
+            try:
+                dt = datetime.datetime.strptime(value, '%Y-%m-%d')
+            except ValueError:
+                log.warning("invalid date value: %s", value)
+            else:
+                return dt.date()
+
+
 default_sqlalchemy_filters = {
     None: AlchemyFilter,
     sa.String: StringAlchemyFilter,
     sa.Text: StringAlchemyFilter,
     sa.Boolean: BooleanAlchemyFilter,
+    sa.Date: DateAlchemyFilter,
 }