serverspec-clc 2.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 10695fdfb1ccbe23909f4195d9744b79c210f20f
+  data.tar.gz: 90dc82bb0f1e1557f26803dad629b14a96b8fd12
+SHA512:
+  metadata.gz: 0f9cf03ef351be5d7a69da77fa05bf31667f2403e64946008003d112f3da04bd8d60844d626bc2c829c5721403e4235fe592e1b980078b10c16ec29f96e68e6b
+  data.tar.gz: 8d887729246551fde0ceaca0edf8dac480df5d00bcc40d4560c393cb822737bff30ada47e3d5a9cb1018fb4672b2f63ad88ceee8442e41017258fe17ec1ebc51

data/.gitignore

@@ -0,0 +1,26 @@
+*.gem
+*.rbc
+*.swp
+.bundle
+.rvmrc
+.versions.conf
+.config
+.yardoc
+.rspec
+.idea/
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+Vagrantfile
+vendor/
+.DS_Store
+Gemfile.local

data/.gitmodules

@@ -0,0 +1,3 @@
+[submodule "integration-test"]
+	path = integration-test
+	url = https://github.com/serverspec/serverspec-integration-test.git

data/.travis.yml

@@ -0,0 +1,14 @@
+language: ruby
+
+rvm:
+  - 1.8.7
+  - 1.9.3
+  - 2.0.0
+  - 2.1.1
+
+before_install:
+  - gem update bundler
+
+script:
+  - bundle exec rake spec
+

data/Gemfile

@@ -0,0 +1,8 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in serverspec.gemspec
+gemspec
+
+# Put Gemfile.local to use arbitrary gems for your use case.
+path = Pathname.new("Gemfile.local")
+eval(path.read) if path.exist?

data/Guardfile

