@objectkit/scriptex.mock

A collection of test interfaces and helpers to mock the Scripter MIDI-FX Plugin environment.

Documentation

Please refer to specs for more information.

Installation

npm i @objectkit/scriptex.mock

API

Global interface

• Scripter

Data interfaces

• TimingInfo
• MIDI

Event interfaces

• Event
• ChannelPressure
• ControlChange
• Note
• NoteOn
• NoteOff
• PitchBend
• PolyPressure
• ProgramChange
• TargetEvent

Environmental Helpers

VirtualScripter

A bare bones Scripter emulation.

DeployPluginHarness

A convenience tool for capturing api, plugin and system references arising through deployment.

VirtualScripterEnvironment

A virtual Scripter environment assembled by VirtualScripter and DeployPluginHarness configurations.

Use cases

Inspect the Microtuner plugin demonstrator for concrete applications or clone the plugin project template to use it in a development context.

Example

The #system property of scriptex plugin instances gives uniform instance level access to the global scope, but that is not useful to all test and deployment scenarios. There are times when access to a simulated gloabl Scripter scope in the test environment will be of better help, and VirtualScripterEnvironment provides the means for that to happen.

import { PitchBend, VirtualScripterEnvironment } from "@objectkit/scriptex.mock"
import { Microtuner } from "scriptex.plugin.microtuner"

describe(`Microtuner Integration`, () => {

  /* link the virtual environemnet to the global scope */
  const virtual= new VirtualScripterEnvironment(global)
  const sandbox= sinon.createSandbox()

  beforeEach(() => {
<<<<<<< HEAD
    /* pre-test: decorate the virtual target, i.e. global scope in this test */
    virtual.applyEnvironment()  
  })

  afterEach(() => {
    /* post-test: undecorate and restore the global scope */
    virtual.unapplyEnvironment()
    sandbox.restore()
  })

  describe(`Given Microtuner has been deployed to Scripter`, () => {
    describe(`When SetParameter is invoked`, () => {
      specify(`Then a new PitchBend is sent.`, () => {

        /* make system properties modifiable for tests */
        Microtuner.CONFIGURABLE= true

        /* export Scripter methods and properties to the global scope */
        const { plugin, system } = virtual.deployPlugin(Microtuner)
        const { SendMIDIEventNow, ParameterChanged, Trace }= sandbox.spy(system)          
        const [ { minValue, maxValue, defaultValue } ]= plugin.parameters
        const { applyPitchBend, onParameter }= sandbox.spy(plugin)
        const { send } = sandbox.spy(Event.prototype )
=======
    virtual.applyEnvironment()
  })

  afterEach(() => {
    sandbox.restore()  
    virtual.unapplyEnvironment()
  })

  describe(`Given Microtuner is integrated with Scripter`, () => {
    describe(`When SetParameter sets the value of #microtuning`, () => {
      describe(`Then #microtuning sets the value of PitchBend#value`, () => {
        specify(`And the PitchBend is immediately sent.`, () => {

          Microtuner.CONFIGURABLE= true

          const { plugin, system } = virtual.deployPlugin(Microtuner)
          const { SendMIDIEventNow, ParameterChanged, Trace }= sandbox.spy(system)          
          const [ { minValue, maxValue, defaultValue } ]= plugin.params
          const { applyPitchBend, onParam }= sandbox.spy(plugin)
          const { send } = sandbox.spy(Event.prototype )
>>>>>>> 657e115b5b4cda3162fe54ad0c716889066fcb39

        /* emulated `Run Script` to setup the parameter view */
        UpdatePluginParameters()

        const runScenario = (val) => {

          SetParameter(0, val)

          {
            assert.callOrder(
              ParameterChanged
              , onParameter
                , applyPitchBend
                  , send
                    , SendMIDIEventNow
            )

<<<<<<< HEAD
            const { lastCall: { firstArg:pitchBend } }= SendMIDIEventNow
            assert.instanceOf(pitchBend, PitchBend)
            assert.strictEqual(pitchBend.value, val)
            assert.strictEqual(GetParameter(0), val)
=======
              const { lastCall: { firstArg: pitchBend } }= SendMIDIEventNow
              assert.instanceOf(pitchBend, PitchBend)
              assert.strictEqual(pitchBend.value, val)
              assert.strictEqual(GetParameter(0), val)
            }
>>>>>>> 657e115b5b4cda3162fe54ad0c716889066fcb39
          }
        }

        runScenario(minValue)
        runScenario(maxValue)
        runScenario(defaultValue)
      })
    })
  })
})

Donations