Cara menggunakan module method python

• Menggunakan modul
• Fungsi rekursif

Pada artikel tentang fungsi, kita telah belajar cara membuat dan menggunakan fungsi pada kode yang kita susun. Bagaimana jika kita ingin menggunakan banyak fungsi di kode program lain yang telah kita buat sebelumnya? Jawabannya adalah dengan melakukan menyertakan kode tersebut sebagai modul (module) yang kita import ke dalam kode program kita.

Apa itu modul?

A module is a file containing Python definitions and statements. The file name is the module name with the suffix .py appended.

Python 3.7.3 documentation

Dari kutipan dokumentasi python 3.7.3 di atas, sebuah modul adalah sebuah file dengan ekstensi .py, yang berisikan kode program dalam bahasa pemrograman python. Nama modul sesuai dengan nama file yang digunakan.

Ada dua syntax cara menggunakan sebuah modul, pertama menggunakan import dan kedua menggunakan from … import …

Menggunakan import ..

Kita akan latihan menggunakan modul yang sudah disediakan python pada standard library-nya. Pada kode di bawah kita mengimport module math kemudian menggunakan fungsi factorial yang ada pada modul tersebut untuk menghitung nilai faktorial sebuah bilangan.

Menggunakan from .. import …

Jika pada kode di atas kita melakukan import modul, pada kode dibawah kita bisa secara spesifik melakukan import terhadap fungsi tertentu pada modul tersebut. Perhatikan baris pertama dan baris keempat pada contoh ini dan bandingkan dengan contoh sebelumnya.

Menggunakan modul yang kita buat sendiri

Dua cara di atas mengambil contoh modul yang tersedia pada standard library. Contoh berikut menggunakan modul yang kita buat sendiri. Perhatikan kode repl berikut.

Perhatikan bahwa pada 3 baris pertama diisi dengan statements import. Masing-masing mengimport modul balok, modul tabung, dan sebuah fungsi bernama hitung_luas dari modul lingkaran. Dimana dan bagaimana isi ketiga modul dimaksud? Untuk lebih jelasnya buka kode repl.it di atas pada tab browser baru (klik pada logo repl.it), dan perhatikan daftar file di sebelah kiri (tampilan seperti pada screenshot di bawah).

Terlihat bahwa selain main.py, terdapat juga file .py lain yakni lingkaran.py, tabung.py, dan balok.py. Masing-masing file tersebut adalah modul yang kita import pada 3 baris pertama kode di sebelah kanan. Jangan lupa untuk membuka masing-masing modul dan menjalankan program untuk lebih memahami maknanya.

Bacaan lebih lanjut

Untuk menambah pemahaman, beberapa artikel ini berisi contoh kode dimana didalamnya dilakukan import terhadap modul lain.:

1. Menggunakan modul datetime
2. Mencari nilai terkecil, terbesar, dan rata-rata
3. Menampilkan grafik sinus (trigonometri) menggunakan matplotlib

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!

• Ulasan Modules dan Packages Python
  • Cara Penulisan Modules Python
  • Cara Mengimpor Objek Modules Python ke dalam Namespace
  • Cara Mengimpor Semua Objek dari Modules Phyton
  • Mengkostum Import Name
  • Cara Menginisialisasi Modules Python
  • Melakukan Extending Modules Python
  • Menjelajahi Module Bawaan
  • Cara Menuliskan Packages Phyton

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.

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:

>>> import urllib
>>> dir(urllib)
['ContentTooShortError', 'FancyURLopener', 'MAXFTPCACHE', 'URLopener', '__all__', '__builtins__', 
'__doc__', '__file__', '__name__', '__package__', '__version__', '_ftperrors', '_get_proxies', 
'_get_proxy_settings', '_have_ssl', '_hexdig', '_hextochr', '_hostprog', '_is_unicode', '_localhost', 
'_noheaders', '_nportprog', '_passwdprog', '_portprog', '_queryprog', '_safe_map', '_safe_quoters', 
'_tagprog', '_thishost', '_typeprog', '_urlopener', '_userprog', '_valueprog', 'addbase', 'addclosehook', 
'addinfo', 'addinfourl', 'always_safe', 'basejoin', 'c', 'ftpcache', 'ftperrors', 'ftpwrapper', 'getproxies', 
'getproxies_environment', 'getproxies_macosx_sysconf', 'i', 'localhost', 'main', 'noheaders', 'os', 
'pathname2url', 'proxy_bypass', 'proxy_bypass_environment', 'proxy_bypass_macosx_sysconf', 'quote', 
'quote_plus', 'reporthook', 'socket', 'splitattr', 'splithost', 'splitnport', 'splitpasswd', 'splitport', 
'splitquery', 'splittag', 'splittype', 'splituser', 'splitvalue', 'ssl', 'string', 'sys', 'test', 'test1', 
'thishost', 'time', 'toBytes', 'unquote', 'unquote_plus', 'unwrap', 'url2pathname', 'urlcleanup', 'urlencode', 
'urlopen', 'urlretrieve']

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:

help(urllib.urlopen)

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:

__init__.py:

__all__ = ["bar"]

Nah itulah tadi penjelasan lengkap mengenai modules dan packages phyton khusus untuk Anda, pembaca setia Codekey. Apakah Anda telah memahami bagaimana penggunaan modules dan packages phyton dengan baik? teruslah berlatih untuk meningkatkan kemampuan dan pemahaman Anda. Terima kasih telah mengikuti hingga akhir, sampai jumpa di artikel menarik lainnya. Semoga bermanfaat!

Jasa Pembuatan Aplikasi, Website dan Internet Marketing | PT APPKEY
PT APPKEY adalah perusahaan IT yang khusus membuat aplikasi Android, iOS dan mengembangkan sistem website. Kami juga memiliki pengetahuan dan wawasan dalam menjalankan pemasaran online sehingga diharapkan dapat membantu menyelesaikan permasalahan Anda.

Apa itu module dalam python?

Apa saja module python?

Apa itu modul dan package?

Apa yang anda ketahui tentang variabel dalam bahasa pemrograman Python?