@@ -0,0 +1,4 @@
+guard :rspec do
+  watch(%r{^spec/.+/.+_spec\.rb$})
+  watch('spec/spec_helper.rb')  { "spec" }
+end

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2013 Gosuke Miyashita
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,15 @@
+# Serverspec [![Gem Version](https://badge.fury.io/rb/serverspec.png)](http://badge.fury.io/rb/serverspec) [![BuildStatus](https://secure.travis-ci.org/serverspec/serverspec.png)](http://travis-ci.org/serverspec/serverspec) [![Code Climate](https://codeclimate.com/github/serverspec/serverspec.png)](https://codeclimate.com/github/serverspec/serverspec) [![wercker status](https://app.wercker.com/status/526d1ff4df6eadaa793dca1affcaed35/s/ "wercker status")](https://app.wercker.com/project/bykey/526d1ff4df6eadaa793dca1affcaed35)
+
+RSpec tests for your servers configured by Puppet, Chef or anything else
+
+You can see the details of serverspec on [serverspec.org](http://serverspec.org/).
+
+----
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/Rakefile

@@ -0,0 +1,30 @@
+require "bundler/gem_tasks"
+begin
+  require "rspec/core/rake_task"
+  require "octorelease"
+rescue LoadError
+end
+
+if defined?(RSpec)
+  task :spec => 'spec:all'
+
+  namespace :spec do
+    task :all => [ 'spec:type:all', 'spec:helper' ]
+
+    namespace :type do
+      oses = Dir.glob('spec/type/*').map {|d| File.basename(d)}
+
+      task :all => oses.map {|os| "spec:type:#{os}" }
+
+      oses.each do |os|
+        RSpec::Core::RakeTask.new(os.to_sym) do |t|
+          t.pattern = "spec/type/#{os}/*_spec.rb"
+        end
+      end
+    end
+
+    RSpec::Core::RakeTask.new(:helper) do |t|
+        t.pattern = "spec/helper/*_spec.rb"
+    end
+  end
+end

data/WINDOWS_SUPPORT.md

@@ -0,0 +1,116 @@
+## Windows support
+
+Serverspec is now providing a limited support for Microsoft Windows.
+
+If you want to test Windows based machines you need to set the target host's OS explicitly in your `spec/spec_helper.rb`
+
+For local testing (equivalent to the Exec option in Linux/Unix systems) simply do:
+
+```ruby
+require 'serverspec'
+
+set :backend, :cmd
+```
+
+For remote testing you have to configure Windows Remote Management in order to communicate to the target host:
+
+```ruby
+require 'serverspec'
+require 'winrm'
+
+set :backend, :winrm
+
+user = <username>
+pass = <password>
+endpoint = "http://#{ENV['TARGET_HOST']}:5985/wsman"
+
+winrm = ::WinRM::WinRMWebService.new(endpoint, :ssl, :user => user, :pass => pass, :basic_auth_only => true)
+winrm.set_timeout 300 # 5 minutes max timeout for any operation
+Specinfra.configuration.winrm = winrm
+```
+
+For how to configure the guest to accept WinRM connections and the different authentication mechanisms check the Microsoft WinRM documentation and verify the ones that are supported by [WinRb/WinRM](https://github.com/WinRb/WinRM).
+
+
+###RSpec Examples for windows target hosts
+```ruby
+describe file('c:/windows') do
+  it { should be_directory }
+  it { should be_readable }
+  it { should_not be_writable.by('Everyone') }
+end
+
+describe file('c:/temp/test.txt') do
+  it { should be_file }
+  it { should contain "some text" }
+end
+
+describe package('Adobe AIR') do
+  it { should be_installed}
+end
+
+describe service('DNS Client') do
+  it { should be_installed }
+  it { should be_enabled }
+  it { should be_running }
+  it { should have_start_mode("Manual") }
+end
+
+describe port(139) do
+  it { should be_listening }
+end
+
+describe user('some.admin') do
+  it { should exist }
+  it { should belong_to_group('Administrators')}
+end
+
+describe group('Guests') do
+  it { should exist }
+end
+
+describe group('MYDOMAIN\Domain Users') do
+  it { should exist }
+end
+
+describe command('& "ipconfig"') do
+  it { should return_stdout(/IPv4 Address(\.| )*: 192\.168\.1\.100/) }
+end
+
+describe windows_registry_key('HKEY_USERS\S-1-5-21-1319311448-2088773778-316617838-32407\Test MyKey') do
+  it { should exist }
+  it { should have_property('string value') }
+  it { should have_property('binary value', :type_binary) }
+  it { should have_property('dword value', :type_dword) }
+  it { should have_value('test default data') }
+  it { should have_property_value('multistring value', :type_multistring, "test\nmulti\nstring\ndata") }
+  it { should have_property_value('qword value', :type_qword, 'adff32') }
+  it { should have_property_value('binary value', :type_binary, 'dfa0f066') }
+end
+
+describe windows_feature('Minesweeper') do
+  it{ should be_installed }
+  it{ should be_installed.by("dism") }
+  it{ should be_installed.by("powershell") }
+end
+
+describe iis_website("Default Website") do
+  it { should exist }
+  it { should be_enabled }
+  it { should be_running }
+  it { should be_in_app_pool "DefaultAppPool" }
+  it { should have_physical_path "c:/inetpub/wwwroot" }
+end
+
+describe iis_app_pool("DefaultAppPool") do
+  it { should exist }
+  it { should have_dotnet_version "2.0" }
+end
+
+```
+
+###Notes:
+* Not all the matchers you are used to in Linux-like OS are supported in Windows, some because of differences between the operating systems (e.g. users and permissions model), some because they haven't been yet implemented.
+* All commands in the windows backend are run via powershell, so the output in case of stderr is a pretty ugly xml-like thing. Still it should contain some information to help troubleshooting.
+* The *command* type is executed again through powershell, so bear that in mind if you mean to run old CMD windows batch or programs. (i.e run the command using the **Invoke-Expression** Cmdlet, or the **&** Call Operator)
+* You may have to change Exectution Policy on the machine at both, machine and user level in order for tests to run: Get-ExecutionPolicy -list|%{set-executionpolicy bypass -scope $_.scope}

data/bin/serverspec-init

@@ -0,0 +1,7 @@
+#!/usr/bin/env ruby
+
+$LOAD_PATH.unshift File.join(File.dirname(__FILE__), *%w[.. lib])
+
+require 'serverspec'
+
+Serverspec::Setup.run

data/lib/serverspec.rb

@@ -0,0 +1,33 @@
+require 'rubygems'
+require 'specinfra'
+require 'rspec'
+require 'rspec/its'
+require 'serverspec/version'
+require 'serverspec/matcher'
+require 'serverspec/helper'
+require 'serverspec/setup'
+require 'serverspec/subject'
+require 'serverspec/commands/base'
+require 'rspec/core/formatters/base_formatter'
+
+module RSpec::Core::Notifications
+  class FailedExampleNotification < ExampleNotification
+    def failure_lines
+      host = ENV['TARGET_HOST'] || Specinfra.configuration.host
+      @failure_lines ||=
+        begin
+          lines = []
+          lines << "On host `#{host}'" if host
+          lines << "Failure/Error: #{read_failed_line.strip}"
+          lines << "#{exception_class_name}:" unless exception_class_name =~ /RSpec/
+          exception.message.to_s.split("\n").each do |line|
+            lines << "  #{line}" if exception.message
+          end
+          lines << "  #{example.metadata[:command]}"
+          lines << "  #{example.metadata[:stdout]}" if example.metadata[:stdout]
+          lines << "  #{example.metadata[:stderr]}" if example.metadata[:stderr]
+          lines
+        end
+    end
+  end
+end

data/lib/serverspec/commands/base.rb

@@ -0,0 +1,7 @@
+module Serverspec
+  module Commands
+    class Base < Specinfra::Command::Base
+    end
+  end
+end
+

data/lib/serverspec/helper.rb

@@ -0,0 +1,8 @@
+# Subject type helper
+require 'serverspec/helper/type'
+extend Serverspec::Helper::Type
+class RSpec::Core::ExampleGroup
+  extend Serverspec::Helper::Type
+  include Serverspec::Helper::Type
+end
+

data/lib/serverspec/helper/type.rb

@@ -0,0 +1,23 @@
+module Serverspec
+  module Helper
+    module Type
+      types = %w(
+        base cgroup command cron default_gateway file group host
+        iis_website iis_app_pool interface ipfilter ipnat iptables
+        ip6tables kernel_module linux_kernel_parameter lxc mail_alias
+        package php_config port ppa process routing_table selinux
+        selinux_module service user yumrepo windows_feature
+        windows_hot_fix windows_registry_key windows_scheduled_task zfs
+      )
+
+      types.each {|type| require "serverspec/type/#{type}" }
+
+      types.each do |type|
+        define_method type do |*args|
+          name = args.first
+          eval "Serverspec::Type::#{type.to_camel_case}.new(name)"
+        end
+      end
+    end
+  end
+end

data/lib/serverspec/matcher.rb

@@ -0,0 +1,35 @@
+# file
+require 'serverspec/matcher/be_mounted'
+require 'serverspec/matcher/contain'
+require 'serverspec/matcher/be_readable'
+require 'serverspec/matcher/be_writable'
+require 'serverspec/matcher/be_executable'
+
+# port
+require 'serverspec/matcher/be_listening'
+
+# host
+require 'serverspec/matcher/be_resolvable'
+require 'serverspec/matcher/be_reachable'
+
+# package
+require 'serverspec/matcher/be_installed'
+
+# service
+require 'serverspec/matcher/be_enabled'
+require 'serverspec/matcher/be_running'
+
+# user
+require 'serverspec/matcher/belong_to_group'
+require 'serverspec/matcher/belong_to_primary_group'
+
+# ipfiter, ipnat, iptables, ip6tables
+require 'serverspec/matcher/have_rule'
+
+# cron, routing_table
+require 'serverspec/matcher/have_entry'
+
+# iis_website
+require 'serverspec/matcher/have_site_application'
+require 'serverspec/matcher/have_site_bindings'
+require 'serverspec/matcher/have_virtual_dir'

data/lib/serverspec/matcher/be_enabled.rb

@@ -0,0 +1,13 @@
+RSpec::Matchers.define :be_enabled do
+  match do |subject|
+    if subject.class.name == 'Serverspec::Type::Service'
+      subject.enabled?(@level || 3)
+    else
+      subject.enabled?
+    end
+  end
+
+  chain :with_level do |level|
+    @level = level
+  end
+end

data/lib/serverspec/matcher/be_executable.rb

@@ -0,0 +1,13 @@
+RSpec::Matchers.define :be_executable do
+  match do |file|
+    file.executable?(@by_whom, @by_user)
+  end
+
+  chain :by do |by_whom|
+    @by_whom = by_whom
+  end
+
+  chain :by_user do |by_user|
+    @by_user = by_user
+  end
+end

data/lib/serverspec/matcher/be_installed.rb

@@ -0,0 +1,13 @@
+RSpec::Matchers.define :be_installed do
+  match do |name|
+    name.installed?(@provider, @version)
+  end
+
+  chain :by do |provider|
+    @provider = provider
+  end
+
+  chain :with_version do |version|
+    @version = version
+  end
+end

data/lib/serverspec/matcher/be_listening.rb

@@ -0,0 +1,13 @@
+RSpec::Matchers.define :be_listening do
+  match do |port|
+    port.listening? @with, @local_address
+  end
+
+  chain :with do |with|
+    @with = with
+  end
+
+  chain :on do |local_address|
+    @local_address = local_address
+  end
+end

data/lib/serverspec/matcher/be_mounted.rb

@@ -0,0 +1,15 @@
+RSpec::Matchers.define :be_mounted do
+  match do |path|
+    path.mounted?(@attr, @only_with)
+  end
+
+  chain :with do |attr|
+    @attr      = attr
+    @only_with = false
+  end
+
+  chain :only_with do |attr|
+    @attr      = attr
+    @only_with = true
+  end
+end