Cara menggunakan python module

Pada tutorial ke 13 ini Anda akan mempelajari bagaimana fungsi dan cara penggunaan modules python serta packages.

Modules python sendiri berfungsi untuk mempermudah mengerjakan suatu tugas dalam sebuah program. Tentunya mempelajari materi kali ini akan sangat berguna dan penting untuk Anda ikuti. Jadi tunggu apalagi, yuk simak penjelasan lengkapnya!

Table of Contents

Ulasan Modules dan Packages Python

Dalam melakukan pemrograman, modules phyton merupakan bagian dari perangkat lunak yang memiliki beberapa fungsi tertentu. Misalnya, saat membuat game ping pong, satu modul akan bertanggung jawab atas logika game, kemudian modul lain akan bertanggung jawab untuk menggambar game di layar. Setiap modul yang dibuat adalah file yang berbeda, di mana file tersebut dapat Anda edit secara terpisah.

Artikel Terkait  Tutorial Python 25 : Cara Menggantikan Fungsi Switch Case Python

Cara Penulisan Modules Python

Modul dalam Python hanyalah berupa file Python dengan ekstensi .py. di mana nama modul akan menjadi nama file. Sebuah modul Python dapat memiliki sekumpulan fungsi, kelas atau variabel yang ditentukan dan diimplementasikan. Untuk memahami penjelasannya, kami berikan contoh dua file, di mana dua file tersebut akan memiliki:

mygame/
mygame/game.py
mygame/draw.py

Pada syntax di atas, skrip Python game.py akan mengimplementasikan permainan. Di mana akan menggunakan fungsi draw_game dari file draw.py, atau dengan kata lain, draw modul, yang mengimplementasikan logika untuk menggambar game pada layar.

Modul diimpor dari modul lain menggunakan import perintah. Dalam contoh ini, game.py skrip kemungkinan akan terlihat seperti syntax di bawah ini:

# game.py
# mengimport modul draw
import draw

def play_game():
    ...

def main():
    result = play_game()
    draw.draw_game(result)

# jika script dijalankan maka 
# fungsi main() akan dijalankan
if __name__ == '__main__':
    main()

sementara itu, draw modul akan terlihat seperti contoh di bawah ini:

# file draw.py

def draw_game():
    ...

def clear_screen(screen):
    ...

Pada contoh modules phyton ini, game modul mengimpor draw modul, yang memungkinkannya menggunakan fungsi yang diimplementasikan dalam modules phyton tersebut. Fungsi main sendiri akan menggunakan fungsi lokal play_game untuk menjalankan permainan, untuk kemudian menarik hasil dari permainan menggunakan fungsi diimplementasikan dalam draw modul yang disebut dengan draw_game.

Untuk menggunakan fungsi draw_game dari draw modul, Anda perlu menentukan di modul mana fungsi tersebut akan diimplementasikan, menggunakan operator titik. Untuk mereferensikan draw_game fungsi dari game modul, Anda perlu mengimpor draw modul dan baru kemudian memanggil draw.draw_game().

Ketika import draw direktif akan Anda jalankan, penerjemah Python akan mencari file di direktori tempat skrip dijalankan, dengan nama modul dengan yang berekstensi .py sufiks, jadi dalam kasus kami ini akan mencoba mencari draw.py. Jika menemukannya, maka akan mengimpornya. Jika tidak, file tersebut akan terus mencari modul bawaan.

Anda mungkin telah memperhatikan bahwa ketika mengimpor modules phyton, sebuah file dengan ekstensi .pyc akan muncul, yang merupakan file Python yang telah dikompilasi. Python mengompilasi file ke dalam bytecode Python sehingga tidak perlu mengurai file setiap kali modul dimuat. Jika dalam .pyc terdapat file, file tersebut akan dimuat, bukan .py file, tetapi proses ini transparan bagi pengguna.

Cara Mengimpor Objek Modules Python ke dalam Namespace

Dalam bahasa pemrograman phuton, Anda juga dapat mengimpor fungsi draw_game secara langsung ke namespace skrip utama, dengan menggunakan from perintah sebagai berikut:

# game.py
# import modul draw
from draw import draw_game

def main():
    result = play_game()
    draw_game(result)

Anda mungkin telah memperhatikan bahwa dalam contoh di atas, draw_game tidak mendahului dengan nama modul yang diimpor, karena di awal telah ditetapkan nama modul dalam import perintah.

Keuntungan menggunakan notasi ini adalah lebih mudah menggunakan fungsi di dalam modul saat ini karena Anda tidak perlu menentukan dari modul mana fungsi tersebut berasal. Namun, namespace apa pun tidak dapat memiliki dua objek dengan nama yang sama persis, jadi import perintah dapat menggantikan objek yang ada di namespace.

Cara Mengimpor Semua Objek dari Modules Phyton

Anda  juga dapat menggunakan perintah import * untuk mengimpor semua objek dari modul tertentu, seperti syntax di bawah ini:

# game.py
# import modul draw
from draw import *

def main():
    result = play_game()
    draw_game(result)

Ketika memasukkan perintah ini hasilnya mungkin sedikit berisiko karena perubahan dalam modul mungkin memengaruhi modul yang mengimpornya, tetapi lebih pendek dan juga tidak mengharuskan Anda menentukan objek mana yang ingin Anda impor dari modul.

