http2py 0.1.31__tar.gz → 0.1.34__tar.gz

http2py-0.1.34/.gitattributes

@@ -0,0 +1 @@
+*.ipynb linguist-documentation

http2py-0.1.34/.github/workflows/ci.yml

@@ -0,0 +1,236 @@
+name: Continuous Integration (uv)
+# NOTE: publishing uses `uv publish`, which reads UV_PUBLISH_TOKEN -- mapped here
+# from secrets.PYPI_PASSWORD. This repo has no repository-level secrets; it
+# inherits the organization-level PYPI_PASSWORD / SSH_PRIVATE_KEY (visibility:
+# all), which is the same pair other migrated packages in this org publish with.
+#
+# The GitHub Pages job below is gated on [tool.wads.ci.docs].enabled, which is
+# false here: docs/ and docsrc/ were removed from this repo, and the legacy CI's
+# `epythet make . github` call against the now-absent docs is what broke Publish.
+on: [push, pull_request]
+
+# Note: Environment variables (PROJECT_NAME and vars from [tool.wads.ci.env])
+# are set by the read-ci-config action in the setup job and made available
+# to all subsequent jobs via GITHUB_ENV
+
+jobs:
+  # First job: Read configuration from pyproject.toml
+  setup:
+    name: Read Configuration
+    runs-on: ubuntu-latest
+    outputs:
+      project-name: ${{ steps.config.outputs.project-name }}
+      python-versions: ${{ steps.config.outputs.python-versions }}
+      pytest-args: ${{ steps.config.outputs.pytest-args }}
+      coverage-enabled: ${{ steps.config.outputs.coverage-enabled }}
+      exclude-paths: ${{ steps.config.outputs.exclude-paths }}
+      test-on-windows: ${{ steps.config.outputs.test-on-windows }}
+      build-sdist: ${{ steps.config.outputs.build-sdist }}
+      build-wheel: ${{ steps.config.outputs.build-wheel }}
+      metrics-enabled: ${{ steps.config.outputs.metrics-enabled }}
+      metrics-config-path: ${{ steps.config.outputs.metrics-config-path }}
+      metrics-storage-branch: ${{ steps.config.outputs.metrics-storage-branch }}
+      metrics-python-version: ${{ steps.config.outputs.metrics-python-version }}
+      metrics-force-run: ${{ steps.config.outputs.metrics-force-run }}
+      ruff-enabled: ${{ steps.config.outputs.ruff-enabled }}
+      black-enabled: ${{ steps.config.outputs.black-enabled }}
+      mypy-enabled: ${{ steps.config.outputs.mypy-enabled }}
+      docs-enabled: ${{ steps.config.outputs.docs-enabled }}
+
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v7
+
+      - name: Set up Python
+        run: uv python install 3.11
+
+      - name: Read CI Config
+        id: config
+        uses: i2mint/wads/actions/read-ci-config@master
+        with:
+          pyproject-path: .
+
+  # Second job: Validation using the config
+  validation:
+    name: Validation
+    if: "!contains(github.event.head_commit.message, '[skip ci]')"
+    needs: setup
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ${{ fromJson(needs.setup.outputs.python-versions) }}
+
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          enable-cache: true
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: i2mint/wads/actions/setup-python-uv@master
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install System Dependencies
+        uses: i2mint/wads/actions/install-system-deps@master
+        with:
+          pyproject-path: .
+
+      - name: Install Dependencies
+        uses: i2mint/wads/actions/install-deps-uv@master
+
+      - name: Format Source Code
+        if: needs.setup.outputs.ruff-enabled != 'false'
+        run: uvx ruff format .
+
+      - name: Format Source Code (black)
+        if: needs.setup.outputs.black-enabled == 'true'
+        run: uvx black .
+
+      - name: Lint Validation
+        if: needs.setup.outputs.ruff-enabled != 'false'
+        run: uvx ruff check --output-format=github ${{ needs.setup.outputs.project-name }}
+
+      - name: Type Check (mypy)
+        if: needs.setup.outputs.mypy-enabled == 'true'
+        run: uvx mypy ${{ needs.setup.outputs.project-name }}
+
+      - name: Run Tests
+        uses: i2mint/wads/actions/run-tests-uv@master
+        with:
+          root-dir: ${{ needs.setup.outputs.project-name }}
+          pytest-args: ${{ needs.setup.outputs.pytest-args }}
+          exclude-paths: ${{ needs.setup.outputs.exclude-paths }}
+          coverage: ${{ needs.setup.outputs.coverage-enabled }}
+
+      - name: Track Code Metrics
+        if: needs.setup.outputs.metrics-enabled == 'true'
+        uses: i2mint/umpyre/actions/track-metrics@master
+        continue-on-error: true
+        with:
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+          config-path: ${{ needs.setup.outputs.metrics-config-path }}
+          storage-branch: ${{ needs.setup.outputs.metrics-storage-branch }}
+          python-version: ${{ needs.setup.outputs.metrics-python-version }}
+          force-run: ${{ needs.setup.outputs.metrics-force-run }}
+
+  # Optional Windows testing (if enabled in config)
+  windows-validation:
+    name: Windows Tests
+    if: "!contains(github.event.head_commit.message, '[skip ci]') && needs.setup.outputs.test-on-windows == 'true'"
+    needs: setup
+    runs-on: windows-latest
+    continue-on-error: true
+
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          enable-cache: true
+
+      - name: Set up Python
+        uses: i2mint/wads/actions/setup-python-uv@master
+        with:
+          python-version: ${{ fromJson(needs.setup.outputs.python-versions)[0] }}
+
+      - name: Install System Dependencies
+        uses: i2mint/wads/actions/install-system-deps@master
+        with:
+          pyproject-path: .
+
+      - name: Install Dependencies
+        uses: i2mint/wads/actions/install-deps-uv@master
+
+      - name: Run Tests
+        uses: i2mint/wads/actions/run-tests-uv@master
+        with:
+          root-dir: ${{ needs.setup.outputs.project-name }}
+          pytest-args: ${{ needs.setup.outputs.pytest-args }}
+          exclude-paths: ${{ needs.setup.outputs.exclude-paths }}
+
+  # Publishing job
+  publish:
+    name: Publish
+    permissions:
+      contents: write
+    if: "!contains(github.event.head_commit.message, '[skip ci]') && (github.ref == 'refs/heads/master' || github.ref == 'refs/heads/main')"
+    needs: [setup, validation]
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          fetch-depth: 0
+          token: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v7
+
+      - name: Set up Python
+        uses: i2mint/wads/actions/setup-python-uv@master
+        with:
+          python-version: ${{ fromJson(needs.setup.outputs.python-versions)[0] }}
+          create-venv: "false"
+
+      - name: Format Source Code
+        if: needs.setup.outputs.ruff-enabled != 'false'
+        run: uvx ruff format .
+
+      - name: Format Source Code (black)
+        if: needs.setup.outputs.black-enabled == 'true'
+        run: uvx black .
+
+      - name: Update Version Number
+        id: version
+        uses: i2mint/isee/actions/bump-version-number@master
+
+      - name: Build Distribution
+        uses: i2mint/wads/actions/build-dist-uv@master
+        with:
+          sdist: ${{ needs.setup.outputs.build-sdist }}
+          wheel: ${{ needs.setup.outputs.build-wheel }}
+
+      - name: Publish to PyPI
+        uses: i2mint/wads/actions/pypi-publish-uv@master
+        with:
+          pypi-token: ${{ secrets.PYPI_PASSWORD }}
+
+      - name: Force SSH for git remote
+        run: git remote set-url origin git@github.com:${{ github.repository }}.git
+
+      - name: Commit Changes
+        uses: i2mint/wads/actions/git-commit@master
+        with:
+          commit-message: "**CI** Formatted code + Updated version to ${{ env.VERSION }} [skip ci]"
+          ssh-private-key: ${{ secrets.SSH_PRIVATE_KEY }}
+          push: true
+
+      - name: Tag Repository
+        uses: i2mint/wads/actions/git-tag@master
+        with:
+          tag: ${{ env.VERSION }}
+          message: "Release version ${{ env.VERSION }}"
+          push: true
+
+  # Optional GitHub Pages (skipped when [tool.wads.ci.docs].enabled = false)
+  github-pages:
+    name: Publish GitHub Pages
+    permissions:
+      contents: write
+      pages: write
+      id-token: write
+    if: "!contains(github.event.head_commit.message, '[skip ci]') && github.ref == format('refs/heads/{0}', github.event.repository.default_branch) && needs.setup.outputs.docs-enabled != 'false'"
+    needs: [setup, publish]
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: i2mint/epythet/actions/publish-github-pages@master
+        with:
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+          ignore: "tests/,scrap/,examples/"

