ezsql

__WARNING: This module is still in active development and is by no means ready for community consumption. Use at your own risk and be nice.__

node-ezsql
==========

pure sql solution for node.js

Why?
----

- ORM's can be overcomplicated
- JS/Node long strings are ugly in code
- Pure SQL is easier to read/search/modify
- Syntax checkers are .sql friendly

How?
----
By using a directory structure, the filename, and the .sql file extension we automatically generate a factory of sql functions that can be called with ease. This allows you to write SQL as you would anywhere else, and forget about the rest.

Usage
-----

$3

### filename: ./sql/path/getUsers.sql

SELECT
*
FROM test.users

### filename: ./sql/path/getUser.sql

SELECT
*
FROM test.users
WHERE id = ?

$3

var sql = require('ezsql')('./sql/path/')({
host: 'localhost',
user: '' //omit
});

$3

### getUsers()

var users = sql.getUsers().then(function(results){
console.log(results);
});

output:

[{
id: 2,
name: 'Sam Adams',
email: 'sam.adams@boston.com',
date_added: Wed Nov 12 2014 00:35:03 GMT-0700 (MST)
}]

### getUser(2)

var user = sql.getUser(2).then(function(results){
console.log(results[0]);
});

output:

{
id: 2,
name: 'Sam Adams',
email: 'sam.adams@boston.com',
date_added: Wed Nov 12 2014 00:35:03 GMT-0700 (MST)
}

Caveats
-------
Due to limitations with async handling and the filesystem, this module is currently synchronous. In order to generate functions using filesystem data, the module waits for each file to be loaded into memory before it can make the generated function available at the module level.

Future
------
- fully support async by using promises or non-blocking sync
- utilize subdirectories to create namespaces
- eg. sql.users.fetchAll()