feat: use the official list of HTTPStatus

taken from python standard library, exists from python 3.5, described
in [the documentation][1] as:

> A subclass of enum.IntEnum that defines a set of HTTP status codes,
> reason phrases and long descriptions written in English.

[1]: https://docs.python.org/3/library/http.html

Author: asfaltboy

openapi_python_client/parser/openapi.py

@@ -2,6 +2,7 @@
 from collections import OrderedDict
 from copy import deepcopy
 from dataclasses import dataclass, field
+from http import HTTPStatus
 from typing import Any, Dict, Iterator, List, Optional, Set, Tuple, Union
 
 import attr
@@ -230,15 +231,16 @@ def _add_responses(
         endpoint = deepcopy(endpoint)
         for code, response_data in data.items():
 
-            status_code: int
+            status_code: HTTPStatus
             try:
-                status_code = int(code)
+                status_code = HTTPStatus(int(code))
             except ValueError:
                 endpoint.errors.append(
                     ParseError(
                         detail=(
-                            f"Invalid response status code {code} (not a number), "
-                            f"response will be ommitted from generated client"
+                            f"Invalid response status code {code} (not a valid HTTP "
+                            f"status code), response will be ommitted from generated "
+                            f"client"
                         )
                     )
                 )

openapi_python_client/parser/responses.py

@@ -1,5 +1,6 @@
 __all__ = ["Response", "response_from_data"]
 
+from http import HTTPStatus
 from typing import Optional, Tuple, Union
 
 import attr
@@ -15,7 +16,7 @@
 class Response:
     """Describes a single response for an endpoint"""
 
-    status_code: int
+    status_code: HTTPStatus
     prop: Property
     source: str
 
@@ -28,7 +29,9 @@ class Response:
 }
 
 
-def empty_response(*, status_code: int, response_name: str, config: Config, description: Optional[str]) -> Response:
+def empty_response(
+    *, status_code: HTTPStatus, response_name: str, config: Config, description: Optional[str]
+) -> Response:
     """Return an untyped response, for when no response type is defined"""
     return Response(
         status_code=status_code,
@@ -46,7 +49,12 @@ def empty_response(*, status_code: int, response_name: str, config: Config, desc
 
 
 def response_from_data(
-    *, status_code: int, data: Union[oai.Response, oai.Reference], schemas: Schemas, parent_name: str, config: Config
+    *,
+    status_code: HTTPStatus,
+    data: Union[oai.Response, oai.Reference],
+    schemas: Schemas,
+    parent_name: str,
+    config: Config,
 ) -> Tuple[Union[Response, ParseError], Schemas]:
     """Generate a Response from the OpenAPI dictionary representation of it"""
 

openapi_python_client/templates/endpoint_module.py.jinja

@@ -1,3 +1,4 @@
+from http import HTTPStatus
 from typing import Any, Dict, List, Optional, Union, cast
 
 import httpx
@@ -75,7 +76,7 @@ def _parse_response(*, response: httpx.Response) -> Optional[{{ return_string }}
 
 def _build_response(*, response: httpx.Response) -> Response[{{ return_string }}]:
     return Response(
-        status_code=response.status_code,
+        status_code=HTTPStatus(response.status_code),
         content=response.content,
         headers=response.headers,
         {% if parsed_responses %}

openapi_python_client/templates/types.py.jinja

@@ -1,4 +1,5 @@
 """ Contains some shared types for properties """
+from http import HTTPStatus
 from typing import Any, BinaryIO, Generic, MutableMapping, Optional, Tuple, TypeVar
 
 import attr
@@ -35,7 +36,7 @@ T = TypeVar("T")
 class Response(Generic[T]):
     """ A response from an endpoint """
 
-    status_code: int
+    status_code: HTTPStatus
     content: bytes
     headers: MutableMapping[str, str]
     parsed: Optional[T]