인공지능 개발자 수다

Poetry를 이용해 파이썬 환경을 관리하는 중에UV라는 새로운 도구를 발견했다.앞으로는 pip, poetry 등을 대체할 것이라는 의견이 많으며, 신규 프로젝트는 UV로 진행되고 있다는 소문이 있다. Pycharm에서는 가상환경은 자동으로 세팅해주니, 그것을 사용하도록 하겠다. 1. UV기반 환경 세팅 방법신규 프로젝트를 만든다custom environment를 클릭하고 UV를 선택해 준다 2. UV환경 사용법2.1. pyproject.toml 확인프로젝트를 생성하면 pyproject.toml 파일이 만들어지는데, 여기서 라이브러리를 관리한다. 2.2. UV 버전 관리uv 버전 확인uv -V uv 최신버전으로 업데이트pip install --upgrade uv 2.3. 라이브러리 설치 및 삭제라이브러리..

FastAPI에서 객체지향 개념을 적용해 보자. 1. FastAPI에서 객체지향 적용의 필요성캡슐화(Encapsulation), 상속(Inheritance), 다형성(Polymorphism)코드가 커지다 보면, 비슷한 기능을 하는 클래스를 여러개 만들 때가 많다. 이럴때 추상클래스와 상속, 다형성 개념을 적용하면 코드를 깔끔하게 정리할 수 있다.예를 들어 삭제 동작을 정의한다고 할 때, 프로젝트의 다양한 곳에서 delete, remove, erase, eliminate 등 다양한 이름으로 사용된다면 상당히 관리가 어려울 것이기 때문이다. 이럴 때, 추상클래스를 상속해 사용한다면 코드 관리가 아주 편리해 질 수 있을 것이다. 의존성 주입을 통한 결합도 낮추기fastapi의 Depends를 활용한 객체 주입..

