Dev

서론FastAPI 개발할 때 로컬에서 서버를 실행하려고 하면, 의외로 자주 만나는 에러들이 있다. 특히 uvicorn main:app --reload 같은 기본 커맨드로 실행할 때 생각보다 많은 시행착오를 겪게 된다.처음에는"엥? 왜 안켜지지?""아까 켜졌는데 왜 안돼?""어디가 문제야?"이런 당황스러운 순간이 온다.오늘은 내가 직접 FastAPI 개발하면서 겪었던, FastAPI(Uvicorn) 서버 실행 시 가장 자주 만나는 에러와 해결 방법을 정리해보려고 한다.본론[Errno 48] Address already in use에러 상황ERROR: [Errno 48] Address already in use이미 8000번 포트를 누가 쓰고 있다.uvicorn 기본 포트가 8000인데, 아까 띄워놓은 서버..

서론깃허브를 사용할 때 누구나 한 번쯤 겪는 실수가 있다.바로 올리면 안 되는 파일을 무심코 푸시(push)해버리는 것.나도 티스토리 스킨을 개발하면서 .vscode/, .history/, 심지어 .DS_Store 같은 불필요한 파일까지 함께 올려버린 경험이 있다.처음엔 별 생각 없이 넘어갔지만, 레포를 깔끔하게 관리하고 싶다는 생각이 점점 강해졌다.특히 오픈소스나 스킨처럼 남들에게 공개하는 레포지토리라면 더욱 신경 써야 하는 부분이다.이 포스트에서는 실수로 올라간 파일이나 폴더를 깔끔하게 제거하는 방법을 소개하고자 한다.같은 실수를 반복하지 않기 위해 정리해두자!본론문제 상황로컬에서 깃허브에 푸시를 했는데 이런 파일이 올라가버렸다..vscode/ (IDE 설정 폴더).history/ (파일 수정 이력 ..

서론최근 블로그 스킨을 제작하면서 블로그 성능 테스트를 해봤다.Google PageSpeed Insights를 통해 내 블로그 속도를 점검해 보던 중, 생각보다 낮은 성능 점수가 눈에 띄었다.처음에는 JS나 CSS 때문이려나 싶었지만, 진단 결과 가장 많은 비중을 차지한 문제는 이미지 용량이었다.Midjourney나 Figma 등에서 작업한 이미지들을 그대로 PNG로 저장하고 업로드한 것이 문제였다.“그림 예쁘게 나왔는데 그냥 올려도 되지 않을까?”라는 안일한 생각이 페이지 로딩 지연 시키고 있었다.미드저니가 만들어준 이미지의 대부분의 PNG가 1.5MB~3MB에 달했고, 썸네일과 대표이미지를 같이 쓰기 때문에 티스토리 시스템이 업데이트되지 않는 한 개선이 불가한 부분이고 이미지의 용량은 내가 반영할 수..

서론로컬에서 GitHub에 push 하려고 할 때마다 자꾸 비밀번호를 물어보는 게 너무 귀찮았고 Jetbrains 시리즈는 자동 연결해 주지만 터미널 명령어로 쓰려면 SSH 연결을 해야 하더라.그래서 SSH 연결 방식으로 바꾸기로 했고, 드디어 성공해서 블로그에 기록해 둔다.(Mac 기준으로 작성되었고, 에디터 관계없이 적용된다.)본문준비GitHub 계정( 계정별로 SSH Key 생성가능)Git CLI (git --version으로 설치 확인)macOS (터미널 사용)1. Git 사용자 정보 등록ssh key 계정 생성 시 터미널 실행 위치는 상관없음.user.name : 깃 커밋 히스토리에 나오는 "작성자 이름”user.email : “작성자 이메일” 깃허브 계정 이메일과 일치하면 자동으로 커밋에 프로..

서론FastAPI로 백엔드 API를 개발하다 보면 공통 응답 포맷을 설계하는 것이 중요해진다.예외 상황에서는 400, 404, 500 등 다양한 상태 코드와 함께 에러 응답을 반환하게 되는데 예외 상황에서도 성공 응답과 동일한 구조로 내려주면, 클라이언트 측에서도 구조적 파싱과 UX 대응이 쉬워진다.이 글에서는 FastAPI에서 CommonResponse를 기반으로 성공/실패/예외까지 하나의 응답 구조로 통일하는 방법을 소개한다. 실제 디렉터리 구조와 함께 샘플 코드도 포함되어 있다.본론디렉토리 구조 예시app/├── main.py # API 엔트리포인트 (라우터)└── core/ ├── response.py # 공통 응답 스키마 정의 └─..

서론FastAPI에서 예외 응답도 CommonResponse로 처리하는 이유API 개발을 하다 보면 "예외가 발생했을 때 어떤 형식으로 응답을 내려줘야 할까?" 하는 고민을 많이 하게 된다. FastAPI를 사용하면서 나는 CommonResponse라는 공통 응답 포맷을 도입했고, 처음에는 단순히 성공한 응답에만 적용했었다.그런데 문제는 예외가 발생했을 때였다. 예외도 결국 응답인데, 이걸 CommonResponse로 감싸야 하나? 그냥 HTTPException처럼 detail만 내려줘도 되는 거 아닌가? 처음엔 나도 헷갈렸다.본문😵‍💫 내가 겪은 혼란예외 처리 코드를 작성하다가 문득 이런 의문이 들었다."raise로 예외를 던졌는데, 이게 응답이 되면 성공인가 실패인가?"raise NotFoundE..

📌 Mac 키보드 기호 정리표기호의미설명⌘Command주로 단축키 조합의 중심 키 (윈도우 Ctrl과 유사)⌥Option보조 키, 복사/이동/고급 옵션 등 다양하게 사용됨⇧Shift대문자/범위 선택, 다른 기능과 함께 조합됨⌃Control터미널 명령이나 일부 고급 단축키에 사용됨fnFunction기능 키(F1~F12 등)를 일반 키로 바꾸거나, 단축키 조합에 사용됨🌐Globe (지구본)일부 키보드에서 fn 키 대신 사용됨 (입력 언어 전환 등) 오려두기, 복사하기, 붙여넣기 및 기타 일반적으로 사용하는 단축키단축키기능설명⌘ + X잘라내기선택한 항목을 클립보드에 복사하고 원본을 제거⌘ + C복사선택한 항목을 클립보드에 복사 (Finder 파일도 포함)⌘ + V붙여넣기클립보드 내용을 문서나 앱에 붙여넣기..

서론Prolog파이썬 프로젝트를 하다 보면 setup.py와 requirements.txt 이 두 가지 파일을 자주 만나게 됩니다:이 둘은 **모두 "패키지 설치와 관련 있는 파일"**이지만,역할은 완전히 다릅니다.requirements 만 알고 있다가 setup 검색해보다 헷갈려서 포스팅글로 정리해봤다.헷갈릴 수 있지만, 용도와 목적을 알면 어느 상황에 어떤 걸 써야 하는지 금방 이해할 수 있다.본론requirements.txt는 무엇인가요?requirements.txt는 이 프로젝트를 실행하려면 어떤 외부 라이브러리가 필요한지를 정리한 파일입니다.requests==2.31.0beautifulsoup4>=4.12.0selenium보통 pip install -r requirements.txt 명령어로 설..

부제 : “점점 코드가 커질수록 정리된 로그가 필요하더라고요” 서론Prolog파이썬을 처음 배우기 시작하면 대부분 책이나 강의에서 가장 먼저 알려주는 건 print() 문이다.프로그램이 잘 돌아가는지 확인할 때마다 "여기까지 왔나?" 하고 print("ok")를 찍어보게 된다.근데 나처럼 실무 프로젝트를 하다 보면 문득 이런 생각이 든다.“프린트가 너무 많다…”“에러 메시지 안 보인다…”“이거 운영 환경에서도 프린트 찍히는 거 맞아?”그러면서 슬슬 궁금해진다.“개발자들이 말하는 로깅은 뭐지?”본문로깅(logging)이란?logging은 파이썬 표준 라이브러리로, print() 대신 메시지를 더 체계적으로 기록할 수 있게 해주는 도구다.일반적으로는 아래와 같은 용도로 사용된다.디버깅을 위한 로그 출력코드 ..

서론Prolog처음에는 나도 그랬다.“RESTful이 정석이라는데 그렇게 해야지 뭐...” 하고 아무 의심 없이 /api/v1/sellers/download 같은 주소를 쓰기 시작했다.하지만 프로젝트가 점점 커지고,CSV, NLP 모델, 학습데이터, 백오피스 다운로드까지 붙다 보니URL이 점점 복잡하고 헷갈리기 시작했다.본론RESTful이란? RESTful이란, “자원(Resource) 중심으로 URL을 구성하는 방식”이다. 예를 들어, users라는 자원을 다룰 때는 이렇게 URL을 짠다:GET /users – 유저 목록 조회POST /users – 유저 생성GET /users/1 – 특정 유저 정보 조회PUT /users/1 – 특정 유저 정보 수정DELETE /users/1 – 특정 유저 삭제이처..