Class: Boxcars::Result

Inherits:
Object
  • Object
show all
Defined in:
lib/boxcars/result.rb

Overview

used by Boxcars to return structured result and additional context

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(status:, answer: nil, explanation: nil, suggestions: nil, **added_context) ⇒ Result

Returns a new instance of Result.

Parameters:

  • status (Symbol) —

    :ok or :error

  • answer (String) (defaults to: nil) —

    The answer to the question

  • explanation (String) (defaults to: nil) —

    The explanation of the answer

  • suggestions (Array<String>) (defaults to: nil) —

    The next suggestions for the user

  • added_context (Hash) —

    Any additional context to add to the result



13
14
15
16
17
18
19
 
# File 'lib/boxcars/result.rb', line 13

def initialize(status:, answer: nil, explanation: nil, suggestions: nil, **added_context)
  @status = status
  @answer = answer || explanation
  @explanation = explanation
  @suggestions = suggestions
  @added_context = added_context
end

Instance Attribute Details

#added_context ⇒ Object

Returns the value of attribute added_context.



6
7
8
 
# File 'lib/boxcars/result.rb', line 6

def added_context
  @added_context
end

#answer ⇒ Object

Returns the value of attribute answer.



6
7
8
 
# File 'lib/boxcars/result.rb', line 6

def answer
  @answer
end

#explanation ⇒ Object

Returns the value of attribute explanation.



6
7
8
 
# File 'lib/boxcars/result.rb', line 6

def explanation
  @explanation
end

#status ⇒ Object

Returns the value of attribute status.



6
7
8
 
# File 'lib/boxcars/result.rb', line 6

def status
  @status
end

#suggestions ⇒ Object

Returns the value of attribute suggestions.



6
7
8
 
# File 'lib/boxcars/result.rb', line 6

def suggestions
  @suggestions
end

Class Method Details

.from_error(error) ⇒ Boxcars::Result

create a new Result from an error string

Parameters:

  • error (String) —

    The error to use for the result

  • kwargs (Hash) —

    Any additional kwargs to pass to the result

Returns:



57
58
59
60
61
62
 
# File 'lib/boxcars/result.rb', line 57

def self.from_error(error, **)
  answer = error
  answer = Regexp.last_match(:answer) if answer =~ /^Error:\s*(?<answer>.*)$/
  explanation = "Error: #{answer}"
  new(status: :error, answer:, explanation:, **)
end

.from_text(text) ⇒ Boxcars::Result

create a new Result from a text string

Parameters:

  • text (String) —

    The text to use for the result

  • kwargs (Hash) —

    Any additional kwargs to pass to the result

Returns:



45
46
47
48
49
50
51
 
# File 'lib/boxcars/result.rb', line 45

def self.from_text(text, **)
  str = text.to_s
  answer = str.delete_prefix('"').delete_suffix('"').strip
  answer = Regexp.last_match(:answer) if answer =~ /^Answer:\s*(?<answer>.*)$/
  explanation = "Answer: #{answer}"
  new(status: :ok, answer:, explanation:, **)
end

Instance Method Details

#to_answer ⇒ String

Returns The answer data to the question.

Returns:

  • (String) —

    The answer data to the question



37
38
39
 
# File 'lib/boxcars/result.rb', line 37

def to_answer
  answer
end

#to_h ⇒ Hash

Returns The result as a hash.

Returns:

  • (Hash) —

    The result as a hash



22
23
24
 
# File 'lib/boxcars/result.rb', line 22

def to_h
  { status:, answer:, explanation:, suggestions: }.merge(added_context).compact
end

#to_json ⇒ String

Returns The result as a json string.

Returns:

  • (String) —

    The result as a json string



27
28
29
 
# File 'lib/boxcars/result.rb', line 27

def to_json(*)
  JSON.generate(to_h, *)
end

#to_s ⇒ String

Returns An explanation of the result.

Returns:

  • (String) —

    An explanation of the result



32
33
34
 
# File 'lib/boxcars/result.rb', line 32

def to_s
  explanation
end