ansible_spec_plus 1.0.0

data/ansible_spec_plus.gemspec

@@ -0,0 +1,26 @@
+# -*- encoding: utf-8 -*-
+# lib = File.expand_path('../lib', __FILE__)
+# $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+# require 'ansible_spec/version'
+
+Gem::Specification.new do |gem|
+  gem.name          = "ansible_spec_plus"
+  gem.date          = Time.now.strftime("%Y-%m-%d")
+  gem.version       = "1.0.0"
+  gem.authors       = ["Meik Minks"]
+  gem.email         = ["mminks@inoxio.de"]
+  gem.description   = %q{Ansible Config Parser for Serverspec to test roles, hosts and playbooks. Providing test coverage.}
+  gem.summary       = %q{Ansible Config Parser for Serverspec to test roles, hosts and playbooks. Providing test coverage.}
+  gem.homepage      = "https://github.com/consort-it/ansible_spec_plus"
+  gem.license       = "MIT"
+  gem.files         = `git ls-files`.split($/)
+  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.require_paths = ["lib"]
+
+  gem.add_development_dependency "bundler", "~> 1.3"
+  gem.add_development_dependency 'rake', '~> 0'
+  gem.add_development_dependency 'diff-lcs', '~> 0'
+  gem.add_development_dependency 'simplecov', '~> 0'
+
+  gem.add_runtime_dependency 'ansible_spec', '~> 0.2', '>= 0.2.19'
+end

data/bin/asp

@@ -0,0 +1,72 @@
+#! /usr/bin/env ruby
+# coding: utf-8
+
+# TODO comment in again when ready
+# require 'ansible_spec_plus'
+require 'optparse'
+
+require_relative '../lib/ansible_spec_plus'
+
+ARGV.push('-h') if ARGV.empty?
+
+KNOWN_RESOURCES = [
+  'file',
+  'template',
+  'docker_container',
+  'docker_image',
+  'service',
+  'apt',
+  'pip',
+  'gem'
+]
+
+options = {}
+
+opt_parser = OptionParser.new do |opt|
+  opt.banner = "Ansible Spec Plus is an addon to 'ansible_spec' which enables you to run
+specs for Ansible roles, hosts and/or playbooks separately. Furthermore
+it provides you with a simple resource coverage summary.
+
+Usage: asp COMMAND [OPTIONS]"
+  opt.separator  ""
+  opt.separator  "Commands:"
+  opt.separator  "     list                                     # list all available specs"
+  opt.separator  "     [rolespec|hostspec|playbookspec] list    # list all available role/host/playbook specs"
+  opt.separator  ""
+  opt.separator  "Options:"
+
+  opt.on("-l", "--local", "running specs on local machine") do
+    ENV['BACKEND'] = 'exec'
+  end
+
+  opt.on("-h","--help","help") do
+    puts opt_parser
+  end
+end
+
+opt_parser.parse!
+
+if ARGV[0] == 'list'
+  options[:list] = true
+elsif ARGV[0] == 'rolespec'
+  if ARGV[1] == 'list'
+    options[:list_rolespec] = true
+  else
+    options[:run_rolespec] = ARGV[1]
+  end
+elsif ARGV[0] == 'hostspec'
+  if ARGV[1] == 'list'
+    options[:list_hostspec] = true
+  else
+    options[:run_hostspec] = ARGV[1]
+  end
+elsif ARGV[0] == 'playbookspec'
+  if ARGV[1] == 'list'
+    options[:list_playbookspec] = true
+  else
+    options[:run_playbookspec] = ARGV[1]
+  end
+else
+end
+
+AnsibleSpecPlus.new.run(options)

data/bin/asp-init

