README

Odin Turbo Pascal

Layar biru Turbo Pascal yang Anda kenal, dengan compiler dan debugger yang menghasilkan program native.

Instalasi · Mulai Cepat · Fitur · Dokumentasi · Changelog · Kontribusi

[!IMPORTANT] Rilis 2.9.0 memperluas bahasa Turbo Pascal 7 dengan OOP berbasis class seperti Delphi dan Free Pascal (pewarisan, virtual/override/abstract, property, is/as, class of, overload method), tanpa mode khusus sehingga program TP7 tetap dikompilasi apa adanya. Rilis ini juga membawa unit Classes dan Contnrs serta menu File › Examples - OOP... dengan 9 contoh. Rilis 2.8.0 menambahkan jendela grafik sungguhan untuk unit Graph. IDE, toolchain Odin, debugger terpadu, dan Odin Vision berjalan di macOS (Intel dan Apple Silicon), Linux (x86_64 dan arm64), dan Windows (x86_64). Windows, Apple Silicon, dan Linux diuji di runner GitHub Actions, belum di perangkat fisik pengembang. Lihat Riwayat Rilis dan Status Pengujian.

Daftar Isi

• Tentang
• Fitur
• Platform yang Didukung
• Persyaratan Sistem
• Instalasi
• Mulai Cepat
• Tutorial Pascal
• Pintasan Keyboard
• Kompatibilitas
• Status Pengujian
• Privasi dan Lokasi Data
• Dokumentasi
• Pengembangan
• Riwayat Rilis
• Kontribusi
• Lisensi
• Penulis

Tentang

Odin Turbo Pascal adalah IDE Pascal yang menghadirkan kembali pengalaman Turbo Pascal era DOS: layar biru, teks kuning, menu abu-abu, jendela editor berbingkai, dan tombol fungsi klasik. Bedanya, kode Anda dikompilasi menjadi program native untuk macOS, Linux, atau Windows, tanpa emulator DOS. Setelah terpasang, Odin tidak memerlukan internet dan tidak mengirim telemetri.

Bahasanya Turbo Pascal 7 secara bawaan, diperluas dengan OOP berbasis class seperti Delphi dan Free Pascal: program TP7 tetap dikompilasi apa adanya, dan siswa bisa melanjutkan ke pewarisan, polimorfisme, dan property tanpa pindah alat.

Compiler-nya adalah toolchain Odin sendiri: compiler Pascal, assembler, linker, runtime library, Odin Vision (Turbo Vision milik Odin), dan debugger, semuanya ditulis dari nol, untuk macOS (Intel dan Apple Silicon), Linux (x86_64 dan arm64), dan Windows (x86_64). Odin tidak memerlukan Free Pascal, Xcode, LLDB, atau GCC; satu-satunya dependensi adalah Python dengan Tk untuk IDE-nya. Free Pascal, yang dipakai rilis 1.0.0 dan menjadi backend alternatif sampai 2.3.0, sudah dicabut.

Odin cocok untuk siswa dan mahasiswa yang belajar algoritma dan pemrograman, guru yang mengajar Pascal di kelas, dan siapa saja yang rindu menekan Ctrl+F9 lalu melihat programnya berjalan.

Editor dengan contoh HELLO.PAS dari rilis 2.2.0 (kini halaman bawaannya bab01_01_halo_dunia.pas). Tangkapan layar dari lingkungan uji Linux; di macOS jendela memakai tampilan Tk native.

Mengapa Odin?

• Nostalgia yang benar-benar bekerja. Alur kerja Turbo Pascal tetap utuh: F2 simpan, F9 make, Ctrl+F9 jalankan, Alt+F5 User screen, F7/F8 menelusuri program baris demi baris.
• Program native, bukan emulasi. Hasil kompilasi adalah executable asli untuk CPU dan sistem operasi Anda, dan bisa diekspor untuk dijalankan di luar IDE.
• Compiler dan debugger milik sendiri. Di macOS, Linux, dan Windows, Odin mengompilasi dengan toolchain yang ditulis dari nol dan men-debug tanpa LLDB atau GDB, dengan jendela Watches dan Call stack seperti Turbo Pascal.
• Program interaktif sungguhan. ReadLn, ReadKey, warna Crt, dan GotoXY berjalan di User screen 80×25. Aplikasi Turbo Vision (Odin Vision) juga berjalan di sana, lengkap dengan mouse.
• Siap untuk kelas. Ada tutorial 20 bab, contoh OOP, contoh grafik, dan contoh AI berbahasa Indonesia, referensi Pascal ringkas, dan daftar pesan compiler yang langsung melompat ke baris yang salah.
• Dari TP7 ke OOP. Tipe object Turbo Pascal tetap ada, dan class gaya Delphi/Free Pascal tersedia tanpa mode khusus: virtual/override/abstract, property, is/as, class of, dan overload method.
• Aman untuk berkas Anda. Penyimpanan atomik, deteksi perubahan dari luar, dan pemulihan sesi otomatis setiap 10 detik.
• Ringan, terbuka, dan privat. Source yang mudah dipelajari dan diubah, berlisensi GNU GPL v3, tanpa akun, server, API key, atau telemetri.

