gloo-lang 0.9.2 → 0.9.3

data/lib/gloo_lang/help/objs/data/sqlite.txt

@@ -0,0 +1,26 @@
+SYSTEM OBJECT TYPE
+  NAME: sqlite
+  SHORTCUT: sqlite
+
+  DESCRIPTION
+    A Sqlite3 database connection.
+
+  CHILDREN
+    database - string - 'test.db'
+      The path to the database file.
+
+  MESSAGES
+    verify - Verify that the database connection can be established.
+
+  EXAMPLE
+
+    sqlite [can] :
+      on_load [script] : run sqlite.sql
+      db [sqlite] :
+        database : test.db
+      sql [query] :
+        database [alias] : sqlite.db
+        sql : SELECT id, key, value FROM key_values
+
+  SEE ALSO
+    query, mysql

data/lib/gloo_lang/help/objs/data/table.txt

@@ -0,0 +1,46 @@
+TABLE OBJECT TYPE
+  NAME: table
+  SHORTCUT: tbl
+
+  DESCRIPTION
+    A data table.
+
+  CHILDREN
+    headers - container
+      A list of headers.
+      The name of the header object needs to be the same as the
+      name of the object in the data container.
+      The value of the header is what will be displayed.
+    data - container
+      The table's data.
+      The data container will have one or more containers, each
+      of which represents one row of data.
+
+  MESSAGES
+    show - Show the contents of the table in the CLI.
+
+  EXAMPLE
+
+    t [tbl] :
+    	on_load [script] :
+    		tell t to show
+    	headers [can] :
+        name : Name
+        phone : Tel
+        notes : Notes
+    	data [alias] : table_data
+    table_data [can] :
+      1 [can] :
+        name : Joe
+        phone : 312-555-1212
+        notes : Play golf with Joe
+      2 [can] :
+        name : Sally
+        phone : 708-555-1212
+        notes : met Sally at the meetup last week
+      3 [can] :
+        name : Frank
+        phone : 312-555-1213
+        notes : Frank Lee Speaking
+
+  SEE ALSO

data/lib/gloo_lang/help/objs/dev/git_repo.txt

@@ -0,0 +1,36 @@
+GIT OBJECT TYPE
+  NAME: git_repo
+  SHORTCUT: git
+
+  DESCRIPTION
+    Reference to a git repository in the file system.
+    The value of the git_repo object is a string.
+    There are no children needed.
+
+  CHILDREN
+    None
+
+  MESSAGES
+    validate - Validate that this is a git repo.
+    check_changes - Check to see if there are any pending changes.
+    get_changes - Get the list of pending changes.
+    commit - Commit changes.
+    get_branch - Get the current branch.
+    review - Review pending changes.
+
+  EXAMPLE
+
+    changes [can] :
+    	on_load [script] :
+    		show "Finding repos with local changes..."
+    		put $.user.home + "/dev" into changes.for.in
+    		run changes.for
+    		show  "Done."
+    	for [each] :
+    		repo [git] :
+    		in [string] :
+    		do [script] :
+    			tell changes.for.repo to check_changes
+    			if it then show changes.for.repo
+
+  SEE ALSO

data/lib/gloo_lang/help/objs/dev/stats.txt

@@ -0,0 +1,36 @@
+GIT OBJECT TYPE
+  NAME: stats
+  SHORTCUT: stats
+
+  DESCRIPTION
+    Development project statistics.
+
+  CHILDREN
+    folder - file
+      The project's root folder.
+    types - string
+      The list of code file types.
+      We'll use this to count lines of code and to find the
+      longest files.
+      The list is a string of space-delimited file extensions.
+      For example:  rb erb js
+    skip - string
+      List of files or folders we'll skip while building stats.
+      For example: .git tmp
+
+  MESSAGES
+    show_all - Show all project statistics
+    show_busy_folders - Show a list of folders with the most files
+    show_types - Show file types and counts
+
+  EXAMPLE
+
+    main [can] :
+      stats [stats] :
+        folder [file] : /Users/me/dev/project
+        types [string] : rb erb js
+        skip [string] : .git tmp
+      on_load [script] :
+        tell main.stats to show_all
+
+  SEE ALSO

