Repolode
nteract

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. 1

    PyPI에서 papermill을 설치합니다

    pip install papermill
  2. 2

    노트북 셀에 'parameters' 태그를 지정하고 CLI에서 매개변수를 전달해 실행합니다

    papermill local/input.ipynb local/output.ipynb -p alpha 0.6 -p l1_ratio 0.1

사용 전 알아둘 점

  • Python 3.10 이상만 지원합니다.

토픽

#jupyter#notebook#data-pipeline#parameters#python#automation#julia#notebook-generator#notebooks#nteract

자주 묻는 질문

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 통계는 매일 갱신됩니다.

관련 프로젝트

변경된 셀에 의존하는 셀을 자동으로 다시 실행하고, 노트북을 일반 .py 파일로 저장하며, 스크립트나 배포 앱으로 실행할 수 있는 반응형 Python 노트북입니다.

2.3만+83 이번 주1.4천PythonApache-2.0활발히 관리됨업데이트 17시간 전