garcun 0.0.2 → 0.0.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 5e5afab358904c0ff67603201613bb8b3e4518cb
-  data.tar.gz: b82642cbea4924320bf4ff2cccded02a132e0b9a
+  metadata.gz: 2827b045552795cc5a3934823fc34bc6d7c3b1bf
+  data.tar.gz: bf3026b6fdd4ca118e727db751c39f256a66dcae
 SHA512:
-  metadata.gz: bc86987f93098617d324810d97cae447b5163fbfc0babf758a319f84f8fb87053654a88baaedf009aaf8ca25ca012452087900ee4575c5387893127992b16d82
-  data.tar.gz: 8e01b6ca679fe8a33b036f87e0043e25ba19ef5282e6d91d12a536f37c0587d4162751aad8f2f4398f2e7ee70577d1759bc8d93c1fac70a07b501b9c72267d2c
+  metadata.gz: 3858d4a7601ff6afbc09a4a6c1765bad36cccf0c6c9b0ed39e52c098fcf4fceb465172dd49ce54c0249bdce98ff8877fbe4215a971337690fd9b2fe27c7e44f4
+  data.tar.gz: 0bfd59282111449b3c6dfffff1fb696b9711f2f30bb16c5759a4bcd0ab23a77788f9b3350feed5ba675bb80d9492ecdb9b60692ba5ac5aee6ce74070a93dd944

data/lib/garcon/chef/chef_helpers.rb

@@ -25,19 +25,16 @@ module Garcon
     extend self
 
     include Chef::Mixin::ShellOut
-    include Garcon::Exceptions
 
-    # def chef_run_context
-    #   ::Chef::RunContext.new(chef_node, nil, nil)
-    # end
-    #
-    #  TODO - ARE THESE CAUSING TROUBLE???
-    #
-    # def chef_node
-    #   node = ::Chef::Node.new
-    #   node.consume_external_attrs(nil, ohai)
-    #   node
-    # end
+    def chef_run_context
+      ::Chef::RunContext.new(chef_node, nil, nil)
+    end
+
+    def chef_node
+      node = ::Chef::Node.new
+      node.consume_external_attrs(nil, ohai)
+      node
+    end
 
     # Boolean indicating if the given Ruby Gem is installed.
     #

data/lib/garcon/chef/coerce/coercer.rb

@@ -30,6 +30,8 @@ module Garcon
   end
 
   class Coercer
+    # Coerces objects based on the definitions that are registered.
+    #
     def initialize
       @coercions = Hash.new do |hash, origin|
         hash[origin] = Hash.new do |h, target|
@@ -101,6 +103,7 @@ module Garcon
     # Calls the coercion.
     #
     # @return [Object]
+    #
     def call(object)
       @block.call(object, @target)
     end

data/lib/garcon/chef/node.rb

@@ -55,20 +55,22 @@ class Chef
     # not exist, otherwise UndefinedAttributeError is raised.
     #
     # @param [Array<String, Symbol>] keys
-    #   the list of keys to kdeep fetch
+    #   The list of keys to kdeep fetch
     #
     # @yield optional block to execute if no value is found
     #
+    # @raise UndefinedAttributeError
+    #
     # @return [Object]
     #
     # @api public
     def get(*keys, &block)
-      args.reduce(self) do |obj, arg|
+      keys.reduce(self) do |obj, key|
         begin
-          arg = Integer(arg) if obj.is_a? Array
-          obj.fetch(arg)
+          key = Integer(key) if obj.is_a? Array
+          obj.fetch(key)
         rescue ArgumentError, IndexError, NoMethodError
-          break block.call(arg) if block
+          break block.call(key) if block
           raise UndefinedAttributeError
         end
       end

data/lib/garcon/chef/provider/download.rb

@@ -227,34 +227,6 @@ class Chef
 
       private #   P R O P R I E T À   P R I V A T A   Vietato L'accesso
 
-      # Handle the download action.
-      #
-      # @return [undefined]
-      #
-      # @api private
-      def do_create
-        if @current_resource.exist? && !access_controls.requires_changes?
-            Chef::Log.debug "#{r.path} already exists - nothing to do"
-
-        elsif @current_resource.exist? && access_controls.requires_changes?
-          converge_by(access_controls.describe_changes) do
-            access_controls.set_all
-          end
-          r.updated_by_last_action(true)
-
-        else
-          converge_by "Download #{r.path}" do
-            backup unless ::File.symlink?(r.path)
-            do_download
-          end
-          do_acl_changes
-          load_resource_attributes_from_file(r)
-          r.updated_by_last_action(true)
-          load_new_resource_state
-          r.exist = true
-        end
-      end
-
       # Change file ownership and mode.
       #
       # @return [undefined]