data/lib/gloo_lang/help/objs/dt/date.txt

@@ -0,0 +1,23 @@
+DATE OBJECT TYPE
+  NAME: date
+  SHORTCUT: date
+
+  DESCRIPTION
+    A reference to a date, but without time.
+
+  CHILDREN
+    None
+
+  MESSAGES
+    now - Set to the current system date.
+
+  EXAMPLE
+
+    time [can] :
+    	t [time] :
+    	on_load [script] :
+    		tell time.t to now
+    		show time.t
+
+  SEE ALSO
+    datetime, time

data/lib/gloo_lang/help/objs/dt/datetime.txt

@@ -0,0 +1,24 @@
+DATETIME OBJECT TYPE
+  NAME: datetime
+  SHORTCUT: dt
+
+  DESCRIPTION
+    A reference to a date and time.
+
+  CHILDREN
+    None
+
+  MESSAGES
+    now - Set to the current system date and time.
+
+  EXAMPLE
+
+    dt [can] :
+    	d [datetime] :
+    	on_load [script] :
+    		tell dt.d to now
+    		show dt.d
+      next [script] : put '1 week from now' into dt.d
+
+  SEE ALSO
+    date, time

data/lib/gloo_lang/help/objs/dt/time.txt

@@ -0,0 +1,23 @@
+TIME OBJECT TYPE
+  NAME: time
+  SHORTCUT: time
+
+  DESCRIPTION
+    A reference to a time, but without a date.
+
+  CHILDREN
+    None
+
+  MESSAGES
+    now - Set to the current system time.
+
+  EXAMPLE
+
+    date [can] :
+      d [date] :
+      on_load [script] :
+        tell date.d to now
+        show date.d
+
+  SEE ALSO
+    date, datetime

data/lib/gloo_lang/help/objs/ror/erb.txt

@@ -0,0 +1,37 @@
+ERB OBJECT TYPE
+  NAME: erb
+  SHORTCUT: erb
+
+  DESCRIPTION
+    Use the ERB templating system to generate content.
+
+  CHILDREN
+    template - text
+      The template that will be used the the ERB object is run.
+    params - container
+      The collection of children values that will be used
+      when the template object is rendered.
+    result - text
+      The result of the template rendering.
+
+  MESSAGES
+    run - Render the result based on the template and the
+          parameter values.
+
+  EXAMPLE
+
+    e [can] :
+    	erb [erb] :
+    		template [text] : BEGIN
+    			Hello <%= first %> <%= last %>!
+    			END
+    		params [container] :
+    			first [string] : Eric
+    			last [string] : Crane
+    		result [text] :
+    	on_load [script] :
+    		run e.erb
+    		show e.erb.result
+
+  SEE ALSO
+    eval, system, execute

data/lib/gloo_lang/help/objs/ror/eval.txt

@@ -0,0 +1,24 @@
+EVAL OBJECT TYPE
+  NAME: eval
+  SHORTCUT: ruby
+
+  DESCRIPTION
+    Execute a ruby expression.
+
+  CHILDREN
+    command - string
+      The ruby expression or command that will be run.
+    result - string
+      The result of the command or expression after it is run.
+
+  MESSAGES
+    run - Execute the ruby command and update the result.
+
+  EXAMPLE
+
+    eval [ruby] :
+      command [string] : 3 * 7
+  	  result [string] : 21
+
+  SEE ALSO
+    system, erb, execute

data/lib/gloo_lang/help/objs/snd/play.txt

