단계별: 시를 사용하여 첫 번째 Python 라이브러리 만들기(1부)

첫 번째 Python 라이브러리를 만드는 방법을 알아보세요! 이 게시물 시리즈에서는 Poetry를 사용하여 Python 라이브러리를 만들고 게시하는 과정을 안내합니다. 초기 구성부터 기본 기능 구현 및 테스트까지 모든 것을 다루는 작은 계산기 애플리케이션 구축부터 시작하겠습니다. 이 시리즈가 끝나면 PyPI에서 전 세계와 공유할 수 있는 라이브러리가 준비됩니다.

시란 무엇입니까?

Poetry는 Python 프로젝트를 위한 종속성 관리 및 패키징 도구입니다. 전통적으로 여러 도구가 필요한 많은 작업을 자동화하여 라이브러리와 애플리케이션을 만들고 유지 관리하는 프로세스를 단순화합니다. Poetry에는 프로젝트를 결정론적으로 관리하는 데 필요한 모든 도구가 함께 제공됩니다. Poetry의 주요 장점은 다음과 같습니다.

• 프로젝트 빌드: 단일 명령으로 쉽게 프로젝트를 빌드하고 패키징합니다.
• 작업 공유: 작업을 PyPI에 게시하여 알리세요.
• 종속성 상태 확인: 단 하나의 명령으로 프로젝트의 종속성을 확인하세요.
• 종속성 해결: Poetry에는 철저한 종속성 해결 프로그램이 함께 제공되며, 존재하는 경우 항상 해결책을 찾습니다.
• 격리: Poetry는 구성된 가상 환경을 사용하거나 자체 생성하여 항상 시스템에서 격리됩니다.
• 직관적인 CLI: Poetry 명령은 직관적이고 사용하기 쉬우며 기본값을 구분하면서도 구성이 가능합니다.

이러한 장점을 통해 Poetry는 Python 프로젝트 개발을 위한 강력하고 효율적인 도구로 돋보입니다.

Python 라이브러리를 시작하기 전에 무엇이 필요합니까?

코드 작성을 시작하기 전에 개발 환경을 설정해야 합니다. 모든 것이 준비되었는지 확인하는 단계는 다음과 같습니다.

파이썬 버전 확인

먼저 최신 버전의 Python이 설치되어 있는지 확인해야 합니다. 시스템에 설치된 Python 버전을 확인하려면 터미널에서 다음 명령을 실행하세요.

python --version

아직 Python이 설치되어 있지 않거나 업데이트가 필요한 경우 공식 Python 웹사이트에서 다운로드하여 설치할 수 있습니다.

시 설치

최신 버전의 Python이 설치되어 있는지 확인한 후 다음 단계는 Poetry를 설치하는 것입니다. 공식 문서에 설명된 지침에 따라 Poetry를 설치할 수 있습니다. 빠른 설치 명령은 다음과 같습니다.

curl -sSL https://install.python-poetry.org | python3 -

라이브러리 시작: 첫 번째 단계

1단계: Poetry를 사용하여 프로젝트 만들기

이제 Python과 Poetry가 설치되었으므로 계산기 프로젝트를 시작할 차례입니다. Poetry를 사용하면 간단한 명령으로 새 프로젝트를 쉽게 만들 수 있습니다.

프로젝트를 생성하려는 디렉터리로 이동하고 터미널에서 다음 명령을 실행합니다.

poetry new calculator
cd calculator

이 명령은 필수 폴더와 파일을 포함하는 새로운 프로젝트 구조를 생성합니다.

calculator/
├── README.md
├── calculator
│   └── __init__.py
├── pyproject.toml
└── tests
    └── __init__.py

생성된 구조를 이해해 봅시다:

• README.md: 프로젝트를 설명하는 문서 파일입니다.
• calculator/: 애플리케이션의 소스 코드가 포함된 폴더입니다.
• tests/: 단위 테스트용 폴더입니다.
• pyproject.toml: Poetry의 기본 구성 파일입니다.

2단계: 계산기 기능 구현

이제 Calculator/calculator.py 파일 내에 계산기 기능을 만들어 보겠습니다.

calculator/
├── calculator.py
├── __init__.py

calculator.py 파일을 열고 기본 계산기 기능을 구현하세요.

def add(a, b):
    return a + b

def subtract(a, b):
    return a - b