@@ -331,9 +303,9 @@ class Chef
 
       def handle_prerequisites
         package 'gnutls', :install
-        yumrepo :create
+        yumrepo(:create) if node.platform_family == 'rhel'
         package 'aria2', :install
-        wipe_repo
+        wipe_repo if node.platform_family == 'rhel'
       end
 
       def package(name, action = :nothing)

data/lib/garcon/chef/resource/base_dsl.rb

@@ -25,6 +25,54 @@ module Garcon
     #
     module BaseDSL
       module ClassMethods
+        # Maps a resource/provider (and optionally a platform and version) to a
+        # Chef resource/provider. This allows finer grained per platform
+        # resource attributes and the end of overloaded resource definitions.
+        #
+        # @note
+        #   The provides method must be defined in both the custom resource and
+        #   custom provider files and both files must have identical provides
+        #   statement(s).
+        #
+        # @param [Symbol] name
+        #   Name of a Chef resource/provider to map to.
+        #
+        # @return [undefined]
+        #
+        def provides(name)
+          if self.name && respond_to?(:constantize)
+            old_constantize = instance_method(:constantize)
+            define_singleton_method(:constantize) do |name|
+              name == self.name ? self : old_constantize.bind(self).call(name)
+            end
+          end
+          @provides_name = name
+          super if defined?(super)
+        end
+
+        # Return the Snake case name of the current resource class. If not set
+        # explicitly it will be introspected based on the class name.
+        #
+        # @param [Boolean] auto
+        #   Try to auto-detect based on class name.
+        #
+        # @return [Symbol]
+        #
+        def resource_name(auto = true)
+          return @provides_name if @provides_name
+          @provides_name || if name && name.start_with?('Chef::Resource')
+            Garcon::Inflections.snakeify(name, 'Chef::Resource').to_sym
+          elsif name
+            Garcon::Inflections.snakeify(name.split('::').last).to_sym
+          end
+        end
+
+        # Used by Resource#to_text to find the human name for the resource.
+        #
+        def dsl_name
+          resource_name.to_s
+        end
+
         # Imitate the behavior of the `Chef::Resource::LWRPBase` DSL providing
         # a `default_action` method.
         #
@@ -134,6 +182,11 @@ module Garcon
       #
       def initialize(*args)
         super
+        if self.class.resource_name(false)
+          @resource_name = self.class.resource_name
+        else
+          @resource_name ||= self.class.resource_name
+        end
         @action = self.class.default_action if @action == :nothing
         (@allowed_actions << self.class.actions).flatten!.uniq!
       end

data/lib/garcon/chef/secret_bag.rb

@@ -45,7 +45,8 @@ module Garcon
   #   The mysql_passwd will == 'eazypass'
   #
   module SecretBag
-    include Garcon::Exceptions
+    InvalidDataBagTypeError = Class.new(RuntimeError)
+    DataBagEncryptionError  = Class.new(RuntimeError)
 
     def secret(bag_name, index)
       if node[:garcon][:devmode]

data/lib/garcon/chef_inclusions.rb

@@ -18,7 +18,6 @@
 #
 
 require_relative 'chef/chef_helpers'
-require_relative 'chef/log'
 require_relative 'chef/node'
 require_relative 'chef/secret_bag'
 require_relative 'chef/validations'
@@ -27,7 +26,6 @@ require_relative 'chef/resource/attribute'
 require_relative 'chef/resource/base_dsl'
 require_relative 'chef/resource/blender'
 require_relative 'chef/resource/lazy_eval'
-require_relative 'chef/resource/resource_name'
 
 module Garcon
   # Extend Resource with class and instance methods.
@@ -36,7 +34,6 @@ module Garcon
     include BaseDSL
     include LazyEval
     include Validations
-    include ResourceName
     include Garcon::UrlHelper
     include Garcon::FileHelper
 
@@ -138,14 +135,9 @@ unless Chef::Recipe.ancestors.include?(Garcon::Interpolation)
   Chef::Provider.send(:include, Garcon::Interpolation)
 end
 
