specs.schema.json

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "title": "Specs",
  "type": "object",
  "additionalProperties": false,
  "required": ["testCases"],
  "properties": {
    "$schema": { "type": "string" },
    "balances": {
      "$ref": "#/definitions/Balances"
    },
    "variables": {
      "$ref": "#/definitions/VariablesMap"
    },
    "metadata": {
      "$ref": "#/definitions/AccountsMetadata"
    },
    "testCases": {
      "type": "array",
      "items": { "$ref": "#/definitions/TestCase" }
    },
    "featureFlags": {
      "type": "array",
      "items": { "type": "string" }
    }
  },
  "definitions": {
    "TestCase": {
      "type": "object",
      "required": ["it"],
      "additionalProperties": false,
      "properties": {
        "it": {
          "type": "string",
          "description": "Test case description"
        },
        "focus": {
          "type": "boolean",
          "description": "Skip all the other tests. Just for debugging: it will result in an error exit code"
        },
        "skip": {
          "type": "boolean",
          "description": "Skip this test. Just for debugging: it will result in an error exit code"
        },

        "balances": {
          "$ref": "#/definitions/Balances"
        },
        "variables": {
          "$ref": "#/definitions/VariablesMap"
        },
        "metadata": {
          "$ref": "#/definitions/AccountsMetadata"
        },
        "expect.postings": {
          "type": "array",
          "items": { "$ref": "#/definitions/Posting" }
        },

        "expect.endBalances": {
          "$ref": "#/definitions/Balances"
        },
        "expect.endBalances.include": {
          "$ref": "#/definitions/Balances"
        },

        "expect.movements": {
          "$ref": "#/definitions/Movements"
        },

        "expect.txMetadata": {
          "$ref": "#/definitions/TxMetadata"
        },

        "expect.metadata": {
          "$ref": "#/definitions/AccountsMetadata"
        },

        "expect.error.missingFunds": {
          "type": "boolean"
        }
      }
    },

    "Balances": {
      "type": "array",
      "description": "List of account balances. The (account, asset, color) triple of each entry must be unique within the list.",
      "items": { "$ref": "#/definitions/BalanceRow" }
    },

    "BalanceRow": {
      "type": "object",
      "description": "The balance of a given (account, asset, color)",
      "additionalProperties": false,
      "required": ["account", "asset", "amount"],
      "properties": {
        "account": {
          "type": "string",
          "pattern": "^([a-zA-Z0-9_-]+(:[a-zA-Z0-9_-]+)*)$"
        },
        "asset": {
          "type": "string",
          "pattern": "^([A-Z]+(/[0-9]+)?)$"
        },
        "amount": {
          "type": "number"
        },
        "color": {
          "type": "string",
          "pattern": "^[A-Z]*$"
        }
      }
    },

    "VariablesMap": {
      "type": "object",
      "description": "Map of variable name to variable stringified value",
      "additionalProperties": false,
      "patternProperties": {
        "^[a-z_]+$": { "type": "string" }
      }
    },

    "AccountsMetadata": {
      "type": "object",
      "description": "Map of an account metadata to the account's metadata",
      "additionalProperties": false,
      "patternProperties": {
        "^([a-zA-Z0-9_-]+(:[a-zA-Z0-9_-]+)*)$": {
          "type": "object",
          "additionalProperties": { "type": "string" }
        }
      }
    },

    "TxMetadata": {
      "type": "object",
      "description": "Map from a metadata's key to the transaction's metadata stringied value",
      "additionalProperties": { "type": "string" }
    },

    "Movements": {
      "type": "array",
      "description": "List of funds sent from an account to another. The (source, destination, asset, color) tuple of each entry must be unique within the list.",
      "items": { "$ref": "#/definitions/Movement" }
    },

    "Movement": {
      "type": "object",
      "description": "The funds sent from an account to another for a given (asset, color)",
      "additionalProperties": false,
      "required": ["source", "destination", "asset", "amount"],
      "properties": {
        "source": {
          "type": "string",
          "pattern": "^([a-zA-Z0-9_-]+(:[a-zA-Z0-9_-]+)*)$"
        },
        "destination": {
          "type": "string",
          "pattern": "^([a-zA-Z0-9_-]+(:[a-zA-Z0-9_-]+)*)$"
        },
        "asset": {
          "type": "string",
          "pattern": "^([A-Z]+(/[0-9]+)?)$"
        },
        "amount": {
          "type": "number"
        },
        "color": {
          "type": "string",
          "pattern": "^[A-Z]*$"
        }
      }
    },

    "Posting": {
      "type": "object",
      "properties": {
        "source": { "type": "string" },
        "destination": { "type": "string" },
        "asset": {
          "type": "string",
          "pattern": "^([A-Z]+(/[0-9]+)?)$"
        },
        "amount": {
          "type": "number"
        },
        "color": {
          "type": "string",
          "pattern": "^[A-Z]*$"
        }
      },
      "required": ["source", "destination", "asset", "amount"]
    }
  }
}