pyindo 1.0.0__tar.gz

pyindo-1.0.0/CHANGELOG.md

@@ -0,0 +1,87 @@
+# Changelog
+
+Semua perubahan penting pada proyek Indpy dicatat di sini.
+
+Format mengikuti [Keep a Changelog](https://keepachangelog.com/id/1.0.0/),
+versi mengikuti [Semantic Versioning](https://semver.org/lang/id/).
+
+---
+
+## [1.0.0] — 2026-07-06
+
+Rilis perdana Indpy — transpiler Bahasa Indonesia ke Python.
+
+### Ditambahkan
+
+#### Inti Transpiler
+- **Lexer** (`lexer.py`) — tokenizer rekursif karakter-per-karakter; mendukung 46 kata kunci Bahasa Indonesia, string literal dijaga utuh (tidak diterjemahkan), longest-match-first untuk operator multi-karakter (`**=`, `//=`, dsb.)
+- **Parser** (`parser.py`) — recursive descent parser; membangun AST lengkap; mendukung tuple unpacking, eksponen kanan-asosiatif, serta keyword yang valid sebagai identifier (mis. `fungsi kosong(diri):`)
+- **Transpiler** (`transpiler.py`) — traversal AST rekursif; menghasilkan kode Python valid dengan indentasi otomatis; penanganan presedensi operator yang benar untuk `**`
+- **Keywords** (`keywords.py`) — peta 46 kata kunci Indonesia→Python beserta operator satu, dua, dan tiga karakter
+- **Errors** (`errors.py`) — hierarki `IndpyError` dengan pesan kesalahan dalam Bahasa Indonesia
+
+#### CLI (`main.py`)
+- `indpy` — masuk REPL interaktif langsung tanpa argumen
+- `indpy namafile.indpy` — shortcut jalankan file tanpa subperintah
+- `indpy jalankan namafile.indpy` — transpilasi + eksekusi; flag `--tampilkan` untuk lihat kode Python hasil
+- `indpy ekspor namafile.indpy` — transpilasi + simpan ke `.py`; flag `-o` untuk tentukan nama output
+- `indpy --versi` — tampilkan versi
+- `indpy --bantuan` — tampilkan bantuan
+
+#### REPL Interaktif
+- Prompt `>>> ` dan `... ` persis seperti Python REPL
+- Namespace persisten — variabel, fungsi, kelas, dan impor tetap hidup antar perintah
+- Hasil ekspresi ditampilkan otomatis (`repr`)
+- Deteksi blok multi-baris otomatis (blok berakhir dengan baris kosong)
+- `q`, `keluar()`, `exit()`, `quit()` → keluar dari REPL
+- Ctrl+C → keluar dari REPL
+- Ctrl+D → eksekusi sisa buffer lalu keluar
+- Error runtime ditampilkan tanpa menutup REPL
+
+#### Installer (`install.sh`)
+- Deteksi environment otomatis: **Termux**, **Acode Terminal**, **Linux**
+- Instalasi dependensi via `pkg` (Termux), `apt`, `apk`, `dnf`, atau `pacman`
+- Cek versi Python minimum (3.7+) dengan pesan kesalahan jelas
+- Update otomatis jika Indpy sudah terpasang (`git pull`)
+- Buat symlink global `indpy` di `$PREFIX/bin` (Termux), `/usr/local/bin`, atau `~/.local/bin`
+- Tambah `$BIN_DIR` ke PATH di `.bashrc`, `.bash_profile`, `.zshrc`, dan `.profile`
+
+#### Lainnya
+- **131 unit test** — mencakup Lexer, Parser, dan Transpiler (`pytest tests/ -v`)
+- **3 file contoh** — `halo_dunia.indpy`, `kalkulator.indpy`, `loop_dan_fungsi.indpy`
+- **VS Code Extension** (`indpy-syntax/`) — syntax highlighting untuk file `.indpy`
+- **Lisensi MIT** — Copyright 2026 Zandero
+
+---
+
+## Kata Kunci yang Didukung (46)
+
+| Indonesia       | Python      | Indonesia    | Python     |
+|-----------------|-------------|--------------|------------|
+| `fungsi`        | `def`       | `impor`      | `import`   |
+| `kelas`         | `class`     | `dari`       | `from`     |
+| `kembali`       | `return`    | `sebagai`    | `as`       |
+| `kembalikan`    | `return`    | `menjadi`    | `as`       |
+| `jika`          | `if`        | `coba`       | `try`      |
+| `jika_tidak`    | `elif`      | `kecuali`    | `except`   |
+| `lainnya`       | `else`      | `akhirnya`   | `finally`  |
+| `untuk`         | `for`       | `naikkan`    | `raise`    |
+| `selama`        | `while`     | `bersama`    | `with`     |
+| `dalam`         | `in`        | `dan`        | `and`      |
+| `hentikan`      | `break`     | `atau`       | `or`       |
+| `lanjut`        | `continue`  | `bukan`      | `not`      |
+| `lewati`        | `pass`      | `tidak`      | `not`      |
+| `lewat`         | `pass`      | `benar`      | `True`     |
+| `global`        | `global`    | `salah`      | `False`    |
+| `nonlokal`      | `nonlocal`  | `kosong`     | `None`     |
+| `hapus`         | `del`       | `cetak`      | `print`    |
+| `lambda`        | `lambda`    | `masukkan`   | `input`    |
+| `pernyataan`    | `assert`    | `panjang`    | `len`      |
+| `bilangan`      | `int`       | `rentang`    | `range`    |
+| `desimal`       | `float`     | `tipe`       | `type`     |
+| `teks`          | `str`       | `daftar`     | `list`     |
+| `himpunan`      | `set`       | `kamus`      | `dict`     |
+
+---
+
+[1.0.0]: https://github.com/ZanderoDev/Indpy/releases/tag/v1.0.0

pyindo-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Zandero
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

pyindo-1.0.0/MANIFEST.in

@@ -0,0 +1,5 @@
+include README.md
+include LICENSE
+include CHANGELOG.md
+recursive-include contoh *.indpy
+recursive-include tests *.py

pyindo-1.0.0/PKG-INFO

@@ -0,0 +1,314 @@
+Metadata-Version: 2.4
+Name: pyindo
+Version: 1.0.0
+Summary: Transpiler Bahasa Indonesia ke Python
+Author: Zandero
+License: MIT
+Keywords: python,indonesia,transpiler,cli
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# Indpy 🇮🇩
+
+**Indpy** adalah transpiler yang mengubah kode dengan sintaks **Bahasa Indonesia** menjadi kode Python valid, lalu langsung menjalankannya.
+
+```
+Kode .indpy  →  Lexer  →  Parser  →  AST  →  Transpiler  →  Python
+```
+
+---
+
+## Instalasi
+
+### Termux / Acode Terminal / Linux
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/ZanderoDev/Indpy/main/install.sh | bash
+```
+
+atau jika sudah di-clone:
+
+```bash
+bash install.sh
+```
+
+Setelah instalasi, buka terminal baru lalu jalankan:
+
+```bash
+indpy --versi
+```
+
+### Persyaratan
+
+- Python 3.7 atau lebih baru
+- Git (untuk instalasi otomatis)
+- pytest — hanya untuk menjalankan unit test
+
+```bash
+pip install pytest
+```
+
+---
+
+## Struktur Folder
+
+```
+Indpy/
+├── main.py        # CLI entry point
+├── lexer.py       # Tokenizer — teks → token
+├── parser.py      # Parser   — token → AST
+├── transpiler.py  # Generator — AST → kode Python
+├── keywords.py    # Peta kata kunci Bahasa Indonesia → Python
+├── errors.py      # Kelas error berbahasa Indonesia
+├── install.sh     # Installer otomatis
+├── tests/
+│   ├── test_lexer.py
+│   ├── test_parser.py
+│   └── test_transpiler.py
+└── contoh/
+    ├── halo_dunia.indpy       # Contoh 1: Halo Dunia
+    ├── kalkulator.indpy       # Contoh 2: Kalkulator
+    └── loop_dan_fungsi.indpy  # Contoh 3: Loop & Fungsi
+```
+
+---
+
+## Cara Pakai
+
+### Setelah install global (`indpy`)
+
+```bash
+# Masuk REPL interaktif
+indpy
+
+# Jalankan file .indpy
+indpy namafile.indpy
+indpy jalankan namafile.indpy
+
+# Lihat kode Python yang dihasilkan sebelum dijalankan
+indpy jalankan namafile.indpy --tampilkan
+
+# Ekspor ke file .py (tanpa menjalankan)
+indpy ekspor namafile.indpy
+indpy ekspor namafile.indpy -o output.py
+
+# Cek versi
+indpy --versi
+```
+
+### Tanpa install (langsung dari folder)
+
+```bash
+python main.py jalankan contoh/halo_dunia.indpy
+python main.py ekspor  contoh/kalkulator.indpy -o hasil.py
+python main.py repl
+```
+
+---
+
+## REPL Interaktif
+
+Jalankan `indpy` tanpa argumen untuk masuk ke mode interaktif:
+
+```
+$ indpy
+Indpy v1.0.0 (Python 3.11.6)
+Ketik 'keluar()' atau tekan Ctrl+D untuk keluar.
+>>> x = 10
+>>> x * 3
+30
+>>> cetak("halo dari REPL")
+halo dari REPL
+```
+
+### Blok multi-baris
+
+Blok yang dibuka dengan `:` otomatis masuk ke mode multi-baris. Tekan **Enter kosong** untuk mengeksekusi:
+
+```
+>>> fungsi kuadrat(n):
+...      kembali n ** 2
+...
+>>> kuadrat(7)
+49
+```
+
+### Pintasan keyboard
+
+| Tombol | Aksi |
+|--------|------|
+| `keluar()` / `exit()` | Keluar dari REPL |
+| Ctrl+D | Keluar dari REPL |
+| Ctrl+C | Batalkan input saat ini (tidak keluar) |
+
+---
+
+## Kata Kunci yang Didukung
+
+| Bahasa Indonesia  | Python      | Keterangan              |
+|-------------------|-------------|-------------------------|
+| `fungsi`          | `def`       | Definisi fungsi         |
+| `kelas`           | `class`     | Definisi kelas          |
+| `kembali`         | `return`    | Nilai kembalian         |
+| `kembalikan`      | `return`    | Alias `kembali`         |
+| `jika`            | `if`        | Kondisi                 |
+| `jika_tidak`      | `elif`      | Kondisi lanjutan        |
+| `lainnya`         | `else`      | Kondisi default         |
+| `untuk`           | `for`       | Loop iterasi            |
+| `selama`          | `while`     | Loop kondisi            |
+| `dalam`           | `in`        | Operator keanggotaan    |
+| `hentikan`        | `break`     | Keluar dari loop        |
+| `lanjut`          | `continue`  | Lanjut iterasi          |
+| `lewati`          | `pass`      | Pernyataan kosong       |
+| `lewat`           | `pass`      | Alias `lewati`          |
+| `impor`           | `import`    | Impor modul             |
+| `dari`            | `from`      | Impor dari modul        |
+| `sebagai`         | `as`        | Alias impor             |
+| `menjadi`         | `as`        | Alias `sebagai`         |
+| `coba`            | `try`       | Blok percobaan          |
+| `kecuali`         | `except`    | Tangkap exception       |
+| `akhirnya`        | `finally`   | Selalu dijalankan       |
+| `naikkan`         | `raise`     | Lempar exception        |
+| `bersama`         | `with`      | Context manager         |
+| `dan`             | `and`       | Operator logika         |
+| `atau`            | `or`        | Operator logika         |
+| `bukan`           | `not`       | Negasi logika           |
+| `tidak`           | `not`       | Alias `bukan`           |
+| `benar`           | `True`      | Nilai boolean           |
+| `salah`           | `False`     | Nilai boolean           |
+| `kosong`          | `None`      | Nilai null              |
+| `global`          | `global`    | Variabel global         |
+| `nonlokal`        | `nonlocal`  | Variabel closure        |
+| `hapus`           | `del`       | Hapus variabel          |
+| `lambda`          | `lambda`    | Fungsi anonim           |
+| `pernyataan`      | `assert`    | Pernyataan asersi       |
+| `cetak`           | `print`     | Tampilkan output        |
+| `masukkan`        | `input`     | Baca input              |
+| `panjang`         | `len`       | Panjang koleksi         |
+| `rentang`         | `range`     | Rentang angka           |
+| `tipe`            | `type`      | Tipe data               |
+| `bilangan`        | `int`       | Konversi ke bilangan    |
+| `desimal`         | `float`     | Konversi ke desimal     |
+| `teks`            | `str`       | Konversi ke teks        |
+| `daftar`          | `list`      | Tipe list               |
+| `kamus`           | `dict`      | Tipe dictionary         |
+| `himpunan`        | `set`       | Tipe set                |
+
+---
+
+## Contoh Kode
+
+### Halo Dunia
+
+```indpy
+cetak("Halo, Dunia!")
+```
+
+### Fungsi dan kondisi
+
+```indpy
+fungsi sapa(nama):
+    jika nama == "":
+        kembali "Halo, Anonim!"
+    kembali "Halo, " + nama + "!"
+
+cetak(sapa("Budi"))
+```
+
+### Loop
+
+```indpy
+untuk i dalam rentang(1, 6):
+    cetak("Iterasi ke-" + teks(i))
+```
+
+### Kelas
+
+```indpy
+kelas Hewan:
+    fungsi __init__(diri, nama):
+        diri.nama = nama
+
+    fungsi suara(diri):
+        cetak(diri.nama, "bersuara!")
+
+h = Hewan("Kucing")
+h.suara()
+```
+
+### Penanganan error
+
+```indpy
+coba:
+    hasil = 10 / 0
+kecuali ZeroDivisionError:
+    cetak("Tidak bisa membagi dengan nol!")
+```
+
+### Impor modul
+
+```indpy
+dari math impor sqrt sebagai akar_kuadrat
+
+cetak(akar_kuadrat(16))   # → 4.0
+```
+
+---
+
+## Keamanan String
+
+Kata kunci di dalam tanda kutip **tidak** diterjemahkan:
+
+```indpy
+cetak("jika hujan, bawa payung")
+# → print("jika hujan, bawa payung")   ✓ bukan "if hujan, bawa payung"
+```
+
+---
+
+## Menjalankan Unit Test
+
+```bash
+pytest tests/ -v
+```
+
+---
+
+## Arsitektur
+
+```
+Lexer (lexer.py)
+  Membaca source code karakter per karakter.
+  Menghasilkan token: KATA_KUNCI, NAMA, ANGKA, TEKS, OP, DELIMITER,
+  INDENT, DEDENT, BARIS_BARU, EOF.
+  Longest-match-first: operator tiga karakter (mis. **=) dicek sebelum dua karakter.
+  String literal dijaga utuh — isinya tidak diproses.
+
+Parser (parser.py)
+  Recursive Descent Parser.
+  Mengonsumsi token dan membangun AST (pohon dict Python).
+  Mendukung: penugasan, if/elif/else, while, for, def, class,
+  try/except/finally, with, import, return, break, continue, pass,
+  lambda, assert, del, global, nonlocal, eksponen kanan-asosiatif, dsb.
+
+Transpiler (transpiler.py)
+  Menelusuri AST secara rekursif.
+  Menghasilkan kode Python valid dengan indentasi otomatis.
+
+main.py (CLI)
+  Subperintah: jalankan | ekspor | repl
+  indpy (tanpa argumen) → langsung masuk REPL.
+  Mengorkestrasi Lexer → Parser → Transpiler → exec().
+```
+
+---
+
+## Lisensi
+
+MIT — bebas digunakan dan dimodifikasi.