Python Modülleri Eğitimi: İçeri Aktarma, Yazma ve Kullanma

Python’da Modül İçe Aktarma

Herhangi bir modülde bulunan işlevselliği kullanmak için onu geçerli programınıza içe aktarmanız gerekir. İstediğiniz modül adıyla birlikte import anahtar kelimesini kullanmanız yeterlidir. Yorumlayıcı bir import ifadesiyle karşılaştığında modülü geçerli programınıza dahil eder.

Bir modülün içindeki fonksiyonları modül adıyla birlikte nokta (.) operatörünü kullanarak çağırabilirsiniz.

Önce standart kütüphane modüllerinin nasıl kullanılacağını görelim. Aşağıdaki örnekte math modülü programa içe aktarılır, böylece sqrt() fonksiyonunu kullanabilirsiniz.

import math  # Import the math module
num = 4
print(math.sqrt(num))  # Call the sqrt() function from the math moduleAltyapı:

Verimlilik nedeniyle, her modül yorumlayıcı oturumu başına yalnızca bir kez içe aktarılır. Bu nedenle modüllerinizde değişiklik yaparsanız yorumlayıcıyı yeniden başlatmalısınız.

Daha önce içe aktardığınız bir modülü yeniden yüklemek isterseniz (ör. düzenledikten sonra), importlib.reload() kullanın.

Eski yerleşik reload() fonksiyonunun Python 3’te artık bulunmadığını unutmayın — Python 3.4+’ta modülleri yeniden yüklemenin güncel ve resmi yolu importlib.reload()’dır.

import importlib
importlib.reload(module_name)Altyapı:

Not: sys, __main__, builtins ve diğer kilit modülleri yeniden yüklemek önerilmez. Birçok uzantı modülü birden fazla kez başlatılacak şekilde tasarlanmamıştır ve yeniden yüklendiğinde öngörülemeyen şekillerde başarısız olabilir. Geliştirme sırasında yalnızca kendi modüllerinizi yeniden yüklemekle yetinin.

Yakında: Python “tembel içe aktarma” (lazy imports) getiriyor. Bunlar, modüllerin yüklenmesini ilk kullanılana kadar erteleyerek başlangıç sürelerini hızlandıracak. Bu, özellikle büyük projelerde faydalıdır; çünkü çoğu modül dosyanın en üstünde içe aktarılır ama hemen gerekmez.

Kendi Python Modüllerinizi Nasıl Yazarsınız

Artık bir modülün programınıza nasıl içe aktarılacağını öğrendiğinize göre, sıra kendi modülünüzü yazıp başka bir programda kullanmaya geldi. Bir modül yazmak, herhangi bir Python dosyası yazmakla aynıdır. calculation.py dosyasında iki sayıyı toplama/çıkarma fonksiyonları yazarak başlayalım.

def add(x,y):
    return (x+y)
def sub(x,y):
    return (x-y)
Altyapı:

Bu betiği komut satırında çalıştırmayı denerseniz hiçbir şey olmaz; çünkü programa herhangi bir şey yapmasını söylemediniz. Aynı dizinde module_test.py adında başka bir Python betiği oluşturun ve aşağıdaki kodu yazın.

import calculation            #Importing calculation module
print(calculation.add(1,2))   #Calling function defined in the calculation module Altyapı:

module_test.py dosyasını çalıştırırsanız çıktı olarak "3" görürsünüz. Yorumlayıcı import ifadesiyle karşılaştığında calculation modülünü kodunuza dahil etti ve nokta operatörünü kullanarak add() fonksiyonuna erişebildiniz.

Çalıştırılabilir kodu if __name__ == "main__" ile koruma

Modül yazarken edinmeniz gereken önemli bir alışkanlık var: Yalnızca doğrudan çalıştırmak istediğiniz (içe aktarıldığında değil) kodu if __name__ == "__main__" korumasına sarmak.

# calculation.py
def add(x, y):
    return x + y

def sub(x, y):
    return x - y

if __name__ == "__main__":
    # This only runs when you execute calculation.py directly
    # It will NOT run when another script imports this module
    print(add(1, 2))Altyapı:

Python’da Modül İçe Aktarmanın Diğer Yolları

Modülleri içe aktarmanın başka yolları da vardır:

• from .. import ifadesi

• from .. import * ifadesi

• içe aktarılan modülün yeniden adlandırılması

from module import name kullanma

from..import ifadesi, bir modüldeki her şeyi içe aktarmak yerine belirli fonksiyonları/değişkenleri içe aktarmanıza olanak tanır. Önceki örnekte module_test.py dosyasına calculation modülünü içe aktardığınızda hem add() hem de sub() fonksiyonları içe aktarılmıştı. Peki ya kodunuzda yalnızca add() fonksiyonuna ihtiyaç duyuyorsanız? İşte from..import kullanımını gösteren bir örnek.

from calculation import add
print(add(1,2))
Altyapı:

Yukarıdaki örnekte yalnızca add() fonksiyonu içe aktarılıp kullanılmıştır. add() kullanımına dikkat ettiniz mi? Artık modül adını kullanmadan doğrudan erişebilirsiniz. Birden fazla özelliği de içe aktarabilirsiniz; içe aktarma ifadesinde virgülle ayırmanız yeterlidir. Aşağıdaki örneğe bakın:

from calculation import add,sub
Altyapı:

from module import * kullanma

Bu ifadeyle bir modülün tüm özelliklerini içe aktarabilirsiniz. Bu, içe aktarılan modülün tüm özelliklerini kodunuzda görünür kılar.

from .. import * kullanımını gösteren bir örnek:

