Class: Schemacop::V3::Node

Inherits:
Object
  • Object
show all
Defined in:
lib/schemacop/v3/node.rb

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(**options, &block) ⇒ Node

Returns a new instance of Node.



73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
# File 'lib/schemacop/v3/node.rb', line 73

def initialize(**options, &block)
  # Check options #
  disallowed_options = options.keys - self.class.allowed_options

  if disallowed_options.any?
    fail Schemacop::Exceptions::InvalidSchemaError, "Options #{disallowed_options.inspect} are not allowed for this node."
  end

  # Assign attributes #
  @name = options.delete(:name)
  @name = @name.to_s unless @name.nil? || @name.is_a?(Regexp)
  @as = options.delete(:as)
  @required = !!options.delete(:required)
  @default = options.delete(:default)
  @title = options.delete(:title)
  @description = options.delete(:description)
  @examples = options.delete(:examples)
  @enum = options.delete(:enum)&.to_set
  @parent = options.delete(:parent)
  @options = options
  @schemas = {}

  # Run subclass init #
  init

  # Run DSL block #
  if block_given?
    unless self.class.supports_children_options
      fail Schemacop::Exceptions::InvalidSchemaError, "Node #{self.class} does not support blocks."
    end

    scope = DslScope.new(self)
    env = ScopedEnv.new(self, self.class.dsl_methods, scope, :dsl_)
    env.instance_exec(&block)
  end

  # Validate self #
  begin
    validate_self
  rescue StandardError => e
    fail Exceptions::InvalidSchemaError, e.message
  end
end

Instance Attribute Details

#asObject (readonly)

Returns the value of attribute as.



5
6
7
# File 'lib/schemacop/v3/node.rb', line 5

def as
  @as
end

#defaultObject (readonly)

Returns the value of attribute default.



6
7
8
# File 'lib/schemacop/v3/node.rb', line 6

def default
  @default
end

#descriptionObject (readonly)

Returns the value of attribute description.



8
9
10
# File 'lib/schemacop/v3/node.rb', line 8

def description
  @description
end

#nameObject (readonly)

Returns the value of attribute name.



4
5
6
# File 'lib/schemacop/v3/node.rb', line 4

def name
  @name
end

#optionsObject (readonly)

Returns the value of attribute options.



9
10
11
# File 'lib/schemacop/v3/node.rb', line 9

def options
  @options
end

#parentObject (readonly)

Returns the value of attribute parent.



10
11
12
# File 'lib/schemacop/v3/node.rb', line 10

def parent
  @parent
end

#titleObject (readonly)

Returns the value of attribute title.



7
8
9
# File 'lib/schemacop/v3/node.rb', line 7

def title
  @title
end

Class Method Details

.allowed_optionsObject



53
54
55
# File 'lib/schemacop/v3/node.rb', line 53

def self.allowed_options
  %i[name required default description examples enum parent options title as]
end

.create(type = self, **options, &block) ⇒ Object



27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
# File 'lib/schemacop/v3/node.rb', line 27

def self.create(type = self, **options, &block)
  klass = resolve_class(type)
  fail "Could not find node for type #{type.inspect}." unless klass

  node = klass.new(**options, &block)

  options = Schemacop.v3_default_options.slice(*klass.allowed_options).merge(options)

  if options.delete(:cast_str)
    format = NodeRegistry.name(klass)
    one_of_options = {
      required:           options.delete(:required),
      treat_blank_as_nil: true,
      name:               options.delete(:name),
      as:                 options.delete(:as),
      description:        options.delete(:description)
    }
    node = create(:one_of, **one_of_options) do
      self.node node
      str format: format, format_options: options
    end
  end

  return node
end

.dsl_methodsObject



57
58
59
# File 'lib/schemacop/v3/node.rb', line 57

def self.dsl_methods
  %i[dsl_scm dsl_node]
end

.resolve_class(type) ⇒ Object



23
24
25
# File 'lib/schemacop/v3/node.rb', line 23

def self.resolve_class(type)
  NodeRegistry.find(type)
end

.supports_children(name: false) ⇒ Object



15
16
17
# File 'lib/schemacop/v3/node.rb', line 15

def self.supports_children(name: false)
  self._supports_children = { name: name }
end

.supports_children_optionsObject



19
20
21
# File 'lib/schemacop/v3/node.rb', line 19

def self.supports_children_options
  _supports_children
end

Instance Method Details

#allowed_typesObject



61
62
63
# File 'lib/schemacop/v3/node.rb', line 61

def allowed_types
  {}
end

#as_jsonObject



140
141
142
# File 'lib/schemacop/v3/node.rb', line 140

def as_json
  process_json([], {})
end

#cast(value) ⇒ Object



144
145
146
# File 'lib/schemacop/v3/node.rb', line 144

def cast(value)
  value || default
end

#childrenObject



69
70
71
# File 'lib/schemacop/v3/node.rb', line 69

def children
  []
end

#create(type, **options, &block) ⇒ Object



117
118
119
120
# File 'lib/schemacop/v3/node.rb', line 117

def create(type, **options, &block)
  options[:parent] = self
  return Node.create(type, **options, &block)
end

#dsl_node(node, *_args, **_kwargs) ⇒ Object



128
129
130
# File 'lib/schemacop/v3/node.rb', line 128

def dsl_node(node, *_args, **_kwargs)
  add_child node
end

#dsl_scm(name, type = :hash, **options, &block) ⇒ Object



124
125
126
# File 'lib/schemacop/v3/node.rb', line 124

def dsl_scm(name, type = :hash, **options, &block)
  @schemas[name] = create(type, **options, &block)
end

#initObject



122
# File 'lib/schemacop/v3/node.rb', line 122

def init; end

#required?Boolean

Returns:

  • (Boolean)


136
137
138
# File 'lib/schemacop/v3/node.rb', line 136

def required?
  @required
end

#schemasObject



132
133
134
# File 'lib/schemacop/v3/node.rb', line 132

def schemas
  (parent&.schemas || {}).merge(@schemas)
end

#used_external_schemasObject



65
66
67
# File 'lib/schemacop/v3/node.rb', line 65

def used_external_schemas
  children.map(&:used_external_schemas).flatten.uniq
end

#validate(data) ⇒ Object



148
149
150
151
152
# File 'lib/schemacop/v3/node.rb', line 148

def validate(data)
  result = Result.new(self, data)
  _validate(data, result: result)
  return result
end