1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

26

27

28

29

30

31

32

33

34

35

36

37

38

39

40

41

42

43

44

45

46

47

48

49

50

51

52

53

54

55

56

57

58

59

60

61

62

63

64

65

66

67

68

69

70

71

72

73

74

75

76

77

78

79

80

81

82

83

84

85

86

87

88

89

90

91

92

93

94

95

96

97

98

99

100

101

102

103

104

105

106

107

108

109

110

111

112

113

114

115

116

117

118

119

120

121

122

123

# -*- coding: utf-8 -*- 

 

r""" 

The ``codes`` object defines a mapping from common names for HTTP statuses 

to their numerical codes, accessible either as attributes or as dictionary 

items. 

 

Example:: 

 

>>> import requests 

>>> requests.codes['temporary_redirect'] 

307 

>>> requests.codes.teapot 

418 

>>> requests.codes['\o/'] 

200 

 

Some codes have multiple names, and both upper- and lower-case versions of 

the names are allowed. For example, ``codes.ok``, ``codes.OK``, and 

``codes.okay`` all correspond to the HTTP status code 200. 

""" 

 

from .structures import LookupDict 

 

_codes = { 

 

# Informational. 

100: ('continue',), 

101: ('switching_protocols',), 

102: ('processing',), 

103: ('checkpoint',), 

122: ('uri_too_long', 'request_uri_too_long'), 

200: ('ok', 'okay', 'all_ok', 'all_okay', 'all_good', '\\o/', '✓'), 

201: ('created',), 

202: ('accepted',), 

203: ('non_authoritative_info', 'non_authoritative_information'), 

204: ('no_content',), 

205: ('reset_content', 'reset'), 

206: ('partial_content', 'partial'), 

207: ('multi_status', 'multiple_status', 'multi_stati', 'multiple_stati'), 

208: ('already_reported',), 

226: ('im_used',), 

 

# Redirection. 

300: ('multiple_choices',), 

301: ('moved_permanently', 'moved', '\\o-'), 

302: ('found',), 

303: ('see_other', 'other'), 

304: ('not_modified',), 

305: ('use_proxy',), 

306: ('switch_proxy',), 

307: ('temporary_redirect', 'temporary_moved', 'temporary'), 

308: ('permanent_redirect', 

'resume_incomplete', 'resume',), # These 2 to be removed in 3.0 

 

# Client Error. 

400: ('bad_request', 'bad'), 

401: ('unauthorized',), 

402: ('payment_required', 'payment'), 

403: ('forbidden',), 

404: ('not_found', '-o-'), 

405: ('method_not_allowed', 'not_allowed'), 

406: ('not_acceptable',), 

407: ('proxy_authentication_required', 'proxy_auth', 'proxy_authentication'), 

408: ('request_timeout', 'timeout'), 

409: ('conflict',), 

410: ('gone',), 

411: ('length_required',), 

412: ('precondition_failed', 'precondition'), 

413: ('request_entity_too_large',), 

414: ('request_uri_too_large',), 

415: ('unsupported_media_type', 'unsupported_media', 'media_type'), 

416: ('requested_range_not_satisfiable', 'requested_range', 'range_not_satisfiable'), 

417: ('expectation_failed',), 

418: ('im_a_teapot', 'teapot', 'i_am_a_teapot'), 

421: ('misdirected_request',), 

422: ('unprocessable_entity', 'unprocessable'), 

423: ('locked',), 

424: ('failed_dependency', 'dependency'), 

425: ('unordered_collection', 'unordered'), 

426: ('upgrade_required', 'upgrade'), 

428: ('precondition_required', 'precondition'), 

429: ('too_many_requests', 'too_many'), 

431: ('header_fields_too_large', 'fields_too_large'), 

444: ('no_response', 'none'), 

449: ('retry_with', 'retry'), 

450: ('blocked_by_windows_parental_controls', 'parental_controls'), 

451: ('unavailable_for_legal_reasons', 'legal_reasons'), 

499: ('client_closed_request',), 

 

# Server Error. 

500: ('internal_server_error', 'server_error', '/o\\', '✗'), 

501: ('not_implemented',), 

502: ('bad_gateway',), 

503: ('service_unavailable', 'unavailable'), 

504: ('gateway_timeout',), 

505: ('http_version_not_supported', 'http_version'), 

506: ('variant_also_negotiates',), 

507: ('insufficient_storage',), 

509: ('bandwidth_limit_exceeded', 'bandwidth'), 

510: ('not_extended',), 

511: ('network_authentication_required', 'network_auth', 'network_authentication'), 

} 

 

codes = LookupDict(name='status_codes') 

 

def _init(): 

for code, titles in _codes.items(): 

for title in titles: 

setattr(codes, title, code) 

if not title.startswith(('\\', '/')): 

setattr(codes, title.upper(), code) 

 

def doc(code): 

names = ', '.join('``%s``' % n for n in _codes[code]) 

return '* %d: %s' % (code, names) 

 

global __doc__ 

__doc__ = (__doc__ + '\n' + 

'\n'.join(doc(code) for code in sorted(_codes)) 

if __doc__ is not None else None) 

 

_init()