theskumar/python-dotenv

어떤 프로젝트인가요?

핵심 기능

• 01기본적으로 기존 변수를 덮어쓰지 않고 .env 파일의 값을 os.environ에 불러옵니다.
• 02dotenv_values()를 통해 환경을 변경하지 않고 파싱한 값을 dict로 반환합니다.
• 03파일뿐 아니라 스트림에서도 설정을 읽습니다.
• 04따옴표, 주석, export 접두사, 여러 줄 값 등 Bash와 비슷한 구문을 지원합니다.
• 05값 안에 ${VAR} 형식으로 작성된 변수를 확장합니다.
• 06불러온 변수로 명령을 설정하거나, 목록을 확인하거나, 실행할 수 있는 dotenv CLI를 제공합니다.
• 07.env 파일을 불러오는 IPython 확장 기능을 제공합니다.

활용 사례

• 개발 중 Python 웹 앱의 데이터베이스 URL과 API 키를 로컬 .env 파일에 보관합니다.
• 네트워크 스트림처럼 파일 시스템이 아닌 소스에서 Python 프로그램으로 설정을 불러옵니다.
• dotenv run 명령으로 .env 파일의 변수를 사용해 스크립트를 실행합니다.
• os.environ을 변경하지 않고 .env 값을 dict로 읽어 설정을 병합합니다.

빠른 시작

1. 1

   PyPI에서 라이브러리를 설치합니다

   pip install python-dotenv
2. 2

   프로젝트 루트에 설정을 담은 .env 파일을 만듭니다

3. 3

   애플리케이션을 시작할 때 load_dotenv()를 호출합니다

사용 전 알아둘 점

• !.env 파일 형식은 공식적으로 규정되어 있지 않으며 시간이 지나면서 변경될 수 있습니다.

토픽

자주 묻는 질문

python-dotenv은(는) 무엇인가요?

12-factor 앱 방식에 따라 .env 파일의 키-값 쌍을 환경 변수로 불러오는 Python 라이브러리입니다. python-dotenv는 .env 파일에서 키-값 쌍을 읽어 환경 변수로 설정합니다. 환경에서 설정을 가져오는 12-factor 앱을 위한 라이브러리로, 개발 중에는 매번 셸에서 변수를 내보내지 않고도 로컬 파일에 설정을 보관할 수 있습니다.

python-dotenv은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

python-dotenv은(는) BSD-3-Clause 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

python-dotenv은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. python-dotenv의 마지막 커밋은 2026년 10월 28일입니다.

python-dotenv은(는) 어디에 사용할 수 있나요?

개발 중 Python 웹 앱의 데이터베이스 URL과 API 키를 로컬 .env 파일에 보관합니다. 네트워크 스트림처럼 파일 시스템이 아닌 소스에서 Python 프로그램으로 설정을 불러옵니다. dotenv run 명령으로 .env 파일의 변수를 사용해 스크립트를 실행합니다. os.environ을 변경하지 않고 .env 값을 dict로 읽어 설정을 병합합니다.

python-dotenv는 어떻게 설치하나요?

PyPI에서 라이브러리를 설치합니다: pip install python-dotenv 프로젝트 루트에 설정을 담은 .env 파일을 만듭니다 애플리케이션을 시작할 때 load_dotenv()를 호출합니다

python-dotenv은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/theskumar/python-dotenv