Class: Gloo::Verbs::Check

Inherits:
Core::Verb show all
Defined in:
lib/gloo/verbs/check.rb

Constant Summary collapse

KEYWORD = 
'check'.freeze
KEYWORD_SHORT = 
'<-'.freeze
FOR = 
'for'.freeze
UNKNOWN_MSG_ERR = 
'Missing message!'.freeze

Constants inherited from Core::Baseo

Core::Baseo::NOT_IMPLEMENTED_ERR

Instance Attribute Summary

Attributes inherited from Core::Verb

#params, #tokens

Attributes inherited from Core::Baseo

#name

Class Method Summary collapse

Instance Method Summary collapse

Methods inherited from Core::Verb

#display_value, help, inherited, #initialize, #type_display

Methods inherited from Core::Baseo

#initialize, #type_display

Constructor Details

This class inherits a constructor from Gloo::Core::Verb

Class Method Details

.doc_data ⇒ Object

Get the verb's documentation data.



59
60
61
62
63
64
65
66
67
68
69
70
71
72
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
 
# File 'lib/gloo/verbs/check.rb', line 59

def self.doc_data
  {
    :name => KEYWORD,
    :shortcut => KEYWORD_SHORT,
    :description => 'Send a message to an object to check for an ' \
      'object condition. This is the same as the tell verb, but ' \
      'gives better syntactical naming.',
    :syntax => [ 'check {path.to.object} for {condition_message}' ],
    :parameters => [
      '{path.to.object} — The object that we want to send a condition_message to.',
      '{message} — The condition_message to send.'
    ],
    :result => 'The result depends on the message that is sent, but ' \
      'by convention the result of the check will be in it.',
    :errors => [
      "#{UNKNOWN_MSG_ERR} — No message was specified, or the 'for' keyword is missing.",
      'Object was not found — The target of the message was not found.'
    ],
    :examples => <<~EXAMPLES.strip
      #
      # Base object checks.
      #
      obj [container] :
        msg [string] :
        on_load [script] :
          show 'Does the obj container have children?'
          check obj for contains?
          show it

          show 'Is the msg blank?'
          check obj.msg for blank?
          show it

          put 'Hello, world!' into obj.msg
          show obj.msg
          show 'Is the msg still blank?'
          check obj.msg for blank?
          show it
    EXAMPLES
  }
end

.keyword ⇒ Object

Get the Verb's keyword.



35
36
37
 
# File 'lib/gloo/verbs/check.rb', line 35

def self.keyword
  return KEYWORD
end

.keyword_shortcut ⇒ Object

Get the Verb's keyword shortcut.



42
43
44
 
# File 'lib/gloo/verbs/check.rb', line 42

def self.keyword_shortcut
  return KEYWORD_SHORT
end

Instance Method Details

#run ⇒ Object

Run the verb.



20
21
22
23
24
25
26
27
28
29
30
 
# File 'lib/gloo/verbs/check.rb', line 20

def run
  msg = @tokens.after_token( FOR )

  unless msg
    @engine.err( UNKNOWN_MSG_ERR ) 
    return
  end

  Gloo::Exec::Dispatch.send_message(
    @engine, msg, @tokens.second, @params )
end