-unless Chef::Resource.method_defined?(:run_now)
-  Chef::Resource.send(:include, Garcon::RunNow::Mixin)
-end
-
 require_relative 'chef/provider/civilize'
+require_relative 'chef/provider/development'
 require_relative 'chef/provider/download'
 require_relative 'chef/provider/house_keeping'
 require_relative 'chef/provider/node_cache'
-require_relative 'chef/provider/partial'
-require_relative 'chef/provider/recovery'
 require_relative 'chef/provider/zip_file'

data/lib/garcon/core_ext/array.rb

@@ -21,7 +21,7 @@ class Array
   # Get or set state of object. You can think of #object_state as an in-code
   # form of marshalling.
   #
-  def object_state(data=nil)
+  def object_state(data = nil)
     data ? replace(data) : dup
   end
 end

data/lib/garcon/core_ext/binding.rb

@@ -18,7 +18,6 @@
 #
 
 class Binding
-
   # Returns the call stack, same format as Kernel#caller()
   #
   def caller( skip=0 )

data/lib/garcon/core_ext/boolean.rb

@@ -18,6 +18,7 @@
 #
 
 # Add #blank? method to TrueClass class.
+#
 class TrueClass
   # True is never blank.
   #
@@ -42,6 +43,7 @@ class TrueClass
 end
 
 # Add #blank? method to FalseClass class.
+#
 class FalseClass
   # False is always blank.
   #

data/lib/garcon/core_ext/hash.rb

@@ -18,7 +18,6 @@
 #
 
 class Hash
-
   # Turn a hash into a method arguments.
   #
   #   h = { :list => [1,2], :base => "HI" }
@@ -55,7 +54,7 @@ class Hash
   # Get or set state of object. You can think of #object_state as an in-code
   # form of marshalling.
   #
-  def object_state(data=nil)
+  def object_state(data = nil)
     data ? replace(data) : dup
   end
 

data/lib/garcon/core_ext/kernel.rb

@@ -17,9 +17,7 @@
 # limitations under the License.
 #
 
-# Add #maybe
 module Kernel
-
   # Random generator that returns true or false. Can also take a block that has
   # a 50/50 chance to being executed.
   #

data/lib/garcon/core_ext/module.rb

@@ -18,7 +18,6 @@
 #
 
 class Module
-
   # Create an instance of Object and extend it with +self+.
   #
   #   mod = Module.new do

data/lib/garcon/core_ext/object.rb

@@ -17,10 +17,7 @@
 # limitations under the License.
 #
 
-
-# Add #blank?, #present?, #try and #try! methods to Object class.
 class Object
-
   # Returns true if the object is nil or empty (if applicable)
   #
   # @example

data/lib/garcon/core_ext/string.rb

@@ -17,21 +17,18 @@
 # limitations under the License.
 #
 
-# Adds `#contains?`, `#blank?` and `#shatter` methods to strings
-#
 class String
-
   # Get or set state of object. You can think of #object_state as an in-code
   # form of marshalling.
   #
-  def object_state(data=nil)
+  def object_state(data = nil)
     data ? replace(data) : dup
   end
 
-  # Common Unix cryptography method.
-  # This adds a default salt to the built-in crypt method.
+  # Common Unix cryptography method. This adds a default salt to the built-in
+  # crypt method.
   #
