임의의 Python 함수를 명령 팔레트에 등록할 수 있는 JupyterLab 확장입니다.
nteract/papermill
명령줄이나 Python API에서 Jupyter 노트북에 매개변수를 지정해 실행하고 결과를 분석하는 Python 도구입니다.
- 스타
- 6,498
- 포크
- 465
- 열린 이슈
- 198
- 마지막 커밋
- 지난달
어떤 프로젝트인가요?
Papermill은 실행 시 전달한 매개변수로 Jupyter 노트북을 실행합니다. 셀에 `parameters` 태그를 지정해 기본값을 정의하면, Papermill이 전달된 값을 담은 새 셀을 삽입합니다. 따라서 매월 다른 날짜로 보고서를 생성하는 것처럼, 같은 노트북으로 입력값에 따라 서로 다른 결과를 만들 수 있습니다.
Python API의 `execute_notebook`이나 `papermill` 명령줄을 통해 노트북을 실행할 수 있습니다. 매개변수는 문자열, 타입이 지정된 값, YAML 파일 또는 base64로 인코딩된 YAML 형식으로 전달할 수 있습니다. 입력 및 출력 경로에는 로컬 파일, HTTP(S) URL, AWS S3, Azure Data Lake 또는 Blob Storage, Google Cloud Storage를 지정할 수 있습니다.
실행 과정을 스크립트로 자동화할 수 있어, 한 노트북의 결과에 따라 다음에 실행할 노트북이 결정되는 데이터 파이프라인에 적합합니다. `s3`나 `azure` 같은 선택적 추가 기능을 설치하면 스토리지 종속성을 추가할 수 있으며, `black` 추가 기능은 삽입된 매개변수의 형식을 지정합니다.
핵심 기능
- 01태그가 지정된 셀에 매개변수를 삽입해 하나의 노트북을 서로 다른 입력값으로 실행합니다.
- 02Python API 또는 papermill 명령줄에서 노트북을 실행합니다.
- 03타입이 지정된 값, 일반 문자열, YAML 파일 또는 YAML 문자열로 매개변수를 전달할 수 있습니다.
- 04로컬 디스크, HTTP(S), S3, Azure, Google Cloud Storage에서 노트북을 읽고 쓸 수 있습니다.
- 05삽입된 매개변수에 선택적으로 Black 형식을 적용할 수 있습니다.
활용 사례
- 같은 재무 보고서나 분석 보고서를 날짜 또는 설정을 바꿔 실행합니다.
- 한 노트북의 출력에 따라 다음 단계가 결정되는 데이터 파이프라인에서 노트북을 연결합니다.
- 예약 작업의 일부로 클라우드 객체 스토리지에 저장된 노트북을 일괄 실행합니다.
빠른 시작
- 1
PyPI에서 papermill을 설치합니다
pip install papermill - 2
노트북 셀에 'parameters' 태그를 지정하고 CLI에서 매개변수를 전달해 실행합니다
papermill local/input.ipynb local/output.ipynb -p alpha 0.6 -p l1_ratio 0.1
사용 전 알아둘 점
- Python 3.10 이상만 지원합니다.
토픽
자주 묻는 질문
- papermill은(는) 무엇인가요?
- 명령줄이나 Python API에서 Jupyter 노트북에 매개변수를 지정해 실행하고 결과를 분석하는 Python 도구입니다. Papermill은 실행 시 전달한 매개변수로 Jupyter 노트북을 실행합니다. 셀에 `parameters` 태그를 지정해 기본값을 정의하면, Papermill이 전달된 값을 담은 새 셀을 삽입합니다. 따라서 매월 다른 날짜로 보고서를 생성하는 것처럼, 같은 노트북으로 입력값에 따라 서로 다른 결과를 만들 수 있습니다.
- papermill은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
- papermill은(는) BSD-3-Clause 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
- papermill은(는) 아직 유지보수되고 있나요?
- 6개월 이내 업데이트. papermill의 마지막 커밋은 2026년 10월 5일입니다.
- papermill은(는) 어디에 사용할 수 있나요?
- 같은 재무 보고서나 분석 보고서를 날짜 또는 설정을 바꿔 실행합니다. 한 노트북의 출력에 따라 다음 단계가 결정되는 데이터 파이프라인에서 노트북을 연결합니다. 예약 작업의 일부로 클라우드 객체 스토리지에 저장된 노트북을 일괄 실행합니다.
- papermill는 어떻게 설치하나요?
- PyPI에서 papermill을 설치합니다: pip install papermill 노트북 셀에 'parameters' 태그를 지정하고 CLI에서 매개변수를 전달해 실행합니다: papermill local/input.ipynb local/output.ipynb -p alpha 0.6 -p l1_ratio 0.1
- papermill은(는) 어디서 받을 수 있나요?
- 소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/nteract/papermill
요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.
관련 프로젝트
구성 가능한 커널과 확장 기능을 갖춘 선언적·재현 가능한 JupyterLab 환경을 위한 Nix 기반 프레임워크입니다.
Jupyter 노트북을 일반 Markdown 또는 Python, Julia, R 스크립트로 저장해 Git에서 변경 사항을 깔끔하게 비교하고 버전 관리합니다.
저장소의 설정 파일을 바탕으로 Git 저장소를 Jupyter가 포함된 Docker 이미지로 빌드합니다.
보고서 노트북처럼 셀을 순차적으로 실행하는 노트북의 개별 셀을 대상으로 단위 테스트를 작성하는 JupyterLab 확장 및 Python 패키지입니다.
변경된 셀에 의존하는 셀을 자동으로 다시 실행하고, 노트북을 일반 .py 파일로 저장하며, 스크립트나 배포 앱으로 실행할 수 있는 반응형 Python 노트북입니다.