benavlabs/fastcrud
FastAPI용 강력한 비동기 CRUD 작업과 자동 엔드포인트 생성 라이브러리
1,531+1이번 주0 찜
115포크12이슈
중간맛 분석
Python 3.10+, FastAPI, SQLAlchemy 2.0, Pydantic 2.4.1 필요합니다. 비동기 CRUD 메서드, 자동 조인 감지, 동적 정렬, 오프셋/커서 기반 페이지네이션을 지원하며 즉시 사용 가능한 엔드포인트를 생성합니다. crud_router로 자동 생성하거나 FastCRUD를 커스텀 엔드포인트에 직접 사용할 수 있어요. N+1 쿼리 방지와 집계/CTE 같은 복잡한 작업은 원본 SQLAlchemy로 처리하는 방식을 권장합니다.
이런 레포예요
이럴 때 쓰면 좋아요
- FastAPI REST API의 표준 CRUD 엔드포인트를 빠르게 구축하고 싶을 때
- 대규모 데이터셋을 커서 기반 페이지네이션으로 효율적으로 처리해야 할 때
- 여러 테이블 간 조인이 필요한 복잡한 쿼리를 동적으로 구성해야 할 때
핵심 기능
완전 비동기 CRUD 메서드 (create, read, update, delete, exists, count)자동 조인 조건 감지 및 관계 테이블 조회오프셋·커서 기반 페이지네이션과 동적 필터링/정렬
대안 대비 차별점
SQLAlchemy 2.0 기반으로 최신 표준을 따르며, 자동 조인 감지, 커서 기반 페이지네이션, AI 코딩 에이전트 지원(Library Skill)을 제공해 기존 미유지 프로젝트들보다 현대적이고 확장성 높습니다.
준비물
- Python 3.10+
- FastAPI
- SQLAlchemy 2.0.21+
- Pydantic 2.4.1+
- async 데이터베이스 드라이버 (예: aiosqlite, asyncpg)
바로 시작하기
- FastCRUD 설치
pip install fastcrud
- SQLAlchemy 모델 정의 (models.py)
# 내용은 README의 models.py 예제 참고
- Pydantic 스키마 정의 (schemas.py)
# 내용은 README의 schemas.py 예제 참고
- FastAPI 앱과 FastCRUD 설정 (main.py)
# 내용은 README의 main.py 예제 참고
- 앱 실행
uvicorn main:app --reload
별 추이 · 7일
1,531+1 / 7일
활용성 · 따라 만들기 좋은가
따라 하기 좋음샘플 점수 52/100
- 관대한 라이선스
- 테스트 있음
- 예제 디렉토리
- 최근 활동
- AGENTS.md
- llms.txt
- 템플릿
🟢 최근 활동 있음 · 2024년 생성
이 레포에 깃밥 배지 달기
[](https://www.gitbap.com/r/benavlabs/fastcrud)🔌 클로드에서 바로 써보기
깃밥을 클로드에 연결하면 이런 레포를 클로드·커서·Codex에서 바로 찾고 체험할 수 있어요.
방법 ① 커넥터 URL
클로드 설정 → 커넥터에 이 주소를 붙여넣기.
https://www.gitbap.com/api/mcp방법 ② 플러그인 (체험까지)
플러그인을 설치하면 /gitbap-trending·/gitbap-try 슬래시 커맨드로 레포를 그 자리에서 체험. Claude Code에서 아래 두 줄을 차례로 실행하세요.
/plugin marketplace add jakeparkcolde/gitbap-cowork/plugin install gitbap-cowork@gitbapAI가 README 기반으로 요약했습니다 · 원문 보기