Mengkostum Import Name

Anda juga dapat memuat modul dengan nama apa pun yang Anda inginkan. Ini berguna ketika Anda ingin mengimpor modules phyton secara kondisional untuk menggunakan nama yang sama di seluruh kode.

Misalnya, jika Anda memiliki dua draw modul dengan nama yang sedikit berbeda – Anda dapat melakukan hal berikut:

# game.py
# import modul draw
if visual_mode:
    # pada bentuk mode, kita akan menggambar menggunakan grafik
    import draw_visual as draw
else:
    # dalam mode textual, nantinya akan mencetak dalam bentuk text
    import draw_textual as draw

def main():
    result = play_game()
    # bagian ini dapat menjadi visual atau textual tergantung dari visual_mode
    draw.draw_game(result)

Cara Menginisialisasi Modules Python

Pada saat pertama kali modul dimuat ke dalam skrip Python yang sedang berjalan, diinisialisasi dengan mengeksekusi kode dalam modul satu kali. Jika modul lain dalam kode Anda mengimpor modul yang sama lagi, itu tidak akan dimuat dua kali tetapi hanya sekali – jadi variabel lokal di dalam modul bertindak sebagai “tunggal” karena skrip modul hanya diinisialisasi sekali.

Ini berguna untuk diketahui, karena ini berarti Anda dapat mengandalkan perilaku ini untuk menginisialisasi objek. Sebagai contoh silahkan Anda perhatikan syntax di bawah ini:

# draw.py

def draw_game():
    # saat membersihkan objek pada layar kita dapat menggunakan objek layar utama yang diinisialisasi dalam modul ini
    clear_screen(main_screen)
    ...

def clear_screen(screen):
    ...

class Screen():
    ...

# menginisialisasi main_screen dalam bentuk tunggal
main_screen = Screen()

Melakukan Extending Modules Python

Ada beberapa cara yang dapat memberi tahu interpreter Python di mana mencari modul, selain dari default, yaitu direktori lokal dan modul bawaan. Anda dapat menggunakan variabel lingkungan PYTHONPATH untuk menentukan direktori tambahan untuk mencari modul, seperti contoh di bawah berikut:

PYTHONPATH=/foo python game.py

Contoh di atas akan dijalankan game.py, dan akan memungkinkan skrip memuat modul dari foo direktori serta direktori lokal. Cara lain yang dapat Anda lakukan adalah sys.path.append fungsinya. Anda dapat menjalankannya sebelum menjalankan perintah import berikut:

sys.path.append("/foo")

Syntax di atas akan menambahkan foo direktori ke daftar jalur untuk mencari modul juga.

Menjelajahi Module Bawaan

Dua fungsi yang sangat penting dan berguna saat menjelajahi modul dengan Python adalah dir dan help fungsi.

Jika Anda ingin mengimpor modul urllib, yang memungkinkan kita membuat data baca dari URL, kita cukup import modulnya dengan cara:

# import library
import urllib

# use it
urllib.urlopen(...)

Anda dapat mencari fungsi mana yang diimplementasikan di setiap modul dengan menggunakan dir fungsi sebagai berikut:

# game.py
# mengimport modul draw
import draw

def play_game():
    ...

def main():
    result = play_game()
    draw.draw_game(result)

# jika script dijalankan maka 
# fungsi main() akan dijalankan
if __name__ == '__main__':
    main()

Ketika Anda ingin menemukan fungsi dalam modul yang ingin Anda gunakan, Anda dapat membacanya lebih lanjut dengan menggunakan help fungsi tersebut, di dalam interpreter Python sebagai berikut:

# game.py
# mengimport modul draw
import draw

def play_game():
    ...

def main():
    result = play_game()
    draw.draw_game(result)

# jika script dijalankan maka 
# fungsi main() akan dijalankan
if __name__ == '__main__':
    main()

Cara Menuliskan Packages Phyton

Packages python adalah ruang nama yang berisi banyak paket dan modul itu sendiri. Mereka hanyalah direktori, tetapi dengan twist.

Setiap packages dalam Python adalah direktori yang HARUS berisi file khusus bernama __init__.py. File ini boleh kosong dan menunjukkan bahwa direktori di dalamnya adalah paket Python, sehingga dapat diimpor dengan cara yang sama seperti saat mengimpor modul.

Jika Anda membuat direktori bernama foo, yang menandai nama paket, Anda kemudian dapat membuat modul di dalam paket yang disebut bar. Kita juga tidak boleh lupa menambahkan __init__.py file di dalam foo direktori.

Untuk menggunakan modul bar, Anda dapat mengimpornya dengan dua cara yaitu:

import foo.bar atau from foo import bar

Pada metode pertama, Anda harus menggunakan foo awalan setiap kali Anda akan mengakses modul bar. Pada metode kedua, Anda tidak perlu melakukannya, karena Anda mengimpor modul ke namespace modul yang telah Anda miliki.

File __init__.py juga dapat memutuskan mana modul ekspor paket sebagai API, sambil menjaga modul lain internal dengan menimpa __all__variabel, seperti berikut ini:

Apa itu module dalam python?

Apa itu modul dan package?

Bagaimana memulai python?

Apa yang membedakan fungsi dan modul dalam python?