피로에 살고 피로에 죽자

FastAPI는 파이썬 3.6 버전부터 활용 가능한 현대적인 웹 프레임워크로, 기존의 Django나 Flask와 비교했을 때 뛰어난 성능과 직관적인 문법을 제공하는 것이 특징이에요. 특히 Node.js나 Go와 대등한 수준의 빠른 속도를 자랑하며 비동기 프로그래밍을 지원한다는 점이 실무에서 큰 장점으로 작용하더라고요. 파이썬 타입 힌트를 기반으로 데이터 검증을 수행하기 때문에 안정적인 API를 구축하는 데 매우 유리해요.

개발 편의성 측면에서도 강력한데, Swagger UI나 ReDoc 같은 도구를 통해 API 문서를 자동으로 생성해 주는 기능이 포함되어 있어요. 이는 별도의 문서화 작업 없이도 협업을 원활하게 만들어주며 개발 생산성을 높여주네요. 또한 공식 자습서가 단계별로 구성되어 있어 특정 요구사항에 맞춰 필요한 부분만 골라 학습하거나 참고하기에도 매우 효율적인 구조를 갖추고 있답니다.

실무 환경에서는 가상환경을 생성하고 `pip freeze > requirements.txt` 명령어를 통해 프로젝트의 의존성을 관리하며 시작하게 돼요. 기본적인 폴더 구조를 정의하고 `main.py` 파일에 FastAPI 애플리케이션을 구현하는 방식이 일반적이며, 이를 통해 체계적인 프로젝트 관리가 가능해지거든요.

서버를 실행하면 터미널에 로컬 환경에서 접속 가능한 주소와 함께 API 문서 경로가 출력되는 것을 확인할 수 있어요. 이는 개발 단계에서 즉각적으로 결과를 확인하고 테스트할 수 있는 환경을 제공해주며, 모든 코드 블록이 복사해서 바로 사용할 수 있도록 구성되어 있어 실무 적용 시 참고하기 좋답니다. 특히 FastAPI CLI를 통해 실행하면 로컬 호스트 주소와 함께 문서 경로가 표시되는데, 이는 개발자가 즉각적으로 API의 동작을 확인하고 디버깅하는 데 큰 도움을 준답니다.

출처

• https://fastapi.tiangolo.com/ko/tutorial/
• https://fastapi.tiangolo.com/ko/
• https://coding-shop.tistory.com/377

파이썬 3.13은 최신 안정 배포 버전으로 여러 핵심적인 변화를 담고 있더라고요. 가장 눈에 띄는 부분은 대화형 인터프리터의 개선과 에러 메시지의 가독성 향상이에요. 이제 트레이스백(Traceback)이 기본적으로 색깔로 표시되어서 개발자가 오류 상황을 훨씬 직관적으로 파악할 수 있게 되었어요. 또한 locals() 내장 함수의 경우 반환된 매핑을 변경하기 위한 의미 구조가 정의되었고, 형 매개변수들이 기본값 설정을 지원하게 되면서 코드의 안정성이 높아진 것 같아요.

성능과 실행 모델 측면에서는 더욱 흥미로운 변화들이 있더라고요. 특히 제한 없는 스레드를 사용하는 파이썬(CPython)을 위한 자유 스레딩 모드인 PEP 703과 실험적인 JIT(Just-In-Time) 컴파일러인 PEP 744가 도입된 점이 핵심이에요. 이러한 변화는 파이썬의 실행 성능을 한 단계 끌어올릴 수 있는 중요한 기반이 될 수 있겠네요. 더불어 모바일 플랫폼에 대한 지원도 강화되면서 활용 범위가 넓어진 점도 주목할 만한 부분이에요.

표준 라이브러리 측면에서는 지속적인 정리가 이루어졌더라고요. 파이썬 3.11 버전부터 폐지되었던 오래된 레거시 모듈이나 API들이 이번 3.13 버전에서 실제로 제거되면서 환경이 더 깔끔해졌어요. 단순히 새로운 기능을 추가하는 것에 그치지 않고, 사용자 친화적이고 정확한 라이브러리를 만들기 위한 업데이트가 꾸준히 진행되고 있네요. 전반적으로 파이썬 3.13은 개발자의 편의성과 코드 가독성을 높이는 데 중점을 둔 버전이라고 볼 수 있어요.

출처

• https://docs.python.org/ko/3.13/whatsnew/index.html
• https://docs.python.org/ko/3/whatsnew/3.13.html
• https://digitalbourgeois.tistory.com/411

