from typing import Annotated

from annotated_doc import Doc
from fastapi.openapi.models import OpenIdConnect as OpenIdConnectModel
from fastapi.security.base import SecurityBase
from starlette.exceptions import HTTPException
from starlette.requests import Request
from starlette.status import HTTP_401_UNAUTHORIZED


class OpenIdConnect(SecurityBase):
    """
    OpenID Connect authentication class. An instance of it would be used as a

import okio.IOException

/**
 * Listener for connection events. Extend this class to monitor the new connections and closes.
 *
 * All event methods must execute fast, without external locking, cannot throw exceptions,
 * attempt to mutate the event parameters, or be reentrant back into the client.
 * Any IO - writing to files or network should be done asynchronously.
 */
internal abstract class ConnectionListener {
  /**

하지만 고급 시나리오에서 필요하다면 커스텀 헤더를 추가할 수 있습니다:

{* ../../docs_src/handling_errors/tutorial002_py310.py hl[14] *}

## 커스텀 예외 핸들러 설치하기 { #install-custom-exception-handlers }

[Starlette의 동일한 예외 유틸리티](https://www.starlette.dev/exceptions/)를 사용해 커스텀 예외 핸들러를 추가할 수 있습니다.

여러분(또는 사용하는 라이브러리)이 `raise`할 수 있는 커스텀 예외 `UnicornException`이 있다고 가정해 봅시다.

그리고 이 예외를 FastAPI에서 전역적으로 처리하고 싶다고 해봅시다.

`@app.exception_handler()`로 커스텀 예외 핸들러를 추가할 수 있습니다:

        @DisplayName("close method should not declare exceptions")
        void testCloseMethodExceptions() throws NoSuchMethodException {
            // Given
            Method closeMethod = SmbResource.class.getMethod("close");

            // When
            Class<?>[] exceptions = closeMethod.getExceptionTypes();

            // Then
            assertEquals(0, exceptions.length, "close() should not declare any exceptions");

                        || message.contains("host unreachable") || message.contains("timeout");
            }
            return true; // Generic socket errors might be recoverable
        }

        // Generic IO exceptions might be recoverable
        if (error instanceof IOException) {
            String message = error.getMessage();
            if (message != null) {
                message = message.toLowerCase();

from typing import Annotated

import pytest
from fastapi import FastAPI, Form
from fastapi.exceptions import FastAPIDeprecationWarning
from fastapi.testclient import TestClient
from inline_snapshot import snapshot

from .utils import needs_py310


def get_client():
    app = FastAPI()
    with pytest.warns(FastAPIDeprecationWarning):

        @app.post("/items/")
        async def read_items(

from pathlib import Path

from fastapi import APIRouter, FastAPI, File, UploadFile
from fastapi.exceptions import HTTPException
from fastapi.testclient import TestClient

app = FastAPI()

router = APIRouter()


class ContentSizeLimitMiddleware:
    """Content size limiting middleware for ASGI applications
    Args:
      app (ASGI application): ASGI application

            assertTrue(result.errorPoms().contains(Paths.get("pom.xml")), "Should contain the failed POM");
        }

        @Test
        @DisplayName("should handle strategy exceptions gracefully")
        void shouldHandleStrategyExceptionsGracefully() throws Exception {
            UpgradeContext context = createMockContext();

    extends AbstractFuture<V> {
  /*
   * In the GWT versions of the methods (below), every exceptionType parameter is required to be
   * Class<Throwable>. To handle only certain kinds of exceptions under GWT, you'll need to write
   * your own instanceof tests.
   */

  public final FluentFuture<V> catching(
      Class<Throwable> exceptionType,
      Function<? super Throwable, ? extends V> fallback,

你大概不需要在程式碼中直接使用。

但若你在進階情境中需要，可以這樣加入自訂標頭：

{* ../../docs_src/handling_errors/tutorial002_py310.py hl[14] *}

## 安裝自訂例外處理器 { #install-custom-exception-handlers }

你可以使用 [Starlette 的相同例外工具](https://www.starlette.dev/exceptions/) 來加入自訂例外處理器。

假設你有一個自訂例外 `UnicornException`，你（或你使用的函式庫）可能會 `raise` 它。

而你想用 FastAPI 全域處理這個例外。

你可以使用 `@app.exception_handler()` 加入自訂例外處理器：