self-explained

self explained tools - starting with "assert"

Instalación

$ npm install self-explained

idioma: castellano también disponible en:

Uso

var assert = require('self-exlain').assert;

var alpha = 10;
var betha = 7;

eval(assert(alpha / 2 > betha -1));

tabla 1	min	max	return
execute	-	-	result.rowCount
fetchAll	0	inf	result.rows, result.rowCount
fetchUniqueValue	1	1	result.value
fetchUniqueRow	1	1	result.row
fetchOneRowIfExists	0	1	result.row, result.rowCount

Ejecuta la expresión como si fuera un assert, y si la expresión evalúa a false se genera mucha más información por la consola (además de lanzar la excepción correspondiente)

ASSERT FAILED
alpha / 2 > betha -1
10 / 2 > 7 - 1
5 > 6
false

Licencia

MIT

pg-promise-strict

postgresql con promesas en el sentido estricto

idioma: castellano también disponible en:

Características

pg-strict-promise implementa una versión con Promise/A+ en el sentido estricto de la librería PG.

Tiene las mismas funciones que PG, con los mismos nombres, los mismos parámetros y que devuelven lo mismo, reemplazando los callbacks con promesas.
Con pruebas que cubren el 100% del código en dos grupos: un grupo de pruebas que usa una base de datos real (postgresl 9.3) y otro que testea solo las llamadas (adaptaciones) que se hacen sobre PG. Ambos grupos de pruebas cubren el 100% del código. Así obtenemos una cobertura de 2 × 100%.
No se reimplementa nada de lo que PG ya implementa
Algunos agregados mínimos para mayor comodidad

Instalación

$ npm install pg-promise-strict

Ejemplo de uso

var pg = require('pg-promise-strict');

pg.easy = true;

var conOpts = {
    user: 'test_user',
    password: 'test_pass',
    database: 'test_db',
    host: 'localhost',
    port: 5432
};

pg.connect(conOpts).then(function(client){
    return client.query('select * from table');
}).then(function(result){
    for(var i=0; i<result.rowCount; i++){
        console.log('row',i,result.row[i]);
    }
}).catch(function(err){
    console.log('ERROR',err);
});

Ejemplos de PG

El primer ejemplo. Trae todas las filas de una consulta a la vez. Ejemplo basado en PG

var pg = require('pg-promise-strict');

pg.easy = true;

var conString = "postgres://username:password@localhost/database";

pg.connect(conString).then(function(client){
    return client.query('SELECT $1::int AS number', ['1']);
}).then(function(result)){
    console.log(result.rows[0].number);
}).catch(err){
    return console.error('error fetching client from pool or running query', err);
}).then(function(){    
    client.done(); // original done function of callback of PG.connect
});

En este ejemplo se puede ver:

la cadena de promesas
los parámetros apsados a libpq en la función query
.then(function(result) es el equivalente a pasar callback a la función a query

Ejemplo sin el pool de conexiones

Corresponde al ejemplo de llamada a PG con conexión directa del cliente

var pg = require('pg-promise-strict');

var conString = "postgres://username:password@localhost/database";

var client = new pg.Client(conString);

client.connect().then(function(client){
    return client.query('SELECT NOW() AS "theTime"');
}).then(function(result){
    console.log(result.rows[0].theTime);
    console.log(row.name);
    client.end();
}).catch(function(err){
    return console.error('error connecting or running query', err);
});

Ejemplo procesando de a una fila a la vez

Corresponde al ejemplo de llamada a PG.query sin función callback. En la documentación de PG, Brian C dice no especifique una function callback para consultas que devuelven grandes conjuntos de datos salvo que quiera que se acumule todo en memoria

Esta es la manera de procesar fila por fila

pg.connect({user: 'brianc', database: 'test'}).then(function(client){
    client.query("SELECT name FROM users").onRow(function(row){
        console.log(row.name);
    }).then(function(result){
        console.log('ready.',result.rowCount,'rows processed');
        client.done();
    });
});

Corriendo los tests

Para correr los test, además de clonar el repositorio e instalar con npm tenemos que proveer una conexión a la base de datos postgresql-9.3 para poder crear el usuario test_user y la base test_db.

Additions in pg-promise-strict

language: English also available in: -

(for this section see spanish version)

Addings:

explicit indication of how many rows are expected in the result
explicit indication of fetchAll in query(...).then calls

function	min	max	return
execute	-	-	result.rowCount
fetchAll	0	inf	result.rows, result.rowCount
fetchUniqueValue	1	1	result.value
fetchUniqueRow	1	1	result.row
fetchOneRowIfExists	0	1	result.row, result.rowCount