rye 0.8.19 → 0.9.0

data/CHANGES.txt

@@ -1,5 +1,21 @@
 RYE, CHANGES
 
+
+#### 0.9.0 (2010-08-19) #############################
+
+* FIXED: Pubkeys correctly added for first connection. 
+  (NOTE: some state seems to be maintained by ssh-agent)
+* ADDED: Interactive and non-interactive shell support (via Net::SSH)
+* ADDED: Basic readline support for interactive mode
+* ADDED: New hook for printing STDOUT as it is returned
+* CHANGE: Removed bin/rye
+* CHANGE: Removed authorize_keys_remote and authorize_keys_local
+
+
+#### 0.8.20 (2010-08-17) #############################
+
+* ADDED: string_append, template_write, template_upload, file_modify
+
 #### 0.8.19 (2010-06-28) #############################
 
 * ADDED: Rye::Box#root?
@@ -307,7 +323,7 @@ Rye.shell and Rye::Box.run_command (SSH) commands.
 * ADDED: Command switches can now be sent as Symbols (rbox.ls(:h))
 * ADDED: Rye.host_keys
 * ADDED: bin/rye
-* ADDED: commands now raise a Rye::CommandError exception 
+* ADDED: commands now raise a Rye::Err exception 
   when the command returns an exit code greater than 0. 
 * CHANGE: Box.add_command renamed to Box.run_command
 

data/README.rdoc

@@ -11,33 +11,6 @@ Rye is a Ruby abstraction for executing shell commands via SSH. By default, Rye
 
 Rye does not require anything to be installed on the server side (other than an SSH daemon) so it can be run from any machine with Ruby, OpenSSL, and OpenSSH.
 
-=== SSH keys
-
-You need SSH keys to use Rye. After installing Rye, you can check if you have any by running:
-
-    $ rye
-
-If you get the message <i>"The agent has no identities"</i> you will need to generate a keypair.
-
-    $ ssh-keygen
-
-
-=== Passwordless SSH authorization
-
-The easiest way to work with Rye is to authorize your remote accounts for passwordless logins (otherwise you'll be prompted for a password for every connection). 
-
-Enable passwordless logins to remote HOST1 and HOST2:
-
-    $ rye authorize HOST1 HOST2    
-
-This will copy your public SSH keys to the <tt>~/.ssh/authorized_keys</tt> and <tt>~/.ssh/authorized_keys2</tt> files on the remote machine(s). 
-
-Enable passwordless logins to the local machine:
-
-    $ rye authorize-local
-
-See <tt>rye -h</tt> for more info.
-
 
 == Example 1 -- Execute commands on a remote machine
 
@@ -53,7 +26,7 @@ The return value for a command is a modified Array containing the contents of ST
 
     ret = rbox.uptime                      # => "11:02  up 16:01, 3 users"
     ret.stderr                             # => []
-    ret.exit_code                          # => 0
+    ret.exit_status                          # => 0
     ret.stdout                             # => "11:02  up 16:01, 3 users"
     ret.stdout.class                       # => Array
     ret.class                              # => Rye::Rap
@@ -161,7 +134,7 @@ The first argument must be the command name and the remaining arguments are sent
 The return value is a Rye::Rap object (just like with Rye::Box) so you have access to the exit code and STDERR output:
 
     ret = Rye.shell :ls, 'nofile'
-    ret.exit_code        # => 1
+    ret.exit_status        # => 1
     ret.stderr           # => "sh: nofile: No such file or directory"
     ret.class            # => Rye::Rap
 

data/bin/try

@@ -1,4 +1,5 @@
 #!/usr/bin/ruby
+# encoding: UTF-8
 
 # Rye -- A working example
 #
@@ -61,8 +62,8 @@ rbox_wild = Rye::Box.new('localhost', :safe => false)
 # arguments are thoroughly escaped. This prevents access to
 # environment variables and file globs (among other things).
 p rbox_safe.echo('$HOME')                                    # => "$HOME"
-p rbox_safe['/etc'].ls('host*')  rescue Rye::CommandError    # Doesn't exist
-p rbox_safe.ls('-l | wc -l')     rescue Rye::CommandError    # => '|' is not a valid ls arg
+p rbox_safe['/etc'].ls('host*')  rescue Rye::Err    # Doesn't exist
+p rbox_safe.ls('-l | wc -l')     rescue Rye::Err    # => '|' is not a valid ls arg
 
 # Here's the same commands with safe-mode disabled:
 p rbox_wild.echo('$HOME')                   # => "/home/rye"
@@ -82,7 +83,7 @@ rbox = Rye::Box.new('localhost')
 rbox.add_keys('/private/key/path')   # Specify additional private keys
 
 # There's currently no rye900 command
-p rbox.commands.member?('rye9000')   # => false
+p rbox.command?('rye9000')   # => false
 
 # But we can add our own commands to the Rye::Cmd class. They 
 # automatically become available to all Rye::Box objects.
@@ -97,7 +98,7 @@ end
 
 # We can now run rye9000 (with arguments)
 p rbox.rye9000('-a')                 # => [".", "..", ".bashrc", ...]
-p rbox.commands.member?('rye9000')   # => true
+p rbox.command?('rye9000')           # => true
 
 
 puts %Q(
@@ -146,12 +147,12 @@ puts %Q(
 rbox = Rye::Box.new('localhost', :safe => false) # Note: safe mode is off
 
 # Rye follows the standard convention of taking exception to a non-zero 
-# exit code by raising a Rye::CommandError. In this case, rye9000.test
+# exit code by raising a Rye::Err. In this case, rye9000.test
 # is not found by the ls command.
 begin
   rbox.ls('rye.test')
-rescue Rye::CommandError => ex
-  puts ex.exit_code                  # => 1
+rescue Rye::Err => ex
+  puts ex.exit_status                  # => 1
   puts ex.stderr                     # => ls: rye.test: No such file or directory
 end
 
@@ -164,7 +165,7 @@ puts rbox.uname('-a 1>&2').stdout    # =>
 puts rbox.uname('-a 1>&2').stderr    # => Darwin ryehost 9.6.0 ...
 
 # There were no actual errors so the exit code should be 0.
-puts rbox.uname('-a 1>&2').exit_code # => 0
+puts rbox.uname('-a 1>&2').exit_status # => 0
 
 
 puts %Q(
@@ -172,10 +173,10 @@ puts %Q(
 #   EXAMPLE 6 -- FILE TRANSFERS
 #)
 
-dir_upload = "#{Rye.sysinfo.tmpdir}/rye-upload/"
-dir_download = "#{Rye.sysinfo.tmpdir}/rye-download/"
+dir_upload = "#{Rye.sysinfo.tmpdir}rye-upload"
+dir_download = "#{Rye.sysinfo.tmpdir}rye-download"
 
-rbox = Rye::Box.new("localhost", :info => false)
+rbox = Rye::Box.new("localhost", :info => STDOUT)
 
 # Rye ships without an rm method (for safety!). Here 
 # we add the rm method only to this instance of rbox.
@@ -201,7 +202,33 @@ p filecontent.read
 
 puts %Q(
 # ------------------------------------------------------------------
-#   EXAMPLE 7 -- LOCAL PROCESSES
+#   EXAMPLE 7 -- FILE TRANSFERS w/ VARIABLE INTERPOLATION
+#)
+
+dir_upload = "#{Rye.sysinfo.tmpdir}rye-upload"
+dir_download = "#{Rye.sysinfo.tmpdir}rye-download"
+
+rbox = Rye::Box.new("localhost", :info => STDOUT)
+
+# Rye ships without an rm method (for safety!). Here 
+# we add the rm method only to this instance of rbox.
+def rbox.rm(*args); __allow('rm', args); end
+
+rbox.rm(:r, :f, dir_upload) # Silently delete test dirs
+rbox.rm(:r, :f, dir_download)
+
+template = StringIO.new("Can we use templates? <%= 'Yes!' %>")
+rbox.mkdir dir_upload
+
+rbox.template_write("#{dir_upload}/template.txt", template)
+
+p rbox.ls(dir_upload)                      # => [template.txt]
+p rbox.cat("#{dir_upload}/template.txt")   # => "Can we use templates? Yes!"
+
+
+puts %Q(
+# ------------------------------------------------------------------
+#   EXAMPLE 8 -- LOCAL PROCESSES
 #)
 
 p Rye.shell :uptime
@@ -210,8 +237,10 @@ p Rye.shell :ls, '*'
 p Rye.shell :ls, '-l $HOME'
 p Rye.shell :ls, :l, '$HOME > crazy.txt'
 
+Rye.shell :rm, 'crazy.txt'
+
 ret = Rye.shell :ls, 'nofile'
-p ret.exit_code                      # => 1
+p ret.exit_status                    # => 1
 p ret.stderr                         # => "sh: nofile: No such file or directory"
 p ret.class                          # => Rye::Rap