psql rosetta

Btrieve / Pervasive.SQL / ZEN : Proyek repositori contoh kode Rosetta

Ide

Berikan contoh kode yang terdokumentasi untuk semua metode akses database yang didukung oleh Pervasive.SQL di semua platform menggunakan semua bahasa populer. Lebih disukai berguna bagi pengguna pemula dan mahir sebagai panduan referensi.

Nama

Melihat:

• Batu Rosetta
• Kode Rosetta

Latar belakang

Selama bertahun-tahun saya tersadar bahwa contoh kode/pengkodean sangat langka. Mereka juga bervariasi dari waktu ke waktu (platform, bahasa yang didukung), tetapi sebagian besar terjebak dalam waktu. Tidak terlalu menarik bagi seorang pemula, apakah dia baru mengenal bahasa pemrograman atau Pervasive.SQL. Selama bertahun-tahun saya mengembangkan ide tentang cara memperbaikinya dan melakukan beberapa upaya untuk menulis kode. Tugas ke depan cukup luas. Apalagi jika seseorang ingin melakukan pekerjaan dengan baik. Ide berubah, ada proyek atau tugas baru di antaranya, dll. Singkat cerita, butuh beberapa waktu dan hasilnya sangat berbeda dari yang diperkirakan sebelumnya karena ide pertama saya adalah menulis aplikasi referensi tunggal yang nantinya bisa di-porting ke bahasa lain/ platform.

Tata Letak

Berdasarkan paragraf Metode Akses Basis Data dalam dokumentasi online Actian Pervasive.SQL V13, saya membuat skrip shell Bash (mk_dirs.sh), mengambil satu argumen sebagai nama bahasa pemrograman, yang membuat struktur direktori yang mencantumkan semua metode akses basis data sebagai subdirektori. Dengan menggunakan skrip ini saya terpaksa melihat dan mendokumentasikan semua kemungkinan (?!) tidak peduli seberapa anehnya. Semua subdirektori berisi file ReadMe penurunan harga mereka sendiri yang menjelaskan kemungkinan (im) dan kode jika disediakan. Semua bahasa pemrograman memiliki file penurunan harga ReadMe di direktori akarnya yang menjelaskan seluk beluk, apa yang diimplementasikan dan tidak, serta file penurunan harga Hasil untuk mencatat apa yang telah diuji pada platform mana.

File hilang versus Hak Cipta

Tujuannya adalah untuk tidak melanggar hak cipta apa pun, jadi header harus disalin dari SDK yang dapat diunduh dari situs web Actian. Hal yang sama berlaku misalnya kode yang dapat disalin/ditempel dari situs web. Akan lebih bagus jika kode contoh (& header) dapat disediakan dari repositori. Saat melihat-lihat di Github, seseorang dapat menemukan file header yang dilindungi hak cipta. Saya serahkan pada Actian untuk menambahkannya.

Perbaikan

Saya sangat menyambut baik perbaikan, komentar, dan kontribusi lainnya. Secara pribadi saya dapat memikirkan pandangan:

• Semua kode harus sesuai dengan standar pengkodean.
• Refactoring/pembersihan kode.
• Semua kode harus kaya akan komentar. Beri anotasi pada semua panggilan basis data.
• Semua kode harus dibuat sangat defensif: jika terjadi kesalahan maka harus dilaporkan atau setidaknya dicatat.
• Semua kode harus diuji dengan benar. Lebih disukai di semua platform yang relevan. Yang pada gilirannya harus didokumentasikan.
• Kode harus ditulis atau diadaptasi untuk platform lain. Khususnya: Mac, iOS, Android
• Beberapa bahasa/platform yang jelas tidak ada. Terutama: Win/VS: c#, VB.net, Win/Embarcadero C++, Win/MingW atau GNU C/C++ lainnya, IOS/Objective C, Android/Java, Mac/membuat skrip bash-shell kompatibel/mendukung.
• Juga beberapa bahasa yang dulunya didukung/penting belum memiliki kode contoh. Apa yang terlintas dalam pikiran: Cobol, Delphi, ... ? Dan ada pula yang sudah tidak penting lagi: (Visual) Basic (pra .net), Pascal, Turboc (DOS), Watcom C/C++ (DOS)
• Beberapa 'bahasa' tidak terlalu dapat dibuktikan karena tampaknya memerlukan proses boilerplating, manajemen proyek, dan/atau integrasi dalam IDE. ASP.NET menjadi contohnya.
• Platform terintegrasi tidak terdaftar. Misalnya Sihir Mungkin tidak masuk akal untuk mencantumkannya. Platform lain yang pernah digunakan sebelumnya: Clarion dan Power Builder
• Subyek lain yang memerlukan perhatian adalah pengembangan berbasis web. Orang dapat memikirkan: Windows/ASP, Python/Flask, Python/Django, Ruby/Ruby-on-rails dan Javascript, NodeJS. Secara opsional diperluas oleh anak-anak baru di blok tersebut seperti Dart/Flutter, Meteor, dll. meskipun banyak dari mereka didasarkan pada Javascript.
• Pengemudi. Saat ini ada satu hal yang terlintas dalam pikiran: SQLAlchemy-Pervasive : memerlukan perhatian dan kasih sayang yang serius.
• Saat ini fokus yang kuat adalah pada konektivitas database. Pada akhirnya aplikasi yang mendukung commandline, kutukan (TUI), GUI saat menggunakan semua panggilan yang tersedia di API (Btrieve, Btrieve2, ODBC, JDBC) akan menjadi bonus nyata. Ini akan digunakan untuk demo, mengilustrasikan bagaimana panggilan harus digunakan dan jelas akan memberikan pengujian yang bagus, terutama jika kode dapat dijalankan menggunakan otomatisasi pengujian. Ini akan menjadi hal utama untuk dirancang dan diimplementasikan dengan benar. Beberapa langkah kecil dalam proses ini saja sudah sangat bagus.

Saya sepenuhnya menyadari bahwa sebagian besar kode tidak memenuhi standar di atas. Memfaktorkan ulang semua kode akan memakan banyak waktu yang akan menunda rilis awal atau bahkan mencegahnya. Untuk alasan ini saya merilis kode yang tidak sesuai dengan pandangan saya tentang pengkodean yang benar.

Kredit

Lihat file Credits.md. File ini berlaku untuk keseluruhan proyek.

Lisensi

Lihat file License.md. File ini berlaku untuk keseluruhan proyek.

Peringatan

Demi kelengkapan dan keseragaman, semua metode akses yang disebutkan dalam manual pemrogram dicantumkan sebagai opsi untuk semua bahasa. Kombinasinya bisa sangat tidak masuk akal atau eksotik. Tentu saja hal-hal tersebut belum (belum) diterapkan dan/atau diuji dengan benar. Semua kode dan dokumentasi dalam repositori ini disediakan apa adanya. Saya tidak berarti saya ahli dalam semua bahasa yang disediakan. Tujuannya adalah untuk setidaknya memberikan kode kerja yang merupakan standar yang sangat rendah, namun sayangnya hal ini tidak jarang terjadi. Menulis tentang pemrograman versus Rekayasa Perangkat Lunak dapat memenuhi rak buku. Jangan pergi ke sana sekarang. Semoga kualitas kode akan meningkat seiring berjalannya waktu jika orang-orang yang ahli dalam bahasa tertentu berpartisipasi dan meningkatkan kode. Kebanyakan kode hanya diuji di Linux kecuali dinyatakan sebaliknya. Untuk meningkatkan kematangan dan kejelasan tabel hasil tes mata pelajaran ini telah ditambahkan.