1. 미들웨어(Middleware) 란 무엇인가개념클라이언트와 서버 사이에서 데이터 요청(Request) 및 응답(Response)을 처리하는 중간 계층HTTP 요청을 처리하거나 응답을 반환하기 전에 실행되는 함수case1 : 요청이 애플리케이션의 특정 라우터에 도달하기 전에 작업을 수행case2 : 응답이 클라이언트에 반환되기 전에 조작하는 데 사용주요 역할요청(Request) 처리 전 작업요청의 유효성을 검사하거나 수정인증(Authentication) 및 권한 확인(Authorization)로그 기록(Log)을 남기거나 성능 모니터링응답(Response) 처리 후 작업데이터 압축(Gzip 등)응답 헤더 추가에러나 예외(Exception)를 클라이언트에 적절히 전달보안(Security)CORS(Cros..

1. 개념1.1. 설명객체 생성 로직을 캡슐화팩토리(Factory) 역할을 하는 메서드나 클래스를 통해 객체를 생성객체 생성의 책임을 별도의 팩토리 클래스 또는 메서드에 위임하여, 객체 생성 로직을 단순화하고 클라이언트 코드와의 결합도를 낮추는 것1.2. 사용 목적객체 생성 방식이 변경되더라도 클라이언트 코드에 영향을 최소화객체 생성 과정의 복잡성을 숨기고 단순화.1.3. 언제 사용하는가?앱 초기화구성 요소 관리 2. FastAPI 활용 예시2.1. 앱 초기화 예시다음과 같은 구조로 코드 예시를 정리한다. (여기서 app.py가 핵심이다.)project/├── app.py # 앱 초기화 및 팩토리 메서드 정의├── main.py # 애플리케이션 실행 진입점├── config..

0. 디자인 패턴(Design Pattern)0.1. 설명소프트웨어 개발 과정에서 반복적으로 나타나는 문제들을 해결하기 위해 제안된 재사용 가능한 솔루션특정한 상황에서의 최선의 설계 방법을 정의0.2. 장점코드 재사용성 증가유지보수성 향상개발 시간 단축효율적인 협업유연하고 확장 가능한 코드0.3. 단점초보 개발자에게는 어려움과도한 설계 / 남용의 위험1. 의존성 주입(Dependency Injection) 개념1.1. 설명특정 값을 외부 함수에서 전달받는 방식1.2. 장점코드 재사용성 증가 (데이터베이스 연결, 인증 토근 검증, 사용자 정보 추출 등)테스트 코드 작성 용이 (개발환경, 테스트 환경에 따라 다른 의존성을 줄 수 있음)특정 로직을 모듈화 (하나의 로직이 하나의 책임만)비즈니스 로직과 기숙적 ..

1. 개요FastAPI에서 예외를 처리하는 대표적인 방법은 아래와 같다.HTTPException 사용Custom Exception 만들기예외처리 핸들러 등록하기2.   HTTPException 사용FastAPI에서 기본적으로 제공하는 예외 클래스간단히 사용할 때 사용.from fastapi import FastAPI, HTTPExceptionapp = FastAPI()@app.get("/items/{item_id}")async def read_item(item_id: int): if item_id  3.  Custom 예외3.1. 왜 사용하는가?예외를 좀더 쉽게 추적하고 디버깅 하기위해코드의 가독성, 유지보수를 위해상태 코드와 메시지로만 예외를 구분하면 코드가 길어지고 복잡복잡한 시스템을 만들 때 ..

1. API의 OutputAPI의 Output에는 어떠한 내용이 담겨있을까?데이터의 결과와 상태에 대한 데이터가 담겨 있다.구체적으로는 아래와 같다.Pydantic (Response Model)FastAPI는 Pydantic 모델을 사용하여 응답 데이터 구조를 정의클라이언트가 받을 데이터의 형태를 명확히 규정하고, 필요에 따라 필드 제한(예: 특정 필드만 출력)Json 데이터FastAPI는 기본적으로 JSON 포맷으로 응답을 반환한다.HTTP 상태 코드응답 상태 코드는 요청이 성공했는지, 실패했는지, 그리고 실패 이유가 무엇인지 클라이언트에 알려줌결론적으로 Json 형태로 만들거나, Pydantic 형태로 만들고데이터와 상태코드를 담아 보내면 된다. 2. 상태 코드2.1. 상태 코드 종류1xx: Info..

지금까지는, API를 만들 때 그때그때 필요한 값을 Input으로 만들었다.앞으로는 상황에 맞는 값들을 사용해 보자.1. Path parameter1.1.설명경로(Path)에 파라미터 지정하는 방법Path Parameters는 클라이언트가 서버로 데이터를 전달하는 방법 중 하나일반적으로 str, int 를 처리한다.리소스 식별에 적합, (특정 리소스(데이터)를 고유하게 식별해야 하는 경우)get, delete 에서 주로 사용1.2. 기본 사용법URL에서 중괄호 {} 안에 정의함수의 파라미터에 input값, 타입힌트 정의주의사항{} 안의 변수명과 함수 매개변수명이 일치기본값을 설정할 수 없음@app.get("/users/{user_id}")async def read_user(user_id: int): ..

1. Join 기본 사용 방법join() 메서드를 이용해 직접 정의해 준다.기본은 내부 조인(inner join) 이다.with Session(engine) as session: # User와 Address 테이블을 조인하여 데이터를 조회 stmt = select(User, Address).join(Address, User.id == Address.user_id) result = session.execute(stmt).all() for user, address in result: print(user.name, address.email_address) outerjoin() 메서드는 left join이다.with Session(engine) as session: # U..

SQLAlchemy 에서 두 테이블 간의 관계를 표현할 때에는ForeignKey(), relationship() 두가지를 이용한다.관계를 설정하는 상세 옵션에 대해 알아보자 1. ForeignKey1.1. 기본 설명ForeignKey 설명부모테이블의 기본키와 자식테이블의 컬럼을 연결한다.두 테이블간의 관계에서, 자식 테이블에서 설정해 준다.해당 옵션은 데이터베이스에서 테이블을 생성할 때 실행해야 의미가 있다. ( Base.metadata.create_all(engine) )즉, ForeignKey에서 정의한 내용은 데이터베이스 스키마에 반영된다.여기서 설정한 옵션은 데이터베이스 레벨의 설정이다.예시 테이블 코드ForeignKey('parent.id') 를 이용해 외래키 정의Base = declarativ..