English summary

Odin Turbo Pascal is a DOS-era, Turbo Pascal–style IDE for macOS, Linux and Windows. The language is Turbo Pascal 7 by default, extended with Delphi/Free Pascal–style classes (no mode switch, no new reserved words). Programs compile into native binaries and run in a built-in 80×25 terminal with Crt and Turbo Vision support, including the mouse. Odin's own toolchain, written from scratch in Rust and Pascal (compiler with x86-64 and AArch64 code generators, assembler, Mach-O, ELF and PE linkers, runtime library, Odin Vision, and an integrated Turbo Pascal–style debugger with Watches, Locals and Call stack windows), is the only compiler, on Intel and Apple Silicon Macs, x86_64 and arm64 Linux, and x86_64 Windows; Apple Silicon, Linux and Windows are verified on GitHub Actions runners. Free Pascal, Xcode and LLDB are not needed; the IDE itself needs Python with Tk. The Free Pascal backend of releases up to 2.3.0 has been removed. Messages and documentation are in Indonesian. Licensed under the GNU GPL v3 or later.

Fitur

Antarmuka dan editor

• Layar biru klasik dengan menu File · Edit · Search · Run · Compile · Debug · Options · Window · Help, status bar, dan baris tombol fungsi.
• Beberapa jendela sekaligus: tile, cascade, zoom, dan daftar jendela.
• Undo/redo, clipboard, find/replace, go to line, hapus baris, indentasi otomatis, serta mode insert/overwrite.
• Warna sintaks Turbo Biru Lembut (latar biru tua dengan warna pastel) aktif secara bawaan dan membedakan kata tercadang, variabel, prosedur/fungsi, tipe bawaan, konstanta, angka, string, operator, komentar, dan direktif kompiler. Teks kuning klasik di latar biru tetap tersedia lewat Options › Editor.
• Desktop menampilkan logo Odin dengan plakat bergaya dialog Turbo Vision di bawahnya: tag versi (misalnya v2.2.0), kredit penulis, hak cipta, dan lisensi. Tag yang sama tampil di baris status, About, dan halaman bawaan bab01_01_halo_dunia.pas.
• Encoding CP437 dan UTF-8 (termasuk BOM), serta akhir baris LF dan CRLF, dipertahankan apa adanya saat menyimpan.

Kompilasi

• Compiler Odin (odinpc): bahasa Turbo Pascal 7 secara bawaan, termasuk tipe object, dengan unit standar dan Turbo Vision (lihat Unit standar), diperluas dengan OOP berbasis class (lihat OOP dengan class). Tidak memerlukan Free Pascal, Xcode, maupun GCC. Menghasilkan program x86_64 dan arm64 untuk CPU Anda (di Windows: x86_64); di Apple Silicon, linker Odin menulis tanda tangan kode ad-hoc yang diwajibkan macOS.
• Compile, Make, dan Build. Tersedia primary file untuk proyek yang terdiri dari program dan unit.
• Unit path dan include path, range check, dan overflow check.
• Daftar diagnostik compiler: klik untuk melompat ke baris error, dan Alt+F8 untuk pesan berikutnya. Pesan compiler berbahasa Indonesia dengan nomor galat gaya Turbo Pascal 7.
• Hasil build disimpan terpisah di cache. Build yang gagal tidak pernah menjalankan executable lama.
• Ekspor executable native.

Menjalankan program

• User screen 80×25 berbasis pseudo-terminal (ConPTY di Windows): ReadLn, ReadKey, KeyPressed, 16 warna, GotoXY, ClrScr, dan Window.
• Tombol F1–F12, Insert, dan panah diteruskan ke program dengan kode scan Turbo Pascal, termasuk kombinasi Shift, Ctrl, dan Alt (Option di Mac).
• Program Turbo Vision menerima klik, seret, dan roda mouse. Setelah program selesai, isi layar sebelumnya kembali.
• Parameter program (Run › Parameters) diteruskan tanpa melewati shell.
• Ctrl+C menginterupsi program, Ctrl+F2 menghentikannya, dan Copy screen menyalin isi layar.
• Runtime error: baris penyebabnya ditandai merah di editor, dan Search › Find error kembali ke baris itu.

Turbo Vision (Odin Vision)

Odin Vision adalah Turbo Vision milik Odin (macOS, Linux, dan Windows), ditulis ulang dari nol (clean-room) mengikuti API Turbo Vision di Turbo Pascal 7:

• Unit App, Drivers, Views, Menus, Dialogs, MsgBox, StdDlg, Memory, HistList, Validate, Editors, Outline, ColorSel, dan TextView: seluruh unit Turbo Vision TP7.
• Jendela bertumpuk dengan bayangan, menu bar dan menu drop-down, serta status line.
• Dialog dengan tombol, input line (dengan validator dan riwayat), check box, radio button, dan list box, ditambah dialog berkas dan dialog ganti direktori.
• Editor teks, outline, dialog warna (TColorDialog), dan terminal teks (TTerminal, ditulis lewat WriteLn dengan AssignDevice).
• Keyboard dan mouse di User screen. Perilakunya dijelaskan di rtl/vision/SPEC.md.
• Program demo (menu, jendela editor, dialog, MessageBox) ada di repositori source: tests/pascal/vision/VISION.PAS. Buka dengan File › Open, lalu tekan Ctrl+F9.

