jsi 0.4.0 → 0.6.0
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/.yardopts +1 -1
- data/CHANGELOG.md +15 -0
- data/README.md +105 -38
- data/lib/jsi/base.rb +349 -155
- data/lib/jsi/jsi_coder.rb +5 -4
- data/lib/jsi/metaschema_node/bootstrap_schema.rb +100 -0
- data/lib/jsi/metaschema_node.rb +156 -129
- data/lib/jsi/pathed_node.rb +47 -49
- data/lib/jsi/ptr.rb +292 -0
- data/lib/jsi/schema/application/child_application/contains.rb +16 -0
- data/lib/jsi/schema/application/child_application/draft04.rb +22 -0
- data/lib/jsi/schema/application/child_application/draft06.rb +29 -0
- data/lib/jsi/schema/application/child_application/draft07.rb +29 -0
- data/lib/jsi/schema/application/child_application/items.rb +18 -0
- data/lib/jsi/schema/application/child_application/properties.rb +25 -0
- data/lib/jsi/schema/application/child_application.rb +40 -0
- data/lib/jsi/schema/application/draft04.rb +8 -0
- data/lib/jsi/schema/application/draft06.rb +8 -0
- data/lib/jsi/schema/application/draft07.rb +8 -0
- data/lib/jsi/schema/application/inplace_application/dependencies.rb +28 -0
- data/lib/jsi/schema/application/inplace_application/draft04.rb +26 -0
- data/lib/jsi/schema/application/inplace_application/draft06.rb +27 -0
- data/lib/jsi/schema/application/inplace_application/draft07.rb +33 -0
- data/lib/jsi/schema/application/inplace_application/ifthenelse.rb +20 -0
- data/lib/jsi/schema/application/inplace_application/ref.rb +18 -0
- data/lib/jsi/schema/application/inplace_application/someof.rb +29 -0
- data/lib/jsi/schema/application/inplace_application.rb +46 -0
- data/lib/jsi/schema/application.rb +12 -0
- data/lib/jsi/schema/draft04.rb +14 -0
- data/lib/jsi/schema/draft06.rb +14 -0
- data/lib/jsi/schema/draft07.rb +14 -0
- data/lib/jsi/schema/issue.rb +36 -0
- data/lib/jsi/schema/ref.rb +159 -0
- data/lib/jsi/schema/schema_ancestor_node.rb +119 -0
- data/lib/jsi/schema/validation/array.rb +69 -0
- data/lib/jsi/schema/validation/const.rb +20 -0
- data/lib/jsi/schema/validation/contains.rb +25 -0
- data/lib/jsi/schema/validation/core.rb +39 -0
- data/lib/jsi/schema/validation/dependencies.rb +49 -0
- data/lib/jsi/schema/validation/draft04/minmax.rb +91 -0
- data/lib/jsi/schema/validation/draft04.rb +112 -0
- data/lib/jsi/schema/validation/draft06.rb +122 -0
- data/lib/jsi/schema/validation/draft07.rb +159 -0
- data/lib/jsi/schema/validation/enum.rb +25 -0
- data/lib/jsi/schema/validation/ifthenelse.rb +46 -0
- data/lib/jsi/schema/validation/items.rb +54 -0
- data/lib/jsi/schema/validation/not.rb +20 -0
- data/lib/jsi/schema/validation/numeric.rb +121 -0
- data/lib/jsi/schema/validation/object.rb +45 -0
- data/lib/jsi/schema/validation/pattern.rb +34 -0
- data/lib/jsi/schema/validation/properties.rb +101 -0
- data/lib/jsi/schema/validation/property_names.rb +32 -0
- data/lib/jsi/schema/validation/ref.rb +40 -0
- data/lib/jsi/schema/validation/required.rb +27 -0
- data/lib/jsi/schema/validation/someof.rb +90 -0
- data/lib/jsi/schema/validation/string.rb +47 -0
- data/lib/jsi/schema/validation/type.rb +49 -0
- data/lib/jsi/schema/validation.rb +51 -0
- data/lib/jsi/schema.rb +486 -133
- data/lib/jsi/schema_classes.rb +157 -42
- data/lib/jsi/schema_registry.rb +141 -0
- data/lib/jsi/schema_set.rb +141 -0
- data/lib/jsi/simple_wrap.rb +2 -2
- data/lib/jsi/typelike_modules.rb +52 -37
- data/lib/jsi/util/attr_struct.rb +106 -0
- data/lib/jsi/util.rb +141 -25
- data/lib/jsi/validation/error.rb +34 -0
- data/lib/jsi/validation/result.rb +210 -0
- data/lib/jsi/validation.rb +15 -0
- data/lib/jsi/version.rb +3 -1
- data/lib/jsi.rb +55 -9
- data/lib/schemas/json-schema.org/draft-04/schema.rb +8 -3
- data/lib/schemas/json-schema.org/draft-06/schema.rb +8 -3
- data/lib/schemas/json-schema.org/draft-07/schema.rb +12 -0
- data/readme.rb +138 -0
- data/{resources}/schemas/json-schema.org/draft-04/schema.json +149 -0
- data/{resources}/schemas/json-schema.org/draft-06/schema.json +154 -0
- data/{resources}/schemas/json-schema.org/draft-07/schema.json +168 -0
- metadata +69 -118
- data/.simplecov +0 -3
- data/Rakefile.rb +0 -9
- data/jsi.gemspec +0 -28
- data/lib/jsi/base/to_rb.rb +0 -128
- data/lib/jsi/json/node.rb +0 -203
- data/lib/jsi/json/pointer.rb +0 -419
- data/lib/jsi/json-schema-fragments.rb +0 -61
- data/lib/jsi/json.rb +0 -10
- data/resources/icons/AGPL-3.0.png +0 -0
- data/test/base_array_test.rb +0 -323
- data/test/base_hash_test.rb +0 -337
- data/test/base_test.rb +0 -486
- data/test/jsi_coder_test.rb +0 -85
- data/test/jsi_json_arraynode_test.rb +0 -150
- data/test/jsi_json_hashnode_test.rb +0 -132
- data/test/jsi_json_node_test.rb +0 -257
- data/test/jsi_json_pointer_test.rb +0 -102
- data/test/jsi_test.rb +0 -11
- data/test/jsi_typelike_as_json_test.rb +0 -53
- data/test/metaschema_node_test.rb +0 -19
- data/test/schema_module_test.rb +0 -21
- data/test/schema_test.rb +0 -208
- data/test/spreedly_openapi_test.rb +0 -8
- data/test/test_helper.rb +0 -97
- data/test/util_test.rb +0 -62
data/lib/jsi/base/to_rb.rb
DELETED
@@ -1,128 +0,0 @@
|
|
1
|
-
# frozen_string_literal: true
|
2
|
-
|
3
|
-
module JSI
|
4
|
-
class Base
|
5
|
-
class << self
|
6
|
-
def class_comment
|
7
|
-
lines = []
|
8
|
-
|
9
|
-
description = schema &&
|
10
|
-
schema['description'].respond_to?(:to_str) &&
|
11
|
-
schema['description'].to_str
|
12
|
-
if description
|
13
|
-
description.split("\n", -1).each do |descline|
|
14
|
-
lines << "# " + descline
|
15
|
-
end
|
16
|
-
lines << "#"
|
17
|
-
end
|
18
|
-
|
19
|
-
schema.described_object_property_names.each_with_index do |propname, i|
|
20
|
-
lines << "#" unless i == 0
|
21
|
-
lines << "# @!attribute [rw] #{propname}"
|
22
|
-
|
23
|
-
property_schema = schema['properties'].respond_to?(:to_hash) &&
|
24
|
-
schema['properties'][propname].respond_to?(:to_hash) &&
|
25
|
-
schema['properties'][propname]
|
26
|
-
|
27
|
-
required = property_schema && property_schema['required']
|
28
|
-
required ||= schema['required'].respond_to?(:to_ary) && schema['required'].include?(propname)
|
29
|
-
lines << "# @required" if required
|
30
|
-
|
31
|
-
type = property_schema &&
|
32
|
-
property_schema['type'].respond_to?(:to_str) &&
|
33
|
-
property_schema['type'].to_str
|
34
|
-
simple = {'string' => 'String', 'number' => 'Numeric', 'boolean' => 'Boolean', 'null' => 'nil'}
|
35
|
-
rettypes = []
|
36
|
-
if simple.key?(type)
|
37
|
-
rettypes << simple[type]
|
38
|
-
elsif type == 'object' || type == 'array'
|
39
|
-
rettypes = []
|
40
|
-
schema_class = JSI.class_for_schema(property_schema)
|
41
|
-
unless schema_class.name =~ /\AJSI::SchemaClasses::/
|
42
|
-
rettypes << schema_class.name
|
43
|
-
end
|
44
|
-
rettypes << {'object' => '#to_hash', 'array' => '#to_ary'}[type]
|
45
|
-
elsif type
|
46
|
-
# not really valid, but there's some information in there. whatever it is.
|
47
|
-
rettypes << type
|
48
|
-
end
|
49
|
-
# we'll add Object to all because the accessor methods have no enforcement that their value is
|
50
|
-
# of the specified type, and may return anything really. TODO: consider if this is of any value?
|
51
|
-
rettypes << 'Object'
|
52
|
-
lines << "# @return [#{rettypes.join(', ')}]"
|
53
|
-
|
54
|
-
description = property_schema &&
|
55
|
-
property_schema['description'].respond_to?(:to_str) &&
|
56
|
-
property_schema['description'].to_str
|
57
|
-
if description
|
58
|
-
description.split("\n", -1).each do |descline|
|
59
|
-
lines << "# " + descline
|
60
|
-
end
|
61
|
-
end
|
62
|
-
end
|
63
|
-
lines.join("\n")
|
64
|
-
end
|
65
|
-
|
66
|
-
def to_rb
|
67
|
-
lines = []
|
68
|
-
description = schema &&
|
69
|
-
schema['description'].respond_to?(:to_str) &&
|
70
|
-
schema['description'].to_str
|
71
|
-
if description
|
72
|
-
description.split("\n", -1).each do |descline|
|
73
|
-
lines << "# " + descline
|
74
|
-
end
|
75
|
-
end
|
76
|
-
lines << "class #{name}"
|
77
|
-
schema.described_object_property_names.each_with_index do |propname, i|
|
78
|
-
lines << "" unless i == 0
|
79
|
-
property_schema = schema['properties'].respond_to?(:to_hash) &&
|
80
|
-
schema['properties'][propname].respond_to?(:to_hash) &&
|
81
|
-
schema['properties'][propname]
|
82
|
-
description = property_schema &&
|
83
|
-
property_schema['description'].respond_to?(:to_str) &&
|
84
|
-
property_schema['description'].to_str
|
85
|
-
if description
|
86
|
-
description.split("\n", -1).each do |descline|
|
87
|
-
lines << " # " + descline
|
88
|
-
end
|
89
|
-
lines << " #" # blank comment line between description and @return
|
90
|
-
end
|
91
|
-
|
92
|
-
required = property_schema && property_schema['required']
|
93
|
-
required ||= schema['required'].respond_to?(:to_ary) && schema['required'].include?(propname)
|
94
|
-
lines << " # @required" if required
|
95
|
-
|
96
|
-
type = property_schema &&
|
97
|
-
property_schema['type'].respond_to?(:to_str) &&
|
98
|
-
property_schema['type'].to_str
|
99
|
-
simple = {'string' => 'String', 'number' => 'Numeric', 'boolean' => 'Boolean', 'null' => 'nil'}
|
100
|
-
rettypes = []
|
101
|
-
if simple.key?(type)
|
102
|
-
rettypes << simple[type]
|
103
|
-
elsif type == 'object' || type == 'array'
|
104
|
-
rettypes = []
|
105
|
-
schema_class = JSI.class_for_schema(property_schema)
|
106
|
-
unless schema_class.name =~ /\AJSI::SchemaClasses::/
|
107
|
-
rettypes << schema_class.name
|
108
|
-
end
|
109
|
-
rettypes << {'object' => '#to_hash', 'array' => '#to_ary'}[type]
|
110
|
-
elsif type
|
111
|
-
# not really valid, but there's some information in there. whatever it is.
|
112
|
-
rettypes << type
|
113
|
-
end
|
114
|
-
# we'll add Object to all because the accessor methods have no enforcement that their value is
|
115
|
-
# of the specified type, and may return anything really. TODO: consider if this is of any value?
|
116
|
-
rettypes << 'Object'
|
117
|
-
lines << " # @return [#{rettypes.join(', ')}]"
|
118
|
-
|
119
|
-
lines << " def #{propname}"
|
120
|
-
lines << " super"
|
121
|
-
lines << " end"
|
122
|
-
end
|
123
|
-
lines << "end"
|
124
|
-
lines.join("\n")
|
125
|
-
end
|
126
|
-
end
|
127
|
-
end
|
128
|
-
end
|
data/lib/jsi/json/node.rb
DELETED
@@ -1,203 +0,0 @@
|
|
1
|
-
# frozen_string_literal: true
|
2
|
-
|
3
|
-
module JSI
|
4
|
-
module JSON
|
5
|
-
# JSI::JSON::Node is an abstraction of a node within a JSON document.
|
6
|
-
# it aims to act like the underlying data type of the node's content
|
7
|
-
# (generally Hash or Array-like) in most cases.
|
8
|
-
#
|
9
|
-
# the main advantage offered by using a Node over the underlying data
|
10
|
-
# is in dereferencing. if a Node consists of a hash with a $ref property
|
11
|
-
# pointing within the same document, then the Node will transparently
|
12
|
-
# follow the ref and return the referenced data.
|
13
|
-
#
|
14
|
-
# in most other respects, a Node aims to act like a Hash when the content
|
15
|
-
# is Hash-like, an Array when the content is Array-like. methods of Hash
|
16
|
-
# and Array are defined and delegated to the node's content.
|
17
|
-
#
|
18
|
-
# however, destructive methods are for the most part not implemented.
|
19
|
-
# at the moment only #[]= is implemented. since Node thinly wraps the
|
20
|
-
# underlying data, you can change the data and it will be reflected in
|
21
|
-
# the node. implementations of destructive methods are planned.
|
22
|
-
#
|
23
|
-
# methods that return a modified copy such as #merge are defined, and
|
24
|
-
# return a copy of the document with the content of the node modified.
|
25
|
-
# the original node's document and content are untouched.
|
26
|
-
class Node
|
27
|
-
include Enumerable
|
28
|
-
include PathedNode
|
29
|
-
|
30
|
-
def self.new_doc(node_document)
|
31
|
-
new_by_type(node_document, JSI::JSON::Pointer.new([]))
|
32
|
-
end
|
33
|
-
|
34
|
-
# if the content of the document at the given pointer is Hash-like, returns
|
35
|
-
# a HashNode; if Array-like, returns ArrayNode. otherwise returns a
|
36
|
-
# regular Node, although Nodes are for the most part instantiated from
|
37
|
-
# Hash or Array-like content.
|
38
|
-
def self.new_by_type(node_document, node_ptr)
|
39
|
-
content = node_ptr.evaluate(node_document)
|
40
|
-
if content.respond_to?(:to_hash)
|
41
|
-
HashNode.new(node_document, node_ptr)
|
42
|
-
elsif content.respond_to?(:to_ary)
|
43
|
-
ArrayNode.new(node_document, node_ptr)
|
44
|
-
else
|
45
|
-
Node.new(node_document, node_ptr)
|
46
|
-
end
|
47
|
-
end
|
48
|
-
|
49
|
-
# a Node represents the content of a document at a given pointer.
|
50
|
-
def initialize(node_document, node_ptr)
|
51
|
-
unless node_ptr.is_a?(JSI::JSON::Pointer)
|
52
|
-
raise(TypeError, "node_ptr must be a JSI::JSON::Pointer. got: #{node_ptr.pretty_inspect.chomp} (#{node_ptr.class})")
|
53
|
-
end
|
54
|
-
if node_document.is_a?(JSI::JSON::Node)
|
55
|
-
raise(TypeError, "node_document of a Node should not be another JSI::JSON::Node: #{node_document.inspect}")
|
56
|
-
end
|
57
|
-
@node_document = node_document
|
58
|
-
@node_ptr = node_ptr
|
59
|
-
end
|
60
|
-
|
61
|
-
# the document containing this Node at our pointer
|
62
|
-
attr_reader :node_document
|
63
|
-
|
64
|
-
# JSI::JSON::Pointer pointing to this node within its document
|
65
|
-
attr_reader :node_ptr
|
66
|
-
|
67
|
-
# returns content at the given subscript - call this the subcontent.
|
68
|
-
#
|
69
|
-
# if the content cannot be subscripted, raises TypeError.
|
70
|
-
#
|
71
|
-
# if the subcontent is Hash-like, it is wrapped as a JSI::JSON::HashNode before being returned.
|
72
|
-
# if the subcontent is Array-like, it is wrapped as a JSI::JSON::ArrayNode before being returned.
|
73
|
-
#
|
74
|
-
# if this node's content is a $ref - that is, a hash with a $ref attribute - and the subscript is
|
75
|
-
# not a key of the hash, then the $ref is followed before returning the subcontent.
|
76
|
-
def [](subscript)
|
77
|
-
ptr = self.node_ptr
|
78
|
-
content = self.node_content
|
79
|
-
unless content.respond_to?(:[])
|
80
|
-
if content.respond_to?(:to_hash)
|
81
|
-
content = content.to_hash
|
82
|
-
elsif content.respond_to?(:to_ary)
|
83
|
-
content = content.to_ary
|
84
|
-
else
|
85
|
-
raise(NoMethodError, "undefined method `[]`\nsubscripting with #{subscript.pretty_inspect.chomp} (#{subscript.class}) from #{content.class.inspect}. content is: #{content.pretty_inspect.chomp}")
|
86
|
-
end
|
87
|
-
end
|
88
|
-
begin
|
89
|
-
subcontent = content[subscript]
|
90
|
-
rescue TypeError => e
|
91
|
-
raise(e.class, e.message + "\nsubscripting with #{subscript.pretty_inspect.chomp} (#{subscript.class}) from #{content.class.inspect}. content is: #{content.pretty_inspect.chomp}", e.backtrace)
|
92
|
-
end
|
93
|
-
if subcontent.respond_to?(:to_hash)
|
94
|
-
HashNode.new(node_document, ptr[subscript])
|
95
|
-
elsif subcontent.respond_to?(:to_ary)
|
96
|
-
ArrayNode.new(node_document, ptr[subscript])
|
97
|
-
else
|
98
|
-
subcontent
|
99
|
-
end
|
100
|
-
end
|
101
|
-
|
102
|
-
# assigns the given subscript of the content to the given value. the document is modified in place.
|
103
|
-
def []=(subscript, value)
|
104
|
-
if value.is_a?(Node)
|
105
|
-
node_content[subscript] = value.node_content
|
106
|
-
else
|
107
|
-
node_content[subscript] = value
|
108
|
-
end
|
109
|
-
end
|
110
|
-
|
111
|
-
# returns a Node, dereferencing a $ref attribute if possible. if this node is not hash-like,
|
112
|
-
# does not have a $ref, or if what its $ref cannot be found, this node is returned.
|
113
|
-
#
|
114
|
-
# currently only $refs pointing within the same document are followed.
|
115
|
-
#
|
116
|
-
# @yield [Node] if a block is given (optional), this will yield a deref'd node. if this
|
117
|
-
# node is not a $ref object, the block is not called. if we are a $ref which cannot be followed
|
118
|
-
# (e.g. a $ref to an external document, which is not yet supported), the block is not called.
|
119
|
-
# @return [JSI::JSON::Node] dereferenced node, or this node
|
120
|
-
def deref(&block)
|
121
|
-
node_ptr_deref do |deref_ptr|
|
122
|
-
return Node.new_by_type(node_document, deref_ptr).tap(&(block || Util::NOOP))
|
123
|
-
end
|
124
|
-
return self
|
125
|
-
end
|
126
|
-
|
127
|
-
# a Node at the root of the document
|
128
|
-
def document_root_node
|
129
|
-
Node.new_doc(node_document)
|
130
|
-
end
|
131
|
-
|
132
|
-
# the parent of this node. if this node is the document root, raises
|
133
|
-
# JSI::JSON::Pointer::ReferenceError.
|
134
|
-
def parent_node
|
135
|
-
Node.new_by_type(node_document, node_ptr.parent)
|
136
|
-
end
|
137
|
-
|
138
|
-
# returns a jsonifiable representation of this node's content
|
139
|
-
def as_json(*opt)
|
140
|
-
Typelike.as_json(node_content, *opt)
|
141
|
-
end
|
142
|
-
|
143
|
-
# takes a block. the block is yielded the content of this node. the block MUST return a modified
|
144
|
-
# copy of that content (and NOT modify the object it is given).
|
145
|
-
def modified_copy(&block)
|
146
|
-
Node.new_by_type(node_ptr.modified_document_copy(node_document, &block), node_ptr)
|
147
|
-
end
|
148
|
-
|
149
|
-
def dup
|
150
|
-
modified_copy(&:dup)
|
151
|
-
end
|
152
|
-
|
153
|
-
# meta-information about the object, outside the content. used by #inspect / #pretty_print
|
154
|
-
# @return [Array<String>]
|
155
|
-
def object_group_text
|
156
|
-
[
|
157
|
-
self.class.inspect,
|
158
|
-
node_ptr.uri.to_s,
|
159
|
-
] + (node_content.respond_to?(:object_group_text) ? node_content.object_group_text : [])
|
160
|
-
end
|
161
|
-
|
162
|
-
# a string representing this node
|
163
|
-
def inspect
|
164
|
-
"\#<#{object_group_text.join(' ')} #{node_content.inspect}>"
|
165
|
-
end
|
166
|
-
|
167
|
-
# pretty-prints a representation this node to the given printer
|
168
|
-
def pretty_print(q)
|
169
|
-
q.text '#<'
|
170
|
-
q.text object_group_text.join(' ')
|
171
|
-
q.group_sub {
|
172
|
-
q.nest(2) {
|
173
|
-
q.breakable ' '
|
174
|
-
q.pp node_content
|
175
|
-
}
|
176
|
-
}
|
177
|
-
q.breakable ''
|
178
|
-
q.text '>'
|
179
|
-
end
|
180
|
-
|
181
|
-
# fingerprint for equality (see FingerprintHash). two nodes are equal if they are both nodes
|
182
|
-
# (regardless of type, e.g. one may be a Node and the other may be a HashNode) within equal
|
183
|
-
# documents at equal pointers. note that this means two nodes with the same content may not be
|
184
|
-
# considered equal.
|
185
|
-
def jsi_fingerprint
|
186
|
-
{class: JSI::JSON::Node, node_document: node_document, node_ptr: node_ptr}
|
187
|
-
end
|
188
|
-
include Util::FingerprintHash
|
189
|
-
end
|
190
|
-
|
191
|
-
# a JSI::JSON::Node whose content is Array-like (responds to #to_ary)
|
192
|
-
# and includes Array methods from Arraylike
|
193
|
-
class ArrayNode < Node
|
194
|
-
include PathedArrayNode
|
195
|
-
end
|
196
|
-
|
197
|
-
# a JSI::JSON::Node whose content is Hash-like (responds to #to_hash)
|
198
|
-
# and includes Hash methods from Hashlike
|
199
|
-
class HashNode < Node
|
200
|
-
include PathedHashNode
|
201
|
-
end
|
202
|
-
end
|
203
|
-
end
|