Metadata-Version: 2.1
Name: ipython-dawet-sql
Version: 0.1b8
Summary: Ipython ODBC SQL Magic for Dawet
Home-page: https://gitlab.com/wakataw/ipython-dawet-sql
Author: Agung Pratama
Author-email: agungpratama1001@gmail.com
License: MIT
Description: # Ipython ODBC SQL Magic
        
        IPython Magic untuk menjalankan SQL menggunakan ODBC secara langsung pada notebook cell.
        
        ## Pemasangan
        
        ```bash
        $ pip3 install ipython-dawet-sql
        ```
        
        ## Penggunaan
        
        ### Load Ekstensi
        Untuk dapat menggunakan, ekstensi harus di *load* terlebih dahulu ke notebook yang sedang digunakan.
        ```
        %load_ext dawetsql
        ```
        
        ### Database Connection
        
        #### Membuka Koneksi
        ```
        %dawetsql
        ```
        Setelah line magic dieksekusi, selanjutnya isi form sesuai dengan konfigurasi ODBC. Username dan password optional jika sudah diset di konfigurasi ODBC sistem.
        
        ![query builder](img/login.PNG)
        
        Untuk me-restart koneksi, cukup klik `connect`, `dawetsql` akan otomatis menutup koneksi terlebih dahulu sebelum membuka koneksi baru lagi.
        
        
        #### Menutup Koneksi
        
        ```
        %dawetsqlclose
        ```
        
        ### Menjalankan SQL
        
        ```
        %%dawetsql
        SELECT * FROM tables
        WHERE somecolumn = 'somevalue'
        ```
        Preview hasil query ditampilkan menggunakan pandas.DataFrame dengan default limit 10 baris.
        
        Available arguments
        
        Arguments | Type | Default | Descriptions
        ---|---|---|---
        `-l --limit` | Integer | 10 | Set limit query untuk preview
        `-o --output` | String | `_` | Nama output hasil query.
        
        ### Contoh Penggunaan
        
        #### Menyimpan Hasil query ke Python Variable
        
        ```
        %%dawetsql --ouput variablename
        SELECT * FROM tables
        WHERE somecolumn = 'somevalue'
        ```
        
        #### Menyimpan Hasil Query ke File
        Cell Magic `%%dawetsql` akan otomatis menyimpan hasil query kedalam file jika nama output memiliki ekstensi `.csv`, `.pkl`, dan `.xlsx`
        ```
        %%dawetsql --output filename.csv
        SELECT * FROM tables
        WHERE somecolumn = 'somevalue'
        ```
        
        ### Widgets
        
        #### Schema Explorer Widget
        
        Widget ini digunakan untuk meng-explore database skema, tabel, kolom, dan tipe kolom.
        
        ```
        %explorer [-f --force]
        ```
        
        **Table Detail**
        
        
        ![table detail](img/widget01.JPG)
        
        **Query Builder**
        
        
        ![query builder](img/widget02.JPG)
        
        **Table Data Preview**
        
        
        ![query builder](img/widget03.JPG)
        
        ### Settings
        
        File konfigurasi `dawetsql` tersimpan pada direktori `~/.dawetsql`.
        
        ### Lain-lain
        
        #### SQL Autocomplete
        Cell magic `%%dawetsql` mendukung SQL Autocomplete. Fitur ini masih bersifat eksperimental. Autocomplete untuk nama tabel dan kolom tersedia setelah pengguna menjalankan magic `%explore`.
        
        ## Legal
        Package ini dirilis di bawah lisensi MIT.
        
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content :: CGI Tools/Libraries
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Utilities
Classifier: Natural Language :: English
Classifier: Natural Language :: Indonesian
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3.5
Classifier: License :: OSI Approved :: MIT License
Requires-Python: >=3.5
Description-Content-Type: text/markdown
