Python 라이브러리를 빌드하고 배포하는 방법

소프트웨어 개발에서는 많은 프로젝트에 동일한 코드와 로직을 사용하는 반복적인 작업이 포함됩니다. 프로그래머는 이 코드를 지속적으로 다시 작성하여 비효율성을 초래합니다. 예로는 이메일 확인 또는 임의 문자열 생성이 있습니다.

해결책은 이 코드를 재사용 가능한 라이브러리에 패키징하는 것입니다. 이러한 라이브러리는 프로젝트 전반에 걸쳐 설치 및 사용되므로 중복 코딩이 제거됩니다. 대부분은 오픈 소스이며 무료로 사용할 수 있습니다.

이것은 Python 및 JavaScript와 같은 언어의 표준 관행입니다. 이 튜토리얼에서는 공식 Python 패키지 저장소인 PyPI에 Python 라이브러리를 구축하고 배포하는 방법을 자세히 설명합니다.

사업개요

이 튜토리얼에서는 REST API와 상호작용하는 오픈 소스 Python 라이브러리를 생성하고 배포하는 과정을 안내합니다.

파이썬 라이브러리

라이브러리는 Abstract API의 Exchange Rates REST API를 래핑합니다. 이 API는 세 가지 엔드포인트를 제공합니다.

• /live: 실시간 환율을 검색합니다.
• /convert: 통화 간 금액을 변환합니다(예: 5 USD를 GBP로).
• /historical: 특정 기간의 과거 환율을 검색합니다.

이 라이브러리는 개발자의 API 상호 작용을 단순화합니다.

프로젝트 요구사항

이 튜토리얼에서는 객체 지향 프로그래밍(OOP) 및 함수 사용을 포함한 Python 코딩 능력을 가정합니다. Git, GitHub 리포지토리, 프로젝트 푸시에 대한 지식도 필요합니다.

도구 및 패키지

필요한 사항:

• Python: 통역사(>=3.9).
• 요청: HTTP 요청용.
• 추상 API 계정: API 키를 얻기 위해(지침 제공)
• Dotenv: 환경변수 관리용.
• 시: Python 종속성 관리 및 패키징 도구입니다.

프로젝트 생성

1. 프로젝트 디렉터리 만들기:

   <code class="language-bash">mkdir exchangeLibrary</code>

2. virtualenv 설치(아직 설치하지 않은 경우):

   <code class="language-bash">pip install virtualenv</code>

3. 프로젝트 디렉토리로 이동하세요:

   <code class="language-bash">cd exchangeLibrary</code>

4. 가상 환경 생성 및 활성화:

   <code class="language-bash">virtualenv env</code>

   활성화(Windows): .envScriptsactivate 활성화(Linux/macOS): source env/bin/activate

5. 필수 패키지 설치:

   <code class="language-bash">pip install requests poetry dotenv</code>

6. 코드 편집기(PyCharm/VS Code)에서 프로젝트를 엽니다.

프로젝트 자원 설정

1. src 디렉터리 만들기: 내부에 exchange_python 및 __init__.py이 포함된 exchange.py을 만듭니다. 구조는 아래 이미지와 유사해야 합니다.

   

2. 단위 테스트를 위해 test.py을 만듭니다.

3. 추상 API 키 얻기: 에이. Abstract API에 가입하세요. 비. 로그인하세요. 기음. 환율 API로 이동합니다. 디. 기본 키를 얻으세요.

4. .env 파일 만들기: API 키 추가:

   <code class="language-bash">mkdir exchangeLibrary</code>

   이제 구조는 다음과 같습니다.

API 래퍼 구축(exchange.py)

<code class="language-bash">pip install virtualenv</code>

(live, historical, convert 메소드는 원래 입력의 설명대로 유지됩니다.)

API 래퍼 테스트(test.py)

1. __init__.py:

   <code class="language-bash">cd exchangeLibrary</code>

2. test.py:

   <code class="language-bash">virtualenv env</code>

3. 테스트 실행: 성공적인 테스트 결과가 표시됩니다.

프로젝트 배포

1. .gitignore 파일 만들기: env, .env 추가.

2. README.md 파일을 만듭니다.

3. 만들기 pyproject.toml:

   <code class="language-bash">pip install requests poetry dotenv</code>

4. GitHub 저장소를 생성하세요.

5. Git 초기화: git init

6. 리모컨 추가: git remote add origin <your github repo>

7. GitHub 저장소 URL로 pyproject.toml을 업데이트하세요.

8. GitHub으로 푸시하세요.

PyPI에 배포

1. PyPI 계정을 만들고 이메일을 확인하세요.
2. 2FA를 설정하세요.
3. 복구 코드를 생성하세요.
4. 인증 앱을 사용하여 QR 코드를 스캔하세요.
5. API 토큰을 받으세요.
6. 패키지 빌드: poetry build
7. PyPI 토큰 설정: poetry config pypi-token.pypi <your-api-token>
8. 게시: poetry publish

프로젝트 유지관리

업데이트 후 GitHub에 변경 사항을 푸시하고, 빌드(poetry build)하고, 다시 게시(poetry publish)하고, 필요에 따라 pyproject.toml에서 버전을 업데이트합니다.

설치 및 사용

<code class="language-bash">mkdir exchangeLibrary</code>

<code class="language-bash">pip install virtualenv</code>

결론

이 튜토리얼에서는 업데이트 및 재게시를 포함하여 Python 라이브러리를 PyPI에 구축하고 배포하는 방법을 다뤘습니다. 오픈 소스 커뮤니티에 대한 귀하의 기여는 Python 개발을 개선하는 데 도움이 됩니다.

위 내용은 Python 라이브러리를 빌드하고 배포하는 방법의 상세 내용입니다. 자세한 내용은 PHP 중국어 웹사이트의 기타 관련 기사를 참조하세요!