Enhance http.HTTPStatus with is_* properties that indicate the HTTP status category #95149
Description
Feature or enhancement
Add five properties to http.HTTPStatus that indicate the category the status belongs to:
class HTTPStatus:
...
@property
def is_informational(self):
return 100 <= self < 200
@property
def is_success(self):
return 200 <= self < 300
@property
def is_redirection(self):
return 300 <= self < 400
@property
def is_client_error(self):
return 400 <= self < 500
@property
def is_server_error(self):
return 500 <= self < 600Pitch
Programs that deal with HTTP requests usually need to deal with the various status codes. Oftentimes, knowing the broad category is sufficient to make quick decisions. For example, a client needs to handle responses differently depending on the status code. Assuming status is an HTTPStatus, instead of writing:
if 200 <= status < 300:
handle_response(response)
elif 300 <= status < 400:
handle_redirect(response)
elif 400 <= status < 500:
raise ClientError(status)
elif 500 <= status < 600:
maybe_retry(response.request)One could more elegantly write:
if status.is_success:
handle_response(response)
elif status.is_redirection:
handle_redirect(response)
elif status.is_client_error:
raise ClientError(status)
elif status.is_server_error:
maybe_retry(response.request)Enums are safer, more readable and more expressive than magic numbers. I think these small additions would only strengthen HTTPStatus.
Let me know if this interests you, and I can open a PR.