./www/py-werkzeug-docs, Python WSGI Utility Library (HTML documentation)

[ CVSweb ] [ Homepage ] [ RSS ] [ Required by ] [ Add to tracker ]


Branch: CURRENT, Version: 0.16.0nb1, Package name: py37-werkzeug-docs-0.16.0nb1, Maintainer: kleink

This package contains the HTML documentation for Werkzeug.

Werkzeug is a WSGI utility library for Python. It's widely used
and BSD licensed.

Werkzeug started as a simple collection of various utilities for
WSGI applications and has become one of the most advanced WSGI
utility modules. It includes a powerful debugger, fully featured
request and response objects, HTTP utilities to handle entity tags,
cache control headers, HTTP dates, cookie handling, file uploads,
a powerful URL routing system and a bunch of community contributed
addon modules.

It does Unicode and doesn't enforce a specific template engine,
database adapter or anything else. It doesn't even enforce a specific
way of handling requests and leaves all that up to the developer.


Required to build:
[pkgtools/cwrappers] [lang/python37]

Master sites:

SHA1: d422fb58b25098bc5f1c73705a2112daef7bf3d8
RMD160: f6201a8dd0110666e4e51cabd38855323b5ee7c7
Filesize: 904.021 KB

Version history: (Expand)


CVS history: (Expand)


   2019-11-14 06:25:43 by David H. Gutteridge | Files touched by this commit (1)
Log message:
py-werkzeug-docs: reflect dependency change

This package now depends on py-pallets-sphinx-themes>=1.2.2nb1, since
the latter added a new dependency for its basic functioning (and 1.2.2
pre-revbump was broken).
   2019-10-22 00:11:34 by Adam Ciarcinski | Files touched by this commit (7)
Log message:
Switch sphinx to versioned deps.
   2019-09-14 19:09:11 by David H. Gutteridge | Files touched by this commit (1)
Log message:
py-werkzeug-docs: note py-werkzeug dependency

Fix bulk builds by noting this depends on py-werkzeug. (While here,
convert other BUILD_DEPENDS to TOOL_DEPENDS.)
   2019-05-23 14:00:48 by Adam Ciarcinski | Files touched by this commit (4) | Package updated
Log message:
py-werkzeug: updated to 0.15.4

Version 0.15.4
-   Fix a SyntaxError on Python 2.7.5. (:issue:1544)

Version 0.15.3
-   Properly handle multi-line header folding in development server in
    Python 2.7. (:issue:1080)
-   Restore the response argument to :exc:~exceptions.Unauthorized.
    (:pr:1527)
-   :exc:~exceptions.Unauthorized doesn't add the WWW-Authenticate
    header if www_authenticate is not given. (:issue:1516)
-   The default URL converter correctly encodes bytes to string rather
    than representing them with b''. (:issue:1502)
-   Fix the filename format string in
    :class:~middleware.profiler.ProfilerMiddleware to correctly handle
    float values. (:issue:1511)
-   Update :class:~middleware.lint.LintMiddleware to work on Python 3.
    (:issue:1510)
-   The debugger detects cycles in chained exceptions and does not time
    out in that case. (:issue:1536)
-   When running the development server in Docker, the debugger security
    pin is now unique per container.
   2019-04-24 18:05:43 by Adam Ciarcinski | Files touched by this commit (4) | Package updated
Log message:
py-werkzeug: updated to 0.15.2

Version 0.15.2
-   Rule code generation uses a filename that coverage will ignore.
    The previous value, "generated", was causing coverage to fail.

-   The test client removes the cookie header if there are no persisted
    cookies. This fixes an issue introduced in 0.15.0 where the cookies
    from the original request were used for redirects, causing functions
    such as logout to fail.
-   The test client copies the environ before passing it to the app, to
    prevent in-place modifications from affecting redirect requests.

-   The "werkzeug" logger only adds a handler if there is no handler
    configured for its level in the logging chain. This avoids double
    logging if other code configures logging first.

Version 0.15.1
-   :class:~exceptions.Unauthorized takes description as the first
    argument, restoring previous behavior. The new www_authenticate
    argument is listed second.

