http — HTTP modules

소스 코드: Lib/http/__init__.py

---

http는 하이퍼텍스트 전송 프로토콜로 작업 하기 위한 여러 모듈을 수집하는 패키지입니다:

• http.client는 저수준 HTTP 프로토콜 클라이언트입니다. 고수준의 URL 열기는 urllib.request를 사용합니다

• http.server는 socketserver에 기반을 둔 기본적인 HTTP 서버 클래스를 포함합니다

• http.cookies는 쿠키를 사용하여 상태 관리를 구현하는 유틸리티가 있습니다

• http.cookiejar는 쿠키의 지속성을 제공합니다

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

class http.HTTPStatus

Added in version 3.5.

HTTP 상태 코드, 이유 구문 그리고 긴 영문 설명의 집합을 정의하는 enum.IntEnum의 서브 클래스입니다.

사용법:

>>> 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, 섹션 6.2.1
101	SWITCHING_PROTOCOLS	HTTP/1.1 RFC 7231, 섹션 6.2.2
102	PROCESSING	WebDAV RFC 2518, 섹션 10.1
103	EARLY_HINTS	힌트를 나타내는 HTTP 상태 코드 RFC 8297
200	OK	HTTP/1.1 RFC 7231, 섹션 6.3.1
201	CREATED	HTTP/1.1 RFC 7231, 섹션 6.3.2
202	ACCEPTED	HTTP/1.1 RFC 7231, 섹션 6.3.3
203	NON_AUTHORITATIVE_INFORMATION	HTTP/1.1 RFC 7231, 섹션 6.3.4
204	NO_CONTENT	HTTP/1.1 RFC 7231, 섹션 6.3.5
205	RESET_CONTENT	HTTP/1.1 RFC 7231, 섹션 6.3.6
206	PARTIAL_CONTENT	HTTP/1.1 RFC 7233, 섹션 4.1
207	MULTI_STATUS	WebDAV RFC 4918, 섹션 11.1
208	ALREADY_REPORTED	WebDAV 바인딩 확장 RFC 5842, 섹션 7.1 (실험적)
226	IM_USED	HTTP의 델타 인코딩 RFC 3229, 섹션 10.4.1
300	MULTIPLE_CHOICES	HTTP/1.1 RFC 7231, 섹션 6.4.1
301	MOVED_PERMANENTLY	HTTP/1.1 RFC 7231, 섹션 6.4.2
302	FOUND	HTTP/1.1 RFC 7231, 섹션 6.4.3
303	SEE_OTHER	HTTP/1.1 RFC 7231, 섹션 6.4.4
304	NOT_MODIFIED	HTTP/1.1 RFC 7232, 섹션 4.1
305	USE_PROXY	HTTP/1.1 RFC 7231, 섹션 6.4.5
307	TEMPORARY_REDIRECT	HTTP/1.1 RFC 7231, 섹션 6.4.7
308	PERMANENT_REDIRECT	영구 리디렉션 RFC 7238, 섹션 3 (실험적)
400	BAD_REQUEST	HTTP/1.1 RFC 7231, 섹션 6.5.1
401	UNAUTHORIZED	HTTP/1.1 인증 RFC 7235, 섹션 3.1
402	PAYMENT_REQUIRED	HTTP/1.1 RFC 7231, 섹션 6.5.2
403	FORBIDDEN	HTTP/1.1 RFC 7231, 섹션 6.5.3
404	NOT_FOUND	HTTP/1.1 RFC 7231, 섹션 6.5.4
405	METHOD_NOT_ALLOWED	HTTP/1.1 RFC 7231, 섹션 6.5.5
406	NOT_ACCEPTABLE	HTTP/1.1 RFC 7231, 섹션 6.5.6
407	PROXY_AUTHENTICATION_REQUIRED	HTTP/1.1 인증 RFC 7235, 섹션 3.2
408	REQUEST_TIMEOUT	HTTP/1.1 RFC 7231, 섹션 6.5.7
409	CONFLICT	HTTP/1.1 RFC 7231, 섹션 6.5.8
410	GONE	HTTP/1.1 RFC 7231, 섹션 6.5.9
411	LENGTH_REQUIRED	HTTP/1.1 RFC 7231, 섹션 6.5.10
412	PRECONDITION_FAILED	HTTP/1.1 RFC 7232, 섹션 4.2
413	REQUEST_ENTITY_TOO_LARGE	HTTP/1.1 RFC 7231, 섹션 6.5.11
414	REQUEST_URI_TOO_LONG	HTTP/1.1 RFC 7231, 섹션 6.5.12
415	UNSUPPORTED_MEDIA_TYPE	HTTP/1.1 RFC 7231, 섹션 6.5.13
416	REQUESTED_RANGE_NOT_SATISFIABLE	HTTP/1.1 범위 요청 RFC 7233, 섹션 4.4
417	EXPECTATION_FAILED	HTTP/1.1 RFC 7231, 섹션 6.5.14
418	IM_A_TEAPOT	HTCPCP/1.0 RFC 2324, 섹션 2.3.2
421	MISDIRECTED_REQUEST	HTTP/2 RFC 7540, 섹션 9.1.2
422	UNPROCESSABLE_ENTITY	WebDAV RFC 4918, 섹션 11.2
423	LOCKED	WebDAV RFC 4918, 섹션 11.3
424	FAILED_DEPENDENCY	WebDAV RFC 4918, 섹션 11.4
425	TOO_EARLY	HTTP에서 초기 데이터(Early Data) 사용 RFC 8470
426	UPGRADE_REQUIRED	HTTP/1.1 RFC 7231, 섹션 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	UNAVAILABLE_FOR_LEGAL_REASONS	법적 장애를 보고하는 HTTP 상태 코드 RFC 7725
500	INTERNAL_SERVER_ERROR	HTTP/1.1 RFC 7231, 섹션 6.6.1
501	NOT_IMPLEMENTED	HTTP/1.1 RFC 7231, 섹션 6.6.2
502	BAD_GATEWAY	HTTP/1.1 RFC 7231, 섹션 6.6.3
503	SERVICE_UNAVAILABLE	HTTP/1.1 RFC 7231, 섹션 6.6.4
504	GATEWAY_TIMEOUT	HTTP/1.1 RFC 7231, 섹션 6.6.5
505	HTTP_VERSION_NOT_SUPPORTED	HTTP/1.1 RFC 7231, 섹션 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

