gloo-lang 1.0.2 → 1.2.1

Sign up to get free protection for your applications and to get access to all the features.
Files changed (92) hide show
  1. checksums.yaml +4 -4
  2. data/.gitignore +1 -0
  3. data/.ruby-gemset +1 -0
  4. data/.ruby-version +1 -0
  5. data/lib/VERSION +1 -1
  6. data/lib/gloo_lang/app/engine.rb +1 -12
  7. data/lib/gloo_lang/app/platform.rb +8 -0
  8. data/lib/gloo_lang/core/dictionary.rb +45 -11
  9. data/lib/gloo_lang/persist/disc_mech.rb +87 -0
  10. data/lib/gloo_lang/persist/file_loader.rb +3 -2
  11. data/lib/gloo_lang/persist/file_saver.rb +2 -1
  12. data/lib/gloo_lang/persist/persist_man.rb +6 -19
  13. metadata +5 -81
  14. data/Gemfile.lock +0 -68
  15. data/lib/gloo_lang/app/help.rb +0 -118
  16. data/lib/gloo_lang/help/app/application.txt +0 -22
  17. data/lib/gloo_lang/help/app/configuration.txt +0 -7
  18. data/lib/gloo_lang/help/app/default_help.txt +0 -14
  19. data/lib/gloo_lang/help/app/logging.txt +0 -16
  20. data/lib/gloo_lang/help/core/color.txt +0 -31
  21. data/lib/gloo_lang/help/core/error.txt +0 -33
  22. data/lib/gloo_lang/help/core/events.txt +0 -21
  23. data/lib/gloo_lang/help/core/gloo_system.txt +0 -57
  24. data/lib/gloo_lang/help/core/here.txt +0 -30
  25. data/lib/gloo_lang/help/core/it.txt +0 -23
  26. data/lib/gloo_lang/help/core/ops.txt +0 -16
  27. data/lib/gloo_lang/help/core/pathname.txt +0 -29
  28. data/lib/gloo_lang/help/objs/basic/alias.txt +0 -36
  29. data/lib/gloo_lang/help/objs/basic/boolean.txt +0 -28
  30. data/lib/gloo_lang/help/objs/basic/container.txt +0 -33
  31. data/lib/gloo_lang/help/objs/basic/decimal.txt +0 -28
  32. data/lib/gloo_lang/help/objs/basic/integer.txt +0 -27
  33. data/lib/gloo_lang/help/objs/basic/script.txt +0 -29
  34. data/lib/gloo_lang/help/objs/basic/string.txt +0 -28
  35. data/lib/gloo_lang/help/objs/basic/text.txt +0 -27
  36. data/lib/gloo_lang/help/objs/basic/untyped.txt +0 -22
  37. data/lib/gloo_lang/help/objs/cli/banner.txt +0 -49
  38. data/lib/gloo_lang/help/objs/cli/bar.txt +0 -37
  39. data/lib/gloo_lang/help/objs/cli/colorize.txt +0 -33
  40. data/lib/gloo_lang/help/objs/cli/confirm.txt +0 -26
  41. data/lib/gloo_lang/help/objs/cli/menu.txt +0 -44
  42. data/lib/gloo_lang/help/objs/cli/menu_item.txt +0 -26
  43. data/lib/gloo_lang/help/objs/cli/pastel.txt +0 -43
  44. data/lib/gloo_lang/help/objs/cli/prompt.txt +0 -27
  45. data/lib/gloo_lang/help/objs/cli/select.txt +0 -34
  46. data/lib/gloo_lang/help/objs/ctrl/each.txt +0 -48
  47. data/lib/gloo_lang/help/objs/ctrl/repeat.txt +0 -38
  48. data/lib/gloo_lang/help/objs/data/markdown.txt +0 -25
  49. data/lib/gloo_lang/help/objs/data/mysql.txt +0 -40
  50. data/lib/gloo_lang/help/objs/data/query.txt +0 -37
  51. data/lib/gloo_lang/help/objs/data/sqlite.txt +0 -26
  52. data/lib/gloo_lang/help/objs/data/table.txt +0 -46
  53. data/lib/gloo_lang/help/objs/dev/git_repo.txt +0 -36
  54. data/lib/gloo_lang/help/objs/dev/stats.txt +0 -36
  55. data/lib/gloo_lang/help/objs/dt/date.txt +0 -23
  56. data/lib/gloo_lang/help/objs/dt/datetime.txt +0 -24
  57. data/lib/gloo_lang/help/objs/dt/time.txt +0 -23
  58. data/lib/gloo_lang/help/objs/ror/erb.txt +0 -37
  59. data/lib/gloo_lang/help/objs/ror/eval.txt +0 -24
  60. data/lib/gloo_lang/help/objs/snd/play.txt +0 -23
  61. data/lib/gloo_lang/help/objs/snd/say.txt +0 -28
  62. data/lib/gloo_lang/help/objs/system/file.txt +0 -48
  63. data/lib/gloo_lang/help/objs/system/ssh_exec.txt +0 -30
  64. data/lib/gloo_lang/help/objs/system/system.txt +0 -32
  65. data/lib/gloo_lang/help/objs/web/http_get.txt +0 -35
  66. data/lib/gloo_lang/help/objs/web/http_post.txt +0 -34
  67. data/lib/gloo_lang/help/objs/web/json.txt +0 -34
  68. data/lib/gloo_lang/help/objs/web/slack.txt +0 -33
  69. data/lib/gloo_lang/help/objs/web/teams.txt +0 -30
  70. data/lib/gloo_lang/help/objs/web/uri.txt +0 -38
  71. data/lib/gloo_lang/help/verbs/alert.txt +0 -33
  72. data/lib/gloo_lang/help/verbs/beep.txt +0 -25
  73. data/lib/gloo_lang/help/verbs/cls.txt +0 -24
  74. data/lib/gloo_lang/help/verbs/context.txt +0 -43
  75. data/lib/gloo_lang/help/verbs/create.txt +0 -33
  76. data/lib/gloo_lang/help/verbs/execute.txt +0 -27
  77. data/lib/gloo_lang/help/verbs/help.txt +0 -34
  78. data/lib/gloo_lang/help/verbs/if.txt +0 -37
  79. data/lib/gloo_lang/help/verbs/list.txt +0 -34
  80. data/lib/gloo_lang/help/verbs/load.txt +0 -38
  81. data/lib/gloo_lang/help/verbs/move.txt +0 -42
  82. data/lib/gloo_lang/help/verbs/put.txt +0 -38
  83. data/lib/gloo_lang/help/verbs/quit.txt +0 -25
  84. data/lib/gloo_lang/help/verbs/run.txt +0 -41
  85. data/lib/gloo_lang/help/verbs/save.txt +0 -26
  86. data/lib/gloo_lang/help/verbs/show.txt +0 -30
  87. data/lib/gloo_lang/help/verbs/tell.txt +0 -34
  88. data/lib/gloo_lang/help/verbs/unless.txt +0 -38
  89. data/lib/gloo_lang/help/verbs/version.txt +0 -32
  90. data/lib/gloo_lang/help/verbs/wait.txt +0 -29
  91. data/lib/gloo_lang/verbs/help.rb +0 -264
  92. data/lib/gloo_lang/verbs/version.rb +0 -37