@@ -0,0 +1,23 @@
+PLAY OBJECT TYPE
+  NAME: play
+  SHORTCUT: play
+
+  DESCRIPTION
+    Play an audio file, an MP3 for example.
+    The value of the play object is the path to the audio file.
+
+  CHILDREN
+    None.
+
+  MESSAGES
+    run - Play the audio file.
+
+  EXAMPLE
+
+    play [can] :
+    	snd [play] : ~/path/to/snd.mp3
+    	on_load [script] :
+    		run play.snd
+
+  SEE ALSO
+    say, beep

data/lib/gloo_lang/help/objs/snd/say.txt

@@ -0,0 +1,28 @@
+SAY OBJECT TYPE
+  NAME: say
+  SHORTCUT: say
+
+  DESCRIPTION
+    Use the Mac text to speech function to convert text to audio.
+    From the Mac CLI, run this to get a list of voices:
+      say -v '?'
+
+  CHILDREN
+    voice - string
+      The Voice to use.  If left blank, the default voice will be used.
+    message - string - 'talk to me'
+      The message to speak.
+
+  MESSAGES
+    run - Speak the message, optionally in the voice specified.
+
+  EXAMPLE
+
+    say [say] :
+    	voice [string] : Moira
+    	message [string] : So long, and thanks for all the fish!
+    	on_load [script] :
+    		tell say to run
+
+  SEE ALSO
+    play, beep

data/lib/gloo_lang/help/objs/system/file.txt

