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

Seçenekler

Modül

Paket

Alt paket

Modüller, paketler ve alt paketler

# Open the text file
with open('alice.txt') as file:
    text = file.read()

n = 0
for word in text.split():
    # Count the number of times the words in the list appear
    if word.lower() in ['cat', 'cats']:
        n += 1

print('Lewis Carroll uses the word "cat" {} times'.format(n))


def count_words(filepath, words_list):
    # Open the text file
    with open(filepath) as file:
        text = file.read()
    
    n = 0
    for word in text.split():
        # Count the number of times the words in the list appear
        if word.lower() in words_list:
            n += 1
    return n


Betikten pakete

def count_words(filepath, words_list):
    # Open the text file
    with open(filepath) as file:
        text = file.read()
    # Count number of times these words appear
    n = 0
    for word in text.split():
        if word.lower() in words_list:
            n += 1
    return n


from textanalysis.textanalysis import count_words

# Count the number of positive words
nb_positive_words = ____(____, [____, ____])

# Count the number of negative words
nb_negative_words = ____(____, ____)

print("{} positive words.".format(nb_positive_words))
print("{} negative words.".format(nb_negative_words))


from textanalysis.textanalysis import count_words

# Count the number of positive words
nb_positive_words = count_words('hotel-reviews.txt', ['good', 'great'])

# Count the number of negative words
nb_negative_words = count_words('hotel-reviews.txt', ['bad', 'awful'])

print("{} positive words.".format(nb_positive_words))
print("{} negative words.".format(nb_negative_words))


Paketi işe koşmak

Dokümantasyon

INCHES_PER_FOOT = 12.0  # 12 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):
    if reverse:
        return x * INCHES_PER_FOOT
    else:
        return x / INCHES_PER_FOOT


INCHES_PER_FOOT = 12.0  # 12 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):
    """

    Parameters
    ----------
    x :

    reverse :
         (Default value = False)

    Returns
    -------

    """
    if reverse:
        return x * INCHES_PER_FOOT
    else:
        return x / INCHES_PER_FOOT


# Run the following command in the console
# pyment -w -o numpydoc impyrial/length/core.py

pyment ile fonksiyon dokümantasyonu yazma

INCHES_PER_FOOT = 12.0  # 12 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):
    """

    Parameters
    ----------
    x :

    reverse :
         (Default value = False)

    Returns
    -------

    """
    if reverse:
        return x * INCHES_PER_FOOT
    else:
        return x / INCHES_PER_FOOT


INCHES_PER_FOOT = 12.0  # 12 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 : numpy.ndarray
        Lengths in feet.
    reverse : bool, optional
        If true this function converts from feet to inches 
        instead of the default behavior of inches to feet. 
        (Default value = False)

    Returns
    -------
    numpy.ndarray
    """
    if reverse:
        return x * INCHES_PER_FOOT
    else:
        return x / INCHES_PER_FOOT


pyment ile fonksiyon dokümantasyonu yazma II

"""
impyrial
========
A package for converting between imperial measurements of length and weight.
"""


"""
impyrial.length
===============
Length conversion between imperial units.
"""


"""Conversions between inches and larger imperial length units"""
INCHES_PER_FOOT = 12.0  # 12 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 : numpy.ndarray
        Lengths in feet.
    reverse : bool, optional
        If true this function converts from feet to inches 
        instead of the default behavior of inches to feet. 
        (Default value = False)

    Returns
    -------
    numpy.ndarray
    """
    if reverse:
        return x * INCHES_PER_FOOT
    else:
        return x / INCHES_PER_FOOT


Paket ve modül dokümantasyonu

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

from ____ import ____

result = convert_unit(10, 'in', 'yd')
print(result)


"""User-facing functions."""
from ____ import (
    ____,
    ____,
    ____
)


def convert_unit(x, from_unit, to_unit):
    """Convert from one length unit to another.

    Parameters
    ----------
    x : array_like
        Lengths to convert.
    from_unit : {'in', 'ft', 'yd'}
        Unit of the input lengths `x`
    to_unit : {'in', 'ft', 'yd'}
        Unit of the returned lengths

    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.
    """
    # Convert length to inches
    if from_unit == "in":
        inches = x
    elif from_unit == "ft":
        inches = inches_to_feet(x, reverse=True)
    elif from_unit == "yd":
        inches = inches_to_yards(x, reverse=True)

    # Convert inches to desired units
    if to_unit == "in":
        value = inches
    elif to_unit == "ft":
        value = inches_to_feet(inches)
    elif to_unit == "yd":
        value = inches_to_yards(inches)

    return value


