@devoxa/integresql-client

integresql-client

IntegreSQL client for managing isolated PostgreSQL databases in integration tests.

Installation • Usage • Contributors • License

Installation

yarn add @devoxa/integresql-client

To install IntegreSQL, please follow their installation instructions.

Usage

Full example

For a full usage example, have a look the integration tests.

Step-by-step guide

1. Initialize the IntegreSQL client

import { IntegreSQLClient } from '@devoxa/integresql-client' const integreSQL = new IntegreSQLClient({ url: 'http://localhost:5000' }) // options.url: The URL of the IntegreSQL instance

1. (Once per test runner process) Get a hash of the migrations & fixtures

// The hash can be generated in any way that fits your business logic, the included // helper creates a SHA1 hash of the file content of all files matching the glob patterns. const hash = await integreSQL.hashFiles(['./migrations/**/*', './fixtures/**/*'])

1. (Once per test runner process) Initialize the template database

await integreSQL.initializeTemplate(hash, async (databaseConfig) => { await migrateTemplateDatabase(databaseConfig) await seedTemplateDatabase(databaseConfig) await disconnectFromDatabase(databaseConfig) })

1. (Before each test) Get a isolated test database

const databaseConfig = await integreSQL.getTestDatabase(hash)

Helpers

• integreSQL.databaseConfigToConnectionUrl(databaseConfig)
  • Converts the database configuration object into a connection URL

API requests

You can directly send requests to the IntegreSQL instance via the included API client, or optionally instantiate a new IntegreSQLApiClient yourself.

await integreSQL.api.reuseTestDatabase(hash, id) const api = new IntegreSQLApiClient({ url: 'http://localhost:5000' }) await api.reuseTestDatabase(hash, id)

Contributors

Thanks goes to these wonderful people (emoji key):

David Reeß 💻 📖 ⚠️

This project follows the all-contributors specification. Contributions of any kind welcome!

License

MIT