ensurepip — pip 설치 프로그램 부트스트랩

버전 3.4에 추가.

ensurepip 패키지는 pip 설치 프로그램을 기존의 파이썬 설치나 가상 환경으로 부트스트랩 하는데 필요한 지원을 제공합니다. 이 부트스트랩 접근 방식은 pip가 자체 배포 주기가 있는 독립적인 프로젝트이며, 최신 사용 가능한 안정 버전이 CPython 참조 인터프리터의 유지 보수와 기능 배포에 번들로 제공된다는 사실을 반영합니다.

대부분, 파이썬의 최종 사용자는 이 모듈을 직접 호출할 필요가 없습니다 (pip는 기본적으로 부트스트랩 되어있어야 하기 때문입니다). 하지만, 파이썬을 설치할 때 (또는 가상 환경을 만들 때) pip를 건너뛰었거나 그 후에 명시적으로 pip를 제거했다면 필요할 수 있습니다.

참고

이 모듈은 인터넷에 접속하지 않습니다. pip를 부트스트랩 하는 데 필요한 모든 구성 요소는 패키지의 내부 부품으로 포함됩니다.

더 보기

파이썬 모듈 설치하기

파이썬 패키지를 설치하기 위한 최종 사용자 지침서

PEP 453: 파이썬 설치에서 pip의 명시적 부트스트랩

이 모듈의 원래 근거와 사양.

명령 줄 인터페이스

명령 줄 인터페이스는 인터프리터의 -m 스위치를 사용하여 호출됩니다.

가장 간단한 호출은 이렇습니다:

python -m ensurepip

이 호출은 아직 설치되지 않았으면 pip를 설치하지만, 그렇지 않으면 아무것도 하지 않습니다. pip의 설치 버전이 적어도 ensurepip에 번들 된 최신 버전이 되도록 하려면, --upgrade 옵션을 전달하십시오:

python -m ensurepip --upgrade

기본적으로, pip는 현재 가상 환경(활성화되었다면)이나 시스템 사이트 패키지(활성 가상 환경이 없으면)에 설치됩니다. 설치 위치는 두 개의 추가 명령 줄 옵션을 통해 제어할 수 있습니다:

  • --root <dir>: 현재 활성화된 가상 환경의 루트(있다면)나 현재 파이썬 설치의 기본 루트 대신, 지정된 루트 디렉터리에 상대적으로 pip를 설치합니다.

  • --user: pip를 현재 파이썬 설치에 전역적으로 설치하지 않고 사용자 사이트 패키지 디렉터리에 설치합니다 (이 옵션은 활성 가상 환경에서는 허용되지 않습니다).

기본적으로, pipX 와 pipX.Y 스크립트가 설치됩니다 (여기서 X.Y는 ensurepip를 호출하는 데 사용된 파이썬 버전을 나타냅니다). 설치된 스크립트는 두 개의 추가 명령 줄 옵션을 통해 제어할 수 있습니다:

  • --altinstall: 대안 설치가 요청되면, pipX 스크립트가 설치되지 않습니다.

  • --default-pip: “기본 pip” 설치가 요청되면, 두 개의 일반 스크립트에 더해 pip 스크립트가 설치됩니다.

두 스크립트 선택 옵션을 모두 제공하면 예외가 발생합니다.

모듈 API

ensurepip는 프로그래밍 방식으로 사용하기 위해 두 가지 함수를 제공합니다:

ensurepip.version()

환경을 부트스트랩 할 때 설치될 pip의 번들 버전을 지정하는 문자열을 반환합니다.

ensurepip.bootstrap(root=None, upgrade=False, user=False, altinstall=False, default_pip=False, verbosity=0)

pip를 현재나 지정된 환경으로 부트스트랩 합니다.

root는 상대 경로로 설치할 대안 루트 디렉터리를 지정합니다. root가 None이면, 설치는 현재 환경의 기본 설치 위치를 사용합니다.

upgrade는 이미 설치된 이전 버전의 pip를 번들 된 버전으로 업그레이드할지를 나타냅니다.

user는 전역으로 설치하는 대신 사용자 구성을 사용할지를 나타냅니다.

기본적으로, pipX 및 pipX.Y 스크립트가 설치됩니다 (여기서 X.Y는 현재 버전의 파이썬을 나타냅니다).

altinstall가 설정되면, pipX가 설치되지 않습니다.

default_pip가 설정되면, 두 개의 일반 스크립트에 더해 pip가 설치됩니다.

altinstall 과 default_pip를 모두 설정하면 ValueError가 발생합니다.

verbosity는 부트스트랩 연산에서 sys.stdout로 출력하는 수준을 제어합니다.

인자 root로 감사 이벤트(auditing event) ensurepip.bootstrap을 발생시킵니다.

참고

부트스트랩 프로세스에는 sys.path 와 os.environ 모두에 부작용이 있습니다. 대신 자식 프로세스에서 명령 줄 인터페이스를 호출하면 이러한 부작용을 피할 수 있습니다.

참고

부트스트랩 프로세스는 pip에 필요한 추가 모듈을 설치할 수 있지만, 다른 소프트웨어는 이러한 종속성이 기본적으로 항상 존재한다고 가정해서는 안 됩니다 (pip의 차후 버전에서 제거될 수 있기 때문입니다).