Debugger

Debugger terpadu bergaya Turbo Pascal (macOS, Linux, dan Windows), tanpa LLDB atau GDB:

• Breakpoint dari gutter atau Ctrl+F8. Breakpoint ikut bergeser saat baris disisipkan, tersimpan bersama pemulihan sesi, dan bisa diubah saat program berjalan.
• Menelusuri program: Trace into (F7), Step over (F8), Go to cursor (F4), dan Continue. Ctrl+C di User screen menghentikan program sementara. Baris yang akan dijalankan berikutnya ditandai hijau.
• Jendela Watches, Local variables, dan Call stack. Ketiganya ikut diatur Tile dan Cascade. Pilih frame di Call stack untuk melihat variabel pemanggil.
• Evaluate/Modify (Ctrl+F7) untuk ekspresi Pascal: variabel, field, indeks dengan cek batas, ^, @, aritmetika, typecast, Ord/Chr/Length/High/Low/SizeOf. Nilai ditampilkan seperti di Turbo Pascal, misalnya 'abc', (1, 2, 3), (X:1; Y:2), [1, 3..5], dan nama enumerasi.

[!NOTE] Rilis 1.0.0 memakai konsol LLDB di User screen. Sejak 2.0.0-alpha.1 debugger terpadu menggantikannya, sejak 2.1.0-alpha.1 debugger ini juga tersedia di Apple Silicon dan Linux, dan sejak 2.2.0 di Windows.

OTP-AI: unit machine learning

Folder otp-AI/ berisi pustaka AI dan machine learning murni Pascal untuk Odin Turbo Pascal, tanpa dependensi luar. Pustakanya terdiri dari 19 unit yang dikelompokkan menurut fungsi seperti modul Python, sehingga cukup beberapa uses untuk satu program:

• 20 program contoh di otp-AI/EXAMPLES/ (regresi, KNN, K-Means, cross-validation, jaringan saraf, Naive Bayes, pohon keputusan, logika fuzzy, Q-learning, dan lainnya), serta tes TESTALL dan TESTADV.
• Validasi input dilakukan di setiap unit: parameter tidak valid mengembalikan kode galat tanpa merusak data.
• Buku tutorial berwarna penuh otp-AI/PANDUAN_OTP_AI.pdf (60 halaman, ditulis Syams Ideris, GPL v3) membahas tiap unit dan contoh: peran unit, tujuan, parameter, hasil yang diharapkan, dan posisinya dalam pembelajaran machine learning.
• Menu File › Examples - Graph... membuka daftar 14 contoh unit Graph (garis, bentuk, palet, grafik batang dan pai, grafik fungsi, animasi, sprite, Mandelbrot, jam analog, menggambar dengan panah), yang dijalankan di jendela grafik sungguhan.
• Menu File › Examples - AI... membuka daftar 20 contoh OTP-AI beserta topiknya, seperti File › Examples untuk tutorial Pascal.
• Cara memakai: 19 unit sudah terpasang di IDE dan langsung dipanggil seperti Crt, tanpa pengaturan unit path: tulis uses AIMATH, AIDATA, AILINEAR; lalu Ctrl+F9. Panduan lengkap ada di otp-AI/README.TXT.

Seluruh contoh dikompilasi dan dijalankan dengan odinpc 2.5.0 di macOS x86_64 (TESTALL 139 pernyataan uji, TESTADV 148). Platform lain belum diuji untuk pustaka ini.

Metrik: Ukur dan Periksa

Bahan analisis dan penilaian kode, misalnya untuk lomba pemrograman (backend Odin; lihat Help › Metrik: Ukur dan Periksa):