@@ -0,0 +1,78 @@
+#! /usr/bin/env ruby
+# coding: utf-8
+
+require "fileutils"
+
+def safe_create_spec_helper
+  content = File.open(File.dirname(__FILE__) + "/../lib/src/spec/spec_helper.rb").read
+  safe_mkdir("spec")
+  safe_touch("spec/spec_helper.rb")
+  File.open("spec/spec_helper.rb", 'w') do |f|
+    f.puts content
+  end
+
+end
+
+def safe_create_ansiblespec
+  content = File.open(File.dirname(__FILE__) + "/../lib/src/.ansiblespec").read
+  safe_touch(".ansiblespec")
+  File.open(".ansiblespec", 'w') do |f|
+    f.puts content
+  end
+end
+
+def safe_create_rspec
+  content = File.open(File.dirname(__FILE__) + "/../lib/src/.rspec").read
+  safe_touch(".rspec")
+  File.open(".rspec", 'w') do |f|
+    f.puts content
+  end
+end
+
+def safe_mkdir(dir)
+  unless FileTest.exist?("#{dir}")
+    FileUtils.mkdir_p("#{dir}")
+    TermColor.green
+    puts "\t\tcreate\t#{dir}"
+    TermColor.reset
+  else
+    TermColor.red
+    puts "\t\texists\t#{dir}"
+    TermColor.reset
+  end
+end
+
+def safe_touch(file)
+  unless File.exists? "#{file}"
+    File.open("#{file}", 'w') do |f|
+        #f.puts content
+    end
+    TermColor.green
+    puts "\t\tcreate\t#{file}"
+    TermColor.reset
+  else
+    TermColor.red
+    puts "\t\texists\t#{file}"
+    TermColor.reset
+  end
+end
+
+class TermColor
+  class << self
+    def reset   ; c 0 ; end
+
+    def red     ; c 31; end
+
+    def green   ; c 32; end
+
+    def c(num)
+      print "\e[#{num.to_s}m"
+    end
+  end
+end
+
+safe_create_spec_helper
+safe_create_ansiblespec
+safe_create_rspec
+
+exit 0

data/lib/ansible_spec_plus.rb