외부 API나 마이크로서비스를 호출할 때 매 요청마다 새로 연결을 맺으면 성능과 안정성에 문제가 생기기 마련입니다. 특히 내부 시스템에서 여러 엔드포인트를 빈번하게 호출하는 경우라면 더더욱 그렇죠. 이럴 때 requests 라이브러리의 Session 객체를 활용하면 네트워크 오버헤드를 크게 줄일 수 있습니다. 기본 함수형 호출 방식인 requests.get()은 매번 새로운 TCP 연결을 생성해서 닫고 반복하기 때문에 동시성이나 빈도 높은 호출에서 병목이 되거든요. 반면 Session 인스턴스를 한 번 만들고 재사용하면 동일한 호스트에 대해 연결 풀(Connection Pool)을 자동으로 관리합니다.

import requests

session = requests.Session()
session.headers.update({"Content-Type": "application/json"})

try:
    response = session.get("https://api.example.com/data", timeout=(3, 10))
    response.raise_for_status()
    print(response.json())
except requests.exceptions.Timeout as e:
    print(f"요청 시간이 초과되었네요: {e}")
except requests.exceptions.HTTPError as e:
    print(f"HTTP 상태 코드가 2xx가 아니에요: {e}")
finally:
    session.close()

여기에 timeout 파라미터를 반드시 지정해야 합니다. 타임아웃을 생략하면 요청이 무한히 대기하다가 애플리케이션 전체가 멈출 수 있으니 주의가 필요하더라구요. 보통은 (연결 대기 시간, 읽기 대기 시간) 형태로 튜플로 넘기면 되는데, 예컨대 timeout=(3, 10)처럼 설정하는 게 일반적입니다. 세션 객체는 스레드 안전하지 않으므로 멀티스레드 환경이라면 각 스레드별로 인스턴스를 분리하거나 락을 걸어줘야 합니다. 세션 객체를 적절히 관리하면 동일한 호스트와의 통신에서 연결 재사용 이점을 자연스럽게 얻을 수 있습니다.

특히 클라이언트 측에서 재시도 로직이나 헤더 공통 설정이 필요할 때 유용하니까, 실제 서비스 코드에 적용해 보면 네트워크 호출의 안정성이 한층 올라가는 걸 확인할 수 있겠네요. 필요한 경우 session.mount() 메서드를 통해 특정 도메인에 대한.adapters.HTTPAdapter 인스턴스를 등록하면 연결 풀 크기를 세밀하게 조절할 수도 있습니다. 재시도 로직이 필요할 때는 urllib3.util.Retry 클래스를 adapter에 주입하면 됩니다. 이렇게 하면 일시적인 네트워크 장애에서도 자동으로 복구 로직을 동작시킬 수 있어요. 연결 풀과 타임아웃을 적절히 조합하면 불안정한 외부 통신 환경에서도 견고한 클라이언트를 구성할 수 있더라구요.

FastAPI로 API를 만드는 첫걸음은 생각보다 단순해요. 클래스 하나를 가져와 앱 객체를 만들고, 거기에 경로(엔드포인트)를 하나씩 붙여 나가면 되거든요. 이 글에서는 그 시작점인 FastAPI 임포트부터 요청을 어디로 보낼지 정하는 '경로' 개념까지 차근차근 짚어볼게요. 우선 fastapi 모듈에서 FastAPI 클래스를 가져오는 것부터 시작합니다.

from fastapi import FastAPI

이렇게 만든 app 변수는 FastAPI 클래스의 인스턴스가 되며, 모든 API를 생성하는 상호작용의 주요 지점이 돼요. 여기서 말하는 경로는 URL에서 첫 번째 슬래시부터 시작하는 부분(도메인 제외)을 의미합니다. https://example.com/items/foo 와 같은 주소에서 /items/foo 가 바로 경로에 해당하죠. 이 경로를 기준으로 요청을 매핑하면 되며, 실제 API 엔드포인트를 설계할 때 유용하게 참고하실 수 있어요.

처리 완료 후에는 dict나 list, str이나 int 같은 단일 값을 반환할 수 있어요. Pydantic 모델을 반환하는 경우도 많고, ORM을 포함한 많은 객체와 모델이 자동으로 JSON으로 변환되니 편하게 선택하시면 됩니다. 이렇게 자동 변환 기능 덕분에 데이터 직렬화 과정을 간결하게 유지할 수 있거든요.

정리하면 FastAPI에서 하나의 엔드포인트는 '경로 + HTTP 메서드 + 처리 함수' 조합으로 만들어져요. 데코레이터로 GET 같은 메서드와 경로를 함수에 연결해 두면, 그 경로로 요청이 들어올 때 바로 아래 함수가 실행되고 그 반환값이 응답으로 나가거든요. 이렇게 임포트부터 앱 객체 생성, 경로 정의, 반환값 처리까지가 FastAPI로 첫 API를 띄우는 기본 뼈대예요. 여기까지 익혀 두면 이후에 요청 파라미터나 요청 본문 같은 기능도 같은 구조 위에 하나씩 얹어 나갈 수 있습니다.

출처

• https://fastapi.tiangolo.com/
• https://fastapi.tiangolo.com/ko/tutorial/first-steps/