• Run › Ukur (Shift+F9) membangun program dengan build juri (odinpc build --count-steps --range-checks --overflow-checks), menjalankannya di User screen, lalu membuka jendela Metrik: jumlah langkah, puncak heap, memori global, dan kedalaman panggilan. Angka-angka ini sama di macOS, Linux, dan Windows, x86-64 maupun arm64, karena yang dihitung adalah langkah, bukan waktu.
• Peta langkah menunjukkan baris mana yang paling banyak dijalankan. Catatan struktur dari odinpc metrics (variabel tidak dipakai, nesting dalam, kompleksitas tinggi, angka ajaib, goto, efek samping global) bisa diklik ke barisnya.
• Run › Periksa... menjalankan program dengan setiap kasus dalam paket soal (aturan.json, kasus/*.in/.out). Hasilnya: vonis per kasus (benar, salah, melewati batas langkah atau memori, runtime error), skor subtask gaya OSN/IOI, dan pemeriksaan syarat soal.
• Laporan bisa disimpan sebagai JSON otp-metrics/1 (odin/metrics.py, hanya pustaka standar Python). Kontrak build hitung langkah ada di rtl/COMPILER_INTERFACE.md §8.

Berkas dan sesi

• Contoh bawaan diperlakukan sebagai template: Save otomatis menjadi Save as, sehingga contoh asli tidak tertimpa.
• Daftar berkas terakhir, pengaturan yang tersimpan, dan hanya satu instance aplikasi yang berjalan.

Platform yang Didukung

Persyaratan Sistem

Pemasang macOS dapat memasang Python dengan Tk melalui Homebrew, dan pemasang Windows melalui winget. Di Linux, Odin dijalankan dari source.

Instalasi

macOS

Pemasang satu berkas (offline). Unduh OdinTurboPascal-VERSI-macos-x86_64.pkg (Mac Intel) dari halaman Releases, lalu buka. Paket memasang aplikasi di ~/Applications tanpa kata sandi administrator dan membawa Python dengan Tk sendiri, jadi tidak ada yang diunduh dan tidak perlu Homebrew atau Xcode. Paket belum ditandatangani Apple: bila macOS menahannya, klik kanan paketnya, pilih Open, atau gunakan System Settings › Privacy & Security › Open Anyway. Dibangun oleh python3 scripts/build_setup_mac.py dan oleh CI. Diuji di Mac Intel pengembang (pasang, pemeriksaan kompilasi dengan jaringan diblokir, buka lewat LaunchServices); versi arm64 hanya dibangun di CI, dan Mac bersih tanpa Python belum diuji.

Dari repositori (Install.command). Pemasang ini memasang rilis 2.9.0: IDE, toolchain Odin universal untuk Mac Intel dan Apple Silicon, dan runtime library-nya. Satu-satunya dependensi adalah Python dengan Tk.

1. Unduh repositori ini (Code › Download ZIP), lalu ekstrak seluruhnya. Jangan menjalankan pemasang dari pratinjau ZIP.
2. Buka Install.command. Pemasang berjalan di Terminal dan akan:
   • mendeteksi chip Intel atau Apple Silicon;
   • memeriksa Python dengan Tk, lalu menawarkan Homebrew atau tautan unduhan resmi bila belum terpasang;
   • mengompilasi dan menjalankan program uji kecil dengan odinpc dari bundel untuk memastikan hasilnya cocok dengan CPU Mac Anda. Bila pemeriksaan ini gagal, pemasangan berhenti dengan pesan kesalahan;
   • memasang aplikasi di ~/Applications dan mencadangkan versi sebelumnya bila ada.
3. Jalankan ~/Applications/Odin Turbo Pascal.app.

[!WARNING] Bundel ini belum ditandatangani maupun dinotarisasi Apple. Bila macOS menahan pembukaannya, buka System Settings › Privacy & Security › Open Anyway. Jangan menonaktifkan Gatekeeper secara global.

[!TIP] Bila atribut executable hilang saat ZIP diekstrak, jalankan pemasang lewat Terminal: /bin/bash "/lokasi/paket/Install.command"

Windows

Pemasang Windows memasang IDE beserta odinpc.exe dan runtime library-nya di %LOCALAPPDATA%\Programs\OdinTurboPascal, tanpa hak administrator.

Setup satu berkas (offline). Pilihan termudah: unduh OdinTurboPascal-VERSI-Setup-x64.exe dari halaman Releases, lalu klik dua kali. Berkas ini membawa Python dengan Tk khusus untuk Odin, jadi tidak ada yang diunduh saat memasang dan tidak ada Python lain yang perlu dipasang. Pemasangan senyap untuk banyak PC: Setup.exe /VERYSILENT /SUPPRESSMSGBOXES. Hapus lewat Settings › Apps. Setup belum ditandatangani kode, sehingga Windows SmartScreen dapat menampilkan peringatan (More info › Run anyway). Setup dibangun oleh python scripts/build_setup_windows.py (Windows, Inno Setup 6.3+) dan oleh job Windows di CI.

Dari repositori (Install.cmd). Jalur ini memerlukan Python dengan Tk yang sudah terpasang atau internet untuk memasangnya:

1. Unduh repositori ini (Code › Download ZIP), lalu ekstrak seluruhnya.
2. Klik dua kali Install.cmd. Pemasang berjalan di jendela PowerShell dan akan:
   • memeriksa Windows 10 1809 atau lebih baru, 64-bit;
   • mencari Python dengan Tk, lalu menawarkan winget atau tautan unduhan resmi bila belum terpasang;
   • mengompilasi dan menjalankan program uji kecil dengan odinpc.exe;
   • memasang aplikasi, mencadangkan versi sebelumnya bila ada, dan membuat pintasan di menu Start dan Desktop.
3. Jalankan Odin Turbo Pascal dari menu Start.

[!NOTE] Di runner GitHub Actions, pemeriksaan kompilasi dan penyalinan aplikasi oleh pemasang diuji pada setiap commit, dan setup Inno dipasang serta dihapus secara senyap. Setup Inno 2.9.0 sudah dibangun, dipasang, dan dijalankan di PC Windows 10 sungguhan dengan hasil berhasil; Install.cmd dengan winget belum diuji di sana.

Linux

Pemasang satu berkas (offline). Unduh OdinTurboPascal-VERSI-linux-x86_64.run (atau -aarch64.run) dari halaman Releases, lalu jalankan sh OdinTurboPascal-VERSI-linux-x86_64.run. Berkas ini membawa IDE, odinpc, dan Python dengan Tk sendiri, jadi tidak ada yang diunduh dan tidak perlu hak root: pemasangan masuk ke ~/.local/share/OdinTurboPascal-app (--prefix DIR untuk folder lain), dengan perintah odin-turbo-pascal di ~/.local/bin dan entri menu aplikasi. Dari sistem hanya dibutuhkan pustaka X11 (ada di setiap desktop Linux). Hapus dengan sh BERKAS.run --uninstall; program Pascal dan pengaturan tetap tersimpan. Pemasang dibangun oleh python3 scripts/build_setup_linux.py setelah cargo build --release, dan oleh CI.

Pemasang ini diuji di VM Ubuntu 24.04 x86_64 dengan jaringan diputus, dan versi arm64 hanya dibangun di CI. Distro lain, glibc 2.34 (build dibuat di glibc 2.39, simbol baru hanya referensi lemah), dan desktop sungguhan belum diuji.

Dari source. Contoh untuk Ubuntu atau Debian:

sudo apt install python3-tk git          # IDE (Python + Tk)
curl https://sh.rustup.rs -sSf | sh      # Rust, sekali saja, untuk membangun odinpc
git clone https://github.com/Syamsuddin/ODIN-TURBO-PASCAL.git
cd ODIN-TURBO-PASCAL/toolchain
cargo build --release                    # membangun odinpc; tanpa crate pihak ketiga
cd ..
python3 main.py                          # IDE menemukan toolchain/target/release/odinpc

Compiler, debugger, dan Odin Vision langsung tersedia. Free Pascal tidak diperlukan.

Dari source (macOS dan Windows)

Dengan Python (Tk) dan Rust:

cd toolchain && cargo build --release && cd ..
python3 main.py                          # di Windows: python main.py

Untuk bundel .app yang berjalan di Intel maupun Apple Silicon, bangun odinpc universal dengan python3 scripts/build_toolchain.py sebelum python3 scripts/package_app.py.

Menghapus aplikasi

Mulai Cepat

1. Pilih File › New, lalu ketik program berikut:
   pascalCopy

   program Halo;
   uses Crt;
   var
     Nama: string;
   begin
     ClrScr;
     TextColor(Yellow);
     Write('Siapa nama Anda? ');
     ReadLn(Nama);
     TextColor(LightCyan);
     WriteLn('Halo, ', Nama, '! Selamat datang di Odin Turbo Pascal.');
     ReadKey;
   end.

2. Tekan F2 untuk menyimpan (di Mac juga bisa Command+S).
3. Tekan Ctrl+F9 untuk mengompilasi dan menjalankan (di Mac juga bisa Command+R). Program tampil di User screen; Alt+F5 menampilkan atau menyembunyikannya.
4. Tekan F8 untuk menjalankan program baris demi baris. Sorot Nama, lalu tekan Ctrl+F7 untuk melihat isinya.
5. Buka File › Examples untuk belajar Pascal dari awal lewat tutorial 20 bab, lalu File › Examples - OOP untuk pemrograman berorientasi objek dengan class.

Tutorial Pascal

File › Examples berisi tutorial Pascal untuk pemula: 90 berkas dalam 20 bab, yaitu 89 program dan satu unit. Setiap kode penting diberi komentar penjelasan singkat dalam bahasa Indonesia. Tes otomatis menjalankan setiap program dan memeriksa keluarannya.

• Nama berkas mengikuti pola babNN_MM_topik.pas, misalnya bab06_04_case_of.pas, sehingga berkas urut sendiri di folder. Nama program di dalamnya sama dengan nama berkas.
• Unit Bab 19 bernama matematika.pas tanpa awalan bab, karena nama berkas unit harus sama dengan nama di baris unit matematika;.
• Program Bab 17 dan proyek Bab 20 membuat berkas data (catatan.txt, angka.dat, siswa.dat, struk.txt, rekap_nilai.txt, kontak.dat). Nama berkasnya ditulis sebagai konstanta di awal program, dan program menampilkan folder tempat berkas itu dibuat, yaitu folder berkas .pas-nya.
• Contoh bawaan adalah templat: Save selalu menjadi Save As. Simpan salinannya ke folder sendiri sebelum mengubah atau menjalankan program yang membuat berkas data, supaya berkas itu tidak tersimpan di dalam folder aplikasi. Untuk Bab 19, salin juga matematika.pas ke folder yang sama.

File › Examples - OOP melanjutkan tutorial dengan sembilan program berorientasi objek di examples-oop/: class pertama, constructor dan destructor, enkapsulasi dan property, pewarisan, polimorfisme (virtual, override, abstract), class var dan class of, daftar objek dengan is/as, overload, dan proyek kasir toko. Tes otomatis juga menjalankan dan memeriksa keluarannya. Buku tutorial PDF masih membahas Bab 1–20 saja.

Pintasan Keyboard

Alternatif Mac: Command+N/O/S (New/Open/Save), Command+B (Compile), Command+R (Run), Command+F (Find), Command+W (Close), Command+Q (Quit). Pada Mac laptop, tekan Fn bersama F1–F12. Daftar lengkap ada di docs/SHORTCUTS.txt.

Kompatibilitas

OOP dengan class

Bahasa bawaannya Turbo Pascal 7. Di atasnya, odinpc memahami OOP berbasis class seperti Delphi dan Free Pascal, tanpa direktif atau mode dan tanpa kata tercadang baru (program TP7 yang memakai class, property, is, atau as sebagai nama tetap dikompilasi):

type
  THewan = class
  private
    FNama: String;
  public
    constructor Create(const ANama: String);
    function Suara: String; virtual; abstract;
    property Nama: String read FNama;
  end;
  TKucing = class(THewan)
    function Suara: String; override;
  end;

• Didukung: class(Induk) dengan akar TObject, deklarasi forward, private/protected/public/published (dan strict), constructor dan destructor, virtual/override/abstract/reintroduce, inherited dengan atau tanpa nama, property (termasuk property larik dan default), class var, class method (juga virtual), class of dengan constructor virtual, overload method, is/as, dan with pada objek.
• Unit Classes (TList, TStringList) dan Contnrs (TObjectList) ditulis dengan class.
• Belum termasuk: exception, interface, generic, procedure of object, dan Result. Tanpa exception, salah pakai menjadi runtime error (211 method abstract, 219 as gagal, 216 rujukan nil).
• Debugger menampilkan isi field objek, dan Obj.Field bisa dievaluasi.
• Diuji di Mac Intel dan di runner GitHub Actions untuk macOS Intel, macOS Apple Silicon, Linux x86_64, Linux arm64, dan Windows. Perangkat fisik Apple Silicon dan Windows belum diuji langsung. Rinciannya ada di docs/COMPATIBILITY.txt dan IMPLEMENTATION_PLAN.md (Tahap 10).

Unit standar Turbo Pascal

Diuji dengan korpus tes di Mac Intel, di VM Ubuntu 24.04 (x86_64, dan aarch64 lewat qemu), dan di runner GitHub Actions untuk macOS Apple Silicon, Linux x86_64, Linux arm64, dan Windows x86_64. Sampai 2.3.0, ekspektasi korpus dibuat dengan Free Pascal 3.2.2 sebagai pembanding.

Rincian dan perbedaan perilaku ada di docs/COMPATIBILITY.txt dan tests/pascal/DEVIATIONS.md.

Batasan

• Odin adalah implementasi baru yang mengikuti antarmuka dan alur Turbo Pascal klasik. Odin bukan salinan Borland dan tidak menyertakan binary, logo, font, maupun berkas bantuan Borland.
• Hasil kompilasi berupa program 64-bit untuk macOS, Linux, atau Windows, bukan EXE DOS 16-bit. Kode Mem/Port, interrupt DOS, assembler 16-bit, dan pointer berbasis segmen perlu di-porting.
• Real berukuran 8 byte (TP: 6 byte), dan Real48 tidak tersedia; berkas biner lama perlu dikonversi. Round membulatkan ke bilangan genap untuk nilai .5.
• Compiler Odin:
  • menghasilkan program untuk macOS dan Linux (x86_64 dan arm64) serta Windows (x86_64); di sistem lain IDE bisa mengedit tetapi tidak mengompilasi;
  • mengikuti bahasa Turbo Pascal 7 secara bawaan, termasuk tipe object, dan diperluas dengan class (lihat OOP dengan class); mode ObjFPC/Delphi dari backend Free Pascal lama tidak ada lagi sebagai mode, exception dan interface belum didukung, begitu pula blok asm;
  • mendukung unit Objects dan seluruh Turbo Vision lewat Odin Vision. Record data dialog harus packed record;
  • Extended sama dengan Double, dan fungsi seperti Exp dan Sin dihitung dalam Double.
• Rilis 1.0.0 memakai konsol LLDB; sejak 2.0.0-alpha.1 debugger terpadu menggantikannya.
• User screen tidak menyediakan scrollback maupun true color. Mouse diteruskan ke program yang memintanya. Option sebagai Alt di keyboard Mac sungguhan belum diuji.

Status Pengujian

[!CAUTION] Belum diverifikasi langsung: Mac Apple Silicon dan PC Linux (hanya runner CI dan VM); pemasangan lewat Install.command di Apple Silicon; Install.cmd lengkap (winget, pintasan, menu Start); Windows on ARM; peluncuran lewat Finder/LaunchServices; Gatekeeper; Mac bersih tanpa Free Pascal maupun Xcode Command Line Tools; LLDB di paket rilis 1.0.0; dan pencetakan lewat Printer.

Privasi dan Lokasi Data

Odin tidak memakai akun, server, API key, maupun telemetri. Internet hanya diperlukan untuk memasang dependensi yang belum ada.

Program dijalankan dengan working directory di folder source program utama. Uninstall.command dan Uninstall.cmd tidak menghapus program pribadi maupun folder pengaturan.

Buku

Help › Buku membuka buku tutorial Belajar Pemrograman Bahasa Pascal dengan ODIN Turbo Pascal (docs/Belajar_Pemrograman_Bahasa_Pascal.pdf) di aplikasi PDF bawaan sistem. Buku berwarna penuh ini ditulis oleh Syams Ideris dan mengikuti tutorial di File › Examples: kata pengantar, daftar isi, 20 bab dalam enam bagian, penutup, dan enam lampiran (pemasangan, pintasan keyboard, kata tercadang, arti pesan kesalahan, daftar program, glosarium). Setiap bab dilengkapi infografik, gambar layar IDE, rangkuman, dan latihan bertingkat.

Semua listing di buku dicetak langsung dari examples/, dan semua keluaran program adalah hasil mengompilasi lalu menjalankan program itu dengan odinpc. Gambar layar IDE digambar dari menu, warna editor, dan kode aslinya. PDF dibangun ulang dengan python3 scripts/build_book.py (perlu Google Chrome dan PyMuPDF; sumbernya di book/).

Dokumentasi

Pengembangan

IDE-nya aplikasi Python/Tk tanpa dependensi pip. Toolchain Odin ditulis dalam Rust tanpa crate pihak ketiga, dan runtime library-nya dalam Pascal.

Build dan tes

Semua perintah dijalankan dari root repositori, dengan Python yang mendukung Tk:

python3 main.py                                     # jalankan IDE dari source (di Windows: python main.py)
python3 -m unittest discover -s tests -v            # seluruh tes Python
python3 -m unittest tests.test_debugger -v          # sesi debugger tanpa Tk
python3 -m unittest tests.test_vision -v            # snapshot layar Odin Vision
ODIN_UPDATE_SNAPSHOTS=1 python3 -m unittest tests.test_vision   # tulis ulang snapshot (tinjau dulu)
(cd toolchain && cargo build --release)             # bangun odinpc
(cd toolchain && cargo test --workspace)            # tes Rust, termasuk korpus diferensial
ODIN_CORPUS_TARGET=aarch64-linux ODIN_CORPUS_RUNNER="qemu-aarch64-static -L /usr/aarch64-linux-gnu" \
  cargo test -p odinpc --test corpus                # korpus untuk target lain (lihat tests/corpus.rs)
python3 scripts/bless_corpus.py NAMA                # ekspektasi korpus untuk program baru (tinjau dulu)
ODIN_BLESS=1 python3 -m unittest tests.test_core.CompilerTests.test_crt_screen_matches_snapshot   # snapshot layar Crt
python3 scripts/check_mac.py                        # gerbang pemasang macOS: odinpc compile + run native
python3 scripts/build_book.py                       # bangun ulang buku PDF (Chrome + PyMuPDF; di luar sandbox, perlu PTY)

Catatan tes:

• Tes compiler dilewati bila odinpc belum dibangun atau sistemnya belum didukung (core.ODIN_HOSTS). Tidak ada tes yang memerlukan Free Pascal.
• Tes GUI dilewati bila tidak ada display. Tes yang membuka pseudo-terminal memerlukan izin membuat PTY.
• GitHub Actions menjalankan semuanya di macOS Intel, macOS Apple Silicon, Linux x86_64, Linux arm64, dan Windows (.github/workflows/ci.yml). Job Windows juga mengunggah odinpc.exe sebagai artefak.

Rilis

python3 scripts/set_version.py X.Y.Z                # naikkan nomor versi di semua berkas dan CHANGELOG
python3 scripts/build_toolchain.py                  # odinpc universal (x86_64 + arm64) untuk bundel macOS
python3 scripts/package_app.py                      # bentuk ulang bundel .app, termasuk tag versi di halaman bawaan
rm toolchain/odinpc.exe; gh run download <run> -n odinpc-windows-x86_64 -D toolchain   # odinpc.exe dari CI Windows
python3 scripts/update_checksums.py                 # buat ulang SHA256SUMS.json (terakhir)
python3 scripts/render_logo.py                      # bila logo berubah: render logo, ikon, dan banner (butuh Pillow)

Struktur proyek

ODIN-TURBO-PASCAL/
├── main.py                  Titik masuk aplikasi
├── odin/
│   ├── app.py               Antarmuka Tk: menu, dialog, User screen, sesi debug
│   ├── windows.py           Jendela desktop: editor, Watches, Local variables, Call stack
│   ├── core.py              Dokumen, pengaturan, build dengan odinpc, diagnostik
│   ├── debugger.py          Sesi debug: odinpc debug di User screen, perintah JSON
│   ├── console.py           Emulator VT100 80×25 dan proses pseudo-terminal (tanpa Tk)
│   ├── terminal.py          Widget Tk untuk User screen
│   └── conpty.py            User screen di Windows (ConPTY lewat ctypes)
├── toolchain/               odinpc (Rust): lexer, parser, sema, codegen x86-64 dan AArch64,
│                            assembler, linker Mach-O/ELF/PE, info debug, debugger;
│                            odinpc.exe untuk paket Windows
├── rtl/                     Runtime library (Pascal): System, Crt, Dos, Strings, Printer, Objects,
│                            Classes, Contnrs, Math, SysUtils, Graph, ...
│   └── vision/              Odin Vision: semua unit Turbo Vision TP7 dan spesifikasinya (SPEC.md)
├── examples/                Tutorial Pascal pemula: 89 program dan satu unit dalam 20 bab
├── examples-graph/          Contoh unit Graph (File › Examples - Graph)
├── examples-oop/            Contoh OOP dengan class (File › Examples - OOP)
├── otp-AI/                  Pustaka AI/machine learning Pascal: 19 unit, 20 contoh, tes, buku PDF
├── docs/                    Panduan, referensi Pascal, pintasan, kompatibilitas
├── tests/                   Tes Python (fungsional, compiler, debugger, GUI, Odin Vision) dan
│   └── pascal/              korpus Pascal dengan ekspektasi tersimpan serta snapshot Crt dan Odin Vision
├── book/                    Sumber buku tutorial (HTML per bab dan buku.css); dibangun scripts/build_book.py
├── scripts/                 Launcher, pemeriksaan pemasang, ekspektasi korpus, bundel .app, versi, logo, buku
├── assets/                  Logo, ikon, dan banner (master PNG serta PNG/ICNS hasil render)
├── .github/workflows/       CI lima platform
├── Odin Turbo Pascal.app    Bundel macOS (dibentuk dari source)
├── Install.command · Uninstall.command          Pemasang macOS
├── Install.cmd · Install.ps1 · Uninstall.cmd   Pemasang Windows
└── CHANGELOG.md · IMPLEMENTATION_PLAN.md · LICENSE · THIRD_PARTY.txt · SHA256SUMS.json

Arsitektur

• Threading. core.py dan debugger.py tidak bergantung pada Tk. Thread kompilasi, pembaca terminal, dan pembaca debugger tidak pernah menyentuh Tk secara langsung. Hasilnya dikirim lewat antrean pesan yang dibaca UI setiap 40 ms.
• Tanpa shell. Kompilasi dan eksekusi program tidak pernah memakai shell.
• Debugger berbasis instrumentasi. Build debug menyisipkan pengait di setiap statement, dan odinpc debug berbicara dengan runtime library program lewat Unix socket (di Windows: TCP 127.0.0.1). Tidak ada ptrace, LLDB, maupun GDB, sehingga perilakunya sama di setiap sistem. Kontraknya ada di rtl/COMPILER_INTERFACE.md.
• Clean-room. Toolchain dan runtime library Odin ditulis tanpa membaca sumber Free Pascal, Free Vision, maupun Borland. Sampai 2.3.0, Free Pascal hanya dipakai sebagai pembanding keluaran program di korpus tests/pascal/; kini proyek ini tidak memakainya sama sekali.

Riwayat Rilis

Rincian setiap rilis ada di CHANGELOG.md dan di halaman Releases.

Kontribusi

Laporan bug, saran, dan pull request dipersilakan melalui Issues dan Pull requests. Sebelum mengirim perubahan:

1. Jalankan python3 -m unittest discover -s tests -v dan, bila mengubah toolchain/ atau rtl/, cargo test --workspace di toolchain/. Tambahkan tes untuk perilaku baru.
2. Untuk perilaku Pascal baru, tambahkan program ke tests/pascal/, buat ekspektasinya dengan scripts/bless_corpus.py, lalu periksa ekspektasi itu terhadap perilaku Turbo Pascal 7 sebelum commit. Jangan membaca atau menyalin sumber Free Pascal, Free Vision, maupun Borland.
3. Tulis pesan untuk pengguna dalam bahasa Indonesia. Label menu tetap berbahasa Inggris, sesuai gaya Turbo Pascal.
4. Awali berkas source baru dengan header lisensi SPDX-License-Identifier: GPL-3.0-or-later.
5. Setelah mengubah source, jalankan python3 scripts/package_app.py agar bundel .app ikut diperbarui.

Lisensi

Odin Turbo Pascal adalah perangkat lunak bebas di bawah GNU General Public License v3.0 atau yang lebih baru. Anda boleh memakai, mempelajari, mengubah, dan menyebarkannya. Bila Anda menyebarkan versi asli atau versi ubahan, sertakan source code-nya dengan lisensi yang sama. Program ini disediakan tanpa jaminan apa pun.

Copyright © 2026 Syams Ideris

• Program yang dikompilasi dengan Odin memuat runtime library Odin, yang juga berlisensi GNU GPL v3 atau yang lebih baru tanpa pengecualian runtime. Bila Anda membagikan program tersebut, ketentuan GPL berlaku untuk program itu.
• Logo dan ikon Odin adalah karya penulis, diambil dari proyek ODIN Turbo Pascal v2.0, dan berlisensi sama.
• Python, Tcl/Tk, Homebrew, dan winget dipasang terpisah dengan lisensinya masing-masing. odinpc dibangun dengan pustaka standar Rust (lisensi MIT/Apache-2.0). Lihat THIRD_PARTY.txt.

[!NOTE] Odin adalah aplikasi independen dan tidak berafiliasi dengan Borland maupun pemilik merek Turbo Pascal saat ini. "Turbo Pascal" dan "Borland" adalah merek dagang dari pemiliknya masing-masing. Nama tersebut dipakai hanya untuk menjelaskan kompatibilitas dan inspirasi.

Penulis

Syams Ideris · syamsuddin.ideris@gmail.com

Bila Odin Turbo Pascal bermanfaat untuk belajar atau mengajar, beri ⭐ pada repositori ini dan bagikan ke teman sekelas.

Dibuat untuk generasi baru pembelajar Pascal.