xahau.js/test/ripple-api-test.ts

import setupAPI from './setup-api'
import {RippleAPI} from 'ripple-api'
import addresses from './fixtures/addresses.json'
import {getAllPublicMethods, loadTestSuites} from './utils'

/**
 * RippleAPI Test Runner
 *
 * Background: "test/api-test.ts" had hit 4000+ lines of test code and 300+
 * individual tests. Additionally, a new address format was added which
 * forced us to copy-paste duplicate the test file to test both the old forms
 * of address. This added a significant maintenance burden.
 *
 * This test runner allows us to split our tests by RippleAPI method, and
 * automatically load, validate, and run them. Each tests accepts arguments to
 * test with, which allows us to re-run tests across different data
 * (ex: different address styles).
 *
 * Additional benefits:
 *   - Throw errors when we detect the absence of tests.
 *   - Type the API object under test and catch typing issues (currently untyped).
 *   - Sets the stage for more cleanup, like moving test-specific fixtures closer to their tests.
 */
describe('RippleAPI [Test Runner]', function() {
  beforeEach(setupAPI.setup)
  afterEach(setupAPI.teardown)

  // Collect all the tests:
  const allPublicMethods = getAllPublicMethods(new RippleAPI())
  const allTestSuites = loadTestSuites()

  // Run all the tests:
  for (const {name: methodName, tests, config} of allTestSuites) {
    describe(`api.${methodName}`, () => {
      // Run each test with the original-style address.
      describe(`[Original Address]`, () => {
        for (const [testName, fn] of tests) {
          it(testName, function() {
            return fn(this.api, addresses.ACCOUNT)
          })
        }
      })
      // Run each test with the newer, x-address style.
      if (!config.skipXAddress) {
        describe(`[X-Address]`, () => {
          for (const [testName, fn] of tests) {
            it(testName, function() {
              return fn(this.api, addresses.ACCOUNT_X)
            })
          }
        })
      }
    })
  }

  // Report any missing tests.
  const allTestedMethods = new Set(allTestSuites.map(s => s.name))
  for (const methodName of allPublicMethods) {
    if (!allTestedMethods.has(methodName)) {
      // TODO: Once migration is complete, remove `.skip()` so that missing tests are reported as failures.
      it.skip(`${methodName} - no test suite found`, () => {
        throw new Error(
          `Test file not found! Create file "test/api/${methodName}/index.ts".`
        )
      })
    }
  }
})