Create mocks for the integration tests so they can run under CI

[amclain]

Tests like this need to mock the call to the NetLinx compiler so they can be tested on a continuous integration platform without the need to install proprietary software. The real integration tests should still be available (and flagged as integration) so they can be run on a machine with the compiler installed.

it "compiles a .axs source code file" do
    files = test_file_generator.new 'source-file-plain'

    files.compiled_files.each do |file|
      # Delete any existing files.
      File.delete file if File.exists? file

      # Compiled files should not exist.
      File.exists?(file).should eq false
    end

    # Add source code file to the list of targets to compile.
    compilable.compiler_target_files << files.source_file

    # Run the compiler.
    compiler.compile compilable

    # Compiled files should exist.
    files.compiled_files.each do |file|
      File.exists?(file).should eq true
    end
  end if INTEGRATION_TEST

This is an example of how the call to the compiler was mocked:

describe "Wine" do
    let(:wine_path) { '~/.wine/drive_c/Program Files/Common Files/AMXShare/COM' }
    let(:source_file) { File.expand_path 'source-file-plain', 'spec/workspace/import-test' }
    let(:wine_command) { "wine \"#{File.expand_path('nlrc.exe', wine_path)}\" \"#{source_file}\"" }

    let(:io_double) {
      double().tap do |d|
        d.should_receive(:read) { '' }
        d.should_receive(:close)
      end
    }

    it "can execute the compiler" do
      # Add source code file to the list of targets to compile.
      compilable.compiler_target_files << source_file

      # Stub File.exists? to force Wine path.
      File.should_receive(:exists?).at_least(:once) do |path|
        path.include?('.wine') ? true : false
      end

      # Stub popen to check for correct command.
      IO.should_receive(:popen) do |cmd|
        cmd.should eq wine_command
        io_double
      end

      # Run the compiler.
      compiler.compile compilable
    end
  end