fairchild-poolparty 1.1.5 → 1.2.12

data/lib/poolparty/provision/boot_strapper.rb

@@ -13,6 +13,8 @@ module PoolParty
       
       # List of gems that are default to install
       def self.gem_list
+        # auser-dslify
+        # auser-parenting
         @gem_list ||= %w( logging
                           rake
                           xml-simple
@@ -21,27 +23,32 @@ module PoolParty
                           net-scp
                           net-ssh-gateway
                           highline
+                          flexmock
+                          lockfile
+                          rubigen
                           json
-                          activesupport
                           grempe-amazon-ec2
                           ohai
                           chef
-                          auser-dslify
-                          auser-parenting
-                          adamwiggins-rest-client
+                          ruby-openid
+                          auser-rest-client
                           rack
                           thin
+                          logging
+                          ruby2ruby
+                          extlib
                         )
       end
 
       # Default options for the boot_strapper
-      @defaults = ::PoolParty::Default.default_options.merge({
+      @defaults = ::PoolParty::Default.dsl_options.merge({
         :full_keypair_path   => "#{ENV["AWS_KEYPAIR_NAME"]}" || "~/.ssh/id_rsa",
         :installer           => 'apt-get',
         :dependency_resolver => 'chef'
       })
       class <<self; attr_reader :defaults; end
       
+      attr_reader :cloud_name
       # In case the method is being called on ourself, let's check the 
       # defaults hash to see if it's available there
       def method_missing(m,*a,&block)
@@ -58,6 +65,7 @@ module PoolParty
         self.class.defaults.merge(opts).to_instance_variables(self)
         @target_host = host
         @cloud = opts[:cloud]
+        @cloud_name = @cloud.name
                 
         instance_eval &block if block
         @cloud.call_before_bootstrap_callbacks if @cloud
@@ -79,36 +87,39 @@ module PoolParty
       def pack_the_dependencies
         # Add the keypair to the instance... shudder
         ::Suitcase::Zipper.add(keypair, "keys")
+        ::Suitcase::Zipper.add_content_as(Default.keys_in_yaml, "ppkeys", "keys")
         
-        # Use the locally built poolparty gem if it is availabl
-        if edge_pp_gem = Dir["#{Default.vendor_path}/../pkg/*poolparty*gem"].pop
-          puts "using edge poolparty: #{::File.expand_path(edge_pp_gem)}"
-          ::Suitcase::Zipper.add(edge_pp_gem, 'gems')
-        else
-          vputs "using gem auser-poolparty. use rake build to use edge"
-          self.class.gem_list << 'auser-poolparty'
-        end
+        edge_pp_gem = Dir["#{Default.vendor_path}/../pkg/*poolparty*gem"].pop
+        # Use the locally built poolparty gem if it is available
+            if edge_pp_gem
+              puts "using edge poolparty: #{::File.expand_path(edge_pp_gem)}"
+              ::Suitcase::Zipper.add(edge_pp_gem, 'gems')
+            else
+              vputs "using gem auser-poolparty. use rake build to use edge"
+              self.class.gem_list << 'auser-poolparty'
+            end
         # Add the gems to the suitcase
         puts "Adding default gem dependencies"
-        ::Suitcase::Zipper.gems self.class.gem_list, "#{Default.tmp_path}/trash/dependencies"
+        ::Suitcase::Zipper.gems self.class.gem_list, :gem_location => "#{cloud.tmp_path}/trash/dependencies", :search_paths => ["#{Default.vendor_path}/../pkg"]
 
-        ::Suitcase::Zipper.packages( "http://rubyforge.org/frs/download.php/45905/rubygems-1.3.1.tgz",
-                 "#{Default.tmp_path}/trash/dependencies/packages")
+        ::Suitcase::Zipper.packages( "http://rubyforge.org/frs/download.php/57643/rubygems-1.3.4.tgz",
+                 "#{cloud.tmp_path}/trash/dependencies/packages")
         # ::Suitcase::Zipper.add("templates/")
         
         ::Suitcase::Zipper.add("#{::File.dirname(__FILE__)}/../templates/monitor.ru", "/etc/poolparty/")
         ::Suitcase::Zipper.add("#{::File.dirname(__FILE__)}/../templates/monitor.god", "/etc/poolparty/")
                 
-        ::Suitcase::Zipper.add("#{Default.tmp_path}/trash/dependencies/cache", "gems")        
+        ::Suitcase::Zipper.add("#{cloud.tmp_path}/trash/dependencies/cache", "gems")        
         
-        ::Suitcase::Zipper.add("#{::File.join(File.dirname(__FILE__), '..', 'templates', 'gemrc' )}", "etc/poolparty")
+        ::Suitcase::Zipper.add("#{::File.join(File.dirname(__FILE__), '..', 'templates', 'gemrc_template' )}", "etc/poolparty")
         
         instances = @cloud.nodes(:status => "running") + [@cloud.started_instance]
-        ::Suitcase::Zipper.add_content_as(
-          {:instances => instances.flatten.compact}.to_json, 
-          "neighborhood.json", "/etc/poolparty")
+        # ::Suitcase::Zipper.add_content_as(
+        #   instances.flatten.compact.to_json, 
+        #   "neighborhood.json", "/etc/poolparty"
+        # )
         
-        ::Suitcase::Zipper.build_dir!("#{Default.tmp_path}/dependencies")
+        ::Suitcase::Zipper.build_dir!("#{cloud.tmp_path}/dependencies")
         
         ::Suitcase::Zipper.flush!
         
@@ -118,35 +129,35 @@ module PoolParty
       # The commands to setup a PoolParty enviornment
       def default_commands
         pack_the_dependencies
-        ::FileUtils.rm_rf "#{Default.tmp_path}/dependencies/gems/cache"
-        rsync "#{Default.tmp_path}/dependencies", '/var/poolparty'
+        ::FileUtils.rm_rf "#{cloud.tmp_path}/dependencies/gems/cache"
+        rsync "#{cloud.tmp_path}/dependencies", '/var/poolparty', ['-v', '-a', '--delete']
         
         commands << [
           "mkdir -p /etc/poolparty",
+          "echo #{cloud.name} > /etc/poolparty/cloud_name",
+          "echo #{cloud.pool.name}>/etc/poolparty/pool_name",
           "mkdir -p /var/log/poolparty",
           "groupadd -f poolparty",
           # "useradd poolparty  --home-dir /var/poolparty  --groups poolparty  --create-home",
-          'cd /var/poolparty/dependencies',
-          "cp /var/poolparty/dependencies/etc/poolparty/gemrc /etc/poolparty",          
+          "cd /var/poolparty/dependencies && cp /var/poolparty/dependencies/etc/poolparty/gemrc_template /etc/poolparty",
           "#{installer} update",
-          "#{installer} install -y ruby ruby1.8-dev libopenssl-ruby1.8 build-essential wget",  #optional, but nice to have
-          "tar -zxvf packages/rubygems-1.3.1.tgz",
-          "cd rubygems-1.3.1",
-          "ruby setup.rb --no-ri --no-rdoc",
-          "ln -sfv /usr/bin/gem1.8 /usr/bin/gem", #TODO: check if this is really needed
-          "cd ../ && rm -rf rubygems-1.3.1*",
+          "#{installer} install -y ruby ruby1.8-dev irb libopenssl-ruby1.8 build-essential wget",  #optional, but nice to have
+          "tar -zxvf packages/rubygems-1.3.4.tgz && cd rubygems-1.3.4 && ruby setup.rb --no-ri --no-rdoc && ln -sfv /usr/bin/gem1.8 /usr/bin/gem && cd ../ && rm -rf rubygems-1.3.1*",
           "gem source --add http://gems.github.com",
+          "gem source -a http://gems.opscode.com",
           "cd /var/poolparty/dependencies/gems/",
-          "gem install --no-rdoc --no-ri -y *.gem",
-          "cd /var/poolparty/dependencies",
-          "cp /var/poolparty/dependencies/etc/poolparty/* /etc/poolparty/",
+          "gem install --no-rdoc --no-ri *.gem",
+          "cd /var/poolparty/dependencies && cp /var/poolparty/dependencies/etc/poolparty/* /etc/poolparty/",
           'touch /var/poolparty/POOLPARTY.PROGRESS',
           "mkdir -p /root/.ssh",
           "cp /var/poolparty/dependencies/keys/* /root/.ssh/",
-          "chmod 600 /root/.ssh/#{::File.basename(@cloud.keypair.full_filepath)}",
+          "chmod 600 /root/.ssh/#{keypair_name}",
           # "god -c /etc/poolparty/monitor.god",
           "mkdir -p /var/log/poolparty/",
-          "thin -R /etc/poolparty/monitor.ru -p 8642 --pid /var/run/stats_monitor.pid --daemon -l /var/log/poolparty/monitor.log start 2>/dev/null",
+          "echo '-- Starting monitor_rack --'",
+          # NOTE: if someone has an old version of thin/rack on their system, this will fail silently and never finish bootstrapping
+          "ps aux | grep thin | grep -v grep | awk '{print $2}' | xargs kill -9; thin -R /etc/poolparty/monitor.ru -p 8642 --pid /var/run/stats_monitor.pid --daemon -l /var/log/poolparty/monitor.log start 2>/dev/null",
+          "tail -n 20 /var/log/poolparty/monitor.log",
           'echo "bootstrap" >> /var/poolparty/POOLPARTY.PROGRESS']
         commands << self.class.class_commands unless self.class.class_commands.empty?
       end

data/lib/poolparty/provision/configurations/chef.rb

@@ -3,20 +3,21 @@ module PoolParty
     
     class Chef
       def self.commands
+        debug_flag = "-l debug" if debugging? 
         [
           "mkdir -p /etc/chef/cookbooks /etc/chef/cache",
           "cp -R /var/poolparty/dr_configure/chef/cookbooks/* /etc/chef/cookbooks",
           "cp /var/poolparty/dr_configure/chef/solo.rb /etc/chef/solo.rb",
           "cp /var/poolparty/dr_configure/chef/dna.json /etc/chef/dna.json",
-          "/usr/bin/chef-solo -c /etc/chef/solo.rb -j /etc/chef/dna.json"
+          "/usr/bin/chef-solo #{debug_flag} -c /etc/chef/solo.rb -j /etc/chef/dna.json"
         ]
       end
       def self.files_to_upload
         [ 
-          "#{Default.tmp_path}/dr_configure/chef/solo.rb",
-          "#{Default.tmp_path}/dr_configure/chef/dna.json",
-          "#{Default.base_config_directory}/chef/solo.rb",
-          "#{Default.base_config_directory}/chef/dna.json"
+          # "#{Default.tmp_path}/dr_configure/chef/solo.rb",
+          # "#{Default.tmp_path}/dr_configure/chef/dna.json",
+          # "#{Default.base_config_directory}/chef/solo.rb",
+          # "#{Default.base_config_directory}/chef/dna.json"
         ]
       end
     end

data/lib/poolparty/provision/dr_configure.rb

@@ -22,42 +22,44 @@ module PoolParty
      # In case the method is being called on ourself, let's check the 
      # defaults hash to see if it's available there
      def method_missing(m,*a,&block)
-       if self.class.defaults.has_key?(m) 
-         self.class.defaults[m]
-       elsif @cloud
+       # if self.class.defaults.has_key?(m) 
+       #   self.class.defaults[m]
+       # elsif @cloud
          @cloud.send m, *a, &block
-       else
-         super
-       end
+       # else
+         # super
+       # end
      end
     
-     attr_reader :cloud, :keypair, :run_count
+     attr_reader :cloud, :keypair, :run_count, :cloud_name
      
      def initialize(host, opts={}, &block)
        self.class.defaults.merge(opts).to_instance_variables(self)
        @target_host = host
-       @configurator = "::PoolParty::Provision::#{dependency_resolver.capitalize}".constantize
+       @configurator = "::PoolParty::Provision::#{dependency_resolver.camelcase}".constantize
        @cloud = opts[:cloud]
+       @cloud_name = @cloud.name
        @keypair = @cloud.keypair
        @run_count = 0
        
        @cloud.call_before_configure_callbacks if @cloud
        prescribe_configuration
        execute!
+       @cloud.call_after_configure_callbacks if @cloud
      end
      
      private
      
      def prescribe_configuration
-       ::FileUtils.mkdir_p "#{Default.tmp_path}/dr_configure" unless ::File.directory?("#{Default.tmp_path}/dr_configure")
-      ::File.cp $pool_specfile, "#{Default.tmp_path}/dr_configure/clouds.rb"
-      ::File.open "#{Default.tmp_path}/dr_configure/clouds.json", "w" do |f|
-        f << cloud.to_properties_hash.to_json
+       ::FileUtils.mkdir_p "#{cloud.tmp_path}/dr_configure" unless ::File.directory?("#{cloud.tmp_path}/dr_configure")
+      ::FileUtils.cp $pool_specfile, "#{cloud.tmp_path}/dr_configure/clouds.rb"
+      ::File.open "#{cloud.tmp_path}/dr_configure/clouds.json", "w" do |f|
+        f << cloud.to_json
       end
       
       setup_configurator
       # write_erlang_cookie
-      @configurator.files_to_upload.each {|f| ::FileUtils.cp f, "#{Default.tmp_path}/dr_configure/#{::File.basename(f)}" if ::File.file?(f) }
+      @configurator.files_to_upload.each {|f| ::FileUtils.cp f, "#{cloud.tmp_path}/dr_configure/#{::File.basename(f)}" if ::File.file?(f) }
       
       pack_up_and_ship_off_suitcase
       run_commands          
@@ -95,9 +97,11 @@ module PoolParty
        commands << [
          'chmod 644 /var/poolparty/dr_configure/clouds.json',
          'chmod 644 /var/poolparty/dr_configure/clouds.rb',
+         "cp -R /var/poolparty/dr_configure/etc/poolparty/* /etc/poolparty/",
+         # TODO: slightly redundant
          'cp /var/poolparty/dr_configure/clouds.json /etc/poolparty',
          'cp /var/poolparty/dr_configure/clouds.rb /etc/poolparty',
-         "touch /var/poolparty/POOLPARTY.PROGRESS",
+         # 'server-manage-election', #ensures that the monitor gets some data
          'echo "configure" >> /var/poolparty/POOLPARTY.PROGRESS'
          ]
        commands << self.class.class_commands unless self.class.class_commands.empty?
@@ -105,8 +109,10 @@ module PoolParty
      end
      
      def pack_up_and_ship_off_suitcase
-       ::Suitcase::Zipper.build_dir!("#{Default.tmp_path}/dr_configure")
-       rsync "#{Default.tmp_path}/dr_configure/", "/var/poolparty/dr_configure/", ['-a --stats']
+       ::Suitcase::Zipper.add(::File.dirname(pool_specfile), "/etc/poolparty")
+       
+       ::Suitcase::Zipper.build_dir!("#{cloud.tmp_path}/dr_configure")
+       rsync "#{cloud.tmp_path}/dr_configure/", "/var/poolparty/dr_configure/", ['-a --stats']
      end
      
      # Pack up  monitors verifiers plugins directories in the same direcotry as your clouds.rb and send to nodes.
@@ -114,7 +120,7 @@ module PoolParty
        # @cloud.write_properties_hash("#{Default.tmp_path}/properties_hash.rb")
        #TODO: move to puppet class       
        #TODO: remove or conditionalize this puppet specific task
-       @cloud.build_and_store_new_config_file("#{Default.tmp_path}/dr_configure/poolparty.pp")
+       @cloud.build_and_store_new_config_file("#{cloud.tmp_path}/dr_configure/poolparty.pp")
        
        %w(monitors verifiers plugins).each do |dir|
         @cloud.pack_user_directory dir
@@ -128,8 +134,8 @@ module PoolParty
      def write_erlang_cookie
        # cookie = (1..16).collect { chars[rand(chars.size)] }.pack("C*")
        cookie =  (1..65).collect {rand(9)}.join()
-       cookie_file = ::File.open("#{Default.tmp_path}/dr_configure/erlang.cookie", 'w+'){|f| f << cookie }
-       ::File.cp "#{::File.dirname(__FILE__)}/../templates/erlang_cookie_maker", "#{Default.tmp_path}/dr_configure/"
+       cookie_file = ::File.open("#{cloud.tmp_path}/dr_configure/erlang.cookie", 'w+'){|f| f << cookie }
+       ::FileUtils.cp "#{::File.dirname(__FILE__)}/../templates/erlang_cookie_maker", "#{cloud.tmp_path}/dr_configure/"
      end
      
      def self.class_commands

data/lib/poolparty/resources/cron.rb

@@ -1,12 +1,45 @@
 module PoolParty    
   module Resources
-        
+=begin rdoc
+== Cron
+
+The cron resource will set cron jobs at the intervals you set
+
+== Usage
+
+  has_cron(:name => '...') do
+    # More options.
+    # This block is optional
+  end
+
+== Options
+
+* <tt>name</tt> The name of the cronjob
+* <tt>user</tt> The users who owns the cronjob  
+* <tt>command</tt> The cronjob command to run
+* <tt>minute</tt> Set the minute of the cronjob
+* <tt>hour</tt> Set the hour of the cronjob
+* <tt>month</tt> Set the month of the cronjob
+* <tt>monthday</tt> Set the day of the month of the cronjob
+* <tt>weekday</tt> Set the weekday of the cronjob, in 0-6 format, where 0 is Sunday
+
+== Example
+
+  has_cron(:name => "report mailer", :minute => "5", :hour => "0", :weekday => 1) do
+    command "/bin/sh /home/user/email_reports.sh"
+  end
+
+=end
     class Cron < Resource
       
-      default_options({
+      default_options(
         :command => nil,
-        :user => "root"
-      })
+        :user => "root",
+        :minute => "*",
+        :hour => "*",
+        :month => "*",
+        :weekday => "*"
+      )
       
       def present
         :create

data/lib/poolparty/resources/directory.rb

@@ -1,8 +1,38 @@
 module PoolParty    
   module Resources
         
+=begin rdoc rdoc
+== Directory
+
+The directory resource is used to describe a directory that should be present
+on all of the instances.
+
+== Usage
+
+  has_directory 'name', :from => '/local/path', :to => '/path/on/server/'
+  
+The above example will place the contents of '/local/path' at '/path/on/server/name'
+
+  has_directory(:name => '/etc/apache2')
+
+== Options
+
+* <tt>name</tt> Describe the location of the file with the name
+* <tt>mode</tt> Describe the mode of the file (default: 644)
+* <tt>owner</tt> The owner of the file (default: poolparty user)
+
+=end
+
+
     class Directory < Resource
       
+      dsl_methods :owner
+      
+      default_options({
+        :recursive => true,
+        :mode => "0644"
+      })
+      
       def present
         :create
       end

data/lib/poolparty/resources/exec.rb

@@ -1,11 +1,41 @@
 module PoolParty    
   module Resources
+=begin rdoc rdoc
+== Exec
+
+Ensure a command is run on the instances
+
+== Usage
+
+  has_exec(:name => '...') do
+    # More options. 
+    # This block is optional
+  end
+
+== Options
+
+* <tt>name</tt> The name of your exec. This is optional, but nice for debugging purposes
+* <tt>cwd</tt> Current working directory to execute the command (optional)
+* <tt>command</tt> This describes the command to run
+* <tt>path</tt> The path to run the command with (optional)
+
+== Examples
+  has_exec(:name => 'start messenger', :command => 'server-start-node', :requires => get_gempackage('poolparty-latest', :onlyif => 'ps aux | grep beam | grep master')
+=end
     
     class Exec < Resource
       
+      dsl_methods :cwd, :creates, :command
       default_options({
         :path => ["/usr/bin:/bin:/usr/local/bin:$PATH"]
       })
+
+      def loaded(o={})
+        if user
+          name "sudo -u #{user} -H #{name}"
+          dsl_options.delete(:user)
+        end
+      end
       
       def present
         nil
@@ -16,7 +46,7 @@ module PoolParty
       end
       
       def after_create
-        options[:name] = options[:command] unless options.name
+        dsl_options[:name] = dsl_options[:command] unless dsl_options[:name]
       end
 
     end

data/lib/poolparty/resources/file.rb

@@ -1,10 +1,49 @@
 module PoolParty    
   module Resources
         
-    class File < Resource
+=begin rdoc rdoc
+== File
+
+The file resource is used to describe a file that should be present on all of the instances.
+
+== Usage
+
+  has_file(:name => '...') do
+    # More options. 
+    # This block is optional
+  end
+
+== Options
+
+* <tt>name</tt> Describe the location of the file with the name
+* <tt>mode</tt> Describe the mode of the file (default: 644)
+* <tt>owner</tt> The owner of the file (default: poolparty user)
+* <tt>content</tt> The contents of the file
+* <tt>source</tt> Used to describe a file that is hosted on the master instance.
+* <tt>template</tt> The file contents are described with the template. The location given must be readable
+  
+To write a file to the template directory, use:
+
+  copy_template_to_storage_directory(filepath)
+
+== Example
+  has_file(:name => '/etc/motd', :content => 'Hey and welcome to your node today!')
+=end
+    class File < Resource 
+      has_searchable_paths(:dir => "templates")
+      
+      dsl_methods :name,            # The name, the full path of the file
+                  :owner,           # String that describes the owner of the file
+                  :content,         # A string that describes the content of the file
+                  :template,        # The file that describes the content of the file
+                  :render_as        # Render the content (Erb) (default: Erb)
+                  
+      default_options(
+        :mode => "644"              # A string indicating the mode of the file
+      )
       
       def loaded(o={}, &block)
-        parent.has_directory ::File.dirname(name) if parent
+        has_directory ::File.dirname(name)
       end
       
       def present
@@ -18,27 +57,30 @@ module PoolParty
       def after_create
         run_render = dsl_options.include?(:render_as) ? dsl_options.delete(:render_as) : false
         
-        if dsl_options.include?(:template)          
-          filename = ::File.expand_path(dsl_options.template)
-          dsl_options.delete(:template)
+        if dsl_options[:template]
+          filename = find_file(dsl_options.delete(:template))
           file = ::File.basename( filename )
           raise TemplateNotFound.new("no template given") unless file
 
-          template_opts = (parent ? options.merge(parent.options) : options)
-          options.merge!(:content => run_render ? Template.compile_file(filename, template_opts.merge(:renderer => run_render)).gsub("\"", "\"") : open(filename).read)
+          template_opts = (parent ? dsl_options.merge(parent.dsl_options) : dsl_options)
+          dsl_options.merge!(:content => run_render ? Template.compile_file(filename, template_opts.merge(:renderer => run_render)).gsub("\"", "\"") : open(filename).read)
         end
         
         if dsl_options.include?(:content)
           cont = dsl_options.delete(:content)
-          template_opts = (parent ? options.merge(parent.options) : options).merge(:renderer => run_render)
-          options.merge!(:content => run_render ? Template.compile_string(cont, template_opts) : cont)
+          template_opts = (parent ? dsl_options.merge(parent.dsl_options) : dsl_options).merge(:renderer => run_render)
+          dsl_options.merge!(:content => run_render ? Template.compile_string(cont, template_opts) : cont)
         end
       end
       
-      def method_missing m, *a, &block
-        super rescue ::File.send(m, *a, &block)
-      end
+      # def method_missing m, *a, &block
+      #   super rescue ::File.send(m, *a, &block)
+      # end
       
+      def variable(k,v)
+        set_default_options(k => v)
+      end
+
     end
     
   end

data/lib/poolparty/resources/group.rb

@@ -0,0 +1,21 @@
+module PoolParty    
+  module Resources
+        
+    class Group < Resource      
+      
+      # default_options({
+      #   :shell => "/bin/sh"
+      # })
+      
+      def present
+        :manage
+      end
+      
+      def absent
+        :remove
+      end
+      
+    end
+    
+  end
+end

data/lib/poolparty/resources/mount.rb

@@ -1,5 +1,29 @@
 module PoolParty
   module Resources
+=begin rdoc
+
+== Mount
+
+The mount specifies a mount that is to be mounted on the instances
+
+== Usage
+
+  has_mount(:name => '...') do
+    # More options. 
+    # This block is optional
+  end
+
+== Options
+
+* <tt>name</tt> The location of the mount (default: /data)
+* <tt>device</tt> The device location for the mount. This mounts at the directory set by the name
+* <tt>options</tt> The options to be set in the mount file fstab (default: rw,nosuid,noquota)
+* <tt>fstype</tt> The Type of mount (default: xfs)
+
+== Examples
+
+  has_mount(:name => "/data", :device => "/dev/sda100")
+=end
     
     class Mount < Resource
       
@@ -11,10 +35,6 @@ module PoolParty
         :atboot => "yes"
       })
       
-      def disallowed_options
-        [:name]
-      end
-      
     end
     
   end

data/lib/poolparty/resources/package.rb

@@ -1,17 +1,41 @@
-module PoolParty    
+module PoolParty
   module Resources
-        
+=begin rdoc
+
+== Package
+
+The package resources defines a package that must be present on all of the
+instances This will install the "name_of_package" package with the package
+provider (apt, yum, etc)
+
+== Usage
+
+  has_package "name_of_package"
+  has_package(:name => '...') do
+    # More options. 
+    # This block is optional
+  end
+
+== Options
+
+* <tt>name</tt> The package name. The default provider for your OS will be picked by the dependency resolver
+
+== Examples
+
+  has_package(:name => 'apache2')
+
+=end
     class Package < Resource
-      
+
       def present
         :install
       end
-      
+
       def absent
         :remove
       end
-      
+
     end
-    
+
   end
 end