garcun 0.0.2

data/lib/garcon/utility/faker/locales/en.yml

@@ -0,0 +1,21 @@
+en:
+  faker:
+    separator: ' & '
+    company:
+      # Buzzword wordlist from http://www.1728.com/buzzword.htm
+      buzzwords:
+        - ["Adaptive", "Advanced", "Ameliorated", "Assimilated", "Automated", "Balanced", "Business-focused", "Centralized", "Cloned", "Compatible", "Configurable", "Cross-group", "Cross-platform", "Customer-focused", "Customizable", "Decentralized", "De-engineered", "Devolved", "Digitized", "Distributed", "Diverse", "Down-sized", "Enhanced", "Enterprise-wide", "Ergonomic", "Exclusive", "Expanded", "Extended", "Face to face", "Focused", "Front-line", "Fully-configurable", "Function-based", "Fundamental", "Future-proofed", "Grass-roots", "Horizontal", "Implemented", "Innovative", "Integrated", "Intuitive", "Inverse", "Managed", "Mandatory", "Monitored", "Multi-channelled", "Multi-lateral", "Multi-layered", "Multi-tiered", "Networked", "Object-based", "Open-architected", "Open-source", "Operative", "Optimized", "Optional", "Organic", "Organized", "Persevering", "Persistent", "Phased", "Polarised", "Pre-emptive", "Proactive", "Profit-focused", "Profound", "Programmable", "Progressive", "Public-key", "Quality-focused", "Reactive", "Realigned", "Re-contextualized", "Re-engineered", "Reduced", "Reverse-engineered", "Right-sized", "Robust", "Seamless", "Secured", "Self-enabling", "Sharable", "Stand-alone", "Streamlined", "Switchable", "Synchronised", "Synergistic", "Synergized", "Team-oriented", "Total", "Triple-buffered", "Universal", "Up-sized", "Upgradable", "User-centric", "User-friendly", "Versatile", "Virtual", "Visionary", "Vision-oriented"]
+        - ["24 hour", "24/7", "3rd generation", "4th generation", "5th generation", "6th generation", "actuating", "analyzing", "asymmetric", "asynchronous", "attitude-oriented", "background", "bandwidth-monitored", "bi-directional", "bifurcated", "bottom-line", "clear-thinking", "client-driven", "client-server", "coherent", "cohesive", "composite", "context-sensitive", "contextually-based", "content-based", "dedicated", "demand-driven", "didactic", "directional", "discrete", "disintermediate", "dynamic", "eco-centric", "empowering", "encompassing", "even-keeled", "executive", "explicit", "exuding", "fault-tolerant", "foreground", "fresh-thinking", "full-range", "global", "grid-enabled", "heuristic", "high-level", "holistic", "homogeneous", "human-resource", "hybrid", "impactful", "incremental", "intangible", "interactive", "intermediate", "leading edge", "local", "logistical", "maximized", "methodical", "mission-critical", "mobile", "modular", "motivating", "multimedia", "multi-state", "multi-tasking", "national", "needs-based", "neutral", "next generation", "non-volatile", "object-oriented", "optimal", "optimizing", "radical", "real-time", "reciprocal", "regional", "responsive", "scalable", "secondary", "solution-oriented", "stable", "static", "systematic", "systemic", "system-worthy", "tangible", "tertiary", "transitional", "uniform", "upward-trending", "user-facing", "value-added", "web-enabled", "well-modulated", "zero administration", "zero defect", "zero tolerance"]
+        - ["ability", "access", "adapter", "algorithm", "alliance", "analyzer", "application", "approach", "architecture", "archive", "artificial intelligence", "array", "attitude", "benchmark", "budgetary management", "capability", "capacity", "challenge", "circuit", "collaboration", "complexity", "concept", "conglomeration", "contingency", "core", "customer loyalty", "database", "data-warehouse", "definition", "emulation", "encoding", "encryption", "extranet", "firmware", "flexibility", "focus group", "forecast", "frame", "framework", "function", "functionalities", "Graphic Interface", "groupware", "Graphical User Interface", "hardware", "help-desk", "hierarchy", "hub", "implementation", "info-mediaries", "infrastructure", "initiative", "installation", "instruction set", "interface", "internet solution", "intranet", "knowledge user", "knowledge base", "local area network", "leverage", "matrices", "matrix", "methodology", "middleware", "migration", "model", "moderator", "monitoring", "moratorium", "neural-net", "open architecture", "open system", "orchestration", "paradigm", "parallelism", "policy", "portal", "pricing structure", "process improvement", "product", "productivity", "project", "projection", "protocol", "secured line", "service-desk", "software", "solution", "standardization", "strategy", "structure", "success", "superstructure", "support", "synergy", "system engine", "task-force", "throughput", "time-frame", "toolset", "utilisation", "website", "workforce"]
+      # BS wordlist from http://dack.com/web/bullshit.html
+      bs:
+        - ["implement", "utilize", "integrate", "streamline", "optimize", "evolve", "transform", "embrace", "enable", "orchestrate", "leverage", "reinvent", "aggregate", "architect", "enhance", "incentivize", "morph", "empower", "envisioneer", "monetize", "harness", "facilitate", "seize", "disintermediate", "synergize", "strategize", "deploy", "brand", "grow", "target", "syndicate", "synthesize", "deliver", "mesh", "incubate", "engage", "maximize", "benchmark", "expedite", "reintermediate", "whiteboard", "visualize", "repurpose", "innovate", "scale", "unleash", "drive", "extend", "engineer", "revolutionize", "generate", "exploit", "transition", "e-enable", "iterate", "cultivate", "matrix", "productize", "redefine", "recontextualize"]
+        - ["clicks-and-mortar", "value-added", "vertical", "proactive", "robust", "revolutionary", "scalable", "leading-edge", "innovative", "intuitive", "strategic", "e-business", "mission-critical", "sticky", "one-to-one", "24/7", "end-to-end", "global", "B2B", "B2C", "granular", "frictionless", "virtual", "viral", "dynamic", "24/365", "best-of-breed", "killer", "magnetic", "bleeding-edge", "web-enabled", "interactive", "dot-com", "sexy", "back-end", "real-time", "efficient", "front-end", "distributed", "seamless", "extensible", "turn-key", "world-class", "open-source", "cross-platform", "cross-media", "synergistic", "bricks-and-clicks", "out-of-the-box", "enterprise", "integrated", "impactful", "wireless", "transparent", "next-generation", "cutting-edge", "user-centric", "visionary", "customized", "ubiquitous", "plug-and-play", "collaborative", "compelling", "holistic", "rich"]
+        - ["synergies", "web-readiness", "paradigms", "markets", "partnerships", "infrastructures", "platforms", "initiatives", "channels", "eyeballs", "communities", "ROI", "solutions", "e-tailers", "e-services", "action-items", "portals", "niches", "technologies", "content", "vortals", "supply-chains", "convergence", "relationships", "architectures", "interfaces", "e-markets", "e-commerce", "systems", "bandwidth", "infomediaries", "models", "mindshare", "deliverables", "users", "schemas", "networks", "applications", "metrics", "e-business", "functionalities", "experiences", "web services", "methodologies"]
+
+    hacker:
+      abbreviation: [TCP,HTTP,SDD,RAM,GB,CSS,SSL,AGP,SQL,FTP,PCI,AI,ADP,RSS,XML,EXE,COM,HDD,THX,SMTP,SMS,USB,PNG,SAS,IB,SCSI,JSON,XSS,JBOD]
+      adjective: [auxiliary,primary,back-end,digital,open-source,virtual,cross-platform,redundant,online,haptic,multi-byte,bluetooth,wireless,1080p,neural, optical,solid state,mobile]
+      noun: [driver,protocol,bandwidth,panel,microchip,program,port,card,array, interface,system,sensor,firewall,hard drive,pixel,alarm,feed,monitor,application,transmitter,bus,circuit,capacitor,matrix]
+      verb: [back up,bypass,hack,override,compress,copy,navigate,index,connect,generate,quantify,calculate,synthesize,input,transmit,program,reboot,parse]
+      ingverb: [backing up,bypassing,hacking,overriding,compressing,copying, navigating,indexing,connecting,generating,quantifying,calculating, synthesizing,transmitting,programming,parsing]