이전 버전과의 호환성을 유지하기 위해 열거값은 http.client 모듈에 상수 형태로도 있습니다. 열거명과 상수명은 동일합니다 (즉, http.HTTPStatus.OK는 http.client.OK로도 사용 가능합니다).

버전 3.7에서 변경: 421 MISDIRECTED_REQUEST 상태 코드 추가.

Added in version 3.8: 451 UNAVAILABLE_FOR_LEGAL_REASONS 상태 코드가 추가.

Added in version 3.9: 103 EARLY_HINTS, 418 IM_A_TEAPOT 및 425 TOO_EARLY 상태 코드가 추가되었습니다.

HTTP status category

Added in version 3.12.

The enum values have several properties to indicate the HTTP status category:

Property	Indicates that	세부 사항
is_informational	100 <= status <= 199	HTTP/1.1 RFC 7231, Section 6
is_success	200 <= status <= 299	HTTP/1.1 RFC 7231, Section 6
is_redirection	300 <= status <= 399	HTTP/1.1 RFC 7231, Section 6
is_client_error	400 <= status <= 499	HTTP/1.1 RFC 7231, Section 6
is_server_error	500 <= status <= 599	HTTP/1.1 RFC 7231, Section 6

사용법:

>>> from http import HTTPStatus
>>> HTTPStatus.OK.is_success
True
>>> HTTPStatus.OK.is_client_error
False

class http.HTTPMethod

Added in version 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:

Method	열거 이름	세부 사항
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