<aside>

</aside>

네, 안녕하세요! 실전 프로젝트 두 번째 시간, FastAPI 17강입니다! 🎉

지난 16강에서는 우리가 만들 ToDo 리스트 API의 목표와 기능 요구사항을 정하고, 필요한 API 엔드포인트와 데이터 모델(Task)을 설계했습니다. 이제 구체적인 구현에 들어갈 시간인데, 그 전에! 잠시 멈춰서 코드의 구조를 먼저 잡고 가는 것이 중요합니다.

작은 프로젝트라면 main.py 파일 하나에 모든 코드를 넣어도 괜찮지만, 기능이 조금만 복잡해져도 코드가 길어지고 관리하기 어려워집니다. 😅 특히 여러 명이 협업하거나 장기적으로 유지보수해야 하는 프로젝트라면 더욱 그렇죠!

이번 시간에는 FastAPI의 APIRouter 라는 아주 유용한 기능을 사용하여, 우리의 ToDo 리스트 프로젝트 코드를 **기능별 모듈(파일)**로 깔끔하게 분리하고 구조화하는 방법을 배웁니다. 이렇게 하면 코드가 훨씬 더 읽기 쉽고, 관리하기 편하며, 확장하기 좋은 형태가 될 거예요. 마치 잘 정리된 서랍장처럼요! 🗄️✨

자, 그럼 실무에 가까운 프로젝트 구조를 만들어 볼까요?

📚 챕터 소개

이번 17강에서는 실무에서 사용될 법한 프로젝트 구조를 만들고, FastAPI의 APIRouter 를 활용하여 관련 있는 API 엔드포인트들을 별도의 모듈(파일)로 분리하는 방법을 배웁니다. 이전까지 모든 코드를 main.py 파일 하나에 작성했지만, 프로젝트 규모가 커지면 이는 유지보수를 어렵게 만듭니다.

APIRouter는 마치 작은 FastAPI 앱처럼 동작하여, 특정 기능(예: 'Task 관리')과 관련된 경로 작동(Path Operations)들을 그룹화할 수 있게 해줍니다. 이렇게 분리된 라우터 모듈들을 메인 애플리케이션(main.py)에서 app.include_router()를 사용하여 포함시키는 방식으로 프로젝트 전체를 구성합니다.

이 과정에서 Pydantic 모델 정의도 별도의 모듈(models/)로 분리하고, 라우터는 routers/ 디렉토리에 위치시키는 등 기능별로 코드를 구성하는 방법을 실습합니다. 또한, 라우터를 포함시킬 때 prefix 옵션으로 공통 URL 경로를 지정하고, tags 옵션으로 API 문서를 깔끔하게 그룹화하는 방법도 알아봅니다. 이를 통해 유지보수성과 확장성이 뛰어난 프로젝트 구조의 기반을 마련합니다.

🎯 챕터 목표

이 강의를 마치면 여러분은 다음을 할 수 있게 됩니다:

1. 단일 파일 프로젝트 구조의 한계를 이해하고 코드 모듈화의 필요성을 설명할 수 있습니다.
2. FastAPI의 APIRouter를 사용하여 관련된 API 엔드포인트들을 그룹화하고 별도의 파일로 분리할 수 있습니다.
3. 기능(라우터, 모델 등)에 따라 디렉토리 구조를 구성하고 Python 모듈/패키지를 만들 수 있습니다.
4. 메인 FastAPI 애플리케이션에서 app.include_router()를 사용하여 분리된 라우터를 포함시킬 수 있습니다.
5. 라우터 포함 시 prefix 옵션을 사용하여 URL 경로 접두사를 설정하고, tags 옵션을 사용하여 API 문서를 그룹화할 수 있습니다.