Metadata-Version: 2.4
Name: dqlab-grader
Version: 0.1.0
Summary: Pengecek jawaban latihan Data Analyst with Python (DQLab) + pencatatan progres peserta
Author: Abel Kristanto
License-Expression: MIT
Project-URL: Homepage, https://github.com/AbelKristanto/DQLab-dataanalystusingpython
Keywords: dqlab,data analyst,python,latihan,autograder,jupyter,colab
Classifier: Programming Language :: Python :: 3
Classifier: Natural Language :: Indonesian
Classifier: Framework :: Jupyter
Classifier: Intended Audience :: Education
Classifier: Topic :: Education
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Provides-Extra: admin
Requires-Dist: pandas; extra == "admin"
Requires-Dist: openpyxl; extra == "admin"
Dynamic: license-file

# dqlab-grader

Alat untuk **mengecek jawaban latihan** kelas Data Analyst with Python (DQLab).

Kamu cukup mengerjakan soal seperti biasa. Alat ini akan memberi tahu apakah jawabanmu sudah benar. Kalau belum, alat ini menjelaskan bagian yang salah dan cara memperbaikinya.

---

## Langkah 1: Pasang (sekali saja)

Tulis ini di sel paling atas notebook (Google Colab), lalu jalankan:

```python
!pip install -q dqlab-grader
```

## Langkah 2: Isi nama dan ID

Jalankan ini sekali setiap kali membuka notebook. Perhatikan: namanya saat di-install `dqlab-grader`, tapi saat dipakai tetap `import dqcheck`.

```python
import dqcheck as dq

dq.mulai(nama="Budi Santoso", id_peserta="DQ-001", sesi=6)
```

- Ganti `nama` dengan nama lengkapmu.
- Ganti `id_peserta` dengan ID dari instruktur. Selalu pakai ID yang **sama**.
- Ganti `sesi` dengan sesi yang sedang kamu kerjakan.

## Langkah 3: Kerjakan soal

Tulis jawabanmu di sel, lalu **jalankan selnya**.

```python
nama_menu = "Kopi Susu Gula Aren"
harga = 18000
```

## Langkah 4: Cek jawaban

Di sel baru, tulis nomor soalnya:

```python
dq.cek("2.1")
```

Hasilnya:

- ✅ **BENAR**: lanjut ke soal berikutnya.
- ❌ **Belum tepat**: baca penjelasannya, perbaiki jawaban, **jalankan ulang sel jawabanmu**, lalu cek lagi.

Tidak apa-apa salah. Kamu boleh mencoba berkali-kali sampai benar.

---

## Perintah lain

| Mau apa? | Tulis ini |
|---|---|
| Cek soal nomor 2.1 | `dq.cek("2.1")` |
| Cek soal Capstone | `dq.cek("Capstone")` |
| Pindah ke sesi 7 | `dq.ganti_sesi(7)` |
| Lihat semua soal dan mana yang sudah benar | `dq.daftar_soal()` |
| Lihat soal yang belum benar saja | `dq.daftar_soal(hanya_belum=True)` |
| Lihat rekap jawabanku | `dq.status()` |
| Lihat bantuan | `dq.bantuan()` |

Arti tanda di daftar soal:

- ✅ sudah benar
- ❌ sudah dicoba tapi belum benar
- ⬜ belum dikerjakan

---

## Ada masalah?

| Pesan yang muncul | Yang harus dilakukan |
|---|---|
| "Isi identitas dulu" | Jalankan `dq.mulai(...)` lagi (Langkah 2). |
| "Variabel ... belum ada" | Jalankan dulu sel jawabanmu. Pastikan nama variabelnya sama persis dengan soal. |
| Sudah diperbaiki tapi masih salah | Kamu lupa menjalankan ulang sel jawaban. Jalankan dulu, baru cek lagi. |
| "Soal ... tidak ada" | Cek nomor soal dan sesinya. Lihat daftarnya dengan `dq.daftar_soal()`. |
| "Server tidak terjangkau" | Internetmu putus. Hasilmu tetap disimpan dan akan dikirim otomatis nanti. |

Kalau notebook di-restart, ulangi dari **Langkah 2**.
