kinto 19.4.0__tar.gz → 19.6.0__tar.gz

{kinto-19.4.0 → kinto-19.6.0}/.github/workflows/publish.yml

@@ -73,6 +73,14 @@ jobs:
       - name: Check out the repo
         uses: actions/checkout@v4
 
+      - name: Set up QEMU
+        uses: docker/setup-qemu-action@v3
+
+      - name: Enable multiplatform builds
+        uses: docker/setup-buildx-action@v3
+        with:
+          buildkitd-flags: "--debug" # Enable detailed logging
+
       - name: Log in to Docker Hub
         uses: docker/login-action@v3
         with:
@@ -93,3 +101,4 @@ jobs:
           push: true
           tags: ${{ steps.meta.outputs.tags }}
           labels: ${{ steps.meta.outputs.labels }}
+          platforms: linux/amd64,linux/arm64

kinto-19.6.0/.github/workflows/scheduled.yml

@@ -0,0 +1,85 @@
+name: Run scheduled jobs
+
+on:
+  schedule:
+    - cron: '0 0 * * *' # Runs daily at midnight
+
+jobs:
+  update-kinto-admin:
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        shell: bash
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Get current version
+        id: current_version
+        run: |
+          CURRENT_VERSION="$(cat kinto/plugins/admin/VERSION)"
+          echo "Current Version: $CURRENT_VERSION"
+          echo "version=$CURRENT_VERSION" >> "$GITHUB_OUTPUT"
+
+      - name: Get latest release version
+        id: latest_release_version
+        run: |
+          LATEST_RELEASE_VERSION=$(curl -s https://api.github.com/repos/Kinto/kinto-admin/releases/latest | jq -r .tag_name)
+          echo "Latest Version: $LATEST_RELEASE_VERSION"
+          echo "version=${LATEST_RELEASE_VERSION#v}" >> "$GITHUB_OUTPUT"
+
+      - name: Compare versions
+        id: compare_versions
+        env:
+          LATEST_RELEASE_VERSION: ${{ steps.latest_release_version.outputs.version }}
+          CURRENT_VERSION: ${{ steps.current_version.outputs.version }}
+        run: |
+          LATEST_VERSION=$(npx --yes semver "$CURRENT_VERSION" "$LATEST_RELEASE_VERSION" | tail -n 1)
+          if [ "$LATEST_VERSION" != "$CURRENT_VERSION" ]; then
+            echo "Kinto Admin update ready"
+            echo "update_needed=true" >> "$GITHUB_OUTPUT"
+          else
+            echo "Kinto Admin up to date"
+            echo "update_needed=false" >> "$GITHUB_OUTPUT"
+          fi
+
+      - name: Configure git
+        if: ${{ steps.compare_versions.outputs.update_needed == 'true' }}
+        # https://github.com/orgs/community/discussions/26560
+        run: |
+          git config user.name github-actions[bot]
+          git config user.email 41898282+github-actions[bot]@users.noreply.github.com
+
+      - name: Create branch
+        id: create_branch
+        if: ${{ steps.compare_versions.outputs.update_needed == 'true' }}
+        env:
+          BRANCH_NAME: updates/kinto-admin-${{ steps.latest_release_version.outputs.version }}
+          LATEST_RELEASE: ${{ steps.latest_release_version.outputs.version }}
+        run: |
+          git fetch origin --no-tags --quiet "refs/heads/updates/*:refs/remotes/origin/updates/*"
+
+          if [ "$(git rev-parse --quiet --verify origin/$"BRANCH_NAME")" ]; then
+            echo "Branch $BRANCH_NAME already exists on origin."
+            echo "pr_needed=false" >> "$GITHUB_OUTPUT"
+          else
+            git checkout -b "$BRANCH_NAME"
+            echo "$LATEST_RELEASE" > kinto/plugins/admin/VERSION
+            git commit -am "Update Kinto Admin to $LATEST_RELEASE"
+            git push origin "$BRANCH_NAME"
+            echo "pr_needed=true" >> "$GITHUB_OUTPUT"
+          fi
+
+      - name: Create pull request
+        if: ${{ steps.compare_versions.outputs.update_needed == 'true' && steps.create_branch.outputs.pr_needed == 'true'}}
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          BRANCH_NAME: updates/kinto-admin-${{ steps.latest_release_version.outputs.version }}
+        run: |
+          gh pr create \
+            --title "Update Kinto Admin version to ${{ steps.latest_release_version.outputs.version }}" \
+            --body "" \
+            --base "main" \
+            --head "$BRANCH_NAME" \
+            --label "dependencies"

{kinto-19.4.0 → kinto-19.6.0}/.github/workflows/test.yml

@@ -16,6 +16,9 @@ jobs:
     steps:
       - uses: actions/checkout@v4
 
+      - name: Actions Lint
+        uses: raven-actions/actionlint@v2
+
       - uses: actions/setup-python@v5
 
       - name: make lint
@@ -158,11 +161,11 @@ jobs:
         run: |
           psql -c "CREATE DATABASE testdb ENCODING 'UTF8' TEMPLATE template0;" -U postgres -h localhost
 
-      - run: mkdir ${DOCKER_CACHE}
+      - run: mkdir "${DOCKER_CACHE}"
 
       - name: Compute cache key
         # Create hash of hashes of checked in files not in Dockerignore
-        run: echo "CACHE_KEY=$(git ls-tree --full-tree -r HEAD | grep -v -f .dockerignore | awk '{print $3}' | git hash-object --stdin)" >> $GITHUB_ENV
+        run: echo "CACHE_KEY=$(git ls-tree --full-tree -r HEAD | grep -v -f .dockerignore | awk '{print $3}' | git hash-object --stdin)" >> "$GITHUB_ENV"
 
       - uses: actions/cache@v4
         with:
@@ -190,9 +193,9 @@ jobs:
         run: |
           docker run --net=host --detach --rm \
             -p 8888:8888 \
-            -v `pwd`/tests/functional.ini:/etc/functional.ini \
+            -v "$(pwd)"/tests/functional.ini:/etc/functional.ini \
             -e KINTO_INI=/etc/functional.ini \
-            ${{ env.TEST_TAG }} && sleep 5
+            "${{ env.TEST_TAG }}" && sleep 5
 
       - name: Functional Tests
         run: |

kinto-19.6.0/.readthedocs.yaml

@@ -0,0 +1,12 @@
+version: 2
+
+build:
+  os: "ubuntu-22.04"
+  tools:
+    python: "3.12"
+  jobs:
+    install:
+      - make install-docs
+    build:
+      html:
+        - SPHINX_BUILDDIR=$READTHEDOCS_OUTPUT make docs

{kinto-19.4.0 → kinto-19.6.0}/CONTRIBUTORS.rst

@@ -17,6 +17,7 @@ Contributors
 * Balthazar Rouberol <br@imap.cc>
 * Boris Feld <lothiraldan@gmail.com>
 * Brady Dufresne <dufresnebrady@gmail.com>
+* Can Berk Güder <cbguder@mozilla.com>
 * Castro
 * Chirag B. Jadwani <chirag.jadwani@gmail.com>
 * Christophe Gragnic <cgragnic@protonmail.com>

{kinto-19.4.0 → kinto-19.6.0}/Dockerfile

@@ -20,7 +20,6 @@ RUN cp -r /kinto-admin/kinto/plugins/admin/build kinto/plugins/admin/
 RUN pip install ".[postgresql,memcached,monitoring]" -c constraints.txt && pip install kinto-attachment kinto-emailer httpie
 
 FROM python:3.10-slim-bullseye
-RUN apt-get update && apt-get install -y --no-install-recommends libpq-dev
 RUN groupadd --gid 10001 app && \
     useradd --uid 10001 --gid 10001 --home /app --create-home app
 

{kinto-19.4.0 → kinto-19.6.0}/Makefile

@@ -1,6 +1,6 @@
 SERVER_CONFIG = config/kinto.ini
 
-SPHINX_BUILDDIR = docs/_build
+SPHINX_BUILDDIR := $(shell echo $${SPHINX_BUILDDIR-docs/_build})
 VENV := $(shell echo $${VIRTUAL_ENV-.venv})
 PYTHON = $(VENV)/bin/python3
 DEV_STAMP = $(VENV)/.dev_env_installed.stamp

{kinto-19.4.0/kinto.egg-info → kinto-19.6.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: kinto
-Version: 19.4.0
+Version: 19.6.0
 Summary: Kinto Web Service - Store, Sync, Share, and Self-Host.
 Author-email: Mozilla Services <developers@kinto-storage.org>
 License: Copyright 2012 - Mozilla Foundation
@@ -33,8 +33,6 @@ Description-Content-Type: text/x-rst
 License-File: LICENSE
 Requires-Dist: bcrypt
 Requires-Dist: colander
-Requires-Dist: cornice
-Requires-Dist: cornice_swagger
 Requires-Dist: dockerflow
 Requires-Dist: jsonschema
 Requires-Dist: jsonpatch
@@ -54,7 +52,7 @@ Provides-Extra: memcached
 Requires-Dist: python-memcached; extra == "memcached"
 Provides-Extra: postgresql
 Requires-Dist: SQLAlchemy<3; extra == "postgresql"
-Requires-Dist: psycopg2; extra == "postgresql"
+Requires-Dist: psycopg2-binary; extra == "postgresql"
 Requires-Dist: zope.sqlalchemy; extra == "postgresql"
 Provides-Extra: monitoring
 Requires-Dist: newrelic; extra == "monitoring"
@@ -136,6 +134,7 @@ Contributors
 * Balthazar Rouberol <br@imap.cc>
 * Boris Feld <lothiraldan@gmail.com>
 * Brady Dufresne <dufresnebrady@gmail.com>
+* Can Berk Güder <cbguder@mozilla.com>
 * Castro
 * Chirag B. Jadwani <chirag.jadwani@gmail.com>
 * Christophe Gragnic <cgragnic@protonmail.com>

{kinto-19.4.0 → kinto-19.6.0}/constraints.in

@@ -1,8 +1,6 @@
 # main dependencies
 bcrypt
 colander
-cornice
-cornice_swagger
 dockerflow
 jsonschema
 jsonpatch
@@ -21,7 +19,7 @@ python-rapidjson
 python-memcached
 # postgresql
 SQLAlchemy < 3
-psycopg2
+psycopg2-binary
 zope.sqlalchemy
 # monitoring
 newrelic

{kinto-19.4.0 → kinto-19.6.0}/constraints.txt

@@ -25,17 +25,9 @@ certifi==2024.7.4
 charset-normalizer==3.3.2
     # via requests
 colander==2.0
-    # via
-    #   -r constraints.in
-    #   cornice-swagger
+    # via -r constraints.in
 colorama==0.4.6
     # via logging-color-formatter
-cornice==6.0.1
-    # via
-    #   -r constraints.in
-    #   cornice-swagger
-cornice-swagger==1.0.1
-    # via -r constraints.in
 coverage==7.6.4
     # via pytest-cov
 dockerflow==2024.4.2
@@ -45,9 +37,7 @@ execnet==2.0.2
 fqdn==1.5.1
     # via jsonschema
 greenlet==3.1.1
-    # via
-    #   playwright
-    #   sqlalchemy
+    # via playwright
 hupper==1.12
     # via pyramid
 idna==3.7
@@ -81,7 +71,7 @@ markupsafe==2.1.4
     # via werkzeug
 msgpack==1.0.7
     # via bravado-core
-newrelic==10.4.0
+newrelic==10.6.0
     # via -r constraints.in
 packaging==23.2
     # via
@@ -96,13 +86,13 @@ plaster==1.1.2
     #   pyramid
 plaster-pastedeploy==1.0.1
     # via pyramid
-playwright==1.49.1
+playwright==1.50.0
     # via -r constraints.in
 pluggy==1.5.0
     # via pytest
 prometheus-client==0.21.1
     # via -r constraints.in
-psycopg2==2.9.10
+psycopg2-binary==2.9.10
     # via -r constraints.in
 pyee==12.0.0
     # via playwright
@@ -111,7 +101,6 @@ pyproject-hooks==1.0.0
 pyramid==2.0.2
     # via
     #   -r constraints.in
-    #   cornice
     #   pyramid-mailer
     #   pyramid-multiauth
     #   pyramid-tm
@@ -163,7 +152,7 @@ rpds-py==0.17.1
     # via
     #   jsonschema
     #   referencing
-ruff==0.9.1
+ruff==0.9.6
     # via -r constraints.in
 sentry-sdk==2.8.0
     # via -r constraints.in
@@ -172,12 +161,11 @@ simplejson==3.19.2
 six==1.16.0
     # via
     #   bravado-core
-    #   cornice-swagger
     #   python-dateutil
     #   rfc3339-validator
 soupsieve==2.5
     # via beautifulsoup4
-sqlalchemy==2.0.36
+sqlalchemy==2.0.38
     # via
     #   -r constraints.in
     #   sentry-sdk
@@ -211,9 +199,7 @@ urllib3==2.2.2
     #   requests
     #   sentry-sdk
 venusian==3.1.0
-    # via
-    #   cornice
-    #   pyramid
+    # via pyramid
 waitress==3.0.2
     # via
     #   -r constraints.in

{kinto-19.4.0 → kinto-19.6.0}/docs/conf.py

@@ -109,7 +109,7 @@ nitpick_ignore = [
     ("py:class", "str"),
     ("py:class", "tuple"),
     ("py:class", "Exception"),
-    ("py:class", "cornice.Service"),
+    ("py:class", "kinto.core.cornice.Service"),
     # Member autodoc fails with those:
     # kinto.core.resource.schema
     ("py:class", "Integer"),
@@ -163,7 +163,6 @@ def setup(app):
 
 intersphinx_mapping = {
     "colander": ("https://colander.readthedocs.io/en/latest/", None),
-    "cornice": ("https://cornice.readthedocs.io/en/latest/", None),
     "pyramid": ("https://pyramid.readthedocs.io/en/latest/", None),
 }
 

{kinto-19.4.0 → kinto-19.6.0}/docs/requirements.txt

@@ -5,8 +5,7 @@ sphinxcontrib-httpdomain==1.8.1
 sphinx-github-changelog==1.4.0
 kinto
 mock==5.1.0
-webtest==3.0.2
-cornice==6.1.0
+webtest==3.0.4
 pyramid==2.0.2
 python-rapidjson==1.20
-SQLAlchemy==2.0.37
+SQLAlchemy==2.0.38

{kinto-19.4.0 → kinto-19.6.0}/docs/troubleshooting.rst

@@ -104,7 +104,7 @@ You might get some error like::
     File "./kinto/__init__.py", line 4, in <module>
       import kinto.core
     File "./kinto/core/__init__.py", line 5, in <module>
-      from cornice import Service as CorniceService
+      from kinto.core.cornice import Service as CorniceService
   ImportError: No module named cornice
   unable to load app 0 (mountpoint='') (callable not found or import error)
 

{kinto-19.4.0 → kinto-19.6.0}/kinto/core/__init__.py

@@ -4,11 +4,11 @@ import logging
 import tempfile
 
 import pkg_resources
-from cornice import Service as CorniceService
 from dockerflow import logging as dockerflow_logging
 from pyramid.settings import aslist
 
 from kinto.core import errors, events
+from kinto.core.cornice import Service as CorniceService
 from kinto.core.initialization import (  # NOQA
     initialize,
     install_middlewares,
@@ -186,10 +186,10 @@ def includeme(config):
     config.add_request_method(events.notify_resource_event, name="notify_resource_event")
 
     # Setup cornice.
-    config.include("cornice")
+    config.include("kinto.core.cornice")
 
     # Setup cornice api documentation
-    config.include("cornice_swagger")
+    config.include("kinto.core.cornice_swagger")
 
     # Per-request transaction.
     config.include("pyramid_tm")

kinto-19.6.0/kinto/core/cornice/__init__.py

@@ -0,0 +1,93 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this file,
+# You can obtain one at http://mozilla.org/MPL/2.0/.
+import logging
+from functools import partial
+
+from pyramid.events import NewRequest
+from pyramid.httpexceptions import HTTPForbidden, HTTPNotFound
+from pyramid.security import NO_PERMISSION_REQUIRED
+from pyramid.settings import asbool, aslist
+
+from kinto.core.cornice.errors import Errors  # NOQA
+from kinto.core.cornice.pyramidhook import (
+    handle_exceptions,
+    register_resource_views,
+    register_service_views,
+    wrap_request,
+)
+from kinto.core.cornice.renderer import CorniceRenderer
+from kinto.core.cornice.service import Service  # NOQA
+from kinto.core.cornice.util import ContentTypePredicate, current_service
+
+
+logger = logging.getLogger("cornice")
+
+
+def set_localizer_for_languages(event, available_languages, default_locale_name):
+    """
+    Sets the current locale based on the incoming Accept-Language header, if
+    present, and sets a localizer attribute on the request object based on
+    the current locale.
+
+    To be used as an event handler, this function needs to be partially applied
+    with the available_languages and default_locale_name arguments. The
+    resulting function will be an event handler which takes an event object as
+    its only argument.
+    """
+    request = event.request
+    if request.accept_language:
+        accepted = request.accept_language.lookup(available_languages, default=default_locale_name)
+        request._LOCALE_ = accepted
+
+
+def setup_localization(config):
+    """
+    Setup localization based on the available_languages and
+    pyramid.default_locale_name settings.
+
+    These settings are named after suggestions from the "Internationalization
+    and Localization" section of the Pyramid documentation.
+    """
+    try:
+        config.add_translation_dirs("colander:locale/")
+        settings = config.get_settings()
+        available_languages = aslist(settings["available_languages"])
+        default_locale_name = settings.get("pyramid.default_locale_name", "en")
+        set_localizer = partial(
+            set_localizer_for_languages,
+            available_languages=available_languages,
+            default_locale_name=default_locale_name,
+        )
+        config.add_subscriber(set_localizer, NewRequest)
+    except ImportError:  # pragma: no cover
+        # add_translation_dirs raises an ImportError if colander is not
+        # installed
+        pass
+
+
+def includeme(config):
+    """Include the Cornice definitions"""
+    # attributes required to maintain services
+    config.registry.cornice_services = {}
+
+    settings = config.get_settings()
+
+    # localization request subscriber must be set before first call
+    # for request.localizer (in wrap_request)
+    if settings.get("available_languages"):
+        setup_localization(config)
+
+    config.add_directive("add_cornice_service", register_service_views)
+    config.add_directive("add_cornice_resource", register_resource_views)
+    config.add_subscriber(wrap_request, NewRequest)
+    config.add_renderer("cornicejson", CorniceRenderer())
+    config.add_view_predicate("content_type", ContentTypePredicate)
+    config.add_request_method(current_service, reify=True)
+
+    if asbool(settings.get("handle_exceptions", True)):
+        config.add_view(handle_exceptions, context=Exception, permission=NO_PERMISSION_REQUIRED)
+        config.add_view(handle_exceptions, context=HTTPNotFound, permission=NO_PERMISSION_REQUIRED)
+        config.add_view(
+            handle_exceptions, context=HTTPForbidden, permission=NO_PERMISSION_REQUIRED
+        )

kinto-19.6.0/kinto/core/cornice/cors.py

@@ -0,0 +1,144 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this file,
+# You can obtain one at http://mozilla.org/MPL/2.0/.
+import fnmatch
+import functools
+
+from pyramid.settings import asbool
+
+
+CORS_PARAMETERS = (
+    "cors_headers",
+    "cors_enabled",
+    "cors_origins",
+    "cors_credentials",
+    "cors_max_age",
+    "cors_expose_all_headers",
+)
+
+
+def get_cors_preflight_view(service):
+    """Return a view for the OPTION method.
+
+    Checks that the User-Agent is authorized to do a request to the server, and
+    to this particular service, and add the various checks that are specified
+    in http://www.w3.org/TR/cors/#resource-processing-model.
+    """
+
+    def _preflight_view(request):
+        response = request.response
+        origin = request.headers.get("Origin")
+        supported_headers = service.cors_supported_headers_for()
+
+        if not origin:
+            request.errors.add("header", "Origin", "this header is mandatory")
+
+        requested_method = request.headers.get("Access-Control-Request-Method")
+        if not requested_method:
+            request.errors.add(
+                "header", "Access-Control-Request-Method", "this header is mandatory"
+            )
+
+        if not (requested_method and origin):
+            return
+
+        requested_headers = request.headers.get("Access-Control-Request-Headers", ())
+
+        if requested_headers:
+            requested_headers = map(str.strip, requested_headers.split(","))
+
+        if requested_method not in service.cors_supported_methods:
+            request.errors.add("header", "Access-Control-Request-Method", "Method not allowed")
+
+        if not service.cors_expose_all_headers:
+            for h in requested_headers:
+                if h.lower() not in [s.lower() for s in supported_headers]:
+                    request.errors.add(
+                        "header", "Access-Control-Request-Headers", 'Header "%s" not allowed' % h
+                    )
+
+        supported_headers = set(supported_headers) | set(requested_headers)
+
+        response.headers["Access-Control-Allow-Headers"] = ",".join(supported_headers)
+
+        response.headers["Access-Control-Allow-Methods"] = ",".join(service.cors_supported_methods)
+
+        max_age = service.cors_max_age_for(requested_method)
+        if max_age is not None:
+            response.headers["Access-Control-Max-Age"] = str(max_age)
+
+        return None
+
+    return _preflight_view
+
+
+def _get_method(request):
+    """Return what's supposed to be the method for CORS operations.
+    (e.g if the verb is options, look at the A-C-Request-Method header,
+    otherwise return the HTTP verb).
+    """
+    if request.method == "OPTIONS":
+        method = request.headers.get("Access-Control-Request-Method", request.method)
+    else:
+        method = request.method
+    return method
+
+
+def ensure_origin(service, request, response=None, **kwargs):
+    """Ensure that the origin header is set and allowed."""
+    response = response or request.response
+
+    # Don't check this twice.
+    if not request.info.get("cors_checked", False):
+        method = _get_method(request)
+
+        origin = request.headers.get("Origin")
+
+        if not origin:
+            always_cors = asbool(request.registry.settings.get("cornice.always_cors"))
+            # With this setting, if the service origins has "*", then
+            # always return CORS headers.
+            origins = getattr(service, "cors_origins", [])
+            if always_cors and "*" in origins:
+                origin = "*"
+
+        if origin:
+            if not any([fnmatch.fnmatchcase(origin, o) for o in service.cors_origins_for(method)]):
+                request.errors.add("header", "Origin", "%s not allowed" % origin)
+            elif service.cors_support_credentials_for(method):
+                response.headers["Access-Control-Allow-Origin"] = origin
+            else:
+                if any([o == "*" for o in service.cors_origins_for(method)]):
+                    response.headers["Access-Control-Allow-Origin"] = "*"
+                else:
+                    response.headers["Access-Control-Allow-Origin"] = origin
+        request.info["cors_checked"] = True
+    return response
+
+
+def get_cors_validator(service):
+    return functools.partial(ensure_origin, service)
+
+
+def apply_cors_post_request(service, request, response):
+    """Handles CORS-related post-request things.
+
+    Add some response headers, such as the Expose-Headers and the
+    Allow-Credentials ones.
+    """
+    response = ensure_origin(service, request, response)
+    method = _get_method(request)
+
+    if (
+        service.cors_support_credentials_for(method)
+        and "Access-Control-Allow-Credentials" not in response.headers
+    ):
+        response.headers["Access-Control-Allow-Credentials"] = "true"
+
+    if request.method != "OPTIONS":
+        # Which headers are exposed?
+        supported_headers = service.cors_supported_headers_for(request.method)
+        if supported_headers:
+            response.headers["Access-Control-Expose-Headers"] = ", ".join(supported_headers)
+
+    return response

kinto-19.6.0/kinto/core/cornice/errors.py

@@ -0,0 +1,40 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this file,
+# You can obtain one at http://mozilla.org/MPL/2.0/.
+import json
+
+from pyramid.i18n import TranslationString
+
+
+class Errors(list):
+    """Holds Request errors"""
+
+    def __init__(self, status=400, localizer=None):
+        self.status = status
+        self.localizer = localizer
+        super(Errors, self).__init__()
+
+    def add(self, location, name=None, description=None, **kw):
+        """Registers a new error."""
+        allowed = ("body", "querystring", "url", "header", "path", "cookies", "method")
+        if location != "" and location not in allowed:
+            raise ValueError("%r not in %s" % (location, allowed))
+
+        if isinstance(description, TranslationString) and self.localizer:
+            description = self.localizer.translate(description)
+
+        self.append(dict(location=location, name=name, description=description, **kw))
+
+    @classmethod
+    def from_json(cls, string):
+        """Transforms a json string into an `Errors` instance"""
+        obj = json.loads(string.decode())
+        return Errors.from_list(obj.get("errors", []))
+
+    @classmethod
+    def from_list(cls, obj):
+        """Transforms a python list into an `Errors` instance"""
+        errors = Errors()
+        for error in obj:
+            errors.add(**error)
+        return errors