feat: Async retriever

Signed-off-by: Dmitry Dygalo <[email protected]>

.github/workflows/ci.yml

@@ -51,7 +51,7 @@ jobs:
           cache-all-crates: "true"
           key: ${{ matrix.os }}
 
-      - run: cargo test --no-fail-fast
+      - run: cargo test --no-fail-fast --all-features
 
   test-wasm:
     name: Test on WASM

CHANGELOG.md

@@ -4,6 +4,7 @@
 
 ### Added
 
+- Support async retrieval for external resources during schema resolution via the new `resolve-async` feature. [#385](https://github.com/Stranger6667/jsonschema/issues/385)
 - Re-export `referencing::Registry` as `jsonschema::Registry`.
 - `ValidationOptions::with_registry` that allows for providing a predefined `referencing::Registry`. [#682](https://github.com/Stranger6667/jsonschema/issues/682)
 

crates/jsonschema-referencing/Cargo.toml

@@ -17,6 +17,13 @@ parking_lot = "0.12.3"
 percent-encoding = "2.3.1"
 serde_json.workspace = true
 
+async-trait = { version = "0.1.86", optional = true }
+futures = { version = "0.3.31", optional = true }
+
+[features]
+default = []
+async = ["dep:async-trait", "dep:futures"]
+
 [lints]
 workspace = true
 
@@ -26,6 +33,7 @@ codspeed-criterion-compat = { version = "2.7", default-features = false }
 criterion = { version = "0.5", default-features = false }
 referencing_testsuite = { package = "jsonschema-referencing-testsuite", path = "../jsonschema-referencing-testsuite/" }
 test-case = "3.3.1"
+tokio = { version = "1", features = ["macros", "rt"] }
 
 [[bench]]
 harness = false

crates/jsonschema-referencing/src/lib.rs

@@ -27,3 +27,6 @@ pub use retriever::{DefaultRetriever, Retrieve};
 pub(crate) use segments::Segments;
 pub use specification::Draft;
 pub use vocabularies::{Vocabulary, VocabularySet};
+
+#[cfg(feature = "async")]
+pub use retriever::AsyncRetrieve;