@discorddungeons/rethinkdb-mock v0.7.4
rethinkdb-mock v0.7.1
Spec-compliant unit-testing for RethinkDB queries
The end goal is to replicate the API of rethinkdbdash.
For all intents and purposes, you should get the same results.
Please review the Feature support table before opening an issue.
Reusing and nesting queries are fully supported. :+1:
Check out the Releases tab for details about the newest versions.
Why use this?
- Load JSON data into the database with
db.load() - Or call
db.init()to easily populate the database - Easily run specific tests (
fitin Jasmine) - Avoid teardown between test suites
- Avoid having to start a
rethinkdbprocess before you can run tests - Avoid mutilating your development
rethinkdb_data - Continuous integration compatibility
Getting started
- Install from Github:
npm install --save-dev @discorddungeons/rethinkdb-mock- Put some boilerplate in your test environment:
const rethinkdb = require('@discorddungeons/rethinkdb-mock')
// Replace `rethinkdbdash` with `rethinkdb-mock`
const mock = require('mock-require')
mock('rethinkdbdash', rethinkdb)
// You must use the same database name as the code you're testing.
const db = rethinkdb({
name: 'test' // The default value
})- Use it in your test suites:
describe('Some test suite', () => {
// Reset the database between suites.
beforeAll(() => {
db.init({
users: [],
friends: [],
})
// Optionally, load JSON into the database.
db.load(__dirname, './data.json')
})
// Now create your tests...
})
Feature support
The entire Rethink API is not yet implemented. Get an idea of what's supported by referencing the table below.
Open an issue to request a feature be implemented. But try implementing it yourself if you have time! :+1:
If a method is not behaving as expected, please open an issue!
But first check out TODO.md for a list of missing behaviors.
❌ means "not implemented yet"
⚠️ means "partially implemented"
💯 means "fully implemented"
| % | Feature |
|---|---|
| ❌ | Changefeeds |
| ❌ | Binary support |
| ❌ | Date-time support |
| ❌ | Geospatial support |
| 💯 | r.table() |
| 💯 | r.tableCreate() |
| ❌ | r.tableList() |
| 💯 | r.tableDrop() |
| ❌ | r.indexCreate() |
| ❌ | r.indexList() |
| ❌ | r.indexDrop() |
| ❌ | r.indexRename() |
| ❌ | r.indexStatus() |
| ❌ | r.indexWait() |
| ⚠️ | r.row |
| 💯 | r() or r.expr() |
| 💯 | r.do() |
| ❌ | r.args() |
| 💯 | r.object() |
| 💯 | r.branch() |
| ⚠️ | r.typeOf() |
| 💯 | r.uuid() |
| ⚠️ | r.desc() |
| ⚠️ | r.asc() |
| ❌ | r.js() |
| ❌ | r.json() |
| ❌ | r.http() |
| ❌ | r.error() |
| ❌ | r.range() |
| 💯 | table.get() |
| 💯 | table.getAll() |
| ⚠️ | table.insert() |
| 💯 | table.delete() |
| 💯 | query() or query.bracket() |
| 💯 | query.nth() |
| 💯 | query.getField() |
| ⚠️ | query.hasFields() |
| ❌ | query.withFields() |
| ⚠️ | query.offsetsOf() |
| ⚠️ | query.contains() |
| ⚠️ | query.orderBy() |
| 💯 | query.isEmpty() |
| 💯 | query.count() |
| 💯 | query.skip() |
| 💯 | query.limit() |
| 💯 | query.slice() |
| ❌ | query.between() |
| 💯 | query.merge() |
| 💯 | query.pluck() |
| ⚠️ | query.without() |
| ⚠️ | query.replace() |
| ⚠️ | query.update() |
| ⚠️ | query.delete() |
| 💯 | query.default() |
| 💯 | query.and() |
| 💯 | query.or() |
| ⚠️ | query.eq() |
| ⚠️ | query.ne() |
| ⚠️ | query.gt() |
| ⚠️ | query.lt() |
| ⚠️ | query.ge() |
| ⚠️ | query.le() |
| ⚠️ | query.add() |
| ⚠️ | query.sub() |
| ⚠️ | query.mul() |
| 💯 | query.div() |
| ❌ | query.mod() |
| ❌ | query.sum() |
| ❌ | query.avg() |
| ❌ | query.min() |
| ❌ | query.max() |
| ❌ | query.not() |
| ❌ | query.ceil() |
| ❌ | query.floor() |
| ❌ | query.round() |
| ❌ | query.random() |
| ❌ | query.coerceTo() |
| 💯 | query.map() |
| ⚠️ | query.filter() |
| ❌ | query.fold() |
| ❌ | query.reduce() |
| ❌ | query.forEach() |
| ❌ | query.distinct() |
| ❌ | query.concatMap() |
| ❌ | query.innerJoin() |
| ❌ | query.outerJoin() |
| ❌ | query.eqJoin() |
| ❌ | query.zip() |
| ❌ | query.group() |
| ❌ | query.ungroup() |
| ❌ | query.sample() |
| ❌ | query.setInsert() |
| ❌ | query.setUnion() |
| ❌ | query.setIntersection() |
| ❌ | query.setDifference() |
| ❌ | query.append() |
| ❌ | query.prepend() |
| ❌ | query.union() |
| ❌ | query.difference() |
| ❌ | query.insertAt() |
| ❌ | query.spliceAt() |
| ❌ | query.deleteAt() |
| ❌ | query.changeAt() |
| ❌ | query.keys() |
| ❌ | query.values() |
| ❌ | query.literal() |
| ❌ | query.match() |
| ❌ | query.split() |
| ❌ | query.upcase() |
| ❌ | query.downcase() |
| ❌ | query.toJSON() or query.toJsonString() |
| ❌ | query.info() |
| ❌ | query.sync() |
Contributing
Issues and pull requests are always appreciated! :grin:
If you have any questions, feel free to open an issue.
Getting started
# This tool compiles the `src` directory during `npm install`.
git clone https://github.com/discorddungeons/rethinkdb-mock
npm install
# Manually compile the `src` directory after you make any changes.
npm build
Similar repositories
- JohanObrink/rethink-mock: Stubs for
sinon(last updated October 2017) - vasc/rethinkdb-mock: Small subset of Rethink API, not spec-compliant (last updated April 2014)