@@ -1,34 +0,0 @@
1
- LIST VERB
2
- NAME: list
3
- SHORTCUT: .
4
-
5
- DESCRIPTION
6
- List out objects (and children) at the current context.
7
- When a path is provided, it will be listed instead of the
8
- current context.
9
-
10
- When using context, the current context will be shown, but
11
- when context has not been set, the root will be shown.
12
-
13
- SYNTAX
14
- list <path.to.object>
15
-
16
- PARAMETERS
17
- path.to.object - Optional path to object that will be listed.
18
- When no path is provided, the current context is used.
19
-
20
- RESULT
21
- Object and children are listed out in the CLI.
22
-
23
- ERRORS
24
- Object does not exist
25
- - The object specified that is to be listed could not be found.
26
-
27
- EXAMPLE
28
-
29
- > list
30
- > list my.container
31
- > list root
32
-
33
- SEE ALSO
34
- context
@@ -1,38 +0,0 @@
1
- LOAD VERB
2
- NAME: load
3
- SHORTCUT: <
4
-
5
- DESCRIPTION
6
- Load an object file.
7
- There are two ways to specify the file. Give either the full path
8
- and file name or use a relative path from the gloo project folder.
9
- For the latter, the extension is not needed. For the former, the
10
- file extension is necessary.
11
-
12
- Using * instead of a file name will load all gloo files in the folder.
13
-
14
- SYNTAX
15
- load <file_name>
16
-
17
- PARAMETERS
18
- file_name - Name of the object file that is to be loaded.
19
-
20
- RESULT
21
- Objects are loaded into the heap.
22
- on_load scripts are run within the loaded objects.
23
-
24
- ERRORS
25
- Missing Expression!
26
- - No expression is provided as parameter to the verb.
27
-
28
- If the file specified can't be found or can't be loaded,
29
- an error condition will result.
30
-
31
- EXAMPLE
32
-
33
- > load my/project/file
34
- > load my/app/*
35
- > load ~/.my_app/settings.gloo
36
-
37
- SEE ALSO
38
- save
@@ -1,42 +0,0 @@
1
- MOVE VERB
2
- NAME: move
3
- SHORTCUT: mv
4
-
5
- DESCRIPTION
6
- Move an object to a new parent.
7
-
8
- SYNTAX
9
- move <path.to.object> to <new.parent>
10
-
11
- PARAMETERS
12
- path.to.object - The object that we want to move.
13
- new.parent - The new location for the object.
14
-
15
- RESULT
16
- The object will now be in the new location.
17
-
18
- ERRORS
19
- Object to move was not specified
20
- - The <path.to.object> is not specified.
21
-
22
- Could not find object to move
23
- - The <path.to.object> cannot be resolved.
24
-
25
- Move' must include 'to' parent object
26
- - The 'to' keyword is missing.
27
- - The <new.parent> is not specified.
28
-
29
- Could not resolve target
30
- - The <new.parent> cannot be resolved.
31
-
32
- EXAMPLE
33
-
34
- can [can] :
35
- two [string] : def
36
- data [can] :
37
- one [string] : abc
38
- on_load [script] :
39
- move can.two to can.data
40
-
41
- SEE ALSO
42
- create
@@ -1,38 +0,0 @@
1
- PUT VERB
2
- NAME: put
3
- SHORTCUT: p
4
-
5
- DESCRIPTION
6
- Put a value into an object.
7
- The value is the result of an expression.
8
-
9
- SYNTAX
10
- put <expression> into <dst.path>
11
-
12
- PARAMETERS
13
- expression - The expression that is evaluated.
14
- dst.path - The path to the destination object.
15
-
16
- RESULT
17
- <it> will contain the result of the evaluation.
18
-
19
- ERRORS
20
- Missing Expression
21
- - The 'into' keyword is missing.
22
- - No source expression is provided.
23
-
24
- Target (into) missing
25
- - The destination is not specified.
26
-
27
- Target could not be resolved
28
- - The destination of the put cannot be resolved.
29
-
30
- EXAMPLE
31
-
32
- > put 'one' into str
33
- > put "two" into str
34
- > put 123 into x
35
- > put 3 + 5 into x
36
- > put TRUE into flag
37
-
38
- SEE ALSO
@@ -1,25 +0,0 @@
1
- QUIT VERB
2
- NAME: quit
3
- SHORTCUT: q
4
-
5
- DESCRIPTION
6
- Stop running the gloo application.
7
- Cleanup and shutdown.
8
-
9
- SYNTAX
10
- quit
11
-
12
- PARAMETERS
13
- None
14
-
15
- RESULT
16
- None
17
-
18
- ERRORS
19
- None
20
-
21
- EXAMPLE
22
-
23
- > quit
24
-
25
- SEE ALSO
@@ -1,41 +0,0 @@
1
- RUN VERB
2
- NAME: run
3
- SHORTCUT: r
4
-
5
- DESCRIPTION
6
- Run a script or other object.
7
- This is the same as sending a 'run' message to the object.
8
-
9
- SYNTAX
10
- run <path.to.object>
11
- run ~> <expression>
12
-
13
- PARAMETERS
14
- path.to.object
15
- - Reference to the object which will be run.
16
- - The object must be a runnable object such as a script.
17
-
18
- expression
19
- - Evaluate the expression and run it.
20
-
21
-
22
- RESULT
23
- The result depends on the object that is run.
24
-
25
- ERRORS
26
- Missing Expression!
27
- - No expression is provided as parameter to the verb.
28
-
29
- EXAMPLE
30
-
31
- > run my.script
32
-
33
- > create s as script : "show 3 + 4"
34
- > run s
35
-
36
- Run a script in an evaluated expression:
37
- > create s as string : "show 3 + 4"
38
- > run ~> s
39
-
40
- SEE ALSO
41
- tell
@@ -1,26 +0,0 @@
1
- SAVE VERB
2
- NAME: save
3
- SHORTCUT: >
4
-
5
- DESCRIPTION
6
- Save a previously loaded object to .gloo file. The path will be for the
7
- root level object that was loaded earlier.
8
-
9
- SYNTAX
10
- save <path.to.object>
11
-
12
- PARAMETERS
13
- path.to.object - Name of the object file that is to be saved.
14
-
15
- RESULT
16
- The file is updated with the latest object state.
17
-
18
- ERRORS
19
- None
20
-
21
- EXAMPLE
22
-
23
- > save my_obj
24
-
25
- SEE ALSO
26
- load
@@ -1,30 +0,0 @@
1
- SHOW VERB
2
- NAME: show
3
- SHORTCUT: =
4
-
5
- DESCRIPTION
6
- Show an object's value.
7
-
8
- SYNTAX
9
- show <path.to.object>
10
-
11
- PARAMETERS
12
- path.to.object - The object that we want to see.
13
-
14
- RESULT
15
- The object's value is shown.
16
- <it> will contain the object's value.
17
-
18
- ERRORS
19
- None
20
-
21
- EXAMPLE
22
-
23
- > show "me"
24
- > show "hello " "world"
25
- > show 132 * 23
26
-
27
- > create x : "boo"
28
- > show x
29
-
30
- SEE ALSO
@@ -1,34 +0,0 @@
1
- TELL VERB
2
- NAME: tell
3
- SHORTCUT: ->
4
-
5
- DESCRIPTION
6
- Send a message to an object.
7
- Ask the object to perform an action.
8
-
9
- SYNTAX
10
- tell <path.to.object> to <message>
11
-
12
- PARAMETERS
13
- path.to.object - The object that we want to see.
14
- message - The message to send.
15
-
16
- RESULT
17
- The result depends on the message that is sent.
18
-
19
- ERRORS
20
- Missing message!
21
- - No message was specified, or the 'to' keyword is missing.
22
-
23
- Object was not found
24
- - The target of the message was not found.
25
-
26
- EXAMPLE
27
-
28
- > tell an.obj to unload
29
- > tell the.script to run
30
- > tell my.str to up
31
- > tell the.container to count
32
-
33
- SEE ALSO
34
- run
@@ -1,38 +0,0 @@
1
- UNLESS VERB
2
- NAME: unless
3
- SHORTCUT: if!
4
-
5
- DESCRIPTION
6
- Unless an expression is true, do something.
7
- This is the opposite of the if verb.
8
-
9
- SYNTAX
10
- unless <true> do <command>
11
-
12
- PARAMETERS
13
- true - Does the expression evaluate to true?
14
- command - Execute command if the expression is not true.
15
-
16
- RESULT
17
- Unchanged if the expression is true.
18
- If not true, then the result will be based on the command
19
- specified after the 'do' keyword.
20
-
21
- ERRORS
22
- Missing Expression!
23
- - No expression is provided as parameter to the verb.
24
-
25
- Other errors depend on the command that is run.
26
-
27
- EXAMPLE
28
-
29
- unless [container] :
30
- x [bool] : true
31
- false_msg [string] : It is NOT true!
32
- on_load [script] :
33
- unless unless.x do show "first time: " + unless.false_msg
34
- put false into unless.x
35
- unless unless.x do show "second time: " + unless.false_msg
36
-
37
- SEE ALSO
38
- if
@@ -1,32 +0,0 @@
1
- VERSION VERB
2
- NAME: version
3
- SHORTCUT: v
4
-
5
- DESCRIPTION
6
- Show the application version information.
7
-
8
- This is the same as showing the version by running gloo
9
- with the --version command line parameter.
10
-
11
- SYNTAX
12
- version
13
-
14
- PARAMETERS
15
- None
16
-
17
- RESULT
18
- None
19
-
20
- ERRORS
21
- None
22
-
23
- EXAMPLE
24
-
25
- > version
26
- > v
27
-
28
- This is the same as running this from the command line:
29
-
30
- > gloo --version
31
-
32
- SEE ALSO
@@ -1,29 +0,0 @@
1
- WAIT VERB
2
- NAME: wait
3
- SHORTCUT: w
4
-
5
- DESCRIPTION
6
- Wait for the given number of seconds.
7
-
8
- SYNTAX
9
- wait <seconds>
10
-
11
- PARAMETERS
12
- seconds - The number of seconds.
13
- If no value is given, we'll wait for 1 second.
14
-
15
- RESULT
16
- None
17
-
18
- ERRORS
19
- None
20
-
21
- EXAMPLE
22
-
23
- > wait
24
- > wait 3
25
-
26
- > create x as int : 10
27
- > wait x
28
-
29
- SEE ALSO
@@ -1,264 +0,0 @@
1
- # Author:: Eric Crane (mailto:eric.crane@mac.com)
2
- # Copyright:: Copyright (c) 2019 Eric Crane. All rights reserved.
3
- #
4
- # Show the help information.
5
- #
6
-
7
- module GlooLang
8
- module Verbs
9
- class Help < GlooLang::Core::Verb
10
-
11
- KEYWORD = 'help'.freeze
12
- KEYWORD_SHORT = '?'.freeze
13
- DEFAULT_HELP = 'default_help'.freeze
14
- HELP_NOT_FOUND_ERR = 'Help command could not be found:'.freeze
15
-
16
- DISPATCH = {
17
- settings: 'show_settings',
18
- keywords: 'show_keywords',
19
- verb: 'show_verbs',
20
- verbs: 'show_verbs',
21
- v: 'show_verbs',
22
- obj: 'show_objs',
23
- object: 'show_objs',
24
- objects: 'show_objs',
25
- o: 'show_objs',
26
- topics: 'show_topics'
27
- }.freeze
28
-
29
- #
30
- # Run the verb.
31
- #
32
- def run
33
- opts = @tokens.second if @tokens
34
- opts = opts.strip.downcase if opts
35
-
36
- if opts
37
- dispatch opts
38
- else
39
- @engine.help.page_topic DEFAULT_HELP
40
- end
41
- end
42
-
43
- #
44
- # Get the text for the list of verbs.
45
- #
46
- def get_verb_list
47
- out = "Verbs:\n"
48
- str = ''
49
- verbs = @engine.dictionary.get_verbs.sort_by( &:keyword )
50
- verbs.each_with_index do |v, i|
51
- cut = v.keyword_shortcut.ljust( 5, ' ' )
52
- str << " #{cut} #{v.keyword.ljust( 20, ' ' )}"
53
- if ( ( i + 1 ) % 3 ).zero?
54
- out << "#{str}\n"
55
- str = ''
56
- end
57
- end
58
-
59
- return out
60
- end
61
-
62
- #
63
- # Lookup the opts in the dispatch table.
64
- #
65
- def lookup_opts( opts )
66
- return DISPATCH[ opts.to_sym ]
67
- end
68
-
69
- #
70
- # Get the text for the list of verbs.
71
- #
72
- def get_obj_list
73
- out = "Object Types:\n"
74
- str = ''
75
- objs = @engine.dictionary.get_obj_types.sort_by( &:typename )
76
- objs.each_with_index do |o, i|
77
- name = o.typename
78
- if o.short_typename != o.typename
79
- name = "#{name} (#{o.short_typename})"
80
- end
81
- str << " #{name.ljust( 30, ' ' )}"
82
- if ( ( i + 1 ) % 4 ).zero?
83
- out << "#{str}\n"
84
- str = ''
85
- end
86
- end
87
-
88
- return out
89
- end
90
-
91
- #
92
- # Get the list of help topics.
93
- #
94
- def get_topics
95
- out = "Help Topics:\n"
96
- str = ''
97
- objs = @engine.help.topics.keys.sort
98
- objs.each_with_index do |o, i|
99
- str << " #{o.ljust( 30, ' ' )}"
100
- if ( ( i + 1 ) % 4 ).zero?
101
- out << "#{str}\n"
102
- str = ''
103
- end
104
- end
105
-
106
- return out
107
- end
108
-
109
- #
110
- # Get the Verb's keyword.
111
- #
112
- def self.keyword
113
- return KEYWORD
114
- end
115
-
116
- #
117
- # Get the Verb's keyword shortcut.
118
- #
119
- def self.keyword_shortcut
120
- return KEYWORD_SHORT
121
- end
122
-
123
- # ---------------------------------------------------------------------
124
- # Private functions
125
- # ---------------------------------------------------------------------
126
-
127
- private
128
-
129
- #
130
- # Report an error with the inline help.
131
- #
132
- def report_help_error( opts )
133
- @engine.err "#{HELP_NOT_FOUND_ERR} '#{opts}'"
134
- end
135
-
136
- #
137
- # Dispatch the help to the right place.
138
- #
139
- def dispatch( opts )
140
- return if dispatch_help_page( opts )
141
-
142
- @engine.log.debug 'looking for built in help topic'
143
- cmd = DISPATCH[ opts.to_sym ]
144
- if cmd
145
- @engine.log.debug 'found help index'
146
- send cmd
147
- else
148
- @engine.log.debug 'looking for entity help'
149
- entity_help opts
150
- end
151
- rescue
152
- report_help_error opts
153
- end
154
-
155
- #
156
- # Dispatch to a help page if we can find one.
157
- #
158
- def dispatch_help_page( opts )
159
- if @engine.help.topic? opts
160
- @engine.log.debug 'found expanded help topic'
161
- @engine.help.page_topic opts
162
- return true
163
- end
164
-
165
- key = @engine.dictionary.lookup_keyword opts
166
- if @engine.help.topic? key
167
- @engine.log.debug 'found expanded help topic'
168
- @engine.help.page_topic key
169
- return true
170
- end
171
-
172
- return false
173
- end
174
-
175
- #
176
- # Write output to it and show it unless we are in
177
- # silent mode.
178
- #
179
- def show_output( out )
180
- @engine.heap.it.set_to out
181
- puts out unless @engine.args.quiet?
182
- end
183
-
184
- #
185
- # List all help topics (articles)
186
- #
187
- def show_topics
188
- out = self.get_topics
189
- show_output out
190
- end
191
-
192
- #
193
- # Dispatch the help command to a verb or object
194
- # if we can find one matching the request.
195
- #
196
- def entity_help( opts )
197
- return if try_verb_help opts
198
- return if try_object_help opts
199
-
200
- report_help_error opts
201
- end
202
-
203
- #
204
- # See if there is a verb we can show help
205
- # information about.
206
- #
207
- def try_verb_help( opts )
208
- if @engine.dictionary.verb?( opts )
209
- t = @engine.dictionary.find_verb( opts )
210
- out = t.send 'help'
211
- show_output out
212
- return true
213
- end
214
-
215
- return false
216
- end
217
-
218
- #
219
- # See if there is a verb we can show help
220
- # information about.
221
- #
222
- def try_object_help( opts )
223
- if @engine.dictionary.obj?( opts )
224
- t = @engine.dictionary.find_obj( opts )
225
- out = t.send 'help'
226
- show_output out
227
- return true
228
- end
229
-
230
- return false
231
- end
232
-
233
- #
234
- # Show application settings.
235
- #
236
- def show_settings
237
- @engine.settings.show
238
- end
239
-
240
- #
241
- # Show all keywords: verbs and objects.
242
- #
243
- def show_keywords
244
- @engine.dictionary.show_keywords
245
- end
246
-
247
- #
248
- # List the verbs
249
- #
250
- def show_verbs
251
- show_output get_verb_list
252
- end
253
-
254
- #
255
- # List the object types
256
- #
257
- def show_objs
258
- out = self.get_obj_list
259
- show_output out
260
- end
261
-
262
- end
263
- end
264
- end