# Pipenv

## 1. 개요
**Pipenv**는 파이썬(Python) 프로젝트의 패키지 관리와 가상 환경(Virtual Environment) 관리를 하나로 통합한 도구입니다. 기존의 `pip`와 `virtualenv` (또는 `venv`)를 각각 사용하여 패키지를 설치하고 환경을 분리하던 방식의 불편함을 해소하기 위해 개발되었습니다.

Pipenv는 **"Python Development Workflow for Humans"**라는 슬로건 아래, Node.js의 `npm`이나 Ruby의 `bundler`와 유사한 사용자 경험을 파이썬 생태계에 제공하는 것을 목표로 합니다.

---

## 2. 주요 특징 및 필요성

### 2.1 기존 방식의 한계점
전통적인 파이썬 개발 방식에서는 다음과 같은 문제점이 있었습니다.
- **`requirements.txt`의 한계**: 설치된 패키지의 버전만 기록할 뿐, 패키지 간의 의존성 그래프(Dependency Graph)를 관리하지 못해 버전 충돌이 발생할 가능성이 높았습니다.
- **가상 환경 관리의 번거로움**: `venv`나 `virtualenv`로 환경을 생성한 후, 매번 `source bin/activate`와 같은 명령어로 활성화해야 하는 불편함이 있었습니다.
- **결정론적 빌드(Deterministic Build) 부족**: 개발 환경과 운영 환경에서 설치되는 패키지 버전이 미세하게 달라져 "내 컴퓨터에서는 되는데 서버에서는 안 된다"는 문제가 빈번했습니다.

### 2.2 Pipenv의 해결책
- **Pipfile 및 Pipfile.lock 도입**: `requirements.txt`를 대체하여 패키지 버전과 의존성을 정밀하게 관리합니다.
- **자동 가상 환경 관리**: 프로젝트 디렉토리 내에서 명령어를 실행하면 Pipenv가 자동으로 적절한 가상 환경을 생성하고 연결합니다.
- **의존성 그래프 생성**: 패키지 간의 관계를 분석하여 충돌을 사전에 방지하고, 정확히 동일한 환경을 재현할 수 있게 합니다.

---

## 3. 핵심 구성 요소

### 3.1 Pipfile
`Pipfile`은 TOML 형식의 파일로, 프로젝트에 필요한 패키지들을 논리적으로 구분하여 저장합니다.
- **`[packages]`**: 실제 서비스 운영에 필요한 라이브러리 (Production dependencies)
- **`[dev-packages]`**: 테스트, 린팅, 포매팅 등 개발 단계에서만 필요한 라이브러리 (Development dependencies)

### 3.2 Pipfile.lock
`Pipfile.lock`은 설치된 모든 패키지의 **정확한 버전**과 **해시(Hash) 값**을 기록한 파일입니다. 이를 통해 모든 팀원이 1비트의 오차도 없이 동일한 환경을 구축할 수 있으며, 해시 값을 통해 패키지 변조 여부를 확인하여 보안성을 높입니다.

---

## 4. 주요 사용법

### 4.1 설치 및 초기화
먼저 pip를 통해 Pipenv를 설치합니다.
```bash
pip install pipenv
```

프로젝트 폴더에서 다음 명령어를 실행하면 가상 환경이 생성되고 `Pipfile`이 만들어집니다.
```bash
pipenv install
```

### 4.2 패키지 관리
- **패키지 설치**:
  ```bash
  pipenv install requests  # 일반 패키지 설치
  pipenv install pytest --dev  # 개발용 패키지로 설치
  ```
- **패키지 삭제**:
  ```bash
  pipenv uninstall requests
  ```
- **환경 동기화 (운영 서버 등)**:
  ```bash
  pipenv install --deploy
  ```

### 4.3 가상 환경 실행
- **쉘 진입**: 가상 환경 내부로 들어가서 작업을 수행합니다.
  ```bash
  pipenv shell
  ```
- **단일 명령 실행**: 쉘에 진입하지 않고 특정 명령어만 실행합니다.
  ```bash
  pipenv run python main.py
  ```

---

## 5. 요약 및 비교

| 비교 항목 | pip + requirements.txt | Pipenv |
| :--- | :--- | :--- |
| **환경 관리** | `venv` 등으로 수동 관리 | 자동 생성 및 관리 |
| **의존성 기록** | `requirements.txt` (단순 목록) | `Pipfile` (구조적 관리) |
| **버전 고정** | 수동으로 버전 명시 필요 | `Pipfile.lock`을 통한 완전 고정 |
| **개발/운영 분리** | `req-dev.txt` 등으로 파일 분리 | `[dev-packages]` 섹션으로 통합 관리 |
| **보안성** | 검증 수단 부족 | 해시(Hash) 값을 통한 무결성 검증 |

---

## 6. 관련 문서 및 참고 자료
- [Pipenv 공식 문서 (Official Documentation)](https://pipenv.pypa.io/)
- [Python Packaging User Guide](https://packaging.python.org/)
- **관련 도구**: `Poetry` (Pipenv와 유사하게 의존성 관리와 패키징을 지원하는 최신 도구)