def multiply(a, b):
    return a * b

def divide(a, b):
    if b == 0:
        raise ValueError("Não é possível dividir por zero")
    return a / b

3단계: 계산기 기능 테스트

테스트는 소프트웨어 품질을 보장하고 버그 수정 및 코드 발전에 대한 신뢰성을 제공하는 데 필수적입니다. 이 예에서는 단위 테스트를 사용하여 계산기 기능을 검증합니다. 테스트 환경을 설정하고 수학 연산이 올바르게 작동하는지 확인하기 위한 몇 가지 테스트 사례를 작성해 보겠습니다.

테스트 환경 구성

개발 종속성으로 pytest를 추가하여 시작하세요.

poetry add --dev pytest

이제 테스트 폴더 안에 test_calculator.py라는 파일을 만듭니다.

import pytest
from calculator.calculator import add, subtract, multiply, divide

def test_add():
    assert add(2, 3) == 5
    assert add(-1, 1) == 0
    assert add(0, 0) == 0
    assert add(-1, -1) == -2

def test_subtract():
    assert subtract(5, 2) == 3
    assert subtract(0, 0) == 0
    assert subtract(-1, 1) == -2
    assert subtract(-1, -1) == 0

def test_multiply():
    assert multiply(2, 3) == 6
    assert multiply(5, 0) == 0
    assert multiply(-1, 1) == -1
    assert multiply(-2, -3) == 6

def test_divide():
    assert divide(6, 2) == 3
    assert divide(5, 2) == 2.5
    assert divide(-10, 2) == -5
    with pytest.raises(ValueError):
        divide(4, 0)

Por fim, basta executar os testes com o seguinte comando:

poetry run pytest

Passo 4: Publicando no GitHub

Agora que nossa aplicação já está coberta com testes, vamos prepará-la para ser compartilhada no GitHub. Siga os passos abaixo para adicionar seu projeto ao GitHub:

1. Crie um repositório no GitHub: Vá para o GitHub e crie um novo repositório para sua calculadora.

2. Adicione seu projeto ao repositório:

• Inicialize o repositório Git dentro do diretório do seu projeto se ainda não estiver inicializado:

git init

• Adicione todos os arquivos ao Git e faça o primeiro commit:

git add .
git commit -m "Initial commit"

• Conecte seu repositório local ao repositório remoto no GitHub:

git remote add origin <URL_DO_SEU_REPOSITORIO_GITHUB>

• Envie seus arquivos para o GitHub:

git push -u origin main

Agora seu projeto está no GitHub e pronto para ser compartilhado e colaborado com outros desenvolvedores.

Passo 5: Instalando via Pip ou Poetry

Para instalar sua biblioteca diretamente basta usar os seguintes comandos:

• Via Pip:

pip install git+https://github.com/seu_usuario/seu_repositorio.git

• Via Poetry:

poetry add git+https://github.com/seu_usuario/seu_repositorio.git

O que vem a seguir?

Nesta primeira parte do tutorial, cobrimos os fundamentos essenciais para criar uma biblioteca Python utilizando o Poetry. Começamos configurando o ambiente de desenvolvimento, implementamos uma calculadora básica com testes unitários usando pytest, e compartilhamos o projeto no GitHub para colaboração.

Na próxima parte deste tutorial, exploraremos como publicar sua biblioteca no PyPI, o repositório padrão de pacotes Python, e aprenderemos como instalá-la usando o Poetry ou pip diretamente do PyPI. Isso não apenas facilitará o uso da sua biblioteca por outros desenvolvedores, mas também ajudará a integrá-la com a comunidade Python.

Parabéns por chegar até aqui! Espero que esteja aproveitando a criação da sua biblioteca Python. Fique à vontade para compartilhar dúvidas ou sugestões nos comentários. Vamos agora para a Parte II e continuar nossa jornada de colaboração com a comunidade Python.

Referências

• Canal Eduardo Mendes (@Dunossauro) Criando um pacote python do zero: dos requisitos ao deploy
• Documentação Poetry
• Poetry: construindo pacotes Python de uma forma fácil

위 내용은 단계별: 시를 사용하여 첫 번째 Python 라이브러리 만들기(1부)의 상세 내용입니다. 자세한 내용은 PHP 중국어 웹사이트의 기타 관련 기사를 참조하세요!