http2py-0.1.34/.gitignore

@@ -0,0 +1,112 @@
+docs/*
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+.DS_Store
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+.hypothesis/
+.pytest_cache/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# pyenv
+.python-version
+
+# celery beat schedule file
+celerybeat-schedule
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+
+# PyCharm
+.idea
+
+# VS Code
+.vscode

{http2py-0.1.31 → http2py-0.1.34}/PKG-INFO

@@ -1,28 +1,44 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.5
 Name: http2py
-Version: 0.1.31
+Version: 0.1.34
 Summary: Tools to create python binders to http web services.
-Home-page: https://github.com/i2mint/http2py
-License: Apache
-Keywords: webservice,http,requests,API
-Platform: any
-Description-Content-Type: text/markdown
+Project-URL: Homepage, https://github.com/i2mint/http2py
+Project-URL: Repository, https://github.com/i2mint/http2py
+Author: Otosense
+License-Expression: Apache-2.0
 License-File: LICENSE
+Keywords: API,http,requests,webservice
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Internet :: WWW/HTTP
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.10
+Requires-Dist: cw<0.2,>=0.1.1
+Requires-Dist: dill
 Requires-Dist: glom
 Requires-Dist: i2
+Requires-Dist: importlib-resources
 Requires-Dist: ju
+Requires-Dist: pyyaml
 Requires-Dist: requests
-Requires-Dist: argh
-Requires-Dist: PyYAML
-Requires-Dist: importlib_resources
-Dynamic: license-file
+Provides-Extra: dev
+Requires-Dist: pytest-cov>=4.0; extra == 'dev'
+Requires-Dist: pytest>=7.0; extra == 'dev'
+Requires-Dist: ruff>=0.1.0; extra == 'dev'
+Requires-Dist: setuptools; extra == 'dev'
+Description-Content-Type: text/markdown
+
+**Note: A new, lighterweight, more modern replacement: [ho](https://github.com/i2mint/ho)**
+
+# (Http) Requests for humans
 
 [Documentation here](https://i2mint.github.io/http2py/)
 
 `the_one_where_we_have_an_http_service_that_we_want_call_through_normal_looking_python_functions`
 
-# (Http) Requests for humans
-
 Tools to create python binders to http web services.
 Here, we develop python data access to web content through http request such as web services or web pages.
 

{http2py-0.1.31 → http2py-0.1.34}/README.md

@@ -1,9 +1,11 @@
+**Note: A new, lighterweight, more modern replacement: [ho](https://github.com/i2mint/ho)**
+
+# (Http) Requests for humans
+
 [Documentation here](https://i2mint.github.io/http2py/)
 
 `the_one_where_we_have_an_http_service_that_we_want_call_through_normal_looking_python_functions`
 
-# (Http) Requests for humans
-
 Tools to create python binders to http web services.
 Here, we develop python data access to web content through http request such as web services or web pages.
 

http2py-0.1.34/conftest.py

@@ -0,0 +1,18 @@
+"""Pytest configuration for the http2py repository.
+
+``http2py/tests`` stands up a real ``py2http`` web service, so it depends on a
+test-only package that is not one of http2py's declared dependencies. Under
+``--doctest-modules`` an unimportable module is not a single failing test: it
+aborts collection for the whole session. So that directory is excluded here.
+
+CI excludes the same path via ``[tool.wads.ci.testing].exclude_paths`` in
+pyproject.toml, which the wads ``run-tests-uv`` action turns into ``--ignore``
+flags. Repeating it here is what makes a bare ``pytest`` (no flags, e.g. a local
+run or an editor's test runner) behave the same way as CI.
+``tests/test_ci_collection_contract.py`` asserts the two lists stay in
+agreement, so they cannot drift apart silently.
+"""
+
+collect_ignore = [
+    "http2py/tests",
+]

{http2py-0.1.31 → http2py-0.1.34}/http2py/api_pkg_maker.py

@@ -1,12 +1,34 @@
-import argh
+"""Generate an installable python package from an OpenAPI specification.
+
+Given a spec (or the URL of one), :func:`mk_api_pkg` writes a small source
+distribution whose functions are bound to the service's routes.
+
+The sdist is built by running ``setup.py sdist`` in a subprocess. This module
+used to call ``setuptools.sandbox.run_setup``, which modern setuptools no longer
+ships -- so merely *importing* it raised ``ImportError`` and the
+``api-pkg-maker`` console script could not start at all (i2mint/http2py#14).
+The subprocess is also better behaved: ``sandbox.run_setup`` needed the process
+to ``os.chdir`` into the build directory and never came back.
+
+``setuptools`` is still needed to *run* :func:`mk_api_pkg`, but it is
+deliberately NOT a declared dependency of http2py: it is needed by this one
+function, not by ``import http2py``, and a virtualenv created by ``uv`` does not
+ship it. :func:`_check_build_backend` turns its absence into an actionable
+message instead of a subprocess exit code.
+"""
+
 import os
 import shutil
+import subprocess
+import sys
 import tempfile
 from http2py.client import HttpClient
 from datetime import datetime, timezone
-from setuptools import sandbox
 
-OUTPUT_DIR = os.path.join(os.environ["HOME"], "http2py", "api_pkgs")
+#: Where built packages are written. ``expanduser`` rather than
+#: ``os.environ["HOME"]``: the latter is a module-import-time ``KeyError`` on
+#: Windows, which would take the whole package down with it.
+OUTPUT_DIR = os.path.join(os.path.expanduser("~"), "http2py", "api_pkgs")
 
 INIT_FILE_TPL = """from .funcs import {funcs}
 """
@@ -100,6 +122,8 @@ def mk_api_pkg(
         with open(filepath, "w") as file:
             print(content, file=file)
 
+    _check_build_backend()
+
     tempdir = tempfile.mkdtemp()
     try:
         api = HttpClient(openapi_spec=openapi_spec, url=openapi_url)
@@ -137,8 +161,20 @@ def mk_api_pkg(
             filepath=os.path.join(tempdir, f"setup.cfg"), content=setup_cfg_content
         )
         create_file(filepath=os.path.join(tempdir, f"setup.py"), content=SETUP_PY)
-        os.chdir(tempdir)
-        sandbox.run_setup("setup.py", ["sdist"])
+        build = subprocess.run(
+            [sys.executable, "setup.py", "sdist"],
+            cwd=tempdir,
+            capture_output=True,
+            text=True,
+        )
+        if build.returncode != 0:
+            # check=True would raise a CalledProcessError carrying only the exit
+            # status, discarding the captured output that says what went wrong.
+            raise RuntimeError(
+                f"`setup.py sdist` failed (exit {build.returncode}) while building "
+                f"{pkg_name!r}.\n--- stdout ---\n{build.stdout}"
+                f"\n--- stderr ---\n{build.stderr}"
+            )
         pkg_filename = f"{pkg_name}-{pkg_version}.tar.gz"
         if not os.path.exists(OUTPUT_DIR):
             os.makedirs(OUTPUT_DIR)
@@ -150,9 +186,34 @@ def mk_api_pkg(
         shutil.rmtree(tempdir)
 
 
+def _check_build_backend():
+    """Fail early and legibly when the interpreter cannot build an sdist.
+
+    ``setup.py sdist`` needs setuptools in the *subprocess's* interpreter, which
+    is this one. Environments created by ``uv`` (and ``python -m venv
+    --without-pip``) do not have it. Without this check the user sees a bare
+    ``CalledProcessError`` with an exit status and no cause.
+    """
+    import importlib.util
+
+    if importlib.util.find_spec("setuptools") is None:
+        raise RuntimeError(
+            "mk_api_pkg builds a source distribution with `setup.py sdist`, "
+            f"which needs setuptools in {sys.executable}. Install it with: "
+            f"{sys.executable} -m pip install setuptools"
+        )
+
+
 def main():
-    argh.dispatch_command(mk_api_pkg)
+    """Entry point for the ``api-pkg-maker`` console script; returns the exit code.
+
+    ``cw.dispatch`` returns the code rather than exiting, and
+    ``[project.scripts]`` wraps this in ``sys.exit(main())``.
+    """
+    import cw
+
+    return cw.dispatch(mk_api_pkg)
 
 
 if __name__ == "__main__":
-    main()
+    raise SystemExit(main())

{http2py-0.1.31 → http2py-0.1.34}/http2py/authentication.py

@@ -1,3 +1,10 @@
+"""Resolve credentials and build the auth callables that requests will use.
+
+:func:`mk_auth` turns an auth specification -- inline values, environment
+variables, or a JSON credentials file -- into something the request layer can
+attach to outgoing calls.
+"""
+
 import json
 import os
 from pathlib import Path

{http2py-0.1.31 → http2py-0.1.34}/http2py/cli_maker.py

@@ -1,4 +1,14 @@
-import argh
+"""Turn an http-bound python object into a command line interface.
+
+Signatures are first made argparse-friendly (:func:`mk_argparse_friendly`),
+then turned into a parser by :func:`mk_cli` and run by :func:`dispatch_cli`.
+
+The parser is built by ``cw``. Its ``BY_NAME_IF_KWONLY`` naming is what
+reproduces the grammar this module has always produced -- see
+:data:`CLI_CONVENTION`.
+"""
+
+import dataclasses
 from functools import wraps
 from glom import glom
 from inspect import signature
@@ -9,11 +19,30 @@ import requests
 from collections.abc import Callable, Iterable
 import yaml
 
+import cw
+
 from i2.io_trans import JSONAnnotAndDfltIoTrans
 from i2.signatures import set_signature_of_func, Sig, KO
 from http2py import HttpClient
 from http2py.authentication import mk_auth, DFLT_CONFIG_FILENAME
 
+#: How the command line is derived from a signature.
+#:
+#: Every function :func:`register_cli_method` builds has KEYWORD-ONLY parameters
+#: only (plus ``*args``/``**kwargs`` on a no-argument route), because
+#: :func:`Sig.merge_with_sig` is called with ``kind=KO``. For that shape,
+#: ``BY_NAME_IF_KWONLY`` is what reproduces the grammar this module produced
+#: under argh: every parameter is an option, required exactly when it has no
+#: default -- ``get-thing -u UID -p PID [-l LIMIT]``.
+#:
+#: cw's ``ARGH`` default (``BY_NAME_IF_HAS_DEFAULT``) would NOT: it turns a
+#: keyword-only parameter with no default into a *positional*, so every required
+#: API argument would silently change spelling. That is not a cw bug -- it
+#: faithfully reproduces argh's *explicit* ``BY_NAME_IF_HAS_DEFAULT`` policy.
+#: This module never selected a policy, and argh's no-policy legacy mode is the
+#: one that matches ``BY_NAME_IF_KWONLY`` here.
+CLI_CONVENTION = dataclasses.replace(cw.ARGH, naming=cw.BY_NAME_IF_KWONLY)
+
 
 def mk_sig_argparse_friendly(sig):
     """Modifies a signature to change all leading underscores in param names
@@ -103,15 +132,20 @@ def mk_cli(
         for methodname, method in client_details.__dict__.items()
         if getattr(method, "method_spec", None)
     ]
-    parser = argh.ArghParser()
-    parser.add_commands(cli_methods)
-    return parser
+    return cw.mk_parser(cli_methods, convention=CLI_CONVENTION)
 
 
 def dispatch_cli(*args, **kwargs):
-    """Makes a CLI parser with mk_cli and then dispatches it (see documentation of mk_cli)"""
-    parser = mk_cli(*args, **kwargs)
-    parser.dispatch()
+    """Makes a CLI parser with mk_cli and then runs it (see documentation of mk_cli)
+
+    Returns ``None`` when the command ran, and raises ``SystemExit(2)`` on a
+    command-line error -- the same two outcomes the previous argh-based
+    implementation produced. ``cw.run`` *returns* the exit code rather than
+    exiting, so the non-zero case is re-raised here.
+    """
+    code = cw.run(mk_cli(*args, **kwargs))
+    if code:
+        raise SystemExit(code)
 
 
 set_signature_of_func(dispatch_cli, signature(mk_cli))

{http2py-0.1.31 → http2py-0.1.34}/http2py/client.py

@@ -1,3 +1,9 @@
+"""The main entry point: a python object facading an http service.
+
+:class:`HttpClient` takes an OpenAPI specification (a dict, or the URL of one)
+and exposes each declared route as a normal python method.
+"""
+
 from glom import glom
 from requests import request, get, Session
 from i2.errors import AuthorizationError

{http2py-0.1.31 → http2py-0.1.34}/http2py/constants.py

@@ -1,3 +1,5 @@
+"""Content-type strings shared across the request and response machinery."""
+
 JSON_CONTENT_TYPE = "application/json"
 BINARY_CONTENT_TYPE = "application/octet-stream"
 FORM_CONTENT_TYPE = "multipart/form-data"

{http2py-0.1.31 → http2py-0.1.34}/http2py/decorators.py

@@ -1,3 +1,10 @@
+"""Response handling: map http status codes to exceptions, decode the payload.
+
+``handle_json_resp`` / ``handle_binary_resp`` / ``handle_raw_resp`` wrap an
+output transformation so it only ever sees a successful response of the
+expected content type.
+"""
+
 from functools import partial
 from i2.errors import (
     AuthorizationError,

{http2py-0.1.31 → http2py-0.1.34}/http2py/default_configs.py

@@ -1,3 +1,5 @@
+"""Default output transformations used when a method spec does not supply one."""
+
 from http2py.decorators import (
     handle_raw_resp,
     handle_json_resp,