data/lib/garcon/utility/file_helper.rb

@@ -0,0 +1,170 @@
+# encoding: UTF-8
+#
+# Author:    Stefano Harding <riddopic@gmail.com>
+# License:   Apache License, Version 2.0
+# Copyright: (C) 2014-2015 Stefano Harding
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+
+module Garcon
+  # Class methods that are added when you include Garcon
+  #
+  module FileHelper
+    # Methods are also available as module-level methods as well as a mixin.
+    extend self
+
+    # Checks in PATH returns true if the command is found.
+    #
+    # @param [String] command
+    #   The name of the command to look for.
+    #
+    # @return [Boolean]
+    #   True if the command is found in the path.
+    #
+    def command_in_path?(command)
+      found = ENV['PATH'].split(File::PATH_SEPARATOR).map do |p|
+        File.exist?(File.join(p, command))
+      end
+      found.include?(true)
+    end
+
+    # Looks for the first occurrence of program within path.
+    #
+    # @param [String] cmd
+    #   The name of the command to find.
+    #
+    # @param [String] path
+    #   The path to search for the command.
+    #
+    # @return [String, NilClass]
+    #
+    # @api public
+    def which(prog, path = ENV['PATH'])
+      path.split(File::PATH_SEPARATOR).each do |dir|
+        file = File.join(dir, prog)
+        return file if File.executable?(file) && !File.directory?(file)
+      end
+
+      nil
+    end
+
+    # In block form, yields each program within path. In non-block form,
+    # returns an array of each program within path. Returns nil if not found
+    # found.
+    #
+    # @example
+    #   whereis('ruby')
+    #     # => [
+    #         [0] "/opt/chefdk/embedded/bin/ruby",
+    #         [1] "/usr/bin/ruby",
+    #         [2] "/Users/sharding/.rvm/rubies/ruby-2.2.0/bin/ruby",
+    #         [3] "/usr/bin/ruby"
+    #     ]
+    #
+    # @param [String] cmd
+    #   The name of the command to find.
+    #
+    # @param [String] path
+    #   The path to search for the command.
+    #
+    # @return [String, Array, NilClass]
+    #
+    # @api public
+    def whereis(prog, path = ENV['PATH'])
+      dirs = []
+      path.split(File::PATH_SEPARATOR).each do |dir|
+        f = File.join(dir,prog)
+        if File.executable?(f) && !File.directory?(f)
+          if block_given?
+            yield f
+          else
+            dirs << f
+          end
+        end
+      end
+      
+      dirs.empty? ? nil : dirs
+    end
+
+    # Get a recusive list of files inside a path.
+    #
+    # @param [String] path
+    #   some path string or Pathname
+    # @param [Block] ignore
+    #   a proc/block that returns true if a given path should be ignored, if a
+    #   path is ignored, nothing below it will be searched either.
+    #
+    # @return [Array<Pathname>]
+    #   array of Pathnames for each file (no directories)
+    #
+    def all_files_under(path, &ignore)
+      path = Pathname(path)
+
+      if path.directory?
+        path.children.flat_map do |child|
+          all_files_under(child, &ignore)
+        end.compact
+      elsif path.file?
+        if block_given? && ignore.call(path)
+          []
+        else
+          [path]
+        end
+      else
+        []
+      end
+    end
+
+    # Takes an object, which can be a literal string or a string containing
+    # glob expressions, or a regexp, or a proc, or anything else that responds
+    # to #match or #call, and returns whether or not the given path matches
+    # that matcher.
+    #
+    # @param [String, #match, #call] matcher
+    #   a matcher String, RegExp, Proc, etc.
+    #
+    # @param [String] path
+    #   a path as a string
+    #
+    # @return [Boolean]
+    #   whether the path matches the matcher
+    #
+    def path_match(matcher, path)
+      case
+      when matcher.is_a?(String)
+        if matcher.include? '*'
+          File.fnmatch(matcher, path)
+        else
+          path == matcher
+        end
+      when matcher.respond_to?(:match)
+        !matcher.match(path).nil?
+      when matcher.respond_to?(:call)
+        matcher.call(path)
+      else
+        File.fnmatch(matcher.to_s, path)
+      end
+    end
+
+    # Normalize a path to not include a leading slash
+    #
+    # @param [String] path
+    #
+    # @return [String]
+    #
+    def normalize_path(path)
+      path.sub(%r{^/}, '').tr('', '')
+    end
+  end
+end

