octopus oc corelibs sql helpers

Kelas PL/SQL Helters

Alat untuk Memproses dan Memformat Kode PL/SQL Otomatis

Keterbatasan

• File multi-objek tidak didukung. Ini berarti: satu file - satu objek dengan pernyataan create . Hasil pemrosesan file multi-objek tidak dapat diprediksi, jadi semua alat (kecuali STR_DECODER ) akan meningkatkan pengecualian.
• Nama objek harus diberikan hanya menggunakan karakter ASCII .
• Menggunakan untuk definisi objek yang tidak didukung juga akan meningkatkan pengecualian. Jenis objek yang didukung adalah:
  • PROSEDUR
  • FUNGSI
  • KEMASAN
  • Tubuh paket

Detail

str_decoder

Satu-satunya fungsi decode_to_str mencoba mendeteksi pengkodean garis dan mengkode ulang ke UTF-8 . Meningkatkan NilaiError jika pengkodean tidak mungkin.

Ringkasan

decode_to_str(line, probables=None)

• line - bytes objek dengan teks untuk decode
• probables - list str dengan pengkodean primer untuk diperiksa. Default: ['cp866', 'cp1251', 'koi8-r']
• Nilai Pengembalian - str (diterjemahkan dan dikodekan ulang ke UTF-8 )

Penggunaan baris perintah

Decoding seluruh file ke file lain. Jalankan ini untuk mendapatkan daftar argumen:

python -m oc_sql_helpers.str_decoder --help

pembungkus

Kelas PLSQLWrapper adalah alat untuk bekerja dengan sumber yang dibungkus Oracle.

Persyaratan

Ada persyaratan tambahan untuk membungkus file. Perhatikan bahwa metode Unwrap berfungsi tanpanya. Ini karena penggunaan utilitas wrap asli dari Oracle yang tidak termasuk dalam paket ini karena pelanggaran lisensi . Anda harus menginstalnya secara terpisah.

• Variabel lingkungan ORACLE_HOME harus diatur dengan benar
• wrap biner akan ditempatkan di bawah ${ORACLE_HOME}/bin dan harus memiliki izin untuk pengguna yang efektif

Ringkasan

PLSQLWrapper() - Untuk membuat instantiate objek untuk kelas itu

Metode

• wrap_path(path_in, write_to=None)
  • path_in - Objek str dengan jalur absolut atau relatif untuk file untuk membungkus.
  • write_to - salah satu dari:
    • None - hasil pembungkus akan dikembalikan dengan metode ini sebagai objek bytes
    • file - Hasil akan ditulis ke objek seperti file yang ditentukan di sini. Harus dibuka dalam mode biner baca-tulis ( 'w+b' ) dan operasi seek dukungan.
    • str - path ke file output, absolut atau relatif. Hasilnya akan ditulis di sana. Harus memiliki ekstensi - ini adalah oracle wrap utility featrue. Ini menambahkan akhiran .plb sendiri jika ekstensi dihilangkan. Harap tentukan ekstensi selalu
  • Nilai pengembalian : lihat write_to di atas
• wrap_buf(fl_in, write_to=None)
  • fl_in - Objek file atau file-like untuk membungkus data dari. Harus dibuka dalam mode biner dan pengoperasian seek dukungan ( 'rb' ).
  • write_to - sama seperti untuk wrap_path
  • Nilai pengembalian : sama seperti untuk wrap_path
• unwrap_path(path_in, write_to=None)
  • path_in - Objek str dengan jalur absolut atau relatif ke file ke unwrap.
  • write_to - salah satu dari:
    • None - hasil yang tidak dibuka akan dikembalikan dengan metode ini sebagai objek bytes
    • file - Hasil akan ditulis ke objek seperti file yang ditentukan di sini. Harus dibuka dalam mode biner baca-tulis ( 'w+b' ) dan operasi seek dukungan.
    • str - path ke file output, absolut atau relatif. Hasilnya akan ditulis di sana.
  • Nilai pengembalian : lihat write_to di atas
• unwrap_buf(fl_in, write_to=None)
  • fl_in - Objek file atau file-like untuk membungkus data dari. Harus dibuka dalam mode biner dan pengoperasian seek dukungan ( 'rb' ).
  • write_to - Sama seperti untuk unwrap_path
  • Nilai Pengembalian : Sama seperti untuk unwrap_path

Penggunaan baris perintah

Membungkus/membuka seluruh file ke file lain. Jalankan ini untuk mendapatkan daftar argumen:

python -m oc_sql_helpers.wrapper --help

Normalizer

Kelas PLSQLNormalizer adalah atau normalisasi kode PL/SQL.

Istilah normalisasi

Normalisasi berarti hampir sama dengan gaya kode , tetapi kurang ketat. Ini berarti hasil normalisasi mungkin tidak dapat digunakan bahkan jika sumbernya benar dari sudut pandang PL/SQL .

Normalisasi default adalah:

• Semua ujung garis diganti untuk gaya unix
• Semua sampah sebelum pernyataan CREATE tanpa komentar pertama dihapus.
• CREATE pernyataan itu sendiri dipesan ke baris pertama hingga AS (atau IS atau WRAPPED ) token, termasuk nama objek, jenis dan skema. Karakter dan komentar ruang ekstra diganti dengan ruang tunggal.
• Baris pertama (dengan pernyataan CREATE yang dipesan) ditingkatkan , termasuk skema dan nama objek .
• Jika skema atau nama objek diberikan dalam kutipan ganda " maka kutipan ganda itu akan dihapus jika memungkinkan. Contoh: "schema"."name" akan menjadi SCHEMA.NAME setelah normalisasi, "ANOTHER.SCHEMA"."ANOTHER.NAME" "another.schema"."another.name"
• Bagian istirahat dari badan definisi objek tidak akan diubah

Bendera normalisasi lainnya :

• uppercase : semua leksem bahasa dalam tubuh objek akan ditingkatkan kecuali literal
• no-comments : Semua komentar di dalam tubuh, termasuk tanda-tanda komentar itu sendiri, akan diganti dengan ruang tunggal.
• no-spaces : Semua karakter ruang yang berulang (ruang itu sendiri, newline, tabulasi ...) akan diganti dengan ruang tunggal umum. Contoh: var := 'the value' akan diterjemahkan ke var := 'the value' . Perhatikan bahwa tidak ada penggantian yang dilakukan di dalam literal 'the value' . Bendera ini tidak dapat digunakan dengan no-comments
• no-literals : Semua nilai literal string akan diganti menjadi yang kosong. Tanda -tanda literal itu sendiri tidak berubah.
• comments-only : Buang seluruh konten file tetapi komentar, termasuk tanda-tanda komentar sendiri. Setiap komentar akan dimulai dengan baris baru. Bendera ini tidak kompatibel dengan siapa pun di atas

Ringkasan

PLSQLNormalizer() - Untuk membuat instantiate objek untuk kelas ini

Metode

• normalize_path(path, flags=None, lines=None, write_to=None)
  • path - Objek str dengan jalur absolut atau relatif untuk mengajukan untuk menormalkan.
  • flags - Bendera normalisasi, list bilangan bulat dari enumerasi PLSQLNormalizationFlags , lihat di bawah. None nilai berarti melakukan normalisasi default ( CREATE DEFINISI) saja.
  • lines - int , batas garis normalisasi (dihitung dari sumber ). Default : None , berarti menormalkan seluruh sumber
  • write_to - salah satu dari:
    • None - hasil pembungkus akan dikembalikan dengan metode ini sebagai objek bytes
    • file - Hasil akan ditulis ke objek seperti file yang ditentukan di sini. Harus dibuka dalam mode biner baca-tulis ( 'w+b' ) dan operasi seek dukungan.
    • str - path ke file output, absolut atau relatif. Hasilnya akan ditulis di sana. Harus memiliki ekstensi - ini adalah oracle wrap utility featrue. Ini menambahkan akhiran .plb sendiri jika ekstensi dihilangkan. Harap tentukan ekstensi selalu
  • Nilai pengembalian : lihat write_to di atas
• normalize(fl, flags, lines=None write_to=None)
  • fl - salah satu dari:
    • file atau objek file-like untuk menormalkan data dari. Harus dibuka dalam mode biner dan pengoperasian seek dukungan ( 'rb' ).
    • str - Data string untuk menormalkan
    • bytes - data "biner" untuk menormalkan
  • flags - sama seperti untuk normalize_path
  • lines - sama seperti untuk normalize_path
  • write_to - sama seperti untuk normalize_path
  • Nilai pengembalian : sama seperti untuk normalize_path
• is_sql(fl) - Periksa data yang diberikan adalah kode PL/SQL yang didukung
  • fl - Sama seperti untuk normalize
  • Nilai retun - bool , kode pl/sql dibungkus atau tidak
• is_sql_path(path) - Sama seperti is_sql tetapi argumen diperlakukan sebagai jalur ke file dengan kode yang mungkin
• is_wrapped(fl) - Periksa data yang diberikan didukung kode PL/SQL yang dibungkus
  • fl - Sama seperti untuk normalize
  • Nilai retun - bool , kode PL/SQL yang didukung atau tidak
• is_wrapped_path(path) - Sama seperti is_wrapped tetapi argumen diperlakukan sebagai jalur ke file dengan kode yang mungkin
• is_wrappable(fl) - Periksa data yang diberikan didukung kode PL/SQL yang dibungkus
  • fl - Sama seperti untuk normalize
  • Nilai retun - bool , objek pl/sql yang dapat dibungkus dalam kode atau tidak
• is_wrappable_path(path) - Sama seperti is_wrappable tetapi argumen diperlakukan sebagai jalur ke file dengan kode yang mungkin

PLSQLNormalizationFlags - enumerasi bendera:

• uppercase
• no_comments
• no_spaces
• no_literals
• comments_only

Lihat deskripsi terperinci di atas dalam bab bendera normalisasi lain dari bagian istilah normalisasi .

Penggunaan baris perintah

Normalisasi seluruh file ke file lain. Jalankan ini untuk mendapatkan daftar argumen:

python -m oc_sql_helpers.normalizer --help