from calculation import *
print(add(1,2))
print(sub(3,2))
Altyapı:

Not ki profesyonel dünyada from..import ve from..import* kullanmaktan kaçınmalısınız. Bu yaklaşım, modüldeki tüm adlarla isim alanınızı kirletir, kodu okurken bir fonksiyonun nereden geldiğini anlamayı imkânsız hale getirir ve zaten tanımladığınız adları fark ettirmeden ezebilir. Bunun yerine açık içe aktarımları kullanın.

Python’da Modülleri Yeniden Adlandırma

İçe aktardığınız modülü yeniden adlandırabilirsiniz; bu, modüle daha anlamlı bir ad vermek istediğinizde veya modül adı tekrar tekrar kullanmak için fazla uzunsa yararlı olabilir. Bunu yapmak için as anahtar kelimesini kullanabilirsiniz. Aşağıdaki örnek programınızda nasıl kullanacağınızı açıklar.

import calculation as cal
print(cal.add(1,2))
Altyapı:

calculation adını cal olarak değiştirerek yazma zahmetinden biraz tasarruf ettiniz.

Not artık calculation.add(1,2) kullanamazsınız; çünkü programınızda calculation artık tanınmaz. Olan şu: Bir modülü as ile takma adlandırdığınızda, o betik içinde özgün ad kullanılamaz hâle gelir.

Python’da Modül Arama Yolu

Modüllerinizin farklı program veya projelerde kullanılmasını isteyebilirsiniz ve fiziksel konumları dizinde farklı olabilir. Başka bir dizinde bulunan bir modülü kullanmak istiyorsanız Python’un sunduğu bazı seçenekler vardır.

calculation adlı bir modül içe aktardığınızda, yorumlayıcı önce bu ada sahip yerleşik bir modül arar. Bulunamazsa, ardından sys.path değişkeninin sunduğu dizinler listesinde calculation.py adlı bir dosya arar. sys.path şu konumları içerir:

• Girdi betiğini içeren dizin (veya geçerli dizin)

• PYTHONPATH (kabuk değişkeni PATH ile aynı sözdizimine sahip dizin adlarının listesi)

• Kuruluma bağlı varsayılan değer

module_test.py dosyasının /home/datacamp/ dizininde olduğunu ve calculation.py dosyasını /home/test/ dizinine taşıdığınızı varsayalım. Python yorumlayıcısının modülü arayacağı yollar listesine /home/test/ dizinini dahil etmek için sys.path’i değiştirebilirsiniz. Bunun için module_test.py dosyasını aşağıdaki şekilde düzenlemeniz gerekir:

import sys
sys.path.append('/home/test/')

import calculation
print(calculation.add(1,2))Altyapı:

Python’da Bayt Derlenmiş Dosyalar

Bir modülü içe aktarmak programların yürütme süresini artırır; bu nedenle Python’un bunu hızlandırmak için bazı yöntemleri vardır. Yollardan biri, .pyc uzantılı bayt derlenmiş dosyalar oluşturmaktır.

Python dahili olarak kaynak kodu bayt kodu adı verilen ara bir biçime dönüştürür. Sonra bunu bilgisayarınızın yerel diline çevirir ve çalıştırır. Bu .pyc dosyası, modülü bir sonraki sefere farklı bir programdan içe aktardığınızda işe yarar — bir modülü içe aktarmak için gereken işlemenin bir kısmı zaten yapıldığından çok daha hızlı olacaktır. Ayrıca bu bayt derlenmiş dosyalar platformdan bağımsızdır.

Not bu .pyc dosyaları genellikle ilgili .py dosyalarıyla aynı dizinde oluşturulur. Python’un o dizinde dosya yazma izni yoksa .pyc dosyaları oluşturulmaz. Bu dosyalar genellikle __pycache__ dizininde, .py dosyalarınızın yanında, kullanılan Python sürümünü yansıtan calculation.cpython-312.pyc gibi adlarla saklanır. Bu klasörü güvenle yok sayabilir veya .gitignore ile hariç tutabilirsiniz. Python bunu otomatik olarak yönetir.

Python dir() Fonksiyonu

dir() fonksiyonu bir modülde tanımlanan tüm adları bulmak için kullanılır. Bir modülde tanımlanan adları içeren sıralı bir dize listesi döndürür.

import calculation
print(calculation.add(1,2))
print(dir(calculation))Altyapı:

['__builtins__', '__cached__', '__doc__', '__file__', '__loader__', '__name__', '__package__', '__spec__', 'add', 'sub']Altyapı:

Çıktıda modülde tanımladığınız add ve sub fonksiyonlarının adlarını görebilirsiniz. __name__ özniteliği modülün adını içerir. Alt çizgi ile başlayan tüm öznitelikler, bir modülle ilişkili varsayılan Python öznitelikleridir.

Sonuç

Bir modül oluşturmak, kodun daha iyi yönetimi ve yeniden kullanılabilirliği için gereklidir. Python, import anahtar kelimesiyle içe aktarabileceğiniz bazı yerleşik modüller sunar. Python ayrıca kendi modüllerinizi oluşturmanıza ve programlarınızda kullanmanıza olanak tanır. Modül kullanımının maliyetini azaltmak için bayt derlenmiş dosyalar sağlar; bu da yürütmeyi hızlandırır. Bir programda kullanılan modülde tanımlanan öznitelikleri öğrenmek için dir() fonksiyonunu kullanabilirsiniz. Bu hem önceden tanımlı modüller hem de kullanıcı tanımlı modüller için geçerlidir.

Python hakkında daha fazla bilgi edinmek isterseniz Intermediate Python for Data Science kursumuza göz atabilirsiniz.