# `http` — HTTP modules

Вихідний код: Lib/http/__init__.py

`http` — пакет, який збирає кілька модулів для роботи з протоколом передачі гіпертексту:

- `http.client` є низькорівневим клієнтом протоколу HTTP; для відкриття URL високого рівня використовуйте `urllib.request`

- `http.server` містить основні класи HTTP-серверів на основі `socketserver`

- `http.cookies` має утиліти для здійснення управління станом за допомогою файлів cookie

- `http.cookiejar` забезпечує збереження файлів cookie

The `http` module also defines the following enums that help you work with http related code:

class http.HTTPStatus

  Нове в версії 3.5.

  Підклас `enum.IntEnum`, який визначає набір кодів стану HTTP, фраз причин і довгих описів, написаних англійською мовою.

  Використання:

      >>> from http import HTTPStatus
      >>> HTTPStatus.OK
      HTTPStatus.OK
      >>> HTTPStatus.OK == 200
      True
      >>> HTTPStatus.OK.value
      200
      >>> HTTPStatus.OK.phrase
      'OK'
      >>> HTTPStatus.OK.description
      'Request fulfilled, document follows'
      >>> list(HTTPStatus)
      [HTTPStatus.CONTINUE, HTTPStatus.SWITCHING_PROTOCOLS, ...]

## Коди стану HTTP

Supported, IANA-registered status codes available in `http.HTTPStatus` are:

Код | Назва переліку | Подробиці
--- | --- | ---
`100` | `CONTINUE` | HTTP/1.1 RFC 7231, Section 6.2.1
`101` | `SWITCHING_PROTOCOLS` | HTTP/1.1 RFC 7231, Section 6.2.2
`102` | `ОБРОБКА` | WebDAV RFC 2518, Розділ 10.1
`103` | `EARLY_HINTS` | Код статусу HTTP для вказівки підказок RFC 8297
`200` | `ОК` | HTTP/1.1 RFC 7231, Section 6.3.1
`201` | `СТВОРЕНО` | HTTP/1.1 RFC 7231, Section 6.3.2
`202` | `ACCEPTED` | HTTP/1.1 RFC 7231, Section 6.3.3
`203` | `НЕ_АВТОРИТАТИВНА_ІНФОРМАЦІЯ` | HTTP/1.1 RFC 7231, Section 6.3.4
`204` | `БЕЗ_ВМІСТУ` | HTTP/1.1 RFC 7231, Section 6.3.5
`205` | `RESET_CONTENT` | HTTP/1.1 RFC 7231, Section 6.3.6
`206` | `PARTIAL_CONTENT` | HTTP/1.1 RFC 7233, Section 4.1
`207` | `МУЛЬТИ_СТАТУС` | WebDAV RFC 4918, Розділ 11.1
`208` | `ВЖЕ_ПОВІДОМЛЕНО` | Розширення зв’язування WebDAV RFC 5842, розділ 7.1 (експериментальний)
`226` | `IM_USED` | Дельта-кодування в HTTP RFC 3229, Розділ 10.4.1
`300` | `MULTIPLE_CHOICES` | HTTP/1.1 RFC 7231, Section 6.4.1
`301` | `ПЕРЕМІЩЕНО_ПОСТІЙНО` | HTTP/1.1 RFC 7231, Section 6.4.2
`302` | `ЗНАЙДЕНО` | HTTP/1.1 RFC 7231, Section 6.4.3
`303` | `SEE_OTHER` | HTTP/1.1 RFC 7231, Section 6.4.4
`304` | `NOT_MODIFIED` | HTTP/1.1 RFC 7232, Section 4.1
`305` | `USE_PROXY` | HTTP/1.1 RFC 7231, Section 6.4.5
`307` | `TEMPORARY_REDIRECT` | HTTP/1.1 RFC 7231, Section 6.4.7
`308` | `ПОСТІЙНЕ_ПЕРЕСПРАВЛЕННЯ` | Permanent Redirect RFC 7238, Section 3 (Experimental)
`400` | `BAD_REQUEST` | HTTP/1.1 RFC 7231, Section 6.5.1
`401` | `НЕАВТОРИЗОВАНО` | HTTP/1.1 Authentication RFC 7235, Section 3.1
`402` | `PAYMENT_REQUIRED` | HTTP/1.1 RFC 7231, Section 6.5.2
`403` | `ЗАБОРОНЕНО` | HTTP/1.1 RFC 7231, Section 6.5.3
`404` | `НЕ_ЗНАЙДЕНО` | HTTP/1.1 RFC 7231, Section 6.5.4
`405` | `METHOD_NOT_ALLOWED` | HTTP/1.1 RFC 7231, Section 6.5.5
`406` | `NOT_ACCEPTABLE` | HTTP/1.1 RFC 7231, Section 6.5.6
`407` | `PROXY_AUTHENTICATION_REQUIRED` | HTTP/1.1 Authentication RFC 7235, Section 3.2
`408` | `REQUEST_TIMEOUT` | HTTP/1.1 RFC 7231, Section 6.5.7
`409` | `КОНФЛІКТ` | HTTP/1.1 RFC 7231, Section 6.5.8
`410` | `ПІШЕЛ` | HTTP/1.1 RFC 7231, Section 6.5.9
`411` | `LENGTH_REQUIRED` | HTTP/1.1 RFC 7231, Section 6.5.10
`412` | `PRECONDITION_FAILED` | HTTP/1.1 RFC 7232, Section 4.2
`413` | `REQUEST_ENTITY_TOO_LARGE` | HTTP/1.1 RFC 7231, Section 6.5.11
`414` | `REQUEST_URI_TOO_LONG` | HTTP/1.1 RFC 7231, Section 6.5.12
`415` | `UNSUPPORTED_MEDIA_TYPE` | HTTP/1.1 RFC 7231, Section 6.5.13
`416` | `REQUESTED_RANGE_NOT_SATISFIABLE` | HTTP/1.1 Range Requests RFC 7233, Section 4.4
`417` | `EXPECTATION_FAILED` | HTTP/1.1 RFC 7231, Section 6.5.14
`418` | `Я_ЧАЙНИК` | HTTPS/1.0 RFC 2324, Розділ 2.3.2
`421` | `MISDIRECTED_REQUEST` | HTTP/2 RFC 7540, Section 9.1.2
`422` | `UNPROCESSABLE_ENTITY` | WebDAV RFC 4918, Section 11.2
`423` | `ЗАБЛОКУВАНО` | WebDAV RFC 4918, Розділ 11.3
`424` | `FAILED_DEPENDENCY` | WebDAV RFC 4918, Розділ 11.4
`425` | `НАДАНТО_РАНО` | Використання ранніх даних у HTTP RFC 8470
`426` | `UPGRADE_REQUIRED` | HTTP/1.1 RFC 7231, Section 6.5.15
`428` | `PRECONDITION_REQUIRED` | Додаткові коди стану HTTP RFC 6585
`429` | `TOO_MANY_REQUESTS` | Додаткові коди стану HTTP RFC 6585
`431` | `REQUEST_HEADER_FIELDS_TOO_LARGE` | Додаткові коди стану HTTP RFC 6585
`451` | `НЕДОСТУПНИЙ_З_ЮРИДИЧНИХ_ПРИЧИН` | Код статусу HTTP для повідомлення про юридичні перешкоди RFC 7725
`500` | `INTERNAL_SERVER_ERROR` | HTTP/1.1 RFC 7231, Section 6.6.1
`501` | `NOT_IMPLEMENTED` | HTTP/1.1 RFC 7231, Section 6.6.2
`502` | `BAD_GATEWAY` | HTTP/1.1 RFC 7231, Section 6.6.3
`503` | `СЛУЖБА_НЕДОСТУПНА` | HTTP/1.1 RFC 7231, Section 6.6.4
`504` | `GATEWAY_TIMEOUT` | HTTP/1.1 RFC 7231, Section 6.6.5
`505` | `HTTP_VERSION_NOT_SUPPORTED` | HTTP/1.1 RFC 7231, Section 6.6.6
`506` | `VARIANT_ALSO_NEGOTIATES` | Узгодження прозорого вмісту в HTTP RFC 2295, розділ 8.1 (експериментальний)
`507` | `INSUFFICIENT_STORAGE` | WebDAV RFC 4918, Розділ 11.5
`508` | `LOOP_DETECTED` | Розширення прив’язки WebDAV RFC 5842, розділ 7.2 (експериментальний)
`510` | `NOT_EXTENDED` | Фреймворк розширення HTTP RFC 2774, Розділ 7 (Експериментальний)
`511` | `NETWORK_AUTHENTICATION_REQUIRED` | Додаткові коди стану HTTP RFC 6585, Розділ 6