-  def crypt(salt=nil)
+  def crypt(salt = nil)
     salt ||= ((SecureRandom.random_number(26) +
               (SecureRandom.random_number(2) == 0 ? 65 : 97)).chr +
               (SecureRandom.random_number(26) +
@@ -56,7 +53,7 @@ class String
   #
   #   "a?".to_re  #=> /a?/
   #
-  def to_re(esc=false)
+  def to_re(esc = false)
     Regexp.new((esc ? Regexp.escape(self) : self))
   end
 
@@ -66,21 +63,18 @@ class String
   #
   #   "[".to_rx  #=> /\[/
   #
-  def to_rx(esc=true)
+  def to_rx(esc = true)
     Regexp.new((esc ? Regexp.escape(self) : self))
   end
 
   # Strips out whitespace then tests if the string is empty.
   #
-  # @example
-  #   "".blank?        # =>  true
-  #   "      ".blank?  # =>  true
-  #   " sup? ".blank?  # =>  false
+  #   "".blank?         #=>  true
+  #   "     ".blank?    #=>  true
+  #   " hey ho ".blank? #=>  false
   #
   # @return [Boolean]
-  #   True if blank, else false.
   #
-  # @api public
   def blank?
     strip.empty?
   end

data/lib/garcon/core_ext/struct.rb

@@ -18,7 +18,6 @@
 #
 
 class Struct
-
   # Get or set state of object. You can think of #object_state as an in-code
   # form of marshalling.
   #

data/lib/garcon/core_ext/symbol.rb

@@ -18,7 +18,6 @@
 #
 
 class Symbol
-
   # Override this in a child if it cannot be dup'ed
   #
   # @return [Object]

data/lib/garcon/core_ext/time.rb

@@ -17,7 +17,6 @@
 # limitations under the License.
 #
 
-# Add #elapse
 class Time
   # Tracks the elapse time of a code block.
   #

data/lib/garcon/core_ext.rb

@@ -21,17 +21,13 @@ require_relative 'core_ext/array'
 require_relative 'core_ext/binding'
 require_relative 'core_ext/boolean'
 require_relative 'core_ext/enumerable'
-require_relative 'core_ext/file'
-require_relative 'core_ext/filetest'
 require_relative 'core_ext/hash'
 require_relative 'core_ext/kernel'
-require_relative 'core_ext/lazy'
 require_relative 'core_ext/method_access'
 require_relative 'core_ext/nil'
 require_relative 'core_ext/numeric'
 require_relative 'core_ext/object'
 require_relative 'core_ext/pathname'
-require_relative 'core_ext/process'
 require_relative 'core_ext/random'
 require_relative 'core_ext/string'
 require_relative 'core_ext/struct'

data/lib/garcon/exceptions.rb

@@ -62,40 +62,5 @@ module Garcon
         end
       end
     end
-
-    # Raised when errors occur during configuration.
-    ConfigurationError             = Class.new(StandardError)
-
-    # Raised when an object's methods are called when it has not been
-    # properly initialized.
-    InitializationError            = Class.new(StandardError)
-
-    # If the maximum number of ReadWriteLock readers or writers is exceeded.
-    ResourceLimitError             = Class.new(StandardError)
-
-    # Raised by an `Executor` when it is unable to process a given task,
-    # possibly because of a reject policy or other internal error.
-    RejectedExecutionError         = Class.new(StandardError)
-
-    # Raised when an operation times out.
-    TimeoutError                   = Class.new(StandardError)
-    PollingError                   = Class.new(StandardError)
-
-    # Raised when node[:garcon][:databag_type] is not valid.
-    InvalidDataBagTypeError        = Class.new(RuntimeError)
-
-    # Raised when cipher direction is invalid.
-    InvalidCipherError             = Class.new(RuntimeError)
-
-    # Raised when no encryption key password is specified.
-    MissingEncryptionPasswordError = Class.new(RuntimeError)
-
-    ResourceNotFoundError          = Class.new(RuntimeError)
-    InvalidStateError              = Class.new(RuntimeError)
-    InvalidTransitionError         = Class.new(RuntimeError)
-    InvalidCallbackError           = Class.new(RuntimeError)
-    TransitionFailedError          = Class.new(RuntimeError)
-    TransitionConflictError        = Class.new(RuntimeError)
-    GuardFailedError               = Class.new(RuntimeError)
   end
 end

data/lib/garcon/task/executor.rb

@@ -17,7 +17,6 @@
 # limitations under the License.
 #
 
-require_relative '../exceptions'
 require_relative 'event'
 
 module Garcon

data/lib/garcon/task/ivar.rb

@@ -18,8 +18,6 @@
 #
 
 require 'thread'
-
-require_relative '../exceptions'
 require_relative 'obligation'
 require_relative 'observable'
 

data/lib/garcon/utility/file_helper.rb

@@ -17,6 +17,10 @@
 # limitations under the License.
 #
 
+require 'thread'
+require 'tempfile'
+require 'fileutils'
+
 module Garcon
   # Class methods that are added when you include Garcon
   #
@@ -93,7 +97,7 @@ module Garcon
           end
         end
       end
-      
+
       dirs.empty? ? nil : dirs
     end
 
@@ -166,5 +170,88 @@ module Garcon
     def normalize_path(path)
       path.sub(%r{^/}, '').tr('', '')
     end
+
+    def atomic_id
+      @atomic_id ||= 0
+      @atomic_id += 1
+    end
+
+    # Same as `File.open`, but acts on a temporary copy of named
+    # file, copying the file back to the original on completion.
+    #
+    # @uncommon
+    #   require 'facets/fileutils/atomic_open'
+    #
+    def atomic_open(file, mode='r', temp_dir = nil, &block)
+      temp_dir  = temp_dir || Dir.tmpdir
+      temp_file = Tempfile.new("#{aomtic_id}-" + File.basename(file), temp_dir)
+      FileUtils.cp(file, temp_file) if File.exist?(file)
+      File.open(temp_file, mode, &block)
+      FileUtils.cp(temp_file, file)
+    end
+
+    # Write to a file atomically. Useful for situations where you don't
+    # want other processes or threads to see half-written files.
+    #
+    #   File.atomic_write("important.txt") do |file|
+    #     file.write("hello")
+    #   end
+    #
+    # If your temporary directory is not on the same filesystem as the file
+    # you're trying to write, you can provide a different temporary directory.
+    #
+    #   File.atomic_write("important.txt", "tmp") do |file|
+    #     file.write("hello")
+    #   end
+    #
+    def atomic_write(file, temp_dir = nil)
+      temp_dir  = temp_dir || Dir.tmpdir
+      temp_file = Tempfile.new(File.basename(file), temp_dir)
+
+      yield temp_file
+      temp_file.close
+
+      begin
+        old_stat = File.stat(file)
+      rescue Errno::ENOENT
+        ext = "#{Thread.current.object_id}.#{Process.pid}.#{rand(1000000)}"
+        check_name = File.join(File.dirname(file), ".permissions_check.#{ext}")
+        File.open(check_name, "w") { }
+        old_stat = File.stat(check_name)
+        File.unlink(check_name)
+      end
+
+      FileUtils.mv(temp_file.path, file)
+      File.chown(old_stat.uid, old_stat.gid, file)
+      File.chmod(old_stat.mode, file)
+    end
+
+    # Reads in a file, removes blank lines and removes lines starting
+    # with '#' and then returns an array of all the remaining lines.
+    #
+    # Thr remark indicator can be overridden via the +:omit:+ option, which
+    # can be a regualar expression or a string that is match against the
+    # start of a line.
+    #
+    def read_list(filepath, options={})
+      chomp = options[:chomp]
+      omit  = case options[:omit]
+              when Regexp
+                omit
+              when nil
+                /^\s*\#/
+              else
+                /^\s*#{Regexp.escape(omit)}/
+              end
+
+      list = []
+      readlines(filepath).each do |line|
+        line = line.strip.chomp(chomp)
+        next if line.empty?
+        next if omit === line
+        list << line
+      end
+      list
+    end
   end
 end

data/lib/garcon/utility/retry.rb

@@ -18,7 +18,6 @@
 #
 
 require_relative 'timeout'
-require_relative '../exceptions'
 
 module Garcon
   # Class methods that are added when you include Garcon::Retry
@@ -27,8 +26,6 @@ module Garcon
     # Methods are also available as module-level methods as well as a mixin.
     extend self
 
-    include Garcon::Exceptions
-
     # Runs a code block, and retries it when an exception occurs. It is
     # configured using four optional parameters `:tries`, `:on`, `:sleep`,
     # `:match`, `:ensure` and runs the passed block. Should an exception

data/lib/garcon/utility/timeout.rb

@@ -18,7 +18,6 @@
 #
 
 require 'thread'
-require_relative '../exceptions'
 
 module Garcon
   # Class methods that are added when you include Garcon::Timeout
@@ -27,8 +26,6 @@ module Garcon
     # Methods are also available as module-level methods as well as a mixin.
     extend self
 
-    include Garcon::Exceptions
-
     # Wait the given number of seconds for the block operation to complete.
     # Intended to be a simpler and more reliable replacement to the Ruby
     # standard library `Timeout::timeout` method.

data/lib/garcon/utils.rb

@@ -23,7 +23,6 @@ require_relative 'utility/file_helper'
 require_relative 'utility/hookers'
 require_relative 'utility/interpolation'
 require_relative 'utility/memstash'
-require_relative 'utility/msg_from_god'
 require_relative 'utility/retry'
 require_relative 'utility/timeout'
 require_relative 'utility/url_helper'

data/lib/garcon/version.rb

@@ -27,7 +27,7 @@ module Garcon
   module Version
     MAJOR = 0
     MINOR = 0
-    PATCH = 2
+    PATCH = 3
 
     # Returns a version string by joining MAJOR, MINOR, and PATCH with '.'
     #