Python

🧩 배경FastAPI에서 API 요청 값을 처리할 때 dict로 받을지, Pydantic 스키마로 받을지 고민한 적이 있다. 특히 부분 업데이트 (PATCH) 혹은 선택적 필드 처리가 필요한 상황에서 어떤 방식을 써야 할지 명확히 구분해두면 좋다.🧪 예제예를 들어, 아래와 같은 ProductUpdate 스키마가 있다고 가정하자:class ProductUpdate(BaseModel): name: Optional[str] = None price: Optional[int] = None url: Optional[str] = None category_id: Optional[int] = None1. Pydantic 방식으로 처리하는 예시def update_product_service(db:..

서론개발할 때 PyCharm에서 자꾸 눈에 거슬리는 경고 메시지들이 보이는데 너무 짜증나요진짜 에디터에서 너무 거슬립니다.Expected type 'CategoryResponse', got 'Category' insteadExpected type 'list[Product]', got 'list[Type[Product]]' insteadInvalid type hints definitions and usageInvalid TypedDict definition and usageShadows built-in name 'type'이런 경고는 실제 코드 실행이나 배포에는 영향을 주지 않지만,PyCharm이 타입 힌트 또는 추론 과정에서 의심스러운 부분을 미리 알려주는 역할을 해요.하지만 개발 단계에서 너무 민감하게..

개요Python 개발할 때 black, isort, ruff를 사용해서 코드 스타일을 자동으로 정리하면 매우 효율적입니다.PyCharm에서는 File Watcher 기능을 사용하면 파일 저장 시 자동으로 포맷팅과 린트 수정이 가능합니다.1. File Watcher란?🔧 File Watcher란?File Watcher는 PyCharm의 자동 실행 도구입니다.간단히 말해,“파일을 저장하면 지정된 명령어(black, isort, ruff 등)를 자동으로 실행해주는 기능”예를 들어:• .py 파일 저장 시 → black이 자동으로 코드 정리• isort가 import 순서를 정리• ruff가 린트 + 포맷 자동 수정이렇게 자동화해주기 때문에 개발자가 따로 명령어를 실행할 필요가 없습니다.2. black, is..

1. 개요Python 프로젝트를 규모 있게 운영하거나 협업하게 되면, 가장 먼저 맞춰야 할 게 코드 스타일과 품질 기준이다.Next.js나 TypeScript처럼 빌드 시 오류를 잡아주는 구조가 아니라, Python은 인터프리터 기반이라 실행 전 오류를 못 잡을 수 있다.그래서 코드 품질 유지와 오류 예방을 위해, 아래 도구들을 도입하게 된다:flake8: 문법 오류, 스타일 경고 감지black: 코드 자동 정렬isort: import 정렬mypy: 타입 검사pre-commit: 커밋 전에 위 도구들을 자동 실행1.1 관련 용어용어 의미 지금 상황과의 관련성Linting (린팅)문법 오류, 스타일 오류 탐지✅ flake8, isortFormatting (포맷팅)코드 자동 정렬✅ blackStatic An..

1. 개요FastAPI에서 파일 다운로드 기능을 구현할 때 자주 사용하는 두 가지 방식이 있다: Response와 FileResponse.처음 FastAPI를 접하는 사람이라면 둘의 차이와 어떤 상황에 어떤 것을 써야 할지 헷갈릴 수 있다.이 글에서는 이 두 방식의 차이를 실제 예제와 함께 비교해본다.2. Response vs FileResponse 비교2.1 기본 개념Response: FastAPI의 가장 기본적인 응답 객체로, JSON, 텍스트, 바이너리 등 다양한 타입을 다룰 수 있다.FileResponse: FastAPI에서 파일 다운로드용으로 특별히 최적화된 응답 객체다. 파일 경로만 넘기면 내부적으로 스트리밍 처리된다.2.2 차이점 정리항목ResponseFileResponse사용 방식파일 열고..

Python 프로젝트를 하다 보면 requirements.txt는 빠질 수 없는 필수 구성이다.이 파일 하나로 필요한 패키지들을 한번에 설치하거나, 현재 프로젝트에서 어떤 패키지를 사용하는지 기록할 수 있다.잘 관리하면 협업, 서버 배포, 로컬 개발 환경 세팅까지 모든 게 쉬워진다.이 글에서는 requirements.txt를 다룰 때 자주 사용하는 pip 명령어들을 정리한다.🔗 명령어 한눈에 보기 2025.03.15 - [🚀 Dev/Python] - [Python] requirements.txt 생성 및 설치 방법1. 명령어 설명1.1 pip freeze현재 가상환경에 설치된 모든 패키지와 버전을 출력한다.이 목록을 파일로 저장해 requirements.txt로 사용한다.예제pip freeze > r..

🔍 발생 상황FastAPI 프로젝트에서 Swagger UI를 사용할 때처음에는 POST 요청 입력창이 아래처럼 나왔었다.text input으로 단어 입력select box로 타입 고르기 (general, brand)하지만 어느 순간부터 아래처럼 바뀌었다:하나의 JSON textarea만 나옴전체 request body를 JSON으로 직접 작성해야 함🔗 엮인글 [🚀 Dev/Python] - [FastAPI] DELETE 요청 시 JSON이 아닌 Path Param으로 값 전달하는 방법[🚀 Dev/Python] - [FastAPI] DELETE 요청 시 path param 여러 개 받는 방법 [🚀 Dev/Python] - [FastAPI] 쿼리 파라미터 vs path 파라미터 설계 전략 [🚀 De..

🚨 문제 상황FastAPI + SQLAlchemy + PostgreSQL 프로젝트에서 아래와 같은 에러 발생:sqlalchemy.exc.DataError: (psycopg2.errors.InvalidTextRepresentation)invalid input value for enum excludewordtype: "GENERAL"▶️ 실제 SQL 로그WHERE exclude_words.type = 'GENERAL'하지만 PostgreSQL ENUM 타입은 아래처럼 소문자로 정의되어 있었음:SELECT unnest(enum_range(NULL::excludewordtype));-- 결과:-- brand-- general❓ 왜 이런 문제가 발생했을까?✔️ 원인 1. Python Enum의 .name vs ..

서론기초공부 없이 파이선 개발하다보니 모르는점이 많아 공부하면서 개발중 ㅠㅠ개념정리겸 포스팅!!무지렁이는 웁니다.본론주석(Comment) vs. 독스트링(Docstring) 차이점Python 코드를 작성하다 보면 함수나 클래스에 대한 설명이 필요할 때가 있고, 반대로 복잡한 코드 흐름이나 예외 처리에 대해 간단히 메모해두고 싶을 때도 있다. 두 개는 모두 설명을 위한 수단이지만, 용도와 역할이 확실히 다르다는 걸 이해하면 훨씬 더 읽기 좋고 유지보수하기 쉬운 코드를 작성할 수 있다.독스트링 (Docstring) 독스트링은 """ """ 또는 ''' '''로 감싸진 문자열로, 함수나 클래스, 모듈이 "무엇을 하는지"를 문서화하기 위해 사용 사용 목적이 함수(또는 클래스)가 무엇을 하는지 설명다른 개발자 또..

서론Create 스키마와 실제 DB 모델이 다를 경우, 가장 일반적인 패턴은 요청(Request) 스키마와 데이터베이스 모델을 변환하는 중간 계층을 만듬본문1. Create 스키마와 DB 모델이 다를 경우 예제📌 예시클라이언트에서 데이터를 보낼 때는 created_at, id가 필요 없음.하지만 DB에 넣을 때는 created_at, id가 자동 생성되어야 함.이럴 경우 schemas.py에서 Create 스키마와 Response 스키마를 분리하고,CRUD 함수에서 변환2. schemas.py에서 Create 스키마와 DB 스키마 구분from pydantic import BaseModelfrom typing import Optionalfrom datetime import datetime# 📌 1️⃣ ..