Version 0.15.0
-   Building URLs is ~7x faster. Each :class:~routing.Rule compiles
    an optimized function for building itself.
-   :meth:MapAdapter.build() <routing.MapAdapter.build> can be passed
    a :class:~datastructures.MultiDict to represent multiple values
    for a key. It already did this when passing a dict with a list
    value.
-   path_info defaults to '/' for
    :meth:Map.bind() <routing.Map.bind>.
    :pr:1316)
-   Change RequestRedirect code from 301 to 308, preserving the verb
    and request body (form data) during redirect.
-   int and float converters in URL rules will handle negative
    values if passed the signed=True parameter. For example,
    /jump/<int(signed=True):count>.
-   Location autocorrection in :func:Response.get_wsgi_headers()
    <wrappers.BaseResponse.get_wsgi_headers> is relative to the current
    path rather than the root path.
    :pr:1315)
-   412 responses once again include entity headers and an error message
    in the body. They were originally omitted when implementing
    If-Match

-   The Content-Length header is removed for 1xx and 204 responses. This
    fixes a previous change where no body would be sent, but the header
    would still be present. The new behavior matches RFC 7230.

-   :class:~exceptions.Unauthorized takes a www_authenticate
    parameter to set the WWW-Authenticate header for the response,
    which is technically required for a valid 401 response.

-   Add support for status code 424 :exc:~exceptions.FailedDependency.

-   :func:http.parse_cookie ignores empty segments rather than
    producing a cookie with no key or value.
-   :func:~http.parse_authorization_header (and
    :class:~datastructures.Authorization,
    :attr:~wrappers.Request.authorization) treats the authorization
    header as UTF-8. On Python 2, basic auth username and password are
    unicode.
-   :func:~http.parse_options_header understands :rfc:2231 parameter
    continuations.
-   :func:~urls.uri_to_iri does not unquote ASCII characters in the
    unreserved class, such as space, and leaves invalid bytes quoted
    when decoding. :func:~urls.iri_to_uri does not quote reserved
    characters. See :rfc:3987 for these character classes.

-   get_content_type appends a charset for any mimetype that ends
    with +xml, not just those that start with application/.
    Known text types such as application/javascript are also given
    charsets.
-   Clean up werkzeug.security module, remove outdated hashlib
    support.
-   In :func:~security.generate_password_hash, PBKDF2 uses 150000
    iterations by default, increased from 50000.
-   :class:~wsgi.ClosingIterator calls close on the wrapped
    *iterable*, not the internal iterator. This doesn't affect objects
    where __iter__ returned self. For other objects, the method
    was not called before.
-   Bytes may be used as keys in :class:~datastructures.Headers, they
    will be decoded as Latin-1 like values are.
-   :class:~datastructures.Range validates that list of range tuples
    passed to it would produce a valid Range header.
-   :class:~datastructures.FileStorage looks up attributes on
    stream._file if they don't exist on stream, working around
    an issue where :func:tempfile.SpooledTemporaryFile didn't
    implement all of :class:io.IOBase. See
    https://github.com/python/cpython/pull/3249.
-   :class:CombinedMultiDict.copy() <datastructures.CombinedMultiDict>
    returns a shallow mutable copy as a
    :class:~datastructures.MultiDict. The copy no longer reflects
    changes to the combined dicts, but is more generally useful.

-   The version of jQuery used by the debugger is updated to 3.3.1.

-   The debugger correctly renders long markupsafe.Markup instances.

-   The debugger can serve resources when Werkzeug is installed as a
    zip file. DebuggedApplication.get_resource uses
    pkgutil.get_data.
-   The debugger and server log support Python 3's chained exceptions.

-   The interactive debugger highlights frames that come from user code
    to make them easy to pick out in a long stack trace. Note that if an
    env was created with virtualenv instead of venv, the debugger may
    incorrectly classify some frames.
-   Clicking the error message at the top of the interactive debugger
    will jump down to the bottom of the traceback.
-   When generating a PIN, the debugger will ignore a KeyError
    raised when the current UID doesn't have an associated username,
    which can happen in Docker.
-   :class:~exceptions.BadRequestKeyError adds the KeyError
    message to the description, making it clearer what caused the 400
    error. Frameworks like Flask can omit this information in production
    by setting e.args = ().
-   If a nested ImportError occurs from :func:~utils.import_string
    the traceback mentions the nested import. Removes an untested code
    path for handling "modules not yet set up by the parent."

-   Triggering a reload while using a tool such as PDB no longer hides
    input.
-   The reloader will not prepend the Python executable to the command
    line if the Python file is marked executable. This allows the
    reloader to work on NixOS.
-   Fix an issue where sys.path would change between reloads when
    running with python -m app. The reloader can detect that a
    module was run with "-m" and reconstructs that instead of the file
    path in sys.argv when reloading.
-   The dev server can bind to a Unix socket by passing a hostname like
    unix://app.socket.
-   Server uses IPPROTO_TCP constant instead of SOL_TCP for
    Jython compatibility.
-   When using an adhoc SSL cert with :func:~serving.run_simple, the
    cert is shown as self-signed rather than signed by an invalid
    authority.
-   The development server logs the unquoted IRI rather than the raw
    request line, to make it easier to work with Unicode in request
    paths during development.
-   The development server recognizes ConnectionError on Python 3 to
    silence client disconnects, and does not silence other OSErrors
    that may have been raised inside the application.
-   The environ keys REQUEST_URI and RAW_URI contain the raw
    path before it was percent-decoded. This is non-standard, but many
    WSGI servers add them. Middleware could replace PATH_INFO with
    this to route based on the raw value.
-   :class:~test.EnvironBuilder doesn't set CONTENT_TYPE or
    CONTENT_LENGTH in the environ if they aren't set. Previously
    these used default values if they weren't set. Now it's possible to
    distinguish between empty and unset values.
-   The test client raises a ValueError if a query string argument
    would overwrite a query string in the path.
-   :class:test.EnvironBuilder and :class:test.Client take a
    json argument instead of manually passing data and
    content_type. This is serialized using the
    :meth:test.EnvironBuilder.json_dumps method.
-   :class:test.Client redirect handling is rewritten.

    -   The redirect environ is copied from the initial request environ.
    -   Script root and path are correctly distinguished when
        redirecting to a path under the root.
    -   The HEAD method is not changed to GET.
    -   307 and 308 codes preserve the method and body. All others
        ignore the body and related headers.
    -   Headers are passed to the new request for all codes, following
        what browsers do.
    -   :class:test.EnvironBuilder sets the content type and length
        headers in addition to the WSGI keys when detecting them from
        the data.
    -   Intermediate response bodies are iterated over even when
        buffered=False to ensure iterator middleware can run cleanup
        code safely. Only the last response is not buffered.

-   :class:~test.EnvironBuilder, :class:~datastructures.FileStorage,
    and :func:wsgi.get_input_stream no longer share a global
    _empty_stream instance. This improves test isolation by
    preventing cases where closing the stream in one request would
    affect other usages.
-   The default :attr:SecureCookie.serialization_method
    <contrib.securecookie.SecureCookie.serialization_method> will
    change from :mod:pickle to :mod:json in 1.0. To upgrade existing
    tokens, override :meth:~contrib.securecookie.SecureCookie.unquote
    to try pickle if json fails.
-   CGIRootFix no longer modifies PATH_INFO for very old
    versions of Lighttpd. LighttpdCGIRootFix was renamed to
    CGIRootFix in 0.9. Both are deprecated and will be removed in
    version 1.0.
-   :class:werkzeug.wrappers.json.JSONMixin has been replaced with
    Flask's implementation. Check the docs for the full API.

-   The :doc:contrib modules </contrib/index> are deprecated and will
    either be moved into werkzeug core or removed completely in
    version 1.0. Some modules that already issued deprecation warnings
    have been removed. Be sure to run or test your code with
    python -W default::DeprecationWarning to catch any deprecated
    code you're using.

    -   LintMiddleware has moved to :mod:werkzeug.middleware.lint.
    -   ProfilerMiddleware has moved to
        :mod:werkzeug.middleware.profiler.
    -   ProxyFix has moved to :mod:werkzeug.middleware.proxy_fix.
    -   JSONRequestMixin has moved to :mod:werkzeug.wrappers.json.
    -   cache has been extracted into a separate project,
        cachelib <https://github.com/pallets/cachelib>_. The version
        in Werkzeug is deprecated.
    -   securecookie and sessions have been extracted into a
        separate project,
        secure-cookie <https://github.com/pallets/secure-cookie>_. The
        version in Werkzeug is deprecated.
    -   Everything in fixers, except ProxyFix, is deprecated.
    -   Everything in wrappers, except JSONMixin, is deprecated.
    -   atom is deprecated. This did not fit in with the rest of
        Werkzeug, and is better served by a dedicated library in the
        community.
    -   jsrouting is removed. Set URLs when rendering templates
        or JSON responses instead.
    -   limiter is removed. Its specific use is handled by Werkzeug
        directly, but stream limiting is better handled by the WSGI
        server in general.
    -   testtools is removed. It did not offer significant benefit
        over the default test client.
    -   iterio is deprecated.

-   :func:wsgi.get_host no longer looks at X-Forwarded-For. Use
    :class:~middleware.proxy_fix.ProxyFix to handle that.

-   :class:~middleware.proxy_fix.ProxyFix is refactored to support
    more headers, multiple values, and more secure configuration.

    -   Each header supports multiple values. The trusted number of
        proxies is configured separately for each header. The
        num_proxies argument is deprecated.
    -   Sets SERVER_NAME and SERVER_PORT based on
        X-Forwarded-Host.
    -   Sets SERVER_PORT and modifies HTTP_HOST based on
        X-Forwarded-Port.
    -   Sets SCRIPT_NAME based on X-Forwarded-Prefix.

    -   The original WSGI environment values are stored in the
        werkzeug.proxy_fix.orig key, a dict. The individual keys
        werkzeug.proxy_fix.orig_remote_addr,
        werkzeug.proxy_fix.orig_wsgi_url_scheme, and
        werkzeug.proxy_fix.orig_http_host are deprecated.

-   Middleware from werkzeug.wsgi has moved to separate modules
    under werkzeug.middleware, along with the middleware moved from
    werkzeug.contrib. The old werkzeug.wsgi imports are
    deprecated and will be removed in version 1.0.

    -   werkzeug.wsgi.DispatcherMiddleware has moved to
        :class:werkzeug.middleware.dispatcher.DispatcherMiddleware.
    -   werkzeug.wsgi.ProxyMiddleware as moved to
        :class:werkzeug.middleware.http_proxy.ProxyMiddleware.
    -   werkzeug.wsgi.SharedDataMiddleware has moved to
        :class:werkzeug.middleware.shared_data.SharedDataMiddleware.

-   :class:~middleware.http_proxy.ProxyMiddleware proxies the query
    string.
-   The filenames generated by
    :class:~middleware.profiler.ProfilerMiddleware can be customized.

-   The werkzeug.wrappers module has been converted to a package,
    and its various classes have been organized into separate modules.
    Any previously documented classes, understood to be the existing
    public API, are still importable from werkzeug.wrappers, or may
    be imported from their specific modules.
   2017-05-31 10:24:38 by Adam Ciarcinski | Files touched by this commit (6)
Log message:
Version 0.12.2
--------------
- Fix regression: Pull request ``892`` prevented Werkzeug from correctly
  logging the IP of a remote client behind a reverse proxy, even when using
  `ProxyFix`.
- Fix a bug in `safe_join` on Windows.
   2017-01-01 15:44:09 by Thomas Klausner | Files touched by this commit (577)
Log message:
Add python-3.6 to incompatible versions.
   2016-07-09 15:04:18 by Thomas Klausner | Files touched by this commit (599)
Log message:
Remove python33: adapt all packages that refer to it.