from impyrial.length.api import convert_unit

result = convert_unit(10, 'in', 'yd')
print(result)


"""User-facing functions."""
from impyrial.length.core import (
    UNITS,
    inches_to_feet,
    inches_to_yards
)


def convert_unit(x, from_unit, to_unit):
    """Convert from one length unit to another.

    Parameters
    ----------
    x : array_like
        Lengths to convert.
    from_unit : {'in', 'ft', 'yd'}
        Unit of the input lengths `x`
    to_unit : {'in', 'ft', 'yd'}
        Unit of the returned lengths

    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.
    """
    # Convert length to inches
    if from_unit == "in":
        inches = x
    elif from_unit == "ft":
        inches = inches_to_feet(x, reverse=True)
    elif from_unit == "yd":
        inches = inches_to_yards(x, reverse=True)

    # Convert inches to desired units
    if to_unit == "in":
        value = inches
    elif to_unit == "ft":
        value = inches_to_feet(inches)
    elif to_unit == "yd":
        value = inches_to_yards(inches)

    return value


Kardeş içe aktarımlar

from impyrial.length.api import convert_unit

# Make sure unit checking is working by trying examples
print('The following line should run:')
result1 = convert_unit(10, 'in', 'yd')
print(result1)

print('The following line should cause an error:')
result2 = convert_unit(10, 'lb', 'yd')
print(result2)


"""User-facing functions."""
# Import the check_units function
____
from impyrial.length.core import (
    UNITS,
    inches_to_feet,
    inches_to_yards,
)


def convert_unit(x, from_unit, to_unit):
    """Convert from one length unit to another.

    Parameters
    ----------
    x : array_like
        Lengths to convert.
    from_unit : {'in', 'ft', 'yd'}
        Unit of the input lengths `x`
    to_unit : {'in', 'ft', 'yd'}
        Unit of the returned lengths

    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.
    """
    # Check if units are valid length units
    check_units(from_unit, to_unit, UNITS)
    
    # convert length to inches
    if from_unit == "in":
        inches = x
    elif from_unit == "ft":
        inches = inches_to_feet(x, reverse=True)
    elif from_unit == "yd":
        inches = inches_to_yards(x, reverse=True)

    # Convert inches to desired units
    if to_unit == "in":
        value = inches
    elif to_unit == "ft":
        value = inches_to_feet(inches)
    elif to_unit == "yd":
        value = inches_to_yards(inches)

    return value


"""User-facing functions."""
# Import the check_units function
from impyrial.utils import check_units
from impyrial.length.core import (
    UNITS,
    inches_to_feet,
    inches_to_yards,
)


def convert_unit(x, from_unit, to_unit):
    """Convert from one length unit to another.

    Parameters
    ----------
    x : array_like
        Lengths to convert.
    from_unit : {'in', 'ft', 'yd'}
        Unit of the input lengths `x`
    to_unit : {'in', 'ft', 'yd'}
        Unit of the returned lengths

    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.
    """
    # Check if units are valid length units
    check_units(from_unit, to_unit, UNITS)
    
    # Convert length to inches
    if from_unit == "in":
        inches = x
    elif from_unit == "ft":
        inches = inches_to_feet(x, reverse=True)
    elif from_unit == "yd":
        inches = inches_to_yards(x, reverse=True)

    # Convert inches to desired units
    if to_unit == "in":
        value = inches
    elif to_unit == "ft":
        value = inches_to_feet(inches)
    elif to_unit == "yd":
        value = inches_to_yards(inches)

    return value


Üst dizinden içe aktarma

# This is the __init__.py file for the impyrial/length subpackage

# Import the convert_unit function from the api.py module
____


# This is the top level __init__.py file

# Import the length subpackage
____


import impyrial

result = impyrial.length.convert_unit(10, 'in', 'yd')
print(result)


# This is the __init__.py file for the impyrial/length subpackage

# Import the convert_unit function from the api.py module
from .api import convert_unit


# This is the top level __init__.py file

# Import the length subpackage
from . import length


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

Test dizinini oluşturma

Bazı temel testler yazma

Testlerini çalıştırma

Paketini farklı ortamlarda test etme

tox'u kurma

tox çalıştırma

Paketini şık tutmak

Uygun biçem filtreleme

Bir dosyayı temizlemek için flake8 kullanma

Belirli hataları yok sayma

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.

pyment ile fonksiyon dokümantasyonu yazma II

Python Paketleri Geliştirme

Uygulamalı etkileşimli egzersiz