FastAPI 개발 환경 준비

가상 환경이란?

가상 환경은 프로젝트를 진행할 때 독립된 환경을 만들어 주는 도구이다.가상 환경을 이용하면 하나의 PC에 서로 다른 버전의 파이썬과 라이브러리를 쉽게 설치하여 사용할 수 있다.

 

1. 가상 환경 디렉터리 생성하기

윈도우에서 명령 프롬프트를 실행하고 다음 명령어를 입력해 C:\venvs라는 디렉터리를 만든다.

C:\Users\pahkey> cd \
C:\> mkdir venvs
C:\> cd venvs

 

 

2. 가상 환경 만들기

다음 명령어를 통해 파이썬 가상 환경을 만든다.

C:\venvs> python -m venv movieapi

명령이 잘 수행되었다면 C:\venvs 디렉터리 아래에 movieapi라는 폴더가 생성된 것을 확인할 수 있다.

그런데 가상 환경을 만들었다 해서 바로 가상 환경을 사용할 수는 없다. 가상 환경을 사용하려면 가상 환경에 진입해야 한다.

 

3. 가상 환경 진입하기

가상 환경에 진입하려면 우리가 생성한 myapi 가상 환경에 있는 Scripts 디렉터리의 activate라는 명령을 수행해야 한다.

다음 명령을 입력해 myapi 가상 환경에 진입해 보자.

C:\venvs> cd C:\venvs\movieapi\Scripts
C:\venvs\movieapi\Scripts> activate
(movieapi) C:\venvs\movieapi\Scripts>

명령이 잘 수행되었다면 C:\ 왼쪽에 (movieapi)라는 프롬프트를 확인할 수 있다. 이 프롬프트는 앞에서 만든 가상 환경의 이름으로 현재 진입한 가상 환경을 의미한다.

 

4. 가상 환경 벗어나기

만약 현재 진입한 가상 환경에서 벗어나려면 deactivate라는 명령을 실행하면 된다. 이 명령은 어느 위치에서 실행해도 상관없다.

(movieapi) C:\venvs\movieapi\Scripts> deactivate
C:\venvs\movieapi\Scripts>

 

가상 환경에서 잘 벗어났다면 C:\ 왼쪽에 있던 (movieapi)라는 프롬프트가 사라졌을 것이다.

 

5. 가상 환경에서 FastAPI 설치하기

다시 movieapi 가상 환경에 진입하고, 진입한 상태에서 pip install fastapi 명령을 입력하자. pip은 파이썬 라이브러리를 설치하고 관리해 주는 파이썬 도구다. pip install fastapi 명령은 pip을 이용해 FastAPI를 설치하라는 명령어라고 생각하면 된다. 다음 화면이 나오면 FastAPI가 잘 설치된 것이다.

(movieapi) C:\venvs\movieapi\Scripts> pip install fastapi
(... 생략 ...)
Successfully installed annotated-types-0.6.0 anyio-4.3.0 fastapi-0.110.0 idna-3.6 pydantic-2.6.4 pydantic-core-2.16.3 sniffio-1.3.1 starlette-0.36.3 typing-extensions-4.10.0

[notice] A new release of pip is available: 23.2.1 -> 24.0
[notice] To update, run: python.exe -m pip install --upgrade pip

마지막에 다음과 같은 경고 문구가 보인다면 pip이 최신 버전이 아니라는 내용이다.

 

6. pip 최신 버전으로 설치하기

경고 메시지에 따라 다음 명령을 입력해 pip을 최신 버전으로 설치하자.

(movieapi) C:\venvs\movieapi\Scripts>python -m pip install --upgrade pip
(... 생략 ...)
      Successfully uninstalled pip-23.2.1
Successfully installed pip-24.0

 

 

 

해당 포스팅은 아래의 출처를 바탕으로 정리했습니다.

https://wikidocs.net/175214