json_schema_test_suite

Crates.iojson_schema_test_suite
lib.rsjson_schema_test_suite
version0.3.0
sourcesrc
created_at2020-06-22 18:36:19.168227
updated_at2020-06-29 19:59:50.64681
descriptionProcedural Macro Attribute to run all the test cases described in JSON-Schema-Test-Suite
homepage
repositoryhttps://github.com/macisamuele/json-schema-test-suite-rs
max_upload_size
id256822
size1,193,238
Samuele Maci (macisamuele)

documentation

http://docs.rs/json-schema-test-suite

README

json_schema_test_suite

ci codecov Crates.io docs.rs

The crate provides a procedural macro attribute that allow to generate all the test cases described by JSON-Schema-Test-Suite.

The main objective is to ensure that for each test a mock server is started and will be able to capture all the requests, ensuring that tests can be ran only interacting with cargo test

In order to ude the procedural macro attribute there are few assumptions that are made:

  • lazy_static dependency is added into your [dev-dependencies] section of the Cargo.toml file
  • mockito dependency is added into your [dev-dependencies] section of the Cargo.toml file
  • serde-json dependency is added into your [dev-dependencies] section of the Cargo.toml file
  • the annotated method signature should be: fn (&str, json_schema_test_suite::TestCase) -> ()

How to use

Cargo.toml

# Ensure that the following lines are present into your Cargo.toml file
[dev-dependencies]
json_schema_test_suite = "0"
# Be careful with dependencies version (using `*` version is never recommended).
# The proc-macro uses nothing fancy with the dependencies, so any version should work well :)
lazy_static = "*"
mockito = "*"
serde_json = "*"

Rust test file example

use json_schema_test_suite::{json_schema_test_suite, TestCase};

// If no tests should be ignored
#[json_schema_test_suite(
    // path separator is assumed to be `/` (regardless of the run platform)
    "path/to/JSON-Schema-Test-Suite/repository",
    // test directory (in <JSON-Schema-Test-Suite>/tests/<test_directory>)
    "draft7"
)]
// If some tests needs to be ignored, just defined them into `{ ... }` as follow
#[json_schema_test_suite(
    // path separator is assumed to be `/` (regardless of the run platform)
    "path/to/JSON-Schema-Test-Suite/repository",
    // test directory (in <JSON-Schema-Test-Suite>/tests/<test_directory>)
    "draft6",
    {   // Names, as generated by the macro, of the tests to ignore
        // NOTE: They can be regular expression as well.
        "name of the tests to ignore",
    }
)]
fn my_simple_test(
    // address of the HTTP server providing the remote files of JSON-Schema-Test-Suite.
    // The format will be: `hostname:port`.
    // This parameter is passed because by starting a mock server we might not start it
    // into `localhost:1234` as expected by JSON-Schema-Test-Suite
    server_address: &str,
    // Representation of the test case
    test_case: TestCase,
) {
    // TODO: Add here your testing logic
}

License: MIT

Commit count: 7

cargo fmt