python

python에서 클로저(closure)란?

Python에서 클로저(Closure)는 함수형 프로그래밍의 중요한 개념 중 하나로, 함수가 정의될 때의 환경(변수 등)을 기억하고, 그 환경에 접근할 수 있는 함수 객체를 말한다. 클로저를 이해하면, 함수가 어떻게 자신이 선언된 환경을 유지하고, 그 환경에 접근할 수 있는지를 알 수 있다. 1. 클로저란?클로저는 내부 함수가 외부 함수의 변수들에 접근할 수 있는 기능을 제공한다. 클로저는 일반적으로 함수가 함수 내부에 정의되고, 그 내부 함수가 외부 함수의 변수에 의존할 때 생성된다. 중요한 점은, 외부 함수가 실행을 마친 후에도 내부 함수가 외부 함수의 변수에 접근할 수 있다는 것이다.2. 클로저의 동작 원리클로저는 함수가 생성된 환경을 기억하고, 그 환경을 계속해서 참조할 수 있게 해준다. 이를 위..

2024. 8. 19. 07:48

python

[python] nonlocal과 global

Python에서 nonlocal과 global 키워드는 변수를 참조하거나 수정할 때, 그 변수의 범위(scope)를 명시적으로 지정하는 데 사용된다. 이 두 키워드는 주로 함수 내에서 사용되며, 함수 내부에서 변수의 값을 읽거나 수정할 때 어느 범위의 변수를 참조할지 결정하는 중요한 역할을 한다. 1. 변수의 범위(Scope)먼저 Python에서 변수의 범위(scope)를 이해하는 것이 중요하다. Python에는 네 가지 주요 범위가 있다.Local Scope (지역 범위): 함수 내부에서 정의된 변수. 이 변수는 해당 함수 내에서만 접근할 수 있다.Enclosing Scope (내포 범위): 중첩된 함수에서 바깥 함수의 변수. 중첩된 함수가 이 변수를 참조할 수 있다.Global Scope (전역 범위..

2024. 8. 19. 07:47

python

python에서 데코레이터(decorator)란?

Python에서 데코레이터(Decorator)는 함수나 메서드에 추가적인 기능을 부여하는 강력한 도구이다. 데코레이터는 코드의 재사용성을 높이고, 함수의 동작을 동적으로 변경할 수 있게 해준다. 1. 데코레이터란?데코레이터는 다른 함수를 수정하지 않고, 그 함수에 새로운 기능을 추가할 수 있는 방법이다. 간단히 말해, 데코레이터는 함수를 감싸는(wrapper) 함수로, 원래의 함수에 새로운 기능을 추가하거나, 함수의 실행 결과를 수정할 수 있다. 데코레이터는 함수나 메서드를 매개변수로 받아서 새로운 함수를 반환하는 클로저 패턴을 사용한다.2. 데코레이터의 기본 구조데코레이터를 정의하는 기본 구조는 다음과 같습니다:def my_decorator(func): def wrapper(*args, **kwa..

2024. 8. 18. 19:52

python

[fastapi] SQLAlchemy 사용하기: 데이터베이스 연동 가이드

FastAPI는 빠르고 간결한 웹 애플리케이션을 개발하기 위해 설계된 프레임워크로, 데이터베이스와의 연동을 쉽게 처리할 수 있다. 그중에서도 SQLAlchemy는 가장 널리 사용되는 SQL toolkit 및 Object-Relational Mapping(ORM) 라이브러리로, Python 애플리케이션과 데이터베이스 간의 상호작용을 단순화해준다. 이 블로그 글에서는 FastAPI와 SQLAlchemy를 함께 사용하는 방법을 단계별로 설명한다.1. FastAPI와 SQLAlchemy 소개FastAPI는 Python의 최신 기능들을 활용해 비동기적으로 높은 성능을 제공하며, 빠른 개발과 유지보수를 가능하게 한다. 반면, SQLAlchemy는 SQL과 Python 간의 중간 계층으로, SQL 구문을 Python..

2024. 8. 16. 15:33

python

[fastapi] 교차 출처 리소스 공유(cors) 설정하기

교차 출처 리소스 공유(CORS, Cross-Origin Resource Sharing)는 웹 애플리케이션이 서로 다른 출처(도메인, 프로토콜 또는 포트)에서 리소스를 요청할 때 발생하는 보안 메커니즘이다. CORS는 기본적으로 웹 브라우저에서 다른 출처의 리소스에 대한 접근을 제한하며, 이를 우회하기 위해 서버에서 CORS 헤더를 통해 특정 출처에서의 접근을 허용할 수 있다.FastAPI는 이러한 CORS 설정을 간편하게 구성할 수 있는 기능을 제공하며, 이 글에서는 FastAPI에서 CORS를 설정하는 방법을 다룬다.1. CORS가 필요한 이유CORS는 기본적으로 보안을 강화하기 위해 존재한다. 브라우저는 자바스크립트를 사용한 요청이 다른 출처로 전송될 때 이를 제한하는데, 이는 악의적인 스크립트가 ..

2024. 8. 16. 14:40

python

[fastapi] 미들웨어(Middleware) 이해하기

1. 미들웨어(Middleware)란?미들웨어는 요청이 들어오고 응답이 나가기 전에 실행되는 함수나 클래스이다. FastAPI에서 미들웨어는 모든 HTTP 요청에 대해 공통적으로 실행되는 코드를 작성할 때 유용하다. 예를 들어, 요청의 처리 시간을 기록하거나, 모든 응답에 공통된 헤더를 추가하는 작업 등을 미들웨어에서 수행할 수 있다.2. @app.middleware("http") 데코레이터를 사용한 미들웨어FastAPI에서 미들웨어를 정의하는 가장 기본적인 방법은 @app.middleware("http") 데코레이터를 사용하는 것이다. 이 데코레이터는 HTTP 요청을 처리하는 미들웨어 함수를 정의할 때 사용된다.from fastapi import FastAPI, Requestimport timeapp ..

2024. 8. 16. 14:25

python

[fastapi] body update: put, patch, exclude_unset에 대한 이해

1. PUT과 PATCH의 차이점PUT과 PATCH는 모두 리소스를 업데이트하는 데 사용되는 HTTP 메소드이다. 그러나 이 둘은 특정한 차이점이 있다.PUT: 전체 리소스를 업데이트한다. 즉, 보낼 데이터는 해당 리소스의 모든 필드를 포함해야 하며, 누락된 필드는 기본값으로 설정된다.PATCH: 부분 업데이트를 수행한다. 보내는 데이터는 수정하려는 필드만 포함한다. 이 때문에 PATCH는 더 효율적이고 유연하게 사용될 수 있다.예제from fastapi import FastAPIfrom pydantic import BaseModelfrom typing import Optionalapp = FastAPI()class Item(BaseModel): name: str description: Opt..

2024. 8. 16. 13:50

python

[fastapi] jsonable_encoder 사용하기

FastAPI의 강력한 점 중 하나는 Pydantic 모델을 사용하여 데이터 검증 및 직렬화를 쉽게 수행할 수 있다는 것이다. 이와 관련하여 jsonable_encoder는 FastAPI에서 JSON 직렬화와 관련된 중요한 기능을 제공한다.1. jsonable_encoder란?jsonable_encoder는 FastAPI에서 제공하는 함수로, Pydantic 모델이나 다른 데이터 구조를 JSON 직렬화 가능한 형태로 변환해준다. 이 함수는 특히 FastAPI에서 반환할 데이터를 JSON 형식으로 변환할 때 유용하다. 데이터가 JSON 직렬화 가능하지 않은 경우(예: 날짜, Enum 등), 이를 올바른 형태로 변환하여 직렬화할 수 있도록 도와준다.2. 기본 사용법FastAPI에서 jsonable_encod..

2024. 8. 16. 13:38

python

[fastapi] 경로 동작(Path Operation) 설정

1. tags: 엔드포인트 분류tags는 엔드포인트를 분류하고 그룹화하여 API 문서에서 관련 엔드포인트를 함께 표시하는 데 사용된다. 태그를 사용하면 API 문서가 더 구조적이고 탐색하기 쉬워진다.from fastapi import FastAPIapp = FastAPI()@app.get("/items/", tags=["items"])def get_items(): return {"items": ["item1", "item2"]}@app.get("/users/", tags=["users"])def get_users(): return {"users": ["user1", "user2"]}여기서는 items와 users라는 태그를 사용하여 엔드포인트를 분류한다. Swagger UI와 ReDoc에서 이..

2024. 8. 16. 13:23

python

[fastapi] Form Data 처리하기

1. Form Data란?Form Data는 웹 폼에서 사용자가 입력한 데이터를 서버에 제출할 때 사용되는 데이터 형식이다. 일반적으로 application/x-www-form-urlencoded 또는 multipart/form-data로 인코딩되어 전송된다. 이 데이터는 URL 인코딩된 키-값 쌍으로 구성된다.2. FastAPI에서 Form Data 사용하기FastAPI에서는 Form 클래스를 사용하여 폼 데이터를 처리할 수 있다. 폼 데이터는 주로 POST 요청으로 전송되며, FastAPI의 Form 클래스를 사용하여 쉽게 파싱하고 검증할 수 있다.2.1. 기본적인 Form Data 처리기본적인 폼 데이터를 처리하는 방법을 살펴보자. 아래는 간단한 사용자 정보를 폼 데이터로 받는 예제이다.from f..

2024. 8. 16. 11:18

python

[fastapi] 응답 모델(Response Model) 사용하기

1. 응답 모델이란?응답 모델은 API 엔드포인트가 클라이언트에게 반환할 데이터의 형식을 정의하는 Pydantic 모델이다. 응답 모델을 사용하면 API 응답의 데이터 구조를 명확히 하고, 자동으로 데이터 검증과 문서화를 지원한다.2. 기본적인 응답 모델 사용법응답 모델을 정의하려면 Pydantic의 BaseModel을 상속받는 클래스를 생성하고, 이를 FastAPI의 response_model 매개변수에 전달한다.다음 예제는 간단한 사용자 정보를 반환하는 API 엔드포인트를 정의한다.from fastapi import FastAPIfrom pydantic import BaseModelapp = FastAPI()class User(BaseModel): id: int name: str em..

2024. 8. 16. 10:44

python

[fastapi] 헤더(Headers) 매개변수 사용하기

1. 헤더 매개변수란?HTTP 요청의 헤더는 요청의 메타데이터를 포함하며, 예를 들어 사용자 인증 정보, 콘텐츠 타입, 캐시 제어 등이 포함된다. FastAPI는 이러한 헤더 정보를 쉽게 추출하고 사용할 수 있게 해준다. 헤더 매개변수는 FastAPI의 라우트 함수에서 직접 요청 헤더를 받아올 수 있도록 도와준다.2. 기본적인 헤더 매개변수 사용법헤더 정보를 라우트 함수에서 사용하려면 fastapi 모듈의 Header 클래스를 활용한다. Header 클래스를 매개변수로 사용하여 요청 헤더의 값을 추출할 수 있다.다음 예제는 X-My-Header라는 사용자 정의 헤더를 읽는 방법을 보여준다:from fastapi import FastAPI, Headerapp = FastAPI()@app.get("/get-..

2024. 8. 16. 10:15

python

[fastapi] Cookie 매개변수 사용하기

1. Annotated란?Annotated는 Python 3.9 이상에서 사용할 수 있는 기능으로, 타입 힌트에 추가적인 메타데이터를 포함시킬 수 있게 해준다. FastAPI에서는 이를 활용하여 라우트 함수의 매개변수에 추가 정보를 제공하거나, 의존성을 주입하는 데 사용한다.2. 기본적인 Annotated와 Cookie 사용법쿠키 데이터를 라우트 함수에서 처리하기 위해 Annotated와 함께 Cookie 매개변수를 사용할 수 있다. 이를 통해 쿠키를 더 명확하고 구조적으로 처리할 수 있다.아래는 Annotated를 사용한 기본적인 쿠키 처리 예제입니다:from fastapi import FastAPI, Cookiefrom typing import Annotatedapp = FastAPI()@app.ge..

2024. 8. 16. 09:47

python

[fastapi] 기본 자료형 외 다양한 데이터 타입 처리하기

FastAPI는 Python의 기본 자료형(str, int, float, bool) 외에도 다양한 데이터 타입을 지원하여 API 개발을 더욱 유연하게 해준다. 이번 글에서는 FastAPI에서 UUID, datetime, date, time, timedelta, frozenset, bytes, decimal 등과 같은 다양한 데이터 타입을 처리하는 방법에 대해 알아보자.1. UUIDUUID(Universally Unique Identifier)는 고유 식별자이다. FastAPI는 UUID 타입을 직접 지원하며, Pydantic을 사용하여 모델에서 쉽게 처리할 수 있다.from fastapi import FastAPIfrom pydantic import BaseModelfrom uuid import UUID..

2024. 8. 16. 09:29

python

[fastapi] Field를 사용하여 Request Body로 데이터 받기

아래 코드는 pydantic v2 이상에서 동작한다.FastAPI는 Python의 Pydantic을 활용하여 데이터를 쉽게 검증하고 처리할 수 있는 강력한 기능을 제공한다. Pydantic의 v2가 등장하면서 여러 개선 사항이 도입되었고, 이에 따라 FastAPI에서도 Pydantic v2를 활용한 예시(example) 설정이 더 유연해졌다. 1. Pydantic v2의 주요 변경 사항Pydantic v2에서는 모델 정의와 유효성 검사 방식에 몇 가지 주요 변경 사항이 있다. 특히, 데이터 클래스 스타일의 필드 정의가 강조되었으며, Field의 사용 방식도 다소 변화가 있었다. 그럼에도 불구하고, example을 추가하는 방식은 이전 버전과 유사하다.2. Pydantic v2에서의 기본 Example 설..

2024. 8. 16. 08:34