Щоб зберегти зворотну сумісність, значення enum також присутні в модулі `http.client` у формі констант. Назва переліку дорівнює імені константи (тобто `http.HTTPStatus.OK` також доступний як `http.client.OK`).

Змінено в версії 3.7: Додано код статусу `421 MISDIRECTED_REQUEST`.

Нове в версії 3.8: Додано код статусу `451 UNAVAILABLE_FOR_LEGAL_REASONS`.

Нове в версії 3.9: Додано коди статусу `103 EARLY_HINTS`, `418 IM_A_TEAPOT` і `425 TOO_EARLY`.

class http.HTTPMethod

  Нове в версії 3.11.

  A subclass of `enum.StrEnum` that defines a set of HTTP methods and descriptions written in English.

  Використання:

      >>> from http import HTTPMethod
      >>>
      >>> HTTPMethod.GET
      <HTTPMethod.GET>
      >>> HTTPMethod.GET == 'GET'
      True
      >>> HTTPMethod.GET.value
      'GET'
      >>> HTTPMethod.GET.description
      'Retrieve the target.'
      >>> list(HTTPMethod)
      [<HTTPMethod.CONNECT>,
       <HTTPMethod.DELETE>,
       <HTTPMethod.GET>,
       <HTTPMethod.HEAD>,
       <HTTPMethod.OPTIONS>,
       <HTTPMethod.PATCH>,
       <HTTPMethod.POST>,
       <HTTPMethod.PUT>,
       <HTTPMethod.TRACE>]

## HTTP methods

Supported, IANA-registered methods available in `http.HTTPMethod` are:

метод | Назва переліку | Подробиці
--- | --- | ---
`GET` | `GET` | HTTP/1.1 RFC 7231, Section 4.3.1
`HEAD` | `HEAD` | HTTP/1.1 RFC 7231, Section 4.3.2
`POST` | `POST` | HTTP/1.1 RFC 7231, Section 4.3.3
`PUT` | `PUT` | HTTP/1.1 RFC 7231, Section 4.3.4
`DELETE` | `DELETE` | HTTP/1.1 RFC 7231, Section 4.3.5
`CONNECT` | `CONNECT` | HTTP/1.1 RFC 7231, Section 4.3.6
`OPTIONS` | `OPTIONS` | HTTP/1.1 RFC 7231, Section 4.3.7
`TRACE` | `TRACE` | HTTP/1.1 RFC 7231, Section 4.3.8
`PATCH` | `PATCH` | HTTP/1.1 RFC 5789