Home

Awesome

<!-- Note: This README.md file was automatically generated. Plase run `make readme` to generate a new one. -->

YAS-QWIN (Yet Another SQL-Query Writing Interface)

YAS-QWIN (pronounced Yas queen!) is a CLI tool for building (and optionally running) SQL queries.

Example:

yas-qwin print-table your_table_name

Output:

-- Print contents of table
SELECT * FROM your_table_name;

Features

Alpha Disclaimer: Currenty, YAS-QWIN has limited support for selection queries. Check the bottom of the README for the full list of missing features.

Installation

Grab your favorite shell and get going:

  1. git clone https://github.com/sebastiancarlos/yas-qwin
  2. cd yas-qwin
  3. ./yas-qwin

Optionally add to your PATH. (This can be done by running make install)

Note:

Usage

Usage: yas-qwin [OPTIONS] COMMAND [COMMAND OPTIONS AND ARGS]
    
Commands:
  list-tables	reindex
  list-indexes	create-table
  print-schemas	column-def
  print-table	table-constr
  rename-table	foreign-key-clause
  rename-column	returning-clause
  add-column	with-clause
  drop-column	cte-def
  create-index	insert
  drop-index	update
  reindex

Options:
  -l, --list-commands    One per line
  -r, --run              Run it in your SQLite db
  -d, --database         Database file to use
  -c, --command          Command to run
  -h, --help             Run with any command

Or run it in your database directly.

yas-qwin -d your_database.db print-indexes --run

Note: You don't need to pass a database file if there's a single *.db file in your current directory.

(Careful Icarus, do not fly close to the sun without sanitizing inputs)

Commandments

Every one of YAS-QWIN's commands comes with its own help message. Just type --help after the command to get a detailed explanation of its usage.

YAS-QWIN's commands shall lead the faithful:

list-tables

Usage: yas-qwin list-tables

- List names of all tables in database
- Note: SQLite only

Default output:

-- List tables in database
SELECT name FROM sqlite_schema WHERE type='table';

list-indexes

Usage: yas-qwin list-indexes
            
- List names of all indexes in database
- Note: SQLite only

Default output:

-- List indexes in database
SELECT name FROM sqlite_schema WHERE type='index';

print-schemas

Usage: yas-qwin print-schemas
            
- Print schema of all tables and indexes in database
- Note: SQLite only

Default output:

-- Print schema of all tables and indexes in database
SELECT sql FROM sqlite_schema;

print-table

Usage: yas-qwin print-table [TABLES]
        
- Print contents of tables
- Note: If no TABLES passed and an SQLite database is in range,
        fetch all tables and print them all

Default output:

-- Print contents of tables
SELECT * FROM sample-table;

rename-table

Usage: yas-qwin rename-table TABLE NEW_NAME
        
- Rename a table

Default output:

-- Rename table
ALTER TABLE old_table RENAME TO new_table;

rename-column

Usage: yas-qwin rename-column TABLE COLUMN NEW_NAME
        
- Rename a column

Default output:

-- Rename column in table
ALTER TABLE sample_table RENAME COLUMN old_column TO new_column;

add-column

Usage: yas-qwin add-column TABLE COLUMN_DEF
        
- Add a column

Default output:

-- Add column to table
ALTER TABLE sample_table ADD COLUMN column_def;

drop-column

Usage: yas-qwin drop-column TABLE COLUMN
        
- Drop a column

Default output:

-- Drop column from table
ALTER TABLE sample_table DROP COLUMN sample_column;

create-index

Usage: yas-qwin create-index [INDEX-NAME] [TABLE] [INDEXED-COLUMNS] [OPTIONS]
        
- Create an index on a column
- INDEXED-COLUMNS is a comma-separated list of columns
        
Options:
  -u/--unique: Create a unique index
  -w/--where EXPR: Create a partial index
  -i/--if-not-exists: Do not error if index already exists

Default output:

-- Create index
CREATE INDEX sample_index ON sample_table (sample_column);

drop-index

Usage: yas-qwin drop-index [INDEX-NAME] [OPTIONS]
        
- Drop an index
        
Options:
  -i/--if-exists: Do not error if index does not exist

Default output:

-- Drop index
DROP INDEX sample_index;

reindex

Usage: yas-qwin reindex [INDEX-NAME]
        
- Reindex a table
- If no index is specified, reindex all tables

Default output:

-- Reindex
REINDEX;

create-table

Usage: yas-qwin create-table [OPTIONS] TABLE_NAME COLUMN_DEFINITIONS [TABLE_CONSTRAINTS]
Options:
  -t, --temporary
  -i, --if-not-exists
  -a, --as-select SELECT_STATEMENT
SQLite only options:
  -s, --strict (defaults to true)
  -w, --without-rowid

Default output:

-- Create table
CREATE TABLE sample_table (sample_column_defs, sample_table_constraints) STRICT;

column-def

Usage: yas-qwin column-def COLUMN_NAME TYPE [OPTIONS]
Options:
  -p, --primary-key [CONFLICT-CLAUSE]
  -a, --autoincrement
  -d, --descending
  -n, --not-null [CONFLICT-CLAUSE]
  -u, --unique [CONFLICT-CLAUSE]
  -k, --check VALUE
  -d, --default VALUE
  -f, --foreign-key FOREIGN_KEY_CLAUSE
  -g, --generated-as VALUE
  -s, --stored

CONFLICT_CLAUSE can be one of:
  rollback
  abort
  fail
  ignore
  replace

Default output:

sample_column sample_type

table-constr

Usage: yas-qwin table-constr [COLUMN_NAMES] [OPTIONS]
Options:
  -p, --primary-key [CONFLICT_CLAUSE]
  -u, --unique [CONFLICT_CLAUSE]
  -k, --check VALUE
  -f, --foreign-key FOREIGN_KEY_CLAUSE
        
Note: COLUMN_NAMES are needed for PRIMARY KEY, UNIQUE, or
      FOREIGN KEY constraints.

CONFLICT_CLAUSE can be one of:
  rollback
  abort
  fail
  ignore
  replace

Default output:

<empty>

foreign-key-clause

Usage: yas-qwin foreign-key-clause FOREIGN_TABLE_NAME [FOREIGN_COLUMN_NAMES]
Options:
  -e, --on-delete VALUE
  -u, --on-update VALUE
  -f, --deferred

VALUE can be one of:
  cascade
  restrict
set null
set default

Default output:

REFERENCES foreign_table_name (foreign_column_names)

returning-clause

Usage: yas-qwin returning [COLUMN_NAMES]
        
  - Return the modified rows back to the application.
  - If COLUMN_NAMES is not specified, '*' is set and
    all columns are returned.

Default output:

RETURNING *

with-clause

Usage: yas-qwin with-clause CTE_DEFS [OPTIONS]
        
  - WITH_CLAUSE is a comma separated list of common table
    expressions (CTEs).
        
Options:
  -r, --recursive    Needed if at least one CTE is recursive.

Default output:

WITH cte_defs

cte-def

Usage: yas-qwin cte-def CTE_NAME SELECT-CLAUSE [OPTIONS]
        
  - CTE_NAME is the name of the common table expression.
  - To be used in a WITH clause.
Options:
  -m, --materialized

Default output:

cte_name AS (select_clause)

insert

Usage: yas-qwin insert TABLE_NAME [COLUMN_NAMES] [VALUES] [OPTIONS]

  - Insert rows into a table.
  - Only one of VALUES, SELECT_CLAUSE and --default may be specified.
  
Options:
  - -w/--with WITH_CLAUSE
  - -r/--returning RETURNING_CLAUSE
  - -o/--on-conflict CONFLICT_CLAUSE
  - -u/--upsert UPSERT_CLAUSE
  - -e/--default
      - Just insert a row with default values.
  - -a/--as-select SELECT_CLAUSE
      - Insert values from a SELECT statement.

CONFLICT_CLAUSE can be one of:
  rollback
  abort
  fail
  ignore
  replace

Default output:

-- Insert rows into a table.
INSERT INTO table_name column_names VALUES sample_values;

update

Usage: yas-qwin update TABLE_NAME UDATE_EXPR

  - Update rows in a table.   
  - UPDATE_EXPR can have the forms:
    - column_name = value, ...
    - (column_name, ...) = (value, ...), ...
  
Options:
  - -w/--with WITH_CLAUSE
  - -r/--returning RETURNING_CLAUSE
  - -o/--on-conflict CONFLICT_CLAUSE
  - -f/--from TABLES_OR_SUBQUERIES_OR_JOIN
  - -w/--where EXPR

CONFLICT_CLAUSE can be one of:
  rollback
  abort
  fail
  ignore
  replace

Default output:

-- Update rows in a table
UPDATE table_name SET update_expr;

Advanced Example

"Roll up your sleeves Jesse, we need to cook!"

#! /usr/bin/env bash

colId="$(yas-qwin column-def id INTEGER --primary-key)";
colName="$(yas-qwin column-def name TEXT --not-null)";
fk="$(yas-qwin foreign-key-clause paper_sizes NAME --deferred --on-delete cascade --on-update cascade)";
colPage="$(yas-qwin column-def paper_size TEXT --foreign-key "${fk}")";
yas-qwin create-table document "$colId, $colName, $colPage";

Output:

-- Create table
CREATE TABLE document (
  id INTEGER PRIMARY KEY NOT NULL, 
  name TEXT NOT NULL, 
  paper_size TEXT REFERENCES paper_sizes (NAME) ON DELETE CASCADE ON UPDATE CASCADE DEFERRABLE INITIALLY DEFERRED
) STRICT

Known Limitations

YAS-QWIN comes with some quirks:

Disclaimer

While the idea of writing SQL through a CLI is mostly silly, no one knew for sure until now. And while YAS-QWIN might be quirky, it stands as a half-serious way of learning and automating your SQL.

If you want a fully feature SQL builder today, check out SQLGlot.