@@ -0,0 +1,653 @@
+require_relative '../lib/helpers/log'
+require_relative '../lib/ansiblespec_helper'
+
+require 'rake'
+require 'rspec/core/rake_task'
+require 'yaml'
+require 'ansible_spec'
+require 'pp'
+require 'json'
+
+class AnsibleSpecPlus
+  include Helpers::Log
+
+  if ENV['BASE_DIR']
+    BASE_DIR = ENV['BASE_DIR']
+  else
+    BASE_DIR = './'
+  end
+
+  ##################
+  # COMMON METHODS #
+  ##################
+
+  def run(options)
+    list_all_specs if options[:list] == true
+
+    list_role_specs if options[:list_rolespec] == true
+    list_host_specs if options[:list_hostspec] == true
+    list_playbook_specs if options[:list_playbookspec] == true
+
+    run_role_spec(options[:run_rolespec]) if options[:run_rolespec]
+    run_host_spec(options[:run_hostspec]) if options[:run_hostspec]
+    run_playbook_spec(options[:run_playbookspec]) if options[:run_playbookspec]
+  end
+
+  def list_all_specs
+    list_role_specs
+    list_host_specs
+    list_playbook_specs
+  end
+
+  def check_for_specs_in_file(file)
+    File.readlines(file).grep(/describe\s{1}/).any?
+  end
+
+  def analyze_resources(resources)
+    analyzed_resources = []
+
+    resources.each do |resource|
+      resource_type = nil
+
+      resource.keys.each do |key|
+        resource_type = key if KNOWN_RESOURCES.include?(key)
+      end
+
+      if resource_type.nil?
+        log.warn "Unknown resource: #{resource}"
+        next
+      end
+
+      skip = false
+
+      if resource.values[1].respond_to?(:each)
+        resource.values[1].each do |key, value|
+          skip = true if value =~ /\{\{/
+        end
+      else
+        skip = true if resource.values[1] =~ /\{\{/
+      end
+
+      if skip == true
+        log.warn "Don't know how to deal with '{{ }}' syntax: #{resource}"
+        next
+      end
+
+      if resource_type == 'file' || resource_type == 'template'
+        resource_type = 'File'
+        if resource.values[1].respond_to?(:each)
+          target = resource.values[1].select { |i| i =~ /path|dest/ }
+          resource_name = target.values[0]
+        else
+          target = resource.values[1].split(" ").select { |i| i =~ /path|dest/ }
+          resource_name = target.first.gsub(/.*=/,'')
+        end
+      elsif resource_type == 'docker_container'
+        resource_type = 'Docker container'
+        resource_name = resource.values[1]['name']
+      elsif resource_type == 'docker_image'
+        resource_type = 'Docker image'
+        resource_name = resource.values[1]['name']
+      elsif resource_type == 'service'
+        resource_type = 'Service'
+        if resource.values[1].respond_to?(:each)
+          resource_name = resource.values[1]['name']
+        else
+          resource_name = resource.values[1].split(" ")[0].gsub(/.*=/,'')
+        end
+      elsif resource_type =~ /apt|pip|gem/
+        if (resource_type == 'apt') && (! resource['apt'].include?('name'))
+          log.warn "Unknown resource: #{resource}"
+          next
+        end
+
+        resource_type = 'Package'
+        resource.each do |item|
+          next unless item[0] =~ /apt|pip|gem/
+
+          resource_name = item[1]['name']
+        end
+      else
+        next
+      end
+
+      analyzed_resources << "#{resource_type} \"#{resource_name}\""
+    end
+
+    return analyzed_resources
+  end
+
+  def get_hosts_from_vai_host_file
+    inventory_hosts = []
+    hosts_with_vagrant_vars = {}
+
+    Dir.chdir(BASE_DIR) do
+      begin
+        File.open('hosts', 'r') do |file|
+          file.each_line do |line|
+            pattern = /^#.*|^$\n|^\[.*|^\r\n?/
+            next if line =~ pattern
+            inventory_hosts << line
+          end
+        end
+      rescue => e
+        log.error "hosts file doesn't exist: #{e}"
+      end
+    end
+
+    inventory_hosts.each do |line|
+      hostname = line.split(' ').first
+
+      parts = line.match(/\s.*/).to_s.split(' ')
+
+      vars = {}
+      vars['name'] = hostname
+      parts.each do |part|
+        key = part.gsub(/=.*/,'')
+        value = part.gsub(/.*=/,'').gsub(/'|"/,'')
+        vars["#{key}"] = value
+      end
+
+      hosts_with_vagrant_vars[hostname] = [vars]
+    end
+
+    return hosts_with_vagrant_vars
+  end
+
+  def print_rounded_role_coverage(all_resources, differences)
+    if all_resources.count == 0
+      return "0%"
+    else
+      "#{((all_resources - differences).count.to_f / all_resources.count.to_f * 100.0).round}%"
+    end
+  end
+
+  def calculate_coverage(type, name)
+    Dir.chdir(BASE_DIR) do
+      json_report = File.read('report.json')
+      parsed_report = JSON.parse(json_report)
+
+      case type
+      when 'role'
+        all_known_resources = analyze_resources(load_role_resources(name))
+      when 'host'
+        all_known_resources = analyze_resources(load_host_resources(name))
+      when 'playbook'
+        all_known_resources = analyze_resources(load_playbook_resources(name))
+      else
+        raise "Unknow type '#{type}'. Should be either role, host or playbook."
+      end
+
+      tested_resources = []
+
+      parsed_report['examples'].each do |example|
+        tested_resources << example['full_description'].gsub(/"\s{1}.*/,'"')
+      end
+
+      tested_resources = tested_resources.uniq
+
+      differences = []
+
+      all_known_resources.each do |resource|
+        differences << resource if ! tested_resources.include?(resource)
+      end
+
+      puts "Total resources: #{all_known_resources.count}"
+      puts "Touched resources: #{(all_known_resources - differences).count}"
+      puts "Resource coverage: #{print_rounded_role_coverage(all_known_resources, differences)}"
+
+      if differences.count > 0
+        puts "\nUncovered resources:"
+        differences.each do |item|
+          puts "- #{item}"
+        end
+      end
+    end
+  end
+
+  ################
+  # ROLE METHODS #
+  ################
+
+  def list_role_specs
+    get_roles_with_specs.each do |role|
+      command = "asp rolespec #{role}"
+      description = "# run role specs for #{role}"
+
+      puts "#{command} #{description.rjust(40)}"
+    end
+  end
+
+  def run_role_spec(role)
+    if check_role_directory_available(role) && check_role_specs_available(role)
+      create_role_rake_task(role)
+
+      Dir.chdir(BASE_DIR) do
+        Rake.application["#{role}"].invoke()
+      end
+
+      calculate_coverage('role', role)
+    end
+  end
+
+  def get_all_roles
+    all_roles = []
+
+    Dir.chdir(BASE_DIR) do
+      Dir.glob("roles/*").each do |role|
+        all_roles << File.basename(role)
+      end
+    end
+
+    return all_roles
+  end
+
+  def get_roles_with_specs
+    roles_with_specs = []
+
+    Dir.chdir(BASE_DIR) do
+      get_all_roles.each do |role|
+        successes = 0
+
+        Dir.glob("roles/#{role}/spec/*_spec.rb").each do |file|
+          successes =+ 1 if File.size(file) > 1
+        end
+
+        roles_with_specs << File.basename(role) if successes > 0
+      end
+    end
+
+    return roles_with_specs
+  end
+
+  def get_roles_without_specs
+    get_all_roles - get_roles_with_specs
+  end
+
+  def check_role_directory_available(role)
+    Dir.chdir(BASE_DIR) do
+      if ! Dir.exists?("roles/#{role}")
+        log.error "Directory 'roles/#{role}' does not exist. That's strange, isn't it?"
+        return false
+      end
+    end
+
+    return true
+  end
+
+  def check_role_specs_available(role)
+    Dir.chdir(BASE_DIR) do
+      successes = 0
+
+      Dir.glob("roles/#{role}/spec/*_spec.rb").each do |file|
+        successes =+ 1 if File.size(file) > 1
+      end
+
+      if successes == 0
+        # log.error "'#{role}' does not have specs but you requested me to run specs. Huu?"
+        return false
+      end
+    end
+
+    return true
+  end
+
+  def get_hosts_where_role_is_used(role)
+    role_used_in_hosts = []
+
+    Dir.chdir(BASE_DIR) do
+      YAML.load_file("site.yml").each do |playbook|
+        YAML.load_file(playbook['include'].to_s).each do |site|
+          site['roles'].each do |playbook_role|
+            if playbook_role.respond_to?(:each)
+              role_used_in_hosts << site['name'].to_s if playbook_role['role'].include?(role)
+            else
+              role_used_in_hosts << site['name'].to_s if playbook_role.include?(role)
+            end
+          end
+        end
+      end
+    end
+
+    return role_used_in_hosts
+  end
+
+  def load_role_resources(name)
+    resources = []
+
+    Dir.chdir(BASE_DIR) do
+      Dir.glob("roles/#{name}/tasks/*.yml").each do |file|
+        AnsibleSpec.load_playbook(file).each do |resource|
+          resources << resource
+        end
+      end
+    end
+
+    return resources
+  end
+
+  def create_role_rake_task(role)
+    Dir.chdir(BASE_DIR) do
+      properties = AnsibleSpecHelper.get_properties
+      cfg = AnsibleSpec::AnsibleCfg.new
+      get_hosts_where_role_is_used = get_hosts_where_role_is_used(role)
+
+      properties.each do |property|
+        next unless property['name'] == get_hosts_where_role_is_used.first
+
+        if property['hosts'].empty?
+          if ! get_hosts_from_vai_host_file.keys.include?(get_hosts_where_role_is_used.first)
+            raise "Uuups. I cannot find '#{get_hosts_where_role_is_used.first}' in your hosts file. 'vagrant up #{get_hosts_where_role_is_used.first}' may help."
+          end
+
+          get_hosts_from_vai_host_file.each do |host, values|
+            values.each do |property|
+              next unless property['name'] == get_hosts_where_role_is_used.first
+
+              RSpec::Core::RakeTask.new(role.to_sym) do |t|
+                log.info "Run role tests for #{role} on #{get_hosts_where_role_is_used.first} (#{property["ansible_ssh_host"]}:#{property["ansible_ssh_port"]})"
+
+                ENV['TARGET_HOST'] = property["ansible_ssh_host"]
+                ENV['TARGET_PORT'] = property["ansible_ssh_port"].to_s
+                ENV['TARGET_PRIVATE_KEY'] = property["ansible_ssh_private_key_file"]
+                ENV['TARGET_USER'] = property["ansible_ssh_user"]
+
+                t.pattern = '{' + cfg.roles_path.join(',') + '}/{' + role + '}/spec/*_spec.rb'
+              end
+            end
+          end
+        else
+          property['hosts'].each do |host|
+            RSpec::Core::RakeTask.new(role.to_sym) do |t|
+              log.info "Run role tests for #{role} on #{get_hosts_where_role_is_used.first} (#{host['uri']})"
+
+              ENV['TARGET_HOST'] = host['uri']
+
+              t.pattern = '{' + cfg.roles_path.join(',') + '}/{' + role + '}/spec/*_spec.rb'
+            end
+          end
+        end
+      end
+    end
+  end
+
+  ################
+  # HOST METHODS #
+  ################
+
+  def list_host_specs
+    get_hosts_with_specs.each do |host|
+      command = "asp hostspec #{host}"
+      description = "# run host specs for #{host}"
+
+      puts "#{command} #{description.rjust(40)}"
+    end
+  end
+
+  def create_host_rake_task(host)
+    Dir.chdir(BASE_DIR) do
+      properties = AnsibleSpecHelper.get_properties
+      cfg = AnsibleSpec::AnsibleCfg.new
+
+      properties.each do |property|
+        next unless property['name'] == host
+
+        if property['hosts'].empty?
+          get_hosts_from_vai_host_file.each do |host, values|
+            values.each do |property|
+              RSpec::Core::RakeTask.new(host.to_sym) do |t|
+                log.info "Run host tests for #{host}"
+
+                ENV['TARGET_HOST'] = property["ansible_ssh_host"]
+                ENV['TARGET_PORT'] = property["ansible_ssh_port"].to_s
+                ENV['TARGET_PRIVATE_KEY'] = property["ansible_ssh_private_key_file"]
+                ENV['TARGET_USER'] = property["ansible_ssh_user"]
+
+                t.pattern = "spec/#{host}/*_spec.rb"
+              end
+            end
+          end
+        else
+          property['hosts'].each do |host|
+            RSpec::Core::RakeTask.new(property["name"].to_sym) do |t|
+              log.info "Run host tests for #{property["name"]}"
+
+              ENV['TARGET_HOST'] = host['uri']
+
+              t.pattern = "spec/#{property["name"]}/*_spec.rb"
+            end
+          end
+        end
+      end
+    end
+  end
+
+  def run_host_spec(host)
+    create_host_rake_task(host)
+
+    Dir.chdir(BASE_DIR) do
+      Rake.application.invoke_task("#{host}")
+    end
+
+    calculate_coverage('host', host)
+  end
+
+  def load_host_resources(name)
+    resources = []
+
+    Dir.chdir(BASE_DIR) do
+      YAML.load_file('./site.yml').each do |site|
+        next unless site.values[0] =~ /#{name}\.(yml|yaml)/
+
+        playbook_path = site.values[0]
+
+        AnsibleSpec.load_playbook(playbook_path).each do |playbook|
+          next if playbook['tasks'].nil?
+
+          playbook['tasks'].map { |task| resources << task }
+        end
+      end
+    end
+
+    return resources.flatten
+  end
+
+  def get_hosts_with_specs
+    hosts_with_specs = []
+
+    get_vagrant_or_regular_ansible_hosts.each do |host|
+      hosts_with_specs << host if check_for_host_specs(host)
+    end
+
+    return hosts_with_specs.uniq
+  end
+
+  def get_vagrant_or_regular_ansible_hosts
+    hosts = []
+
+    Dir.chdir(BASE_DIR) do
+      properties = AnsibleSpecHelper.get_properties
+      cfg = AnsibleSpec::AnsibleCfg.new
+
+      properties.each do |property|
+        if property['hosts'].empty?
+          get_hosts_from_vai_host_file.each do |host, values|
+            values.each do |property|
+              hosts << property['name'] if check_for_existing_playbook(property['name'])
+            end
+          end
+        else
+          property['hosts'].each do |host|
+            hosts << property['name'] if check_for_existing_playbook(property['name'])
+          end
+        end
+      end
+    end
+
+    return hosts
+  end
+
+  def check_for_host_specs(host)
+    Dir.chdir(BASE_DIR) do
+      if File.directory?("./spec/#{host}")
+        Dir.glob("./spec/#{host}/*_spec.rb").each do |file|
+          if check_for_specs_in_file(file)
+            return true
+          else
+            return false
+          end
+        end
+      else
+        return false
+      end
+    end
+  end
+
+  def get_roles_of_host(host)
+    roles_with_specs = []
+
+    Dir.chdir(BASE_DIR) do
+      playbook_path = ''
+
+      YAML.load_file('./site.yml').each do |site|
+        next unless site.values[0] =~ /#{host}\.(yml|yaml)/
+
+        playbook_path = site.values[0]
+      end
+
+      YAML.load_file(playbook_path).each do |playbook|
+        playbook['roles'].each do |role|
+          roles_with_specs << role if check_role_specs_available(role)
+        end
+      end
+    end
+
+    return roles_with_specs.uniq
+  end
+
+  ####################
+  # PLAYBOOK METHODS #
+  ####################
+
+  def list_playbook_specs
+    get_playbooks_with_host_and_or_role_specs.each do |playbook|
+      command = "asp playbookspec #{playbook}"
+      description = "# run playbook specs (host specs and role specs) for #{playbook} playbook"
+
+      puts "#{command} #{description.rjust(77)}"
+    end
+  end
+
+  def run_playbook_spec(playbook)
+    create_playbook_rake_task(playbook)
+
+    Dir.chdir(BASE_DIR) do
+      Rake.application.invoke_task("#{playbook}")
+    end
+
+    calculate_coverage('playbook', playbook)
+  end
+
+  def create_playbook_rake_task(playbook)
+    ansiblespec_roles = []
+
+    hostname = playbook.gsub(/\.yml|\.yaml/,'')
+
+    get_roles_of_host(hostname).each do |role|
+      ansiblespec_roles << role if check_role_specs_available(role)
+    end
+
+    Dir.chdir(BASE_DIR) do
+      properties = AnsibleSpecHelper.get_properties
+      cfg = AnsibleSpec::AnsibleCfg.new
+
+      if properties.select { |item| item['name'] == hostname}[0]['hosts'].empty?
+        get_hosts_from_vai_host_file.select { |name,_| name == hostname }.each do |item|
+          ENV['TARGET_HOST'] = item.flatten.last['ansible_ssh_host']
+          ENV['TARGET_PORT'] = item.flatten.last['ansible_ssh_port']
+          ENV['TARGET_PRIVATE_KEY'] = item.flatten.last['ansible_ssh_private_key_file']
+          ENV['TARGET_USER'] = item.flatten.last['ansible_ssh_user']
+        end
+      else
+        ENV['TARGET_HOST'] = properties.select { |item| item['name'] == hostname}[0]['hosts'][0]['uri']
+      end
+
+      RSpec::Core::RakeTask.new("#{hostname}".to_sym) do |t|
+        log.info "Run playbook tests for #{hostname}"
+
+        roles_pattern = ansiblespec_roles.nil? ? '' : ",{#{cfg.roles_path.join(',')}}/{#{ansiblespec_roles.uniq.join(',')}}/spec/*_spec.rb"
+        host_pattern = check_for_host_specs(hostname) ? ",spec/#{hostname}/*_spec.rb" : ''
+
+        t.pattern = roles_pattern + host_pattern
+      end
+    end
+  end
+
+  def load_playbook_resources(name)
+    resources = []
+
+    # collect role resources
+    Dir.chdir(BASE_DIR) do
+      YAML.load_file('./site.yml').each do |site|
+        next unless site.values[0] =~ /#{name}\.(yml|yaml)/
+
+        playbook_path = site.values[0]
+
+        AnsibleSpec.load_playbook(playbook_path).each do |playbook|
+          playbook['roles'].map { |role| resources << load_role_resources(role) }
+        end
+      end
+    end
+
+    # collect host resources
+    resources = resources.flatten + load_host_resources(name)
+
+    return resources
+  end
+
+  def check_for_existing_playbook(host)
+    Dir.chdir(BASE_DIR) do
+      if File.exists?("#{host}.yml")
+        return true
+      else
+        return false
+      end
+    end
+  end
+
+  def get_playbooks_host_spec_summary
+    playbooks = []
+
+    Dir.chdir(BASE_DIR) do
+      YAML.load_file('./site.yml').each do |site|
+        Dir.glob(site.values[0]).each do |playbook|
+          playbook = File.basename(playbook)
+          host = playbook.gsub(/\.yml|\.yaml/,'')
+
+          playbooks << { playbook => check_for_host_specs(host) }
+        end
+      end
+    end
+
+    return playbooks.uniq
+  end
+
+  def get_playbooks_with_host_and_or_role_specs
+    playbooks = []
+
+    get_playbooks_host_spec_summary.each do |entry|
+      host = entry.keys[0].gsub(/\.yml|\.yaml/,'')
+      has_specs = entry.values[0]
+
+      if has_specs
+        playbooks << host
+      else
+        get_roles_of_host(host).each do |role|
+          playbooks << host if check_role_specs_available(role)
+        end
+      end
+    end
+
+    return playbooks.uniq
+  end
+end