Modul Python untuk mengambil sebuah laman untuk kata/frasa dalam KBBI Daring.
pip install kbbi- Lakukan instalasi untuk paket-paket prasyarat (
requests,BeautifulSoup4, danappdirs). - Klonakan repositori ini atau unduh
kbbi.py. - Letakkan
kbbi.pydalam direktori yang Anda inginkan.
Buat objek KBBI baru (contoh: kata = KBBI('kata kunci')), lalu manfaatkan
representasi str-nya dengan memanggil str(kata) atau ambil dict hasil
serialisasinya dengan memanggil kata.serialisasi(). Apabila ingin memanfaatkan
representasi str-nya tanpa contoh (jika ada), gunakan __str__(contoh=False).
Untuk lebih jelasnya, lihat contoh berikut.
>>> from kbbi import KBBI
>>> cinta = KBBI('cinta')
>>> print(cinta)
cin.ta
1. (a) suka sekali; sayang benar: orang tuaku -- kepada kami semua; -- kepada sesama makhluk
2. (a) kasih sekali; terpikat (antara laki-laki dan perempuan): sebenarnya dia tidak -- kepada lelaki itu, tetapi hanya menginginkan hartanya
3. (a) ingin sekali; berharap sekali; rindu: makin ditindas makin terasa betapa --nya akan kemerdekaan
4. (a) (kl) susah hati (khawatir); risau: tiada terperikan lagi --nya ditinggalkan ayahnya itu
>>> print(cinta.__str__(contoh=False))
cin.ta
1. (a) suka sekali; sayang benar
2. (a) kasih sekali; terpikat (antara laki-laki dan perempuan)
3. (a) ingin sekali; berharap sekali; rindu
4. (a) (kl) susah hati (khawatir); risau>>> kata = KBBI('taksir')
>>> print(kata)
tak.sir (1)
(n) kira-kira; hitungan (kasar)
tak.sir (2)
1. (a) (Ar) tidak mengindahkan; lalai; alpa
2. (n) (Ar) kelalaian; kealpaan
>>> import json
>>> print(json.dumps(kata.serialisasi(), indent=2))
{
"pranala": "https://kbbi.kemdikbud.go.id/entri/taksir",
"entri": [
{
"nama": "tak.sir",
"nomor": "1",
"kata_dasar": [],
"pelafalan": "",
"bentuk_tidak_baku": [],
"varian": [],
"makna": [
{
"kelas": [
{
"kode": "n",
"nama": "Nomina",
"deskripsi": "kata benda"
}
],
"submakna": [
"kira-kira",
"hitungan (kasar)"
],
"info": "",
"contoh": []
}
]
},
{
"nama": "tak.sir",
"nomor": "2",
"kata_dasar": [],
"pelafalan": "",
"bentuk_tidak_baku": [],
"varian": [],
"makna": [
{
"kelas": [
{
"kode": "a",
"nama": "Adjektiva",
"deskripsi": "kata yang menjelaskan nomina atau pronomina"
},
{
"kode": "Ar",
"nama": "Arab",
"deskripsi": "-"
}
],
"submakna": [
"tidak mengindahkan",
"lalai",
"alpa"
],
"info": "",
"contoh": []
},
{
"kelas": [
{
"kode": "n",
"nama": "Nomina",
"deskripsi": "kata benda"
},
{
"kode": "Ar",
"nama": "Arab",
"deskripsi": "-"
}
],
"submakna": [
"kelalaian",
"kealpaan"
],
"info": "",
"contoh": []
}
]
}
]
}Untuk memanfaatkan fitur khusus pengguna, buat objek AutentikasiKBBI terlebih
dahulu, lalu gunakan objek tersebut dalam pembuatan objek KBBI.
>>> auth = AutentikasiKBBI("posel@saya.tld", "password_saya")
>>> roh = KBBI("roh", auth)
>>> print(roh)
roh
bentuk tidak baku: ruh
Etimologi: [Arab] (n) (sg) (f/m) رُوْحٌ rūh: tiupan; sesuatu yang membuat manusia dapat hidup
1. (n) sesuatu (unsur) yang ada dalam jasad yang diciptakan Tuhan sebagai penyebab adanya hidup (kehidupan); nyawa: jika -- sudah berpisah dari badan, berakhirlah kehidupan seseorang
2. (n) makhluk hidup yang tidak berjasad, tetapi berpikiran dan berperasaan (malaikat, jin, setan, dan sebagainya)
3. (n) (ki) semangat; spirit: kedamaian bagi seluruh warga sesuai dengan -- Islam
Gabungan Kata
roh Kudus; roh suciFitur khusus pengguna yang didukung saat ini adalah etimologi, entri terkait (kata turunan, gabungan kata, peribahasa, dan idiom), saran entri terkait ketika entri tidak ditemukan, dan batas pencarian yang lebih besar.
Untuk mendapatkan representasi str-nya tanpa fitur entri terkait, gunakan
__str__(terkait=False).
>>> print(roh.__str__(contoh=False, terkait=False))
roh
bentuk tidak baku: ruh
Etimologi: [Arab] (n) (sg) (f/m) رُوْحٌ rūh: tiupan; sesuatu yang membuat manusia dapat hidup
1. (n) sesuatu (unsur) yang ada dalam jasad yang diciptakan Tuhan sebagai penyebab adanya hidup (kehidupan); nyawa
2. (n) makhluk hidup yang tidak berjasad, tetapi berpikiran dan berperasaan (malaikat, jin, setan, dan sebagainya)
3. (n) (ki) semangat; spiritUntuk memanfaatkan fitur saran entri yang mirip apabila entri tidak dapat
ditemukan, gunakan objek KBBI yang terdapat pada objek TidakDitemukan
melalui atribut objek.
>>> from kbbi import TidakDitemukan
>>> try:
... huk = KBBI("huk", auth)
... except TidakDitemukan as e:
... huk = e.objek
...
>>> print(huk)
Berikut beberapa saran entri lain yang mirip.
auk, buk (1), buk (2), cuk, duk, hak (1), hak (2), hak (3), hak (4), huh, hun, hus, Hut, kuk (1), kuk (2), luk, muk, suk, tuk (1), yuk (1), yuk (2), DUK, HUT, KUK, UK, hub (2), Hud, tuk (2), guk
>>> print(huk.serialisasi())
{'pranala': 'https://kbbi.kemdikbud.go.id/entri/huk', 'entri': [], 'saran_entri': ['auk', 'buk (1)', 'buk (2)', 'cuk', 'duk', 'hak (1)', 'hak (2)', 'hak (3)', 'hak (4)', 'huh', 'hun', 'hus', 'Hut', 'kuk (1)', 'kuk (2)', 'luk', 'muk', 'suk', 'tuk (1)', 'yuk (1)', 'yuk (2)', 'DUK', 'HUT', 'KUK', 'UK', 'hub (2)', 'Hud', 'tuk (2)', 'guk']}
>>> print(huk.saran_entri)
['auk', 'buk (1)', 'buk (2)', 'cuk', 'duk', 'hak (1)', 'hak (2)', 'hak (3)', 'hak (4)', 'huh', 'hun', 'hus', 'Hut', 'kuk (1)', 'kuk (2)', 'luk', 'muk', 'suk', 'tuk (1)', 'yuk (1)', 'yuk (2)', 'DUK', 'HUT', 'KUK', 'UK', 'hub (2)', 'Hud', 'tuk (2)', 'guk']Untuk menonaktifkan fitur khusus pengguna (selain batas pencarian yang lebih
besar), tambahkan argumen fitur_pengguna=False pada pemanggilan __str__
atau serialisasi.
Apabila ingin menyimpan kuki autentikasi, panggil method simpan_kuki() pada
objek AutentikasiKBBI.
>>> auth.simpan_kuki()Berikutnya, objek AutentikasiKBBI dapat dibuat tanpa menggunakan alamat posel
dan sandi. Autentikasi dilakukan dengan memanfaatkan kuki yang telah disimpan.
>>> auth_baru = AutentikasiKBBI()Lokasi penyimpanan/pembacaan kuki bisa diatur dengan parameter lokasi_kuki
ketika membuat objek AutentikasiKBBI.
>>> auth = AutentikasiKBBI("posel@saya.tld", "sandi_saya", lokasi_kuki="~/kuki_kbbi.json")
>>> auth_baru = AutentikasiKBBI(lokasi_kuki="~/kuki_kbbi.json")Secara default, lokasi tersebut adalah:
- Unix:
~/.local/share/kbbi/kuki.json - Windows:
%localappdata%\laymonage\kbbi\kuki.json - macOS:
~/Library/Application Support/kbbi/kuki.json
$ kbbi cinta
Pencarian dengan kata/frasa yang dipisahkan oleh spasi harus diapit oleh tanda petik.
$ kbbi "tanggung jawab"
Apabila tidak ingin menampilkan contoh, gunakan --tanpa-contoh atau -c.
$ kbbi "tanggung jawab" --tanpa-contoh
Untuk mendapatkan hasil dalam bentuk serialisasi JSON, gunakan --json
atau -j.
$ kbbi "tanggung jawab" --json
Untuk mengatur indentasi pada serialisasi JSON, gunakan --indentasi N
atau -i N.
$ kbbi "tanggung jawab" --json --indentasi 2
Untuk memanfaatkan fitur khusus pengguna, lakukan autentikasi terlebih dahulu
dengan bantuan kbbi-autentikasi.
$ kbbi-autentikasi $KBBI_POSEL $KBBI_SANDI
Penggunaan kbbi berikutnya akan otomatis menggunakan kuki hasil autentikasi.
Untuk menonaktifkan fitur entri terkait, gunakan --tanpa-terkait atau -t.
$ kbbi alam --tanpa-terkait
Untuk menonaktifkan semua fitur khusus pengguna (selain batas pencarian yang
lebih besar dan tanpa menghapus kuki), gunakan --nonpengguna atau -n.
$ kbbi alam --nonpengguna
Untuk menghapus kuki, gunakan opsi --bersihkan atau -c.
$ kbbi-autentikasi --bersihkan
Gunakan opsi --lokasi-kuki atau -l untuk menentukan lokasi kuki yang akan
disimpan/dimuat.
$ kbbi-autentikasi $KBBI_POSEL $KBBI_SANDI --lokasi-kuki kukiku.json
$ kbbi alam --lokasi-kuki kukiku.json
Catatan:
kbbijuga bisa dipanggil denganpython kbbi.py.
kbbi-autentikasijuga bisa dipanggil denganpython -c "import kbbi; kbbi.autentikasi()"
Silakan lihat CONTRIBUTING.md.
Proyek ini didistribusikan dengan lisensi MIT.
Proyek ini merupakan proyek pribadi yang didasari oleh rasa cinta kepada bahasa Indonesia dan bahasa pemrograman Python. Proyek ini bertujuan untuk memudahkan akses ke KBBI daring tanpa menggunakan peramban web. Proyek ini tidak dimaksudkan untuk menyalahi hak cipta KBBI daring. Proyek ini dan pengembangnya tidak berafiliasi dengan Badan Bahasa Kemdikbud maupun Python Software Foundation. Pengembang tidak bertanggung jawab atas penyalahgunaan yang mungkin muncul dari proyek ini.