Daha önce yazdığın betikleri dönüştürerek paketine başlangıç yap. Kendi bilgisayarında kullanabileceğin basit bir paket oluşturacaksın.

Bir pakete başlama

Modüller, paketler ve alt paketler

Betikten pakete

Paketi işe koşmak

Dokümantasyon

pyment ile fonksiyon dokümantasyonu yazma

pyment ile fonksiyon dokümantasyonu yazma II

Paket ve modül dokümantasyonu

İçe aktarımları yapılandırma

Kardeş içe aktarımlar

Üst dizinden içe aktarma

Fonksiyonları kullanıcılara açma

Dağınık Koddan Yerel Pakete

Paketini kendin ve başkaları için kurulabilir hale getir. Bu bölümde bağımlılıkları ele almayı, README yazmayı ve lisans eklemeyi öğreneceksin. Ayrıca paketini Python paketlerinin ana yuvası olan PyPI’de yayımlamak için gerekli tüm adımları tamamlayacaksın.

Kendi paketini yükleme

Kurulum betiğini ekleme

Paketini yerel olarak yükleme

Düzenlenebilir kurulumları kullanma

Bağımlılıkları yönetme

Kullanıcı bağımlılıkları

Geliştirme bağımlılıkları

Lisansları eklemek ve README yazmak

README yazma

MANIFEST - Paketinle birlikte ekstra dosyaları eklemek

Paketini yayımlama

Bir dağıtım oluşturma

Dağıtımları yükleme

Paketini Her Yerden Yükle

Paketini profesyonel bir seviyeye taşı. Hatalara karşı koruma sağlamak için pytest’i, paketinin Python’un birden fazla sürümüyle çalışıp çalışmadığını test etmek için tox’u ve harika bir kod stili korumak için flake8’i nasıl kullanacağını keşfet.

Paketini test etmek

from impyrial.length.core import inches_to_feet, inches_to_yards


Test dizinini oluşturma

from impyrial.length.core import inches_to_feet, inches_to_yards

# Define tests for inches_to_feet function
def ____():
	# Check that 12 inches is converted to 1.0 foot
    ____ ____(____) == 1.0 
    # Check that 2.5 feet is converted to 30.0 inches
    ____ ____(____, reverse=True) == ____


from impyrial.length.core import inches_to_feet, inches_to_yards

# Define tests for inches_to_feet function
def test_inches_to_feet():
	# Check that 12 inches is converted to 1.0 foot
    assert inches_to_feet(12) == 1.0
    # Check that 2.5 feet is converted to 30.0 inches
    assert inches_to_feet(2.5, reverse=True) == 30.0


Bazı temel testler yazma

from impyrial.length.core import inches_to_feet, inches_to_yards

# Define tests for inches_to_feet function
def test_inches_to_feet():
	# Check that 12 inches is converted to 1 foot
    assert inches_to_feet(12) == 1.0
    # Check that 2.5 feet is converted to 30 inches
    assert inches_to_feet(2.5, reverse=True) == 30.0
    


"""Conversions between inches and larger imperial length units"""
INCHES_PER_FOOT = 120  # 12.0 inches in a foot
INCHES_PER_YARD = INCHES_PER_FOOT * 3.0  # 3 feet in a yard

UNITS = ("in", "ft", "yd")


def inches_to_feet(x, reverse=False):
    """Convert lengths between inches and feet.
    Parameters
    ----------
    x : array_like
        Lengths in feet.
    reverse : bool, optional
        If this is set to true this function converts from feet to inches
        instead of the default behaviour of inches to feet.
    Returns
    -------
    ndarray
        An array of converted lengths with the same shape as `x`. If `x` is a
        0-d array, then a scalar is returned.
    """
    if reverse:
        return x * INCHES_PER_FOOT
    else:
        return x / INCHES_PER_FOOT


def inches_to_yards(x, reverse=False):
    """Convert lengths between inches and yards.
    Parameters
    ----------
    x : array_like
        Lengths in feet.
    reverse : bool, optional
        If this is set to true this function converts from yards to inches
        instead of the default behaviour of inches to yards.
    Returns
    -------
    ndarray
        An array of converted lengths with the same shape as `x`. If `x` is a
        0-d array, then a scalar is returned.
    """
    if reverse:
        return x * INCHES_PER_YARD
    else:
        return x / INCHES_PER_YARD


"""Conversions between inches and larger imperial length units"""
INCHES_PER_FOOT = 12.0  # 12.0 inches in a foot
INCHES_PER_YARD = INCHES_PER_FOOT * 3.0  # 3 feet in a yard

UNITS = ("in", "ft", "yd")


def inches_to_feet(x, reverse=False):
    """Convert lengths between inches and feet.
    Parameters
    ----------
    x : array_like
        Lengths in feet.
    reverse : bool, optional
        If this is set to true this function converts from feet to inches
        instead of the default behaviour of inches to feet.
    Returns
    -------
    ndarray
        An array of converted lengths with the same shape as `x`. If `x` is a
        0-d array, then a scalar is returned.
    """
    if reverse:
        return x * INCHES_PER_FOOT
    else:
        return x / INCHES_PER_FOOT


