Adding the "ralsh" executable (formerly known as x2puppet).

git-svn-id: https://reductivelabs.com/svn/puppet/trunk@2322 980ebf18-57e1-0310-9a29-db15c13687c0

3 files changed, 153 insertions, 1 deletions

diff --git a/CHANGELOG b/CHANGELOG
index 6ca0dc2f0..e8b7b810c 100644
--- a/CHANGELOG
+++ b/CHANGELOG
@@ -1,4 +1,7 @@
 0.22.2 (grover)
+    Added 'ralsh' (formerly x2puppet) to the svn tree.  When possible it
+    should be added to the packages.
+
     The 'notify' type now defaults to its message being the same as its name.
 
     Reopening $stdin to read from /dev/null during execution, in hopes that
diff --git a/Rakefile b/Rakefile
index 2fd73af57..de80684ac 100644
--- a/Rakefile
+++ b/Rakefile
@@ -28,7 +28,7 @@ project = Rake::RedLabProject.new("puppet") do |p|
         'examples/**/*',
         'conf/**/*'
     ]
-    p.filelist.exclude("bin/pi")
+    p.filelist.exclude("bin/pi", "bin/ralsh")
 
     p.add_dependency('facter', '1.1.0')
 
diff --git a/bin/ralsh b/bin/ralsh
new file mode 100755
index 000000000..5424c5d29
--- /dev/null
+++ b/bin/ralsh
@@ -0,0 +1,149 @@
+#!/usr/bin/env ruby
+#
+# = Synopsis
+#
+# Use the Puppet RAL to directly interact with the system.
+#
+# = Usage
+#
+#   ralsh [-h|--help] [-e|--edit] type <name>
+#
+# = Description
+#
+# This command provides simple facilities for converting current system state
+# into Puppet code, along with some ability to use Puppet to affect the current
+# state.
+#
+# By default, you must at least provide a type to list, which case ralsh
+# will tell you everything it knows about all instances of that type.  You can
+# optionally specify an instance name, and ralsh will only describe that single
+# instance.
+#
+# You can also add +--edit+ as an argument, and ralsh will write its output
+# to a file, open that file in an editor, and then apply the file as a Puppet
+# transaction.  You can easily use this to use Puppet to make simple changes to
+# a system.
+#
+# = Options
+#
+# edit:
+#   Write the results of the query to a file, open the file in an editor,
+#   and read the file back in as an executable Puppet manifest.
+#
+# help:
+#   Print this help message.
+#
+# types:
+#   List all available types.
+#
+# = Example
+#
+#   $ ralsh user luke
+#   user { 'luke':
+#       home => '/home/luke',
+#       uid => '100',
+#       ensure => 'present',
+#       comment => 'Luke Kanies,,,',
+#       gid => '1000',
+#       shell => '/bin/bash',
+#       groups => ['sysadmin','audio','video','puppet']
+#   }
+#   $
+#
+# = Author
+#
+# Luke Kanies
+#
+# = Copyright
+#
+# Copyright (c) 2005-2007 Reductive Labs, LLC
+# Licensed under the GNU Public License
+
+
+require 'getoptlong'
+require 'puppet'
+
+result = GetoptLong.new(
+	[ "--types",	"-t",			GetoptLong::NO_ARGUMENT ],
+	[ "--edit",		"-e",			GetoptLong::NO_ARGUMENT ],
+	[ "--help",		"-h",			GetoptLong::NO_ARGUMENT ]
+)
+
+edit = false
+
+result.each { |opt,arg|
+	case opt
+    when "--types"
+        types = []
+        Puppet::Type.loadall
+        Puppet::Type.eachtype do |t|
+            next if t.name == :component
+            types << t.name.to_s 
+        end
+        puts types.sort
+        exit
+    when "--edit"
+        edit = true
+    when "--help"
+        if Puppet.features.usage?
+            RDoc::usage
+        else
+            puts "install RDoc:usage for help"
+        end
+        exit
+    else
+        raise "Invalid option '#{opt}'"
+	end
+}
+
+type = nil
+if ARGV.length > 0
+    type = ARGV.shift
+else
+    raise "You must specify the type to display"
+end
+
+
+typeobj = nil
+
+unless typeobj = Puppet::Type.type(type)
+    raise "Could not find type %s" % type
+end
+
+states = typeobj.states.collect { |s| s.name }
+
+text = typeobj.list.collect do |obj|
+    next if ARGV.length > 0 and ! ARGV.include? obj.name
+    trans = obj.to_trans(true)
+
+    trans.dup.each do |param, value|
+        if value == "" or value == []
+            trans.delete(param)
+        end
+
+        unless states.include?(param)
+            trans.delete(param)
+        end
+    end
+
+    trans.to_manifest
+end.reject { |t| t.nil? }.join("\n")
+
+if edit
+    file = "/tmp/x2puppet-#{$$}.pp"
+    begin
+        File.open(file, "w") do |f|
+            f.puts text
+        end
+        system(ENV["EDITOR"], file)
+        system("puppet -v " + file)
+    ensure
+        #if FileTest.exists? file
+        #    File.unlink(file)
+        #end
+    end
+else
+    puts text
+end
+
+# $Id$