Class: LLM::Schema

Inherits:
Object
  • Object
show all
Defined in:
lib/llm/schema.rb,
lib/llm/schema/leaf.rb,
lib/llm/schema/null.rb,
lib/llm/schema/array.rb,
lib/llm/schema/number.rb,
lib/llm/schema/object.rb,
lib/llm/schema/string.rb,
lib/llm/schema/boolean.rb,
lib/llm/schema/integer.rb,
lib/llm/schema/version.rb

Overview

The LLM::Schema class represents a JSON schema, and provides methods that let you describe and produce a schema that can be used in various contexts that include the validation and generation of JSON data.

Examples:

schema = LLM::Schema.new
schema.object({
  name: schema.string.enum("John", "Jane").required,
  age: schema.integer.required,
  hobbies: schema.array(schema.string, schema.null).required,
  address: schema.object({street: schema.string}).required,
})

See Also:

Defined Under Namespace

Classes: Array, Boolean, Integer, Leaf, Null, Number, Object, String

Constant Summary collapse

VERSION = 
"0.1.0"

Class Method Summary collapse

Instance Method Summary collapse

Class Method Details

.inherited(klass)

This method returns an undefined value.

Configures a monitor for a subclass



34
35
36
37
38
 
# File 'lib/llm/schema.rb', line 34

def self.inherited(klass)
  LLM.lock(:inherited) do
    klass.instance_eval { @__monitor = Monitor.new }
  end
end

.object ⇒ LLM::Schema::Object

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Returns:



75
76
77
78
79
 
# File 'lib/llm/schema.rb', line 75

def self.object
  lock do
    @object ||= schema.object({})
  end
end

.property(name, type, description, options = {}) ⇒ Object

Parameters:

  • name (String) —

    The property name

  • type (Class) —

    The property type

  • description (String) —

    The property description

  • options (Hash) (defaults to: {}) —

    A hash of options



49
50
51
52
53
54
55
56
57
58
59
60
61
 
# File 'lib/llm/schema.rb', line 49

def self.property(name, type, description, options = {})
  lock do
    if LLM::Schema::Leaf === type
      prop = type
    else
      target = type.name.split("::").last.downcase
      prop = schema.public_send(target)
    end
    options = {description:}.merge(options)
    options.each { (_2 == true) ? prop.public_send(_1) : prop.public_send(_1, *_2) }
    object[name] = prop
  end
end

.schema ⇒ LLM::Schema

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Returns:



66
67
68
69
70
 
# File 'lib/llm/schema.rb', line 66

def self.schema
  lock do
    @schema ||= LLM::Schema.new
  end
end

Instance Method Details

#array(*items) ⇒ LLM::Schema::Array

Returns an array

Parameters:

  • items (Array) —

    An array of items

Returns:



100
101
102
 
# File 'lib/llm/schema.rb', line 100

def array(*items)
  Array.new(*items)
end

#boolean ⇒ LLM::Schema::Boolean

Returns a boolean

Returns:



128
129
130
 
# File 'lib/llm/schema.rb', line 128

def boolean
  Boolean.new
end

#integer ⇒ LLM::Schema::Integer

Returns an integer

Returns:



121
122
123
 
# File 'lib/llm/schema.rb', line 121

def integer
  Integer.new
end

#null ⇒ LLM::Schema::Null

Returns null

Returns:



135
136
137
 
# File 'lib/llm/schema.rb', line 135

def null
  Null.new
end

#number ⇒ LLM::Schema::Number

Returns a number

Returns:



114
115
116
 
# File 'lib/llm/schema.rb', line 114

def number
  Number.new
end

#object(properties) ⇒ LLM::Schema::Object

Returns an object

Parameters:

  • properties (Hash) —

    A hash of properties

Returns:



92
93
94
 
# File 'lib/llm/schema.rb', line 92

def object(properties)
  Object.new(properties)
end

#string ⇒ LLM::Schema::String

Returns a string

Returns:



107
108
109
 
# File 'lib/llm/schema.rb', line 107

def string
  String.new
end