gloo 1.0.0 → 1.1.0

data/lib/gloo/help/objs/cli/prompt.txt

@@ -1,27 +0,0 @@
-PROMPT OBJECT TYPE
-  NAME: prompt
-  SHORTCUT: ask
-
-  DESCRIPTION
-    CLI prompt for user input.
-
-  CHILDREN
-    prompt - string - '> '
-      The prompt displayed to the user.
-    result - string - none
-      The result with the user's input.
-
-  MESSAGES
-    run - Prompt the user and then set the result.
-    multiline - Show a multiline prompt.
-
-  EXAMPLE
-
-    ask [ask] :
-    	prompt [string] : What is your name?
-    	result [string] :
-    	on_load [script] :
-    		run ask
-    		show 'Hello, ' + ask.result + '!  Thanks for playing'
-
-  SEE ALSO

data/lib/gloo/help/objs/cli/select.txt

@@ -1,34 +0,0 @@
-SELECT OBJECT TYPE
-  NAME: select
-  SHORTCUT: sel
-
-  DESCRIPTION
-    Prompt for user to select from a list of options.
-
-  CHILDREN
-    prompt - string - '> '
-      The prompt displayed to the user.
-    options - container
-      The list of options for the selection list.
-      The name of each option will be presented to the user, but
-      the value will be put in the result.
-    result - string - none
-      The result with the user's selection.
-
-  MESSAGES
-    run - Prompt the user for a selection and then set the result.
-
-  EXAMPLE
-
-    select [select] :
-    	prompt [string] : What is your favorite color?
-      options [can] :
-        red : r
-        green : g
-        blue : b
-    	result [string] :
-    	on_load [script] :
-    		run select
-    		show select.result
-
-  SEE ALSO

data/lib/gloo/help/objs/ctrl/each.txt

@@ -1,48 +0,0 @@
-EACH OBJECT TYPE
-  NAME: each
-  SHORTCUT: each
-
-  DESCRIPTION
-    Perform an action for each item in a collection.
-
-  CHILDREN
-    child | word | line | repo - string - none
-      The entity we want to loop for.
-      It will hold the current value while the script is running.
-    in - string - none
-      The collection we will iterate in.
-      In the case of <word> or <line> this will be a string or text.
-      In the case of <repo> this will be the root path.
-    do - script - none
-      The action we want to perform for each found item.
-
-  MESSAGES
-    run - Look through the collecion and perform this for each
-      found item.
-
-  EXAMPLE
-
-    #
-    # Show each child in a container.
-    #
-
-    for [each] :
-    	child [alias] :
-    	in [alias] : objs
-    	do [script] : show for.child
-    objs [can] :
-      1 [string] : one
-      2 [string] : two
-      3 [string] : three
-
-    #
-    # Show each word in a string.
-    #
-
-    for [each] :
-    	word [string] :
-    	in [string] : one word at a time
-    	do [script] : show for.word
-
-
-  SEE ALSO

data/lib/gloo/help/objs/ctrl/repeat.txt

@@ -1,38 +0,0 @@
-REPEAT OBJECT TYPE
-  NAME: repeat
-  SHORTCUT: repeat
-
-  DESCRIPTION
-    Run a script a given number of times.
-
-  CHILDREN
-    times integer - 0
-      The number of times to run the script.
-    index integer - 0
-      The current iteration when the repeat loop is running.
-    do - script - none
-      The action we want to perform for iteration of the loop.
-
-  MESSAGES
-    run - Run the script for the given number of times.
-
-  EXAMPLE
-
-    repeat [can] :
-      s [string] :
-      on_load [script] :
-        put $.screen_cols / 2 into repeat.x.times
-        tell repeat.x to run
-        show repeat.s
-        tell repeat.y to run
-        show repeat.s
-      x [repeat] :
-        times [integer] : 30
-        index [integer] : 0
-        do [script] : put repeat.s + '-' into repeat.s
-      y [repeat] :
-        times [integer] : 10
-        index [integer] : 0
-        do [script] : show repeat.y.index
-
-  SEE ALSO

data/lib/gloo/help/objs/data/markdown.txt

@@ -1,25 +0,0 @@
-MARKDOWN OBJECT TYPE
-  NAME: markdown
-  SHORTCUT: md
-
-  DESCRIPTION
-    Markdown data in a text string.
-
-  CHILDREN
-    None
-
-  MESSAGES
-    show - Show the markdown data in the terminal.
-    page - Show the markdown data in the terminal, paginated.
-
-  EXAMPLE
-
-    md [can] :
-      f [file] : 
-      on_load [script] :
-        put $.gloo.projects + "/o/data/txt.md" into md.f
-        tell md.f to read (md.data)
-    		tell md.data to show
-    	data [md] :
-
-  SEE ALSO

data/lib/gloo/help/objs/data/mysql.txt

@@ -1,40 +0,0 @@
-SYSTEM OBJECT TYPE
-  NAME: mysql
-  SHORTCUT: mysql
-
-  DESCRIPTION
-    A MySQL database connection.
-
-  CHILDREN
-    host - string
-      The database server host
-    database - string
-      The name of the database.
-    username - string
-      The username with which to connect.
-    pasword - string
-      The user's password.
-
-  MESSAGES
-    verify - Verify that the database connection can be established.
-
-  EXAMPLE
-
-    mysql [can] :
-      on_load [script] :
-        run mysql.get_passwd
-        run mysql.sql
-      db [mysql] :
-        host : localhost
-        database : my_database
-        username : my_user
-        password [alias] : mysql.get_passwd.result
-      sql [query] :
-        database [alias] : mysql.db
-        sql : SELECT first, last, phone FROM people
-      get_passwd [ask] :
-        prompt [string] : Database Password?
-        result [string] :
-
-  SEE ALSO
-    query, sqlite

data/lib/gloo/help/objs/data/query.txt

@@ -1,37 +0,0 @@
-SYSTEM OBJECT TYPE
-  NAME: query
-  SHORTCUT: sql
-
-  DESCRIPTION
-    A SQL Query.
-    A SELECT, INSERT, UPDATE or other SQL statement.
-    The query requires a valid database connection.
-
-  CHILDREN
-    database - string
-      The name of the database.
-    sql - string
-      The SQL query to execute.
-    result - container
-      The result of the query will be a container for each row,
-      with an object for each column.
-      The result container is optional.  If it is not present,
-      the results will be displayed in the console.
-    params - container
-      Optional list of parameters for the query.
-
-  MESSAGES
-    run - Run the query and get back the data.
-
-  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
-    mysql, sqlite

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

@@ -1,26 +0,0 @@
-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/help/objs/data/table.txt

@@ -1,46 +0,0 @@
-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/help/objs/dev/git_repo.txt

@@ -1,36 +0,0 @@
-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/help/objs/dev/stats.txt

@@ -1,36 +0,0 @@
-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/help/objs/dt/date.txt

@@ -1,23 +0,0 @@
-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/help/objs/dt/datetime.txt

@@ -1,24 +0,0 @@
-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/help/objs/dt/time.txt

@@ -1,23 +0,0 @@
-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/help/objs/ror/erb.txt

@@ -1,37 +0,0 @@
-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/help/objs/ror/eval.txt

@@ -1,24 +0,0 @@
-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/help/objs/snd/play.txt

@@ -1,23 +0,0 @@
-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/help/objs/snd/say.txt

@@ -1,28 +0,0 @@
-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/help/objs/system/file.txt

@@ -1,48 +0,0 @@
-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/help/objs/system/ssh_exec.txt

@@ -1,30 +0,0 @@
-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