Mojo Academy · Pelajaran

API Publik dan Struktur

Tentukan apa yang akan diekspos.

Pelajaran 3 dari 413 langkah

API Publik dan Struktur adalah pelajaran Mojo Academy gratis di CoddyKit. Ini adalah pelajaran 3 dari 4. Kamu bisa membaca pelajaran lengkapnya di bawah secara gratis — lalu praktikkan langsung di browser dengan editor kode bawaan dan tutor AI 24/7. Ini adalah bagian dari jalur belajar Mojo Academy, dan progresmu tersinkronisasi di web dan aplikasi CoddyKit. Kursus Mojo Academy mencakup 4 pelajaran total.

Yang Anda Tampilkan Itu Penting

Pustaka yang baik dinilai dari tampilan luarnya. Menentukan apa yang akan ditampilkan membentuk kemudahan penggunaan API Anda. 🚪

API Publik Anda

Fungsi dan tipe yang memang dimaksudkan untuk dipanggil oleh kode lain membentuk API publik Anda. Itulah janji yang Anda berikan kepada pengguna.

Bagian Internal Tetap Tersembunyi

Kode pembantu yang mendukung API Anda tetapi tidak ditujukan untuk pemanggil disebut internal. Menyembunyikannya membuat permukaan API tetap kecil.

Permukaan Lebih Kecil, Risiko Lebih Rendah

Semakin sedikit nama yang Anda tampilkan, semakin mudah pustaka dipelajari dan semakin leluasa Anda mengubah bagian internal di kemudian hari.

Ekspor Ulang dari init

__init__.mojo pada paket dapat mengimpor nama-nama penting agar pengguna dapat mengaksesnya langsung dari paket, bukan dari berkas yang tersembunyi jauh di dalam.

from .core import add, subtract

Pintu Depan yang Rapi

Dengan mengumpulkan impor dalam __init__, Anda memberi pemanggil satu titik masuk yang jelas, bukan jalur modul yang panjang dan rentan rusak.

from mypkg import add

Sembunyikan Tata Letaknya

Pengguna mengimpor dari paket, bukan dari berkas-berkasnya. Dengan begitu, Anda dapat menata ulang modul internal tanpa merusak kode mereka.

Beri Nama dengan Jelas

Nama publik harus mudah dipahami. Nama yang jelas dan stabil merupakan bagian dari kontrak yang tidak ingin Anda ubah.

Dokumentasikan Permukaannya

Tambahkan docstring ke setiap fungsi dan tipe publik. Dokumentasi yang baik memberi tahu pemanggil cara menggunakan API dengan benar.

fn add(a: Int, b: Int) -> Int:
    """Return the sum of a and b."""
    return a + b

Janji yang Stabil

Perlakukan API publik Anda sebagai sebuah kontrak. Mengubahnya dapat merusak pengguna, jadi pertahankan agar tetap kecil dan pikirkan baik-baik sebelum menambahkannya.

Rancang dari Luar ke Dalam

Bayangkan terlebih dahulu cara pemanggil ingin menggunakan pustaka Anda, lalu bangun bagian internal untuk mendukung pengalaman yang rapi tersebut. 🎨

Pemeriksaan Singkat

Mari pikirkan cara menjaga API agar mudah dipelihara.

Jawab di pelajaran interaktif

Rangkuman

Tampilkan API publik yang kecil dan jelas, ekspor ulang nama-nama penting dalam __init__, sembunyikan bagian internal, dan dokumentasikan hal yang Anda bagikan. 🎯

Gratis untuk memulai

Belajar Mojo dengan tutor AI — gratis

Tulis dan jalankan kode asli di browser kamu, dapatkan bantuan instan dari tutor AI 24/7, dan lanjutkan di mana kamu tinggalkan di web atau aplikasi.

Kursus: 30
Pelajaran: 120

Mulai belajar gratis Lihat kursus lengkapnya

Pertanyaan yang Sering Diajukan

Apakah pelajaran “API Publik dan Struktur” gratis?

Ya — teks lengkap “API Publik dan Struktur” gratis dibaca di sini di web. Untuk praktiknya secara interaktif (editor kode bawaan dan tutor AI 24/7) dan buka sisa kursus Mojo Academy, upgrade ke CoddyKit PRO. Kursus Mojo Academy mencakup 4 pelajaran total.

Apa yang akan aku pelajari di “API Publik dan Struktur”?

Tentukan apa yang akan diekspos. Kamu berlatih Mojo Academy dengan kode praktik yang langsung kamu jalankan di browser, dan tutor AI 24/7 menjawab pertanyaanmu saat kamu mengerjakan pelajaran ini.

Apakah aku perlu pengalaman untuk memulai Mojo Academy?

Tidak diperlukan pengalaman sebelumnya. Mojo Academy di CoddyKit dirancang untuk pemula hingga pelajar tingkat lanjut, jadi kamu bisa memulai di sini atau dari awal dan belajar sesuai kecepatan kamu sendiri. Ini adalah pelajaran 3 dari 4.

Berapa lama pelajaran “API Publik dan Struktur” memakan waktu?

Sebagian besar pelajaran CoddyKit memakan waktu sekitar 5–10 menit. Setiap pelajaran ringkas dan interaktif, jadi kamu membuat kemajuan stabil dan melanjutkan dari tempat kamu tinggalkan di web dan aplikasi.

Bisakah aku menulis dan menjalankan kode dalam pelajaran Mojo Academy ini?

Ya. Setiap pelajaran Mojo Academy menyertakan editor kode bawaan, jadi kamu menulis dan menjalankan kode nyata langsung di browser dan mendapatkan umpan balik AI instan — tidak diperlukan penyiapan lokal.

Semua pelajaran dalam kursus ini

← Kembali ke Mojo Academy