테스트 의존성 오버라이드

테스트 중 의존성 오버라이드하기

테스트를 진행하다 보면 의존성을 오버라이드해야 하는 경우가 있습니다.

원래 의존성을 실행하고 싶지 않을 수도 있습니다(또는 그 의존성이 가지고 있는 하위 의존성까지도 실행되지 않길 원할 수 있습니다).

대신, 테스트 동안(특정 테스트에서만) 사용될 다른 의존성을 제공하고, 원래 의존성이 사용되던 곳에서 사용할 수 있는 값을 제공하기를 원할 수 있습니다.

예를 들어, 외부 인증 제공자를 호출해야 하는 경우를 생각해봅시다.

토큰을 보내면 인증된 사용자를 반환합니다.

제공자는 요청당 요금을 부과할 수 있으며, 테스트를 위해 고정된 모의 사용자가 있는 경우보다 호출하는 데 시간이 더 걸릴 수 있습니다.

외부 제공자를 한 번만 테스트하고 싶을 수도 있지만 테스트를 실행할 때마다 반드시 호출할 필요는 없습니다.

이 경우 해당 공급자를 호출하는 종속성을 오버라이드하고 테스트에 대해서만 모의 사용자를 반환하는 사용자 지정 종속성을 사용할 수 있습니다.

이런 경우를 위해 FastAPI 응용 프로그램에는 app.dependency_overrides라는 속성이 있습니다. 이는 간단한 dict입니다.

테스트를 위해 의존성을 오버라이드하려면, 원래 의존성(함수)을 키로 설정하고 오버라이드할 의존성(다른 함수)을 값으로 설정합니다.

그럼 FastAPI는 원래 의존성 대신 오버라이드된 의존성을 호출합니다.

{* ../../docs_src/dependency_testing/tutorial001_an_py310.py hl[26:27,30] *}

/// tip | 팁

FastAPI 애플리케이션 어디에서든 사용된 의존성에 대해 오버라이드를 설정할 수 있습니다.

원래 의존성은 경로 동작 함수, 경로 동작 데코레이터(반환값을 사용하지 않는 경우), .include_router() 호출 등에서 사용될 수 있습니다.

FastAPI는 여전히 이를 오버라이드할 수 있습니다.

///

그런 다음, app.dependency_overrides를 빈 dict로 설정하여 오버라이드를 재설정(제거)할 수 있습니다:

app.dependency_overrides = {}

/// tip | 팁

특정 테스트에서만 의존성을 오버라이드하고 싶다면, 테스트 시작 시(테스트 함수 내부) 오버라이드를 설정하고 테스트 종료 시(테스트 함수 끝부분) 재설정하면 됩니다.

///