def inches_to_yards(x, reverse=False):
    """Convert lengths between inches and yards.
    Parameters
    ----------
    x : array_like
        Lengths in feet.
    reverse : bool, optional
        If this is set to true this function converts from yards to inches
        instead of the default behaviour of inches to yards.
    Returns
    -------
    ndarray
        An array of converted lengths with the same shape as `x`. If `x` is a
        0-d array, then a scalar is returned.
    """
    if reverse:
        return x * INCHES_PER_YARD
    else:
        return x / INCHES_PER_YARD


Testlerini çalıştırma

Paketini farklı ortamlarda test etme

[tox]
____

[testenv]
____ = 
	____
____ =
	____


[tox]
envlist = py27, py39

[testenv]
deps = 
	pytest
commands =
	pytest


tox'u kurma

[tox]
envlist = py27, py39

[testenv]
deps = 
	pytest
commands =
	pytest
    


from setuptools import setup, find_packages

# Add install requirements
setup(
    author="<your-name>",
    description="A package for converting imperial lengths and weights.",
    name="impyrial",
    packages=find_packages(include=["impyrial", "impyrial.*"]),
    version="0.1.0",
    install_requires=['numpy>=1.10', 'pandas'],
    #python_requires="==____.*",
)


from setuptools import setup, find_packages

# Add install requirements
setup(
    author="<your-name>",
    description="A package for converting imperial lengths and weights.",
    name="impyrial",
    packages=find_packages(include=["impyrial", "impyrial.*"]),
    version="0.1.0",
    install_requires=['numpy>=1.10', 'pandas'],
    python_requires="==3.9.*",
)


tox çalıştırma

Paketini şık tutmak

Uygun biçem filtreleme

"""Main module."""

def absolute_value(num):
    """Return the absolute value of the number"""
    if num>=0: return num
    else:
    	return -num


"""Main module."""


def absolute_value(num):
    """Return the absolute value of the number"""
    if num >= 0:
        return num
    else:
        return -num


Bir dosyayı temizlemek için flake8 kullanma

import numpy as np


def calculate_hypotenuse(side1, side2):
    """Calculate the length of the hypotenuse."""
    l = np.sqrt( side1**2 + side2**2 )  # ____: ____
    return l


import numpy as np


def calculate_hypotenuse(side1, side2):
    """Calculate the length of the hypotenuse."""
    l = np.sqrt( side1**2 + side2**2 )  # noqa: E741
    return l


Belirli hataları yok sayma

[flake8]

# Ignore F401 violations in the main __init__.py file
# per-file-ignores =
#     ____ : ____
        
# Ignore all violations in the tests directoory
# exclude = ____


from impyrial.length.api import (
    convert_unit,
    unit_to_mixed,
    mixed_to_unit,
)

def test_convert_unit():
    assert convert_unit(30, "ft", "in")==360.0
    assert convert_unit(30, "yd", "ft")==90.0
    assert convert_unit(10, "mi", "yd")==17600.0


[flake8]

# Ignore F401 violations in the main __init__.py file
per-file-ignores =
    impyrial/__init__.py: F401
        
# Ignore all violations in the tests directoory
exclude = tests/*


flake8'i yapılandırma

Paket Kaliteni Artırma

Paketlerini daha hızlı oluştur. Bu son bölümde, paketinin ihtiyaç duyduğu tüm destekleyici dosyaları üretmek için cookiecutter kullanmayı, yeni sürümleri yayımlamayı kolaylaştırmak için Makefile’ları kullanmayı ve kullanıcıları ile katkıda bulunanları çekmek için gereken son birkaç dosyayla tanışmayı öğreneceksin.

Şablonlarla daha hızlı paket geliştirme

Paket şablonlarını kullanma

Sürüm numaraları ve geçmişi

CONTRIBUTING.md

Geçmiş dosyası

bumpversion ile sürüm numarasını izleme

Makefile'lar ve sınıflandırıcılar

PyPI sınıflandırıcıları

Makefile kullanma

Kapanış

Hızlı Paket Geliştirme

Aynı kodu dosyalar arasında kopyalayıp yapıştırırken, keşke bu harika parçacıkları yeniden kullanmak ve paylaşmak daha kolay olsa diye düşünüyor musun? Kodunu Python paketlerine sarmak yardımcı olabilir! Bu kursta, dağınık kodu kullanışlı paketlere dönüştürmek için paket yapısını ve gereken ek dosyaları öğreneceksin. Ayrıca içe aktarma yapısı, dokümantasyon ve flake8 ile kod stilini nasıl koruyacağını da göreceksin. Ardından, şablonlar oluşturarak ve cookiecutter kullanarak paket iskeletleri yaratarak geliştirme hızını artıracaksın. Son olarak, paketlerini PyPI’ye—Python paketlerinin dünya sahnesine—yapılandırmak ve yayımlamak için setuptools ve twine kullanmayı öğreneceksin.

Introduction to Shell

Writing Functions in Python

Paket yapısını, ithalat yapısını, belgeleri öğrenin, kod stilini koruyun, şablonlar oluşturun.

Python Paketleri Geliştirme

Kodunuzu daha kolay kullanmak ve başkalarıyla paylaşmak için kendi Python paketlerinizi oluşturmayı öğrenin.

tox çalıştırma

Python Paketleri Geliştirme

Uygulamalı etkileşimli egzersiz