feat: Add ValidationOptions::with_registry

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

CHANGELOG.md

@@ -2,6 +2,11 @@
 
 ## [Unreleased]
 
+### Added
+
+- 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)
+
 ## [0.28.3] - 2025-01-24
 
 ### Fixed

crates/jsonschema-referencing/src/registry.rs

@@ -336,6 +336,12 @@ impl Registry {
             _ => unreachable!(),
         }
     }
+
+    pub fn resources(&self) -> impl Iterator<Item = (&Uri<String>, Arc<Resource>)> {
+        self.resources
+            .iter()
+            .map(|(uri, resource)| (uri, Arc::clone(resource)))
+    }
 }
 
 fn process_resources(

crates/jsonschema/src/lib.rs

@@ -516,7 +516,7 @@ pub use error::{ErrorIterator, MaskedValidationError, ValidationError};
 pub use keywords::custom::Keyword;
 pub use options::ValidationOptions;
 pub use output::BasicOutput;
-pub use referencing::{Draft, Error as ReferencingError, Resource, Retrieve, Uri};
+pub use referencing::{Draft, Error as ReferencingError, Registry, Resource, Retrieve, Uri};
 pub use validator::Validator;
 
 use serde_json::Value;

crates/jsonschema/src/options.rs

@@ -311,6 +311,42 @@ impl ValidationOptions {
         }
         self
     }
+
+    /// Use external schema resources from the registry, making them accessible via references
+    /// during validation.
+    ///
+    /// # Example
+    ///
+    /// ```rust
+    /// # use serde_json::json;
+    /// # fn main() -> Result<(), Box<dyn std::error::Error>> {
+    /// use jsonschema::{Registry, Resource};
+    ///
+    /// let mut registry = Registry::try_new(
+    ///     "urn:name-schema",
+    ///     Resource::from_contents(json!({"type": "string"}))?
+    /// )?;
+    /// let schema = json!({
+    ///     "properties": {
+    ///         "name": { "$ref": "urn:name-schema" }
+    ///     }
+    /// });
+    /// let validator = jsonschema::options()
+    ///     .with_registry(registry)
+    ///     .build(&schema)?;
+    /// assert!(validator.is_valid(&json!({ "name": "Valid String" })));
+    /// assert!(!validator.is_valid(&json!({ "name": 123 })));
+    /// # Ok(())
+    /// # }
+    /// ```
+    pub fn with_registry(&mut self, registry: referencing::Registry) -> &mut Self {
+        // NOTE: This is not particularly efficient, and should be changed in the future
+        for (uri, resource) in registry.resources() {
+            self.resources
+                .insert(uri.as_str().to_string(), (&*resource).clone());
+        }
+        self
+    }
     /// Register a custom format validator.
     ///
     /// # Example