data/lib/garcon/utility/hookers.rb

@@ -0,0 +1,178 @@
+# encoding: UTF-8
+#
+# Author:    Stefano Harding <riddopic@gmail.com>
+# License:   Apache License, Version 2.0
+# Copyright: (C) 2014-2015 Stefano Harding
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+
+require_relative 'uber/options'
+require_relative 'uber/inheritable_attr'
+
+# No not that kind! callback hooks.
+#
+module Garcon
+  module Hookers
+    module ClassMethods
+      def define_hookers(*names)
+        options = extract_options!(names)
+        names.each { |name| setup_hooker(name, options) }
+      end
+      alias_method :define_hooker, :define_hookers
+
+      def run_hooker(name, *args)
+        run_hooker_for(name, self, *args)
+      end
+
+      def run_hooker_for(name, scope, *args)
+        _hookers[name].run(scope, *args)
+      end
+
+      def callbacks_for_hooker(name)
+        _hookers[name]
+      end
+
+      private #        P R O P R I E T À   P R I V A T A   Vietato L'accesso
+
+      def setup_hooker(name, options)
+        _hookers[name] = Hooker.new(options)
+        define_hooker_writer(name)
+      end
+
+      def define_hooker_writer(name)
+        instance_eval(*hooker_writer_args(name))
+      end
+
+      def hooker_writer_args(name)
+        str = <<-RUBY_EVAL
+          def #{name}(method=nil, &block)
+            _hookers[:#{name}] << (block || method)
+          end
+        RUBY_EVAL
+
+        [str, __FILE__, __LINE__ + 1]
+      end
+
+      def extract_options!(args)
+        args.last.is_a?(Hash) ? args.pop : {}
+      end
+
+      def included(descendant)
+        descendant.class_eval do
+          extend Uber::InheritableAttr
+          extend ClassMethods
+          inheritable_attr :_hookers
+          self._hookers = BunchOfHookers.new
+        end
+      end
+    end
+
+    extend ClassMethods
+
+    def run_hooker(name, *args)
+      self.class.run_hooker_for(name, self, *args)
+    end
+
+    class BunchOfHookers < Hash
+      def [](name)
+        super(name.to_sym)
+      end
+
+      def []=(name, values)
+        super(name.to_sym, values)
+      end
+
+      def clone
+        super.tap do |cloned|
+          each { |name, callbacks| cloned[name] = callbacks.clone }
+        end
+      end
+    end
+
+    class Hooker < Array
+      def initialize(options)
+        super()
+        @options = options
+      end
+
+      def run(scope, *args)
+        inject(Results.new) do |results, callback|
+          executed = execute_callback(scope, callback, *args)
+
+          return results.halted! unless continue_execution?(executed)
+          results << executed
+        end
+      end
+
+      def <<(callback)
+        super Uber::Options::Value.new(callback, dynamic: true)
+      end
+
+      private #        P R O P R I E T À   P R I V A T A   Vietato L'accesso
+
+      def execute_callback(scope, callback, *args)
+        callback.evaluate(scope, *args)
+      end
+
+      def continue_execution?(result)
+        @options[:halts_on_falsey] ? result : true
+      end
+
+      class Results < Array
+        def initialize(*)
+          super
+          @halted = false
+        end
+
+        def halted!
+          @halted = true
+          self
+        end
+
+        def halted?
+          @halted
+        end
+
+        def not_halted?
+          not @halted
+        end
+      end
+    end
+
+    module InstanceHookers
+      include ClassMethods
+
+      def run_hooker(name, *args)
+        run_hooker_for(name, self, *args)
+      end
+
+      private #        P R O P R I E T À   P R I V A T A   Vietato L'accesso
+
+      def _hookers
+        @_hookers ||= self.class._hookers.clone
+      end
+
+      module ClassMethods
+        def define_hooker_writer(name)
+          super
+          class_eval(*hooker_writer_args(name))
+        end
+      end
+
+      def self.included(descendant)
+        descendant.extend(ClassMethods)
+      end
+    end
+  end
+end

data/lib/garcon/utility/interpolation.rb

@@ -0,0 +1,90 @@
+# encoding: UTF-8
+#
+# Author:    Stefano Harding <riddopic@gmail.com>
+# License:   Apache License, Version 2.0
+# Copyright: (C) 2014-2015 Stefano Harding
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+
+module Garcon
+  module Interpolation
+    # Methods are also available as module-level methods as well as a mixin.
+    extend self
+
+    # Interpolate provides a means of externally using Ruby string
+    # interpolation mechinism.
+    #
+    # @example
+    #   node[:ldap][:basedir] = '/opt'
+    #   node[:ldap][:homedir] = '%{basedir}/openldap/slap/happy'
+    #
+    #   interpolate(node[:ldap])[:homedir]  # => "/opt/openldap/slap/happy"
+    #
+    # @param [String] item
+    #   The string to interpolate.
+    #
+    # @param [String, Hash] parent
+    #   The string used for substitution.
+    #
+    # @return [String]
+    #   The interpolated string.
+    #
+    # @api public
+    def interpolate(item = self, parent = nil)
+      item = render item, parent
+      item.is_a?(Hash) ? ::Mash.new(item) : item
+    end
+
+    private #        P R O P R I E T À   P R I V A T A   Vietato L'accesso
+
+    # Return a symbol if key is a symbol using duck quacking.
+    #
+    # @param [Object] key
+    #   The object to duck quack for a :to_sym method.
+    #
+    # @return [Boolean]
+    #    True if object reponds to :to_sym quack duck, else false.
+    #
+    # @api private
+    def sym(key)
+      key.respond_to?(:to_sym) ? key.to_sym : key
+    end
+
+    # Provides recursive interpolation of node objects, using standard
+    # string interpolation methods.
+    #
+    # @param [String] item
+    #   The string to interpolate.
+    #
+    # @param [String, Hash] parent
+    #   The string used for substitution.
+    #
+    # @return [String]
+    #
+    # @api private
+    def render(item, parent = nil)
+      item = item.to_hash if item.respond_to?(:to_hash)
+      if item.is_a?(Hash)
+        item = item.inject({}) { |memo, (k,v)| memo[sym(k)] = v; memo }
+        item.inject({}) {|memo, (k,v)| memo[sym(k)] = render(v, item); memo}
+      elsif item.is_a?(Array)
+        item.map { |i| render(i, parent) }
+      elsif item.is_a?(String)
+        item % parent rescue item
+      else
+        item
+      end
+    end
+  end
+end