# self-explained self explained tools - starting with "assert" # Instalación ```sh $ npm install self-explained ```  [](https://npmjs.org/package/self-explain) [](https://npmjs.org/package/self-explain) [](https://travis-ci.org/codenautas/self-explain) [](https://coveralls.io/r/codenautas/self-explain) [](https://codeclimate.com/github/codenautas/self-explain) [](https://david-dm.org/codenautas/self-explain) [](http://codenautas.com/github/codenautas/self-explain) idioma:  también disponible en: [](README.md) ## Uso ```js 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) ```txt ASSERT FAILED alpha / 2 > betha -1 10 / 2 > 7 - 1 5 > 6 false ``` ## Licencia [MIT](LICENSE) # pg-promise-strict **postgresql** con **promesas** en el sentido estricto  [](https://npmjs.org/package/pg-promise-strict) [](https://npmjs.org/package/pg-promise-strict) [](https://travis-ci.org/codenautas/pg-promise-strict) [](https://ci.appveyor.com/project/codenautas/pg-promise-strict) [](https://coveralls.io/r/codenautas/pg-promise-strict) [](https://codeclimate.com/github/codenautas/pg-promise-strict) [](https://david-dm.org/codenautas/pg-promise-strict) [](http://codenautas.com/github/codenautas/pg-promise-strict) idioma:  también disponible en: [](README.md) # 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](docs/agregados.md) mínimos para mayor comodidad # Instalación ```sh $ npm install pg-promise-strict ``` # Ejemplo de uso ```js 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 ## Ejemplos de PG El primer ejemplo. Trae todas las filas de una consulta a la vez. Ejemplo basado en [PG](https://www.npmjs.com/package/pg#client-pooling) ```js 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](https://github.com/brianc/node-postgres#client-instance) con conexión directa del cliente ```js 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](https://github.com/brianc/node-postgres/wiki/Client#simple-query-without-callback).query sin función callback. En la documentación de [PG](https://github.com/brianc/node-postgres/wiki/Client#parameters-1), [Brian C](https://github.com/brianc) 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 ```js 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:  also available in: [](agregados.md) - (for this section see [spanish version](agregados.md)) 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 # fast-devel-server Fast developer server for displaying markdown and others Working in resolving the unsecure dependencies!  [](https://npmjs.org/package/fast-devel-server) [](https://npmjs.org/package/fast-devel-server) [](https://travis-ci.org/codenautas/fast-devel-server) [](https://codeclimate.com/github/codenautas/fast-devel-server) [](https://david-dm.org/codenautas/fast-devel-server) idioma:  también disponible en: [](README.md) ## Instalación ```sh $ npm install fast-devel-server ``` ## USO ```js npm start ``` Y luego usa en tu navegador para renderizar o ver y autorefrescar tus datos  ***No necesitas refrescar con F5!*** ## Licencias [MIT](LICENSE)