자신만의 Python 패키지를 만들고 배포하세요

모든 것은 당신이 자신의 Python 패키지를 생성하고 효과적으로 배포할 수 있는 방법에 대한 질문으로 시작됩니다. 이 가이드에서는 패키지를 개발하여 다른 사용자에게 제공할 수 있도록 단계별로 진행하는 방법을 보여드리겠습니다. 올바른 파일을 생성하고 올바른 구조를 보장하는 것이 필수적입니다. 이를 통해 다른 사람들이 당신의 패키지를 쉽게 설치하고 사용할 수 있습니다. 바로 시작하여 패키지 배포의 기본을 탐색해 보겠습니다.

주요 통찰

1. 패키지의 모든 메타데이터를 포함하는 setup.py 파일을 생성하세요.
2. 모든 비-Python 파일을 나열하는 매니페스트 파일을 추가하세요.
3. 터미널에서 배포를 만들기 위한 올바른 명령을 사용하세요.
4. 압축 해제된 패키지는 쉽게 설치할 수 있도록 전달할 수 있습니다.

단계별 가이드

자신의 Python 패키지를 만들기 위해 따라야 할 몇 가지 중요한 단계가 있습니다. 아래에는 자신의 패키지 배포를 위한 길을 안내하는 세부 가이드와 스크린샷이 있습니다.

디렉토리 구조 생성

먼저 패키지를 위한 올바른 디렉토리 구조를 준비해야 합니다. 소스 코드, 문서 및 라이센스 정보를 포함하여 모든 파일과 하위 디렉토리를 포함하는 기본 디렉토리를 만드세요.

이 예제에서는 README.md 파일과 라이센스 파일이 포함된 간단한 구조를 준비합니다. 패키지의 권리를 정의하기 위해 GPL 라이센스를 사용할 수 있습니다.

API 구조 정의

패키지를 유용하게 만들기 위해서는 최소한 하나의 API 문서와 다른 클래스가 상속할 수 있는 기본 클래스가 필요합니다. 이 구조는 패키지의 확장 및 맞춤화를 가능하게 합니다.

간단한 API 및 저장 재고 클래스는 훌륭한 출발점을 제공할 수 있습니다.

setup.py 파일 생성

패키지의 핵심 구성 요소는 setup.py 파일입니다. 여기서 설치 과정에서 필요한 모든 프로젝트 정보를 정의합니다.

이 파일에서 필요한 모듈을 가져오고 패키지 이름, 저자, 이메일, 버전 번호 및 웹사이트를 포함한 기본 세부 정보를 제공합니다.

필요한 패키지 지정

패키지의 모든 종속성이 명시되도록 해야 합니다. 이는 setup.py에서 패키지 목록을 추가하여 처리합니다.

여기서 기본 클래스 및 특정 종합 클래스를 포함하여 모든 필요 하위 패키지를 추가하세요.

매니페스트 파일 생성

모든 관련 비-Python 파일이 패키지에 포함되도록 매니페스트 파일을 생성하세요. 이 파일은 패키징 시 고려해야 할 모든 파일을 나열합니다.

이 파일에서 포함할 파일 유형과 문서화와 같은 디렉토리를 지정합니다.

배포 생성을 위한 터미널 명령

이제 패키지를 생성할 시간입니다. 터미널을 열고 setup.py가 있는 디렉토리로 이동하세요. 여기에서 패키지를 생성하는 명령을 실행할 수 있습니다.

생성된 파일 확인

배포를 생성한 후에는 패키지가 포함된 dist라는 이름의 디렉토리를 찾아야 합니다.

이제 이 파일을 배포하거나 설치할 수 있습니다.

패키지 설치

패키지가 올바르게 작동하는지 확인하기 위해 스스로 다시 설치할 수 있습니다. 이를 위해 디렉토리를 압축 해제하고 setup.py 파일을 다시 실행하세요.

관리자 권한이 없는 사용자에게는 현재 사용자에 대한 설치 명령을 실행할 수 있습니다:

python setup.py install --user

사용자를 위한 배포

패키지를 배포하고자 할 경우 README.md, 라이센스 및 setup.py와 같은 모든 파일이 포함되도록 하세요. 이는 사용자가 패키지를 다운로드할 때 올바르게 설치될 수 있도록 보장합니다.

여기에서 당신의 패키지가 파일 시스템에 준비되어 있으며 다른 사람에게 제공될 수 있습니다.

요약 – 나만의 Python 패키지를 올바르게 포장하세요

이제 당신은 자신의 Python 패키지를 위한 포괄적인 구조를 만들고 쉽게 배포할 수 있는 배포판을 성공적으로 생성하는 방법을 배웠습니다. 디렉토리 구조 생성부터 최종 사용자가 설치할 수 있는 단계까지, 당신은 자신의 패키지를 효과적으로 배포하기 위해 모든 단계를 거쳤습니다.