@@ -0,0 +1,48 @@
+FILE OBJECT TYPE
+  NAME: file
+  SHORTCUT: dir
+
+  DESCRIPTION
+    Reference to a file or folder (directory) on disk.
+    The string value of the file object is the path and name
+    of the file.
+
+  CHILDREN
+    None.
+
+  MESSAGES
+    read <into.obj> - Read file and put data in the specified object.
+      If the <into.obj> is not specified, the data will be in <it>.
+    write <from.obj> - Write the data in the <from.object> into
+      the file.
+    show - Show the contents of the file.
+    page - Show the contents of the file, paginated
+    open - Open the file with the default application for the type.
+    check_exists - Check to see if the file exists.
+      <It> will be true or false.
+    check_is_file - Check to see if the file specified is a
+      regular file.  <It> will be true or false.
+    check_is_dir - Check to see if the file specified is a
+      diretory.  <It> will be true or false.
+    find_match - Look for the existence of a file matching
+      the file's pattern.  <It> will be true or false.
+
+  EXAMPLE
+
+    exists [can] :
+    	f [file] : /Users/me/tmp
+    	on_load [script] :
+    		show "Checking to see if file exists:  " + exists.f
+    		tell exists.f to check_exists
+    		show it
+    		tell exists.f to check_is_dir
+    		show "is a directory?  " + it
+    		tell exists.f to check_is_file
+    		show "is a file?  " + it
+
+    f [file] : /Users/me/gloo/*.gemspec
+    pattern [script] :
+      tell f to find_match
+      show it
+
+  SEE ALSO

data/lib/gloo_lang/help/objs/system/ssh_exec.txt

@@ -0,0 +1,30 @@
+SYSTEM OBJECT TYPE
+  NAME: ssh_exec
+  SHORTCUT: ssh
+
+  DESCRIPTION
+    Open an SSH session to host and execute a system command.
+
+  CHILDREN
+    host - string - 'localhost'
+      The remote host to which to open a connection.
+      The object assumes that the user has password-less SSH
+      set up to the remote host.
+    cmd - string
+      The command to execute on the remote system.
+    result - string
+      The result of running the command.
+
+  MESSAGES
+    run - Open the connection and execute the command.
+      Set the result value to the output of the command.
+
+  EXAMPLE
+
+    remote [ssh_exec] :
+      host [string] : localhost
+      cmd [string] : hostname
+      result [string] :
+
+  SEE ALSO
+    execute, system

data/lib/gloo_lang/help/objs/system/system.txt

@@ -0,0 +1,32 @@
+SYSTEM OBJECT TYPE
+  NAME: system
+  SHORTCUT: sys
+
+  DESCRIPTION
+    Execute a system command.
+
+  CHILDREN
+    command - string - 'date'
+      The command that will be sent to the system.
+    get_output - boolean - true
+      Should executing the command get the output and put it
+      in the result object?
+    result - string
+      The result of running the command.
+      The result will only be set if the 'get_output' child
+      is set to true.
+
+  MESSAGES
+    run - Run the system level command.
+      Set the result value to the output of the command if the
+      'get_output' child is marked as true.
+
+  EXAMPLE
+
+    date [system] :
+      command [string] : date
+      get_output [bool] : true
+      result [string] :
+
+  SEE ALSO
+    execute, eval, erb

data/lib/gloo_lang/help/objs/web/http_get.txt

@@ -0,0 +1,35 @@
+HTTP_GET OBJECT TYPE
+  NAME: http_get
+  SHORTCUT: get
+
+  DESCRIPTION
+    Perform an HTTP Get.
+
+  CHILDREN
+    uri - string - 'https://web.site/'
+      The URI for the HTTP Get request.
+    params - container
+      Collection of parameters for the HTTP Get.
+    result - string
+      The result of the request.  Whatever was returned from
+      the HTTP Get call.
+    skip_ssl_verify - boolean (optional)
+      Skip the SSL verification as part of the request.
+
+  MESSAGES
+    run - Run the HTTP Get and update the result.
+
+  EXAMPLE
+
+    g [http_get] :
+    	uri [string] : http://api.sunrise-sunset.org/json
+    	params [container] :
+    		lat [string] : 36.7201600
+    		lng [string] : -4.4203400
+    		date [string] : today
+    	result [string] :
+
+    > run g
+
+  SEE ALSO
+    http_post, json, uri

data/lib/gloo_lang/help/objs/web/http_post.txt

@@ -0,0 +1,34 @@
+HTTP_POST OBJECT TYPE
+  NAME: http_post
+  SHORTCUT: post
+
+  DESCRIPTION
+    Perform an HTTP Post.
+
+  CHILDREN
+    uri - string - 'https://web.site/'
+      The URI for the HTTP Post.
+    body - container
+      Collection of parameters for the HTTP Post.
+    result - string - Optional parameter
+      The result of the request.  Whatever was returned in the body
+      of the HTTP POST.
+    skip_ssl_verify - boolean (optional)
+      Skip the SSL verification as part of the request.
+
+  MESSAGES
+    run - Run the HTTP Post sending the body data to the
+      endpoint specified in the URI.
+
+  EXAMPLE
+
+    post [post] :
+      txt [str] : Message from gloo!
+    	uri [str] : https://my.service.com/my-long-token
+    	body [can] :
+    		text [alias] : post.txt
+    		username [str] : me
+    	on_load [script] : run post
+
+  SEE ALSO
+    http_get, json, uri

data/lib/gloo_lang/help/objs/web/json.txt

@@ -0,0 +1,34 @@
+JSON OBJECT TYPE
+  NAME: json
+  SHORTCUT: json
+
+  DESCRIPTION
+    JSON data in a text string.
+
+  CHILDREN
+    None
+
+  MESSAGES
+    get - get a value from the JSON data
+      Example: tell myjson to get ("title")
+      The additional parameter is the path to the value.
+    parse - parse the JSON data and put values in the
+      object specified by the additional parameter
+      Example: tell myjson to parse ("path.to.objects")
+    pretty - make the JSON format pretty
+
+  EXAMPLE
+
+    json [can] :
+      on_load [script] :
+        list json.objs
+        show json.j
+        tell json.j to parse (json.objs)
+        list json.objs
+      j [json] : {"title":"Brute Force","quotation":"When in doubt, use brute force.","author":"Eric Steven Raymond","source":"The Art of Unix Programming"}
+      objs [can] :
+        title [string] :
+        quotation [string] :
+
+  SEE ALSO
+    http_get, http_post, uri

data/lib/gloo_lang/help/objs/web/slack.txt

@@ -0,0 +1,33 @@
+SLACK OBJECT TYPE
+  NAME: slack
+  SHORTCUT: slack
+
+  DESCRIPTION
+    Send message to channel in Slack.
+
+  CHILDREN
+    uri - string - 'https://hooks.slack.com/services/...'
+      The URI with access to the Slack channel.
+    message - string - 'textual message'
+      Message to send to Slack.
+    username - string - 'Slack Bot'
+      Attribute the message to this user.
+    channel - string - 'general'
+      The name of the channel for the post.
+    icon_emoji - string - ':ghost:'
+      The emoji to use for the attribution.
+
+  MESSAGES
+    run - Post the message to Slack.
+
+  EXAMPLE
+
+    slack [slack] :
+    	uri [string] : https://hooks.slack.com/services/MYTOKEN
+    	message [string] : Slackbot is here to help!
+    	username [string] : SlackBot
+    	channel [string] : general
+    	icon_emoji [string] : :ghost:
+
+  SEE ALSO
+    http_get, http_post, json, uri

data/lib/gloo_lang/help/objs/web/teams.txt

@@ -0,0 +1,30 @@
+TEAMS OBJECT TYPE
+  NAME: teams
+  SHORTCUT: team
+
+  DESCRIPTION
+    Send message to channel in Teams.
+
+  CHILDREN
+    uri - string - 'https://outlook.office.com/webhook/...'
+      The URI with access to the Teams channel.
+    title - string
+      Message title; header.
+    color - string - '008000'
+      Color theme for the message.
+    message - string
+      The message to post in Teams.
+
+  MESSAGES
+    run - Post the message to Teams.
+
+  EXAMPLE
+
+    team [teams] :
+    	uri [string] : https://outlook.office.com/webhook/MYTOKEN/IncomingWebhook/MYTOKEN
+    	title [string] : Success
+    	color [string] : 008000
+    	message [string] : This worked!
+
+  SEE ALSO
+    http_get, http_post, json, uri

data/lib/gloo_lang/help/objs/web/uri.txt

@@ -0,0 +1,38 @@
+URI OBJECT TYPE
+  NAME: uri
+  SHORTCUT: url
+
+  DESCRIPTION
+    A URI or URL.
+
+  CHILDREN
+    None
+
+  MESSAGES
+    open - open the URL in the default browser
+    get_scheme - get the URI scheme; example:  http
+    get_host - get the URI host; example:  google.com
+    get_path - get the URI resource path; example:  /post
+    get_query - get the URI query parameters; example:  id=121
+    get_fragment - get the URI fragment
+    get_cert_expires - get the web site's certificate expiration date
+
+  EXAMPLE
+
+    url [can] :
+      on_load [script] :
+        tell url.u to get_scheme
+        show "scheme: " + it
+
+        tell url.u to get_host
+        show "host: " + it
+
+        tell url.u to get_path
+        show "path: " + it
+
+        show "opening URL: " + url.u
+        tell url.u to open
+      u [uri] : https://my.url/path/1234
+
+  SEE ALSO
+    http_get, http_post, json

data/lib/gloo_lang/help/verbs/alert.txt

@@ -0,0 +1,33 @@
+ALERT VERB
+  NAME: alert
+  SHORTCUT: !
+
+  DESCRIPTION
+    Show a pop-up notification.
+    This has only been implemented for the Mac OS X as of yet.
+
+  SYNTAX
+    alert <messsage>
+
+  PARAMETERS
+    messsage - The message that will be displayed in the alert.
+
+  RESULT
+    On the Mac, a notification will popup on screen.
+    <it> will be set to the message.
+
+  ERRORS
+    Missing Expression!
+      - No expression is provided as parameter to the verb.
+    Expression evaluated with no result!
+      - Expression is provided but evaluates to nil.
+
+  EXAMPLE
+
+    > create s as string : "boo"
+    > alert s
+
+    > alert "important message!"
+
+  SEE ALSO
+    show