Kamalator

Konverter dua arah (Bidirectional) antara Raw SQL (Oracle & PostgreSQL) dan SQLAlchemy 2.0 ORM berbasis AST (sqlglot & Python ast) dengan pendekatan Clean Architecture.

Fitur Utama

1. Raw SQL -> SQLAlchemy 2.0 ORM (oracle() & postgresql()):
   • Mendukung query pendek maupun query panjang (otomatis memecah CTE WITH dan Subquery menjadi variabel terpisah).
   • Menangani sintaks spesifik Oracle (TRUNC, SYSDATE, DECODE, NVL, ROWNUM, FROM DUAL) dan PostgreSQL (::type cast, ILIKE, DISTINCT ON, FILTER).
2. SQLAlchemy 2.0 ORM -> Raw SQL (to_oracle() & to_postgresql()):
   • Menerima objek Select/ClauseElement SQLAlchemy langsung atau potongan kode string Python SQLAlchemy tanpa perlu mendefinisikan class Model terlebih dahulu.
   • Menyubstitusikan nilai dictionary params ({'id': 101}) ke dalam query dan merapikan format SQL (pretty=True).
3. Output Minimalis:
   • Hanya menampilkan watermark versi beserta durasi eksekusi (kamalator v0.1 - 0.23ms) diikuti langsung oleh hasil query-nya.

Penggunaan Cepat

import kamalator

id = 101

# 1. Raw SQL -> SQLAlchemy 2.0 ORM
kamalator.oracle(
    "SELECT * from table_a where tgl = trunc(sysdate) and id = :id",
    {"id": id},
)

kamalator.postgresql(
    "SELECT * from table_a where tgl = current_date and id = :id",
    {"id": id},
)

# 2. SQLAlchemy 2.0 ORM -> Raw SQL
kamalator.to_oracle(
    """
    select(TableA)
    .where(
        TableA.tgl == func.trunc(func.sysdate()),
        TableA.id == bindparam("id"),
    )
    """,
    {"id": id},
)

kamalator.to_postgresql(
    """
    select(TableA)
    .where(
        TableA.tgl == func.current_date(),
        TableA.id == bindparam("id"),
    )
    """,
    {"id": id},
)