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. 👍

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 (fit in Jasmine)
• Avoid teardown between test suites
• Avoid having to start a rethinkdb process before you can run tests
• Avoid mutilating your development rethinkdb_data
• Continuous integration compatibility

 

Getting started

1. Install from Github:

npm install --save-dev @discorddungeons/rethinkdb-mock

2. 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
})

3. 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! 👍

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! 😁

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)