@ovotech/blaise
An API to generate mock payloads for @ovotech/castle using @ovotech/avro-mock-generator
Last updated 2 days ago by ikerin .
Apache-2.0 · Repository · Bugs · Original npm · Tarball · package.json
$ cnpm install @ovotech/blaise 
SYNC missed versions from official npm registry.

Blaise

An API to generate mock payloads for @ovotech/castle using @ovotech/avro-mock-generator

Usage

Concept

blaise() is mostly just a chainable deepMerge, with utilities to generate messages and payloads once everything is configured.

Calling blaise() returns a new version of blaise, preloaded with the provided defaults, without mutating the parent.

examples/chain.ts

import blaise from '@ovotech/blaise'

const withAvro = blaise({ avro: { schema } });
const coffee = withAvro({ avro: { pickUnion: ['coffee'] } });
const tea = withAvro({ avro: { pickUnion: ['tea'] } });

coffee.getDefault(); // { avro: { schema, pickUnion: ['coffee']}}
tea.getDefault(); // { avro: { schema, pickUnion: ['tea']}}

Generate an Avro Message

examples/avro-message.ts

import blaise from '@ovotech/blaise'

const schema: avsc.RecordType = {
  type: 'record',
  name: '',
  fields: [{ name: 'anInt', type: 'int' }],
};
type MyType = { anInt: number };
blaise<MyType>({ avro: { schema } }).message(); // {topic: '', {anInt: 32}, [...]}

You can also override the message, either as part of the default or when calling the function

examples/avro-message-override.ts

import blaise from '@ovotech/blaise'

const schema: avsc.RecordType = {
  // [...]
};
const brewCoffee = blaise({
  avro: { schema },
  message: { value: { type: 'coffee' } },
});
brewCoffee.message({ value: { with: 'milk' } }); // {offset: 13, value {type: 'coffee', with: 'milk'}, [...]}

Generate a CastleEachMessagePayload

examples/each-message.ts

import blaise from '@ovotech/blaise'

const schema: avsc.RecordType = {
  // [...]
};
blaise({ avro: { schema }).eachMessage(); // { topic: 'aTopic', value: {} [...]}

Generate a CastleEachBatchPayload

examples/each-batch.ts

import blaise from '@ovotech/blaise'

const schema: avsc.RecordType = {
  // [...]
};
const makeMessage = blaise({ avro: { schema })
blaise.eachBatch([makeMessage()]); // {batch: { topic: 'aTopic', value: {} }[...]}

Deterministic generation

Make use of the seed options to use a deterministic random generator instead of true randomness.

Each call to .defaults() or .seed() with a seed will reset the randomness.

Running the tests

You can run the tests with:

yarn test

Coding style (linting, etc) tests

Style is maintained with prettier and eslint

yarn lint

Deployment

Deployment is preferment by lerna automatically on merge / push to master, but you'll need to bump the package version numbers yourself. Only updated packages with newer versions will be pushed to the npm registry.

Contributing

Have a bug? File an issue with a simple example that reproduces this so we can take a look & confirm.

Want to make a change? Submit a PR, explain why it's useful, and make sure you've updated the docs (this file) and the tests.

License

This project is licensed under Apache 2 - see the LICENSE file for details

What does the name mean?

It's just a fun pun. Take a Castle, make a 'mock' version of it, and you get Bristol's Blaise Castle

Current Tags

  • 0.2.2                                ...           latest (2 days ago)

6 Versions

  • 0.2.2                                ...           2 days ago
  • 0.2.1                                ...           6 months ago
  • 0.2.0                                ...           7 months ago
  • 0.1.2                                ...           8 months ago
  • 0.1.1                                ...           9 months ago
  • 0.1.0                                ...           9 months ago
Downloads
Today 0
This Week 9
This Month 9
Last Day 1
Last Week 0
Last Month 0
Dependencies (3)
Dev Dependencies (12)
Dependents (0)
None

Copyright 2014 - 2016 © taobao.org |