rconf 0.5.9 → 0.6.1

data/README.rdoc

@@ -10,39 +10,38 @@ for each application is becoming increasingly complex and switching from one
 application to another for development in particular is quickly becoming
 close to impossible.
 
-RightEnv aims at addressing some of these difficulties by providing a uniform
+rconf aims at addressing some of these difficulties by providing a uniform
 and consistent mechanism for applications developed at RightScale to 
-declaratively specify the tools they depend on in various systems (development,
-test, staging, production) and platforms (linux, darwin and windows). RightEnv
-uses a DSL close to Chef recipes for defining an application configuration.
+declaratively specify the tools they depend on various platforms (linux, darwin
+and potentially windows). 
+
+rconf uses a DSL close to Chef recipes for defining an application configuration.
 Each application must be equipped with a definition that must reside at the top
-level directory of the application and must be named "<application>.re" (where
-"<application>" should be subsituted with the name of the application.
-Configuring the system to run the application then merely consists of running
-the "script/bootstrap_environment" script provided in the "script" directory
-("script/bootstrap_environment.bat" on windows).
+level directory of the application and use the '.rc' file extension. When run
+for the first time rconf sets up a .rvmrc file which gets invoked and sets up
+the environment each time the application directory gets 'cd-ed' into.
 
-Internally RightEnv relies on 'configurators' to configure the machine
+Internally rconf relies on 'configurators' to configure the machine 
 appropriately. There is one configurator per tool that needs configuration.
-Each configurator is dynamically instantiated by RightEnv as it reads the
+Each configurator is dynamically instantiated by rconf as it reads the
 application configuration file. This makes for an extensible system where new
 configurator may be added to configure new tools that new applications may 
-rely on. For a list of available configurators run "script/configurator --list".
+rely on.
 
 == REQUIREMENTS
 
 === Running
 
-- Linux and MAc OS X
+==== Linux and Mac OS X
 
- - ruby >= 1.8.6
- - curl
- - tar
+- ruby >= 1.8.6
+- curl
+- tar
 
-- Windows
+==== Windows
 
- - ruby >= 1.8.6
- - Win32API gem
+- ruby >= 1.8.6
+- Win32API gem
 
 === Unit testing
 
@@ -54,3 +53,50 @@ Then the build can be tested with
  
   rake spec
 
+== WRITING RCONF CONFIGURATION FILES
+
+rconf uses a ruby DSL for configuration files (.rc). Each configurator is
+associated with a keyword. The configuration for a given configurator then
+lists each configurator setting it needs to set and the associated value as in:
+
+  ruby do
+    version 'ruby-1.9.2-p136'
+  end
+
+The configuration file consists of a sequence of these configurator sections
+executed in order. For a complete list of available configurators run:
+
+  rconf --configurators
+
+The same configurator can appear multiple times in a configuration file.
+
+== EXTENDING RCONF WITH NEW CONFIGURATORS
+
+Writing a configurator consists of writing a ruby class which includes the 
++RightConf::Configurator+ module and uses the class methods define there to
+register, provide a description and list its settings.
+
+The exact methods are:
+
+- +register+: Takes one argument which is the keyword associated with the configurator in configuration files.
+- +description+: Associates the description with the configurator used in the help.
+- +settings+: The value should be a hash where the keys are the settings names (ruby symbols) and the value is the setting description.
+- +validate_has_settings+: An array of settings names (symbols) for all settings that must be set for a configuration to be valid when using that configurator.
+
+The configurator class then needs to implement the +run+ method which gets 
+called whenever rconf executes a configuration section using the configurator.
+
+Alternatively the configurator class may implement +run_<platform>+ where
++<platform>+ can take the values 'darwin', 'linux' or 'windows' if the
+implementation needs to be platform specific.
+
+The configurator can also provide distribution specific implementations by
+implementing +run_<platform>_<flavor>+ where +<flavor>+ depends on the 
+platform and can take the values 'ubuntu', 'centos' etc. (linux).
+
+Finally the +run+ method can also be implemented using the full specification 
+for a platform including the release number (e.g. +run_linux_ubuntu_10_10+). In
+each case rconf will use the most specific implementation (so if both 
++run_linux+ and +run_linux_ubuntu+ are provided and the configurator is
+running on Ubuntu then rconf will call the +run_linux_ubuntu+ implementation).
+

data/bin/rconf

@@ -37,7 +37,7 @@ where [options] are:
         opt :output, 'Output file (output to STDOUT by default)', :type => :string
         opt :verbose, 'Print debug output'
       end
-      if opts[:config].nil?
+      if opts[:config].nil? && !opts[:configurators]
         opts[:config] = Dir['./*.rc']
         if opts[:config].empty?
           Trollop::die :config, "not used and could not find a '.rc' file in the working directory"
@@ -74,7 +74,8 @@ where [options] are:
           configurator.all_settings.each do |name, desc|
             num_spaces = max_size - name.to_s.size + 1
             print "  - #{name.to_s.blue}:#{' ' * num_spaces}#{desc}"
-            if configurator.required_settings.include?(name)
+            required_settings = configurator.required_settings || []
+            if required_settings.include?(name)
               puts ' [required]'.green
             else
               puts

data/lib/rconf/configurators/packages_configurator.rb

@@ -22,7 +22,8 @@ module RightConf
     settings :debian  => 'Packages to be installed on Debian based Linux',
              :centos  => 'Packages to be installed on RedHat / Centos',
              :windows => 'Softwared to be downloaded and installed on Windows',
-             :mac     => 'Brew packages to be installed on Mac OS X (https://github.com/mxcl/homebrew)'
+             :mac     => 'Brew packages to be installed on Mac OS X (https://github.com/mxcl/homebrew)',
+             :abort_on_failure => 'Whether to abort if packages failed to install (false by default)'
 
     # Install debian packages
     #
@@ -31,7 +32,8 @@ module RightConf
     def run_linux_ubuntu
       return if debian.nil?
       report_check("Installing the following packages:\n#{debian.join(' ')}\nThis could take a while")
-      opts = debian << { :abort_on_failure => 'Failed to install packages' }
+      opts = debian.dup 
+      opts << { :abort_on_failure => 'Failed to install packages' } if abort_on_failure
       Command.execute('sudo', 'aptitude', 'install', *opts)
       report_success
     end
@@ -44,7 +46,8 @@ module RightConf
     def run_linux_centos
       return if centos.nil?
       report_check("Installing the following packages:\n#{centos.join(' ')}\nThis could take a while")
-      opts = centos << { :abort_on_failure => 'Failed to install packages' }
+      opts = centos.dup
+      opts << { :abort_on_failure => 'Failed to install packages' } if abort_on_failure
       Command.execute('sudo', 'yum', 'install', '-y', *opts)
       report_success
     end

data/lib/rconf/version.rb

@@ -12,8 +12,8 @@
 module RightConf
 
   MAJOR = 0
-  MINOR = 5
-  BUILD = 9
+  MINOR = 6
+  BUILD = 1
 
   VERSION = [MAJOR, MINOR, BUILD].map(&:to_s).join('.')
 

data/spec/configurators/bundler_configurator_spec.rb

@@ -39,7 +39,7 @@ describe RightConf::BundlerConfigurator do
     flexmock(RightConf::Command.instance).should_receive(:execute).once.with(
       'bundle', 'install', {:abort_on_failure=>"Failed to install gems"}).and_return(success_result)
     flexmock(RightConf::Command.instance).should_receive(:execute).once.with(
-      'gem', 'uninstall', 'bundler', '-a', '-x', {:abort_on_failure=>"Failed to uninstall bundler"}).and_return(success_result)
+      'gem', 'uninstall', 'bundler', '-a', '-x').and_return(success_result)
     flexmock(RightConf::Command.instance).should_receive(:execute).once.with(
       'gem', 'install', 
       File.join(RightConf::BundlerConfigurator::DEFAULT_GEM_PATH, 'bundler-0.gem'),

data/spec/configurators/packages_configurator_spec.rb

@@ -27,15 +27,13 @@ describe RightConf::PackagesConfigurator do
 
   it 'should install packages on Ubuntu' do
     flexmock(RightConf::Command.instance).should_receive(:execute).once.with(
-      'sudo', 'aptitude', 'install', 'deb1', 'deb2', 
-      {:abort_on_failure=>"Failed to install packages"}).and_return(success_result)
+      'sudo', 'aptitude', 'install', 'deb1', 'deb2').and_return(success_result)
     @configurator.run_linux_ubuntu
   end
 
   it 'should install packages on Centos' do
     flexmock(RightConf::Command.instance).should_receive(:execute).once.with(
-      'sudo', 'yum', 'install', '-y', 'cent1', 'cent2',
-      {:abort_on_failure=>"Failed to install packages"}).and_return(success_result)
+      'sudo', 'yum', 'install', '-y', 'cent1', 'cent2').and_return(success_result)
     @configurator.run_linux_centos
   end
 

metadata

@@ -2,7 +2,7 @@
 name: rconf
 version: !ruby/object:Gem::Version 
   prerelease: 
-  version: 0.5.9
+  version: 0.6.1
 platform: ruby
 authors: 
 - Raphael Simon
@@ -10,7 +10,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2011-03-07 00:00:00 -08:00
+date: 2011-03-08 00:00:00 -08:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency