rust_json_schema 0.3.0-aarch64-linux-musl

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 692035aaa205794b3ba351ae5cacc56be9c075db8cdade886eefdc724c59a522
+  data.tar.gz: e4022f6ba311200cdb44f2c856414c97489f3c3ca5cc1b1af6ed3a5fb09dc44b
+SHA512:
+  metadata.gz: 354cbea0d00b85e5ea371b79e88b17bc1bb37edd1078b0219aed53ee5ffd2ef126eb7bf64e427a5224e089c780bf33eb730b8f4efa55a3432519deb2351ec8bb
+  data.tar.gz: 47fb3ebe8db3348bbe7996ee904fa2ccf0cb481c9450d90c00c0739857614bd4034138b9eed569e18f58ad6d7324658eeae838d949159db56c4f91272b240265

data/.rspec

@@ -0,0 +1,3 @@
+--format documentation
+--color
+--require spec_helper

data/.standard.yml

@@ -0,0 +1,3 @@
+# For available configuration options, see:
+#   https://github.com/testdouble/standard
+ruby_version: 2.6

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2024 Taylor Thurlow
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,83 @@
+# `rust_json_schema`
+
+[![Gem Version](https://badge.fury.io/rb/rust_json_schema.svg)](https://rubygems.org/gems/rust_json_schema)
+
+`rust_json_schema` is a Ruby wrapper gem for Rust's [jsonschema-rs crate](https://github.com/Stranger6667/jsonschema-rs).
+
+> [!IMPORTANT]
+> This gem is built with `json_schema` crate version `0.19.1`, and therefore does not support any features for any potential future versions of the crate. I will review and accept PRs if you would like to work on adding support for newer versions of the crate. I generally am trying to keep things up to date but I am not cutting new releases for each new patch version of the crate.
+
+The minimum Ruby version required by this gem is 3.0, due to the runtime Rust libraries that make the extensions possible (and easy).
+
+This gem ships with precompiled binaries for Linux and macOS. Check the available gems on [Rubygems](https://rubygems.org/gems/rust_json_schema). Precompiled binaries do not exist for non-standard rubies like JRuby or TruffleRuby, nor do they exist for Windows. I will review and accept PRs if you would like to work on adding these build targets.
+
+[rusty_json_schema](https://github.com/driv3r/rusty_json_schema) is a direct source of inspiration. Now that [bundler has explicit support for rust-backed Ruby gems](https://bundler.io/blog/2023/01/31/rust-gem-skeleton.html) as of early 2023, the Rust library code is a lot simpler that it previously needed to be, largely thanks to [magnus crate](https://github.com/matsadler/magnus) and the [rb-sys gem](https://github.com/oxidize-rb/rb-sys/tree/main/gem), and by extension, the [oxidize-rb team](https://github.com/oxidize-rb).
+
+## Warning
+
+My experience with Rust is limited, but this gem does have tests, and it is deployed in production. Please confirm that the gem is working as expected before using it in any production-critical situation. If you are using this gem in a production environment, and have any comments or feedback, I would love to hear about it.
+
+## Installation
+
+Install the gem and add to the application's Gemfile by executing:
+
+    $ bundle add rust_json_schema
+
+If bundler is not being used to manage dependencies, install the gem by executing:
+
+    $ gem install rust_json_schema
+
+## Usage
+
+```ruby
+schema = <<~JSON
+  {
+    "properties": {
+      "foo": { "type": "string" },
+      "bar": { "type": "integer" },
+      "baz": {}
+    },
+    "required": ["foo", "baz"]
+  }
+JSON
+
+validator = RustJSONSchema::Validator.new(schema, draft: :draft7)
+
+errors = validator.validate('{ "foo": 1, "bar": "wadus" }')
+# => [
+#   'path "/bar": "wadus" is not of type "number"',
+#   'path "/foo": 1 is not of type "string"',
+#   'path "/": "baz" is a required property'
+# ]
+```
+
+### Options
+
+- `:draft` - Select the JSON schema draft number to use. Valid options are `draft4`, `draft6`, `draft7`, `draft201909`, and `draft202012`. Supported drafts are entirely determined by the `jsonschema` crate. The default draft is also determined by the crate. If new versions of the crate support additional draft versions, a code change in this gem will be required. I'm open to PRs to solve this problem - I don't know enough Rust to tell if it's easily done. _Both `draft201909` and `draft202012` are reported to have "some keywords not implemented", so use them at your own risk._
+
+Any additional options provided by the `jsonschema` crate are options I do not understand or may not make sense to implement in a wrapper library such as this.
+
+`RustJSONSchema::Validator#options` is provided and will return a Hash containing configuration options from the underlying Rust library. While I make an effort for them to look similar, or identical, to the options passed into the `Validator` initializer, the initializer arguments and the returned Hash should not be considered one-to-one. It exists as a way to confirm the configuration of the underlying schema validator instance.
+
+### Errors
+
+- All errors are subclasses of `RustJSONSchema::Error`.
+- Calling `RustJSONSchema::Validator#new`, `#validate` or `#valid?` with a string which is not valid JSON will raise `RustJSONSchema::JSONParseError`.
+- Calling `RustJSONSchema::Validator#new` with an invalid schema will raise `RustJSONSchema::SchemaParseError`.
+- Calling `RustJSONSchema::Validator#new` with an invalid draft version value will raise `RustJSONSchema::InvalidOptionsError`.
+
+## Development
+
+The rust extension is located at `ext/rust_json_schema`, and can be compiled using the `rake-compiler` tasks, usually `bin/rake compile`. Don't attempt to `cargo build` the extension separately, that typically doesn't work. View other rake tasks with `bin/rake --tasks`.
+
+You can run the tests with `bin/rspec`, but ensure any changes to the rust extension are compiled first.
+
+To release a new version, update the version number in `version.rb`, tag the new commit with the version number, and push the tag to GitHub. The gem will be built and pushed to Rubygems automatically. This will also automatically build the platform-specific binaries and attach them to the release.
+
+## Contributing
+
+Bug reports and pull requests are welcome.
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/Rakefile

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+require "standard/rake"
+
+require "rb_sys/extensiontask"
+
+task build: :compile
+
+rubies = ["3.3.0", "3.2.0", "3.1.0", "3.0.0"]
+ENV["RUBY_CC_VERSION"] ||= rubies.join(":")
+
+spec = Bundler::GemHelper.gemspec
+RbSys::ExtensionTask.new("rust_json_schema", spec) do |ext|
+  ext.lib_dir = "lib/rust_json_schema"
+
+  ext.cross_compile = true
+end
+
+task default: %i[compile spec standard]

data/lib/rust_json_schema/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module RustJSONSchema
+  VERSION = "0.3.0"
+end

data/lib/rust_json_schema.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+require_relative "rust_json_schema/version"
+
+module RustJSONSchema
+  class Error < StandardError; end
+
+  class JSONParseError < Error; end
+
+  class SchemaParseError < Error; end
+
+  class InvalidOptionsError < Error; end
+end
+
+# Tries to require the extension for the given Ruby version first
+begin
+  RUBY_VERSION =~ /(\d+\.\d+)/
+  require "rust_json_schema/#{Regexp.last_match(1)}/rust_json_schema"
+rescue LoadError
+  require_relative "rust_json_schema/rust_json_schema"
+end

data/sig/rust_json_schema.rbs

@@ -0,0 +1,4 @@
+module RustJSONSchema
+  VERSION: String
+  # See the writing guide of rbs: https://github.com/ruby/rbs#guides
+end

metadata

@@ -0,0 +1,92 @@
+--- !ruby/object:Gem::Specification
+name: rust_json_schema
+version: !ruby/object:Gem::Version
+  version: 0.3.0
+platform: aarch64-linux-musl
+authors:
+- Taylor Thurlow
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2024-09-16 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rake-compiler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rake-compiler-dock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Ruby wrapper for jsonschema-rs
+email:
+- thurlow@hey.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".rspec"
+- ".standard.yml"
+- LICENSE.txt
+- README.md
+- Rakefile
+- lib/rust_json_schema.rb
+- lib/rust_json_schema/3.0/rust_json_schema.so
+- lib/rust_json_schema/3.1/rust_json_schema.so
+- lib/rust_json_schema/3.2/rust_json_schema.so
+- lib/rust_json_schema/3.3/rust_json_schema.so
+- lib/rust_json_schema/version.rb
+- sig/rust_json_schema.rbs
+homepage: https://github.com/taylorthurlow/rust_json_schema-rb
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/taylorthurlow/rust_json_schema-rb
+  source_code_uri: https://github.com/taylorthurlow/rust_json_schema-rb
+  changelog_uri: https://github.com/taylorthurlow/rust_json_schema-rb/releases
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.0'
+  - - "<"
+    - !ruby/object:Gem::Version
+      version: 3.4.dev
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.3.11
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.3.22
+requirements: []
+rubygems_version: 3.4.4
+signing_key: 
+specification_version: 4
+summary: Ruby wrapper for jsonschema-rs
+test_files: []