Отображение WSGI-приложений

Существует множество способов отображения WSGI-приложения. Во время разработки вы обычно не хотите иметь полностью развернутый веб-сервер, такой как Apache, а вместо этого простой автономный. По этой причине Werkzeug поставляется со встроенным сервером разработки.

Самый простой способ — создать небольшой start-myproject.py файл, который запускает приложение с помощью встроенного сервера:

from werkzeug.serving import run_simple
from myproject import make_app

app = make_app(...)
run_simple('localhost', 8080, app, use_reloader=True)

Вы также можете передать ему extra_files ключевое слово с списком дополнительных файлов (например, файлов конфигурации), за которыми вы хотите наблюдать.

werkzeug.serving.run_simple(hostname, port, application, use_reloader=False, use_debugger=False, use_evalex=True, extra_files=None, exclude_patterns=None, reloader_interval=1, reloader_type='auto', threaded=False, processes=1, request_handler=None, static_files=None, passthrough_errors=False, ssl_context=None)

Запуск сервера разработки для WSGI-приложения. Можно включить различные дополнительные функции.

Предупреждение

Не используйте сервер разработки при развертывании в продакшене. Он предназначен только для использования во время разработки на локальной машине. Он не предназначен для высокой эффективности, стабильности или безопасности.

Параметры:

• hostname (str) – Хост, к которому следует привязаться, например 'localhost'. Может быть доменом, IPv4 или IPv6 адресом или путем к файлу, начинающемуся с unix:// для Unix-соккета.
• port (int) – Порт, к которому следует привязаться, например 8080. Использование 0 говорит ОС выбрать случайный свободный порт.
• application (WSGIApplication) – WSGI-приложение для запуска.
• use_reloader (bool) – Использовать процесс перезагрузчика для перезапуска процесса сервера при изменении файлов.
• use_debugger (bool) – Использовать отладчик Werkzeug, который отобразит отформатированные трассировки при необработанных исключениях.
• use_evalex (bool) – Сделать отладчик интерактивным. Можно открыть терминал Python для любого кадра в трассировке. Предоставляется некоторая защита, требующая PIN-кода, но это никогда не должно быть включено на публично доступном сервере.
• extra_files (Optional[Iterable[str]]) – Перезагрузчик будет следить за этими файлами на предмет изменений помимо файлов Python-модулей. Например, отслеживание файла конфигурации.
• exclude_patterns (Optional[Iterable[str]]) – Перезагрузчик будет игнорировать изменения в любых файлах, соответствующих этим шаблонам fnmatch. Например, игнорирование файлов кеша.
• reloader_interval (int) – Частота проверки перезагрузчика на предмет изменений.
• reloader_type (str) – Используемый перезагрузчик. Встроенный перезагрузчик 'stat' , но может потребовать значительных ресурсов процессора для отслеживания файлов. Перезагрузчик 'watchdog' намного эффективнее, но для его использования необходимо предварительно установить пакет watchdog.
• threaded (bool) – Обработка одновременных запросов с помощью потоков. Не может быть использовано с processes.
• processes (int) – Обработка одновременных запросов с использованием до этого количества процессов. Не может быть использовано с threaded.
• request_handler (Optional[Type[WSGIRequestHandler]]) – Использовать другой BaseHTTPRequestHandler подкласс для обработки запросов.
• static_files (Optional[Dict[str, Union[str, Tuple[str, str]]]]) – Словарь, сопоставляющий префиксы URL с каталогами для обслуживания статических файлов с помощью SharedDataMiddleware.
• passthrough_errors (bool) – Не перехватывать необработанные исключения на уровне сервера, позволить серверу завершиться вместо этого. Если use_debugger включено, отладчик по-прежнему будет перехватывать такие ошибки.
• ssl_context (Optional[Union[ssl.SSLContext, Tuple[str, Optional[str]], te.Literal['adhoc']]]) – Настройка TLS для обслуживания по HTTPS. Может быть объектом ssl.SSLContext, кортежем (cert_file, key_file) для создания типичного контекста или строкой 'adhoc' для генерации временного самозаверяющего сертификата.

Тип возвращаемого значения:

None

Журнал изменений

Изменено в версии 2.1: Показать инструкции для обработки ошибки «адрес уже используется».

Изменено в версии 2.1: Запуск на 0.0.0.0 или :: отображает адрес петли обратной связи в дополнение к реальному IP-адресу.

Изменено в версии 2.1: Интерфейс командной строки был удален.

Изменено в версии 2.0: Запуск на 0.0.0.0 или :: отображает реальный IP-адрес, который был привязан, а также предупреждение о том, что сервер разработки не следует запускать в продакшене.

Изменено в версии 2.0: Добавлен параметр exclude_patterns.

Изменено в версии 0.15: Привязка к сокету Unix путём передачи hostname начинающегося с unix://.

Изменено в версии 0.10: Улучшен перезагрузчик и добавлена поддержка изменения бэкенда через параметр reloader_type.

Изменено в версии 0.9: Добавлен интерфейс командной строки.

Изменено в версии 0.8: ssl_context может быть кортежем путей к файлам сертификата и приватного ключа.

Изменено в версии 0.6: Добавлен параметр ssl_context.

Изменено в версии 0.5: Добавлены параметры static_files и passthrough_errors.

werkzeug.serving.is_running_from_reloader()

Проверка, запущен ли сервер как подпроцесс в перезагрузчике Werkzeug.

Журнал изменений

Добавлено в версии 0.10.

Тип возвращаемого значения:

bool

werkzeug.serving.make_ssl_devcert(base_path, host=None, cn=None)

Создаёт SSL-ключ для разработки. Его следует использовать вместо ключа 'adhoc', который генерирует новый сертификат при каждом запуске сервера. Он принимает путь для хранения ключа и сертификата, а также имя хоста или CN. Если указан хост, он будет использовать CN *.host/CN=host.

Дополнительную информацию см. в run_simple().

Журнал изменений

Введено в версии 0.9.

Параметры:

• base_path (str) – путь к сертификату и ключу. Расширение .crt добавляется для сертификата, .key добавляется для ключа.
• host (Optional[str]) – имя хоста. Его можно использовать как альтернативу для cn.
• cn (Optional[str]) – используемое CN.

Тип возвращаемого значения:

Tuple[str, str]

127.0.0.1       localhost yourapplication.local api.yourapplication.local

import multiprocessing
from werkzeug import Request, Response, run_simple

def get_token(q: multiprocessing.Queue) -> None:
    @Request.application
    def app(request: Request) -> Response:
        q.put(request.args["token"])
        return Response("", 204)

    run_simple("localhost", 5000, app)

if __name__ == "__main__":
    q = multiprocessing.Queue()
    p = multiprocessing.Process(target=get_token, args=(q,))
    p.start()
    print("waiting")
    token = q.get(block=True)
    p.terminate()
    print(token)

::1             localhost

import ssl
ctx = ssl.SSLContext(ssl.PROTOCOL_TLS_SERVER)
ctx.load_cert_chain('ssl.cert', 'ssl.key')
run_simple('localhost', 4000, application, ssl_context=ctx)

$ openssl genrsa 1024 > ssl.key
$ openssl req -new -x509 -nodes -sha1 -days 365 -key ssl.key > ssl.cert

run_simple('localhost', 4000, application,
           ssl_context='adhoc')

from werkzeug.serving import run_simple
run_simple('unix://example.sock', 0, app)