# flare.http.error

> A module of flare_mlake's API.

HTTP-level error types.

Provides ``HttpError`` (raised on non-2xx responses when
``raise_for_status()`` is called) and ``TooManyRedirects`` (raised when
a redirect chain exceeds the configured limit).

Example:
    ```mojo
    from flare.http import HttpClient, HttpError

    def main() raises:
        var client = HttpClient()
        try:
            client.get("https://httpbin.org/status/404").raise_for_status()
        except e: HttpError:
            print("HTTP", e.status, e.reason)
    ```

## Structs

### `HttpError`

```mojo
struct HttpError
```

Raised by ``Response.raise_for_status()`` on non-2xx responses.

Fields:
    status: The HTTP status code (e.g. 404, 500).
    reason: The HTTP reason phrase (e.g. ``"Not Found"``).
    url: The URL that returned the error (empty if unknown).

Example:
```mojo
raise HttpError(404, "Not Found", "https://example.com/missing")
```

Implements: `Copyable`, `Movable`, `Writable`

Fields:

- `status: Int`
- `reason: String`
- `url: String`

#### `__init__`

```mojo
def __init__(out self, status: Int, reason: String = "", url: String = "")
```

Initialise an ``HttpError``.

Args:

- `status`: HTTP status code (e.g. 404).
- `reason`: HTTP reason phrase (e.g. ``"Not Found"``).
- `url`: URL that returned the error.

#### `write_to`

```mojo
def write_to[W: Writer, //](self, mut writer: W)
```

Write the error description to ``writer``.

Args:

- `writer`: Destination writer.

### `TooManyRedirects`

```mojo
struct TooManyRedirects
```

Raised when a redirect chain exceeds the configured maximum.

Fields:
    url: The URL at which the limit was reached.
    count: The number of redirects that were followed.

Example:
```mojo
raise TooManyRedirects("https://example.com", 10)
```

Implements: `Copyable`, `Movable`, `Writable`

Fields:

- `url: String`
- `count: Int`

#### `__init__`

```mojo
def __init__(out self, url: String, count: Int)
```

Initialise a ``TooManyRedirects`` error.

Args:

- `url`: The URL that caused the limit to be exceeded.
- `count`: Number of redirects followed before giving up.

#### `write_to`

```mojo
def write_to[W: Writer, //](self, mut writer: W)
```

Write the error description to ``writer``.

Args:

- `writer`: Destination writer.