Chlorine keeps your (DB) pool clean!
Chlorine is very easy to use. Currently MySQL and Postgres databases are supported.
Chlorine works by spinning up one time use connections. A connection is created, a query is made, the result is returned, and the connection is closed and returned to the pool. This is all abstracted away so that all you need to do is create the pool and make queries.
To install Chlorine simply use NPM:
npm install chlorine
Creating a Pool
To create a pool you will need to provide a configuration object for the database pool. Here's an example which utilizes all the options:
var chlorine = ;var poolCreationConfig =type: 'mysql' //Valid values are currently 'mysql' and 'postgres'. Chlorine will fallback on mySQL if an invalid value is passed.poolName: 'myPool' //The variable name of the poolpoolConfig:max: 25 //Maximum number of connectionsmin: 0 //Minimum number of connectionsidleTimeoutMillis: 59000 //Amount of time before an idle connection expireslog: false //Output debugging logs for the poolname: 'MyDatabaseConnectionPool' //Name of the node generic pooldbConfig:host: 'mydb.url.com' //URL to the databaseuser: 'username' //Username to log in withpassword: 'correcthorsebatterystaple' //Password to log in withinsecureAuth: false //Whether to use old authentication or notdebug: false //Provide debug logging for the DB;chlorine;
"But wait! You forgot to create a var for the pool, and now it is gone forever! YOU FOOL!"
Or did I?
Making a Query
Pools are saved and managed by chlorine. You can access your pool through chlorine by the "poolName" option in the creation configuration. For example, let's make a query with the pool we created from the example above:
When you call
chlorine.poolName.query Chlorine will create a connection to the database, make your query, get the results, then close the connection freeing it to be used elsewhere.
If you encounter any issues, have any questions, or have an idea for Chlorine, please feel free to open up an issue or request ticket and we'll get back to you.