pi_build_modifier 0.3.0.pre.alpha → 0.3.1.pre.alpha

data/pi_customizer/lib/pi_customizer.rb

@@ -0,0 +1,84 @@
+# Copyright (c) 2017-2019 Beate Ottenwälder
+#
+# 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.
+
+require 'thor'
+require 'fileutils'
+require 'pi_customizer/version'
+require 'pi_customizer/build/environment/environment_builder_factory'
+require 'pi_customizer/build/workspace/remote_workspace'
+require 'pi_customizer/build/workspace/local_workspace'
+require 'pi_customizer/write/image_writer'
+require 'pi_customizer/utils/logex'
+
+module PiCustomizer
+
+  ##
+  # PiCustomizer defines all of pi_customizer's cli commands
+
+  class PiCustomizer < Thor
+
+    ##
+    # The build command can be called by a user to trigger a customized build of a pi image
+
+    desc 'build ENV', 'Build pi image on environment ENV (valid environments are: VAGRANT).'
+    method_option :build_sources_git_url, :default => Workspace::DEFAULT_GIT_PATH, :aliases => '-g'
+    method_option :build_sources_git_tag, :default => Workspace::DEFAULT_GIT_TAG, :aliases => '-t'    
+    method_option :remote_workspace_dir, :default => Workspace::DEFAULT_REMOTE_WORKSPACE_DIRECTORY, :aliases => '-w'
+    method_option :config_file, :aliases => '-c', :required => true
+    method_option :local_workspace_dir, :default => Workspace::DEFAULT_LOCAL_WORKSPACE_DIRECTORY, :aliases => '-l'
+    method_option :modifier_gem, :default => '', :aliases => '-m', :desc => 'Path to the modifier_gem. If not specified, the most recent gem from rubygems.org is downloaded.'
+    method_option :deploy_dir, :default => Dir.getwd, :aliases => '-d'
+    method_option :skip_steps, :type => :array, :aliases => '-s'
+
+    def build(env)
+      begin
+        remote_workspace = Workspace::RemoteWorkspace.new("#{options[:remote_workspace_dir]}", "#{options[:build_sources_git_url]}", "#{options[:build_sources_git_tag]}")
+        local_workspace = Workspace::LocalWorkspace.new("#{options[:config_file]}", "#{options[:local_workspace_dir]}", "#{options[:modifier_gem]}")
+        builder = Environment::builder_factory(env, local_workspace, remote_workspace, options[:skip_steps])
+        builder.build
+      rescue Exception => e
+        $logger.error e.message
+      end
+    end
+
+    ##
+    # The version command allows users to query for the current version of the pi_customizer gem. It is printed on the command line.
+
+    desc 'v, version', 'Shows the version number.'
+
+    def version
+      puts VERSION
+    end
+
+    ##
+    # Allow uswers to write an image to a SD card
+
+    desc 'write IMAGE DEVICE', 'Write an image to a device.'
+
+    def write_image(image, device)
+      begin
+        ImageWriter.new().write(image, device)
+      rescue Exception => e
+        $logger.error e.message
+      end
+    end
+
+  end
+end

data/pi_customizer/pi_customizer.gemspec

@@ -0,0 +1,30 @@
+# coding: utf-8
+
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+
+require 'pi_customizer/version'
+
+Gem::Specification.new do |spec|
+  spec.name = 'pi_customizer'
+  spec.version = PiCustomizer::VERSION
+  spec.license = 'MIT'
+  spec.author = 'Beate Ottenwälder'
+  spec.email = 'ottenwbe.public@gmail.com'
+  spec.homepage = 'https://github.com/ottenwbe/pi-gen-environment.git'
+  spec.summary = 'The pi_customizer gem!'
+  spec.description = 'The pi_customizer gem allows you to adapt Raspbian images to your needs!'
+
+  spec.files = Dir.glob('{envs}/**/*') + `git ls-files -z`.split("\x0").reject do |f|
+    f.match(%r{^(test|spec|features)/})
+  end
+  spec.executables = spec.files.grep(%r{^bin/}) {|f| File.basename(f)}
+  spec.require_paths = ['lib']
+
+  spec.add_development_dependency 'bundler', '~> 2.0'
+  spec.add_development_dependency 'rake', '~> 12.3'
+  spec.add_development_dependency 'rspec', '~> 3.8'
+  spec.add_development_dependency 'simplecov', '~> 0.16'
+  spec.add_development_dependency 'rdoc', '~> 6.1'
+  spec.add_runtime_dependency 'thor', '~> 0.20'
+end

data/pi_customizer/spec/fixtures/TestVagrantfile

@@ -0,0 +1,61 @@
+# -*- mode: ruby -*-
+# vi: set ft=ruby :
+
+$dependencies = <<SCRIPT
+sudo apt update
+sudo apt -y upgrade
+sudo apt -y install quilt parted qemu-user-static debootstrap zerofree pxz zip dosfstools libcap2-bin bsdtar
+sudo apt -y install git curl ruby-full build-essential
+sudo apt -y install wpasupplicant openssl libssl-dev
+SCRIPT
+
+$install_modifier_gem = <<SCRIPT
+# install gem
+gem install /home/ubuntu/pi_build_modifier.gem
+SCRIPT
+
+$prepare = <<SCRIPT
+rm -rf /build/pi-gen
+mkdir -p /build/pi-gen
+echo 'git clone to workspace'
+git clone --branch master https://github.com/ottenwbe/pi-gen.git /build/pi-gen
+SCRIPT
+
+$modify = <<SCRIPT
+# Execute gem with parameters
+cd  /build/pi-gen
+pi_build_modifier modify /vagrant/config.json /build/pi-gen
+sudo ./build.sh
+mkdir -p /build/pi-gen/deploy
+cp -r /build/pi-gen/deploy /vagrant
+echo "Pi Image copied to your local workspace ~/workspace/pi-gen-environment/tmp_vagrant_file"
+SCRIPT
+
+Vagrant.configure('2') do |config|
+
+  config.vm.box = 'ubuntu/xenial64' #Note, that 'debian/stretch64' cannot be resized with the disksize plugin
+
+  unless Vagrant.has_plugin?("vagrant-disksize")
+    raise 'vagrant-disksize plugin is not installed! Use: vagrant plugin install vagrant-disksize'
+  end
+
+  config.disksize.size = '60GB'
+
+  # Prepare environment by updating the dependencies
+  config.vm.provision 'shell', inline: $dependencies
+
+  config.vm.provision 'file', source: '~/workspace/pi-gen-environment/my_gem.gem', destination: '/home/ubuntu/pi_build_modifier.gem'
+
+  # Modifier gem is installed
+  config.vm.provision 'shell', inline: $install_modifier_gem
+
+  # Copy config file
+  config.vm.provision 'file', source: '~/workspace/pi-gen-environment/pi_customizer/lib/pi_customizer/build/workspace/../../../../resources/config.json', destination: '/vagrant/config.json'
+
+  # Prepare the modification
+  config.vm.provision 'shell', inline: $prepare
+
+  # Actually modify the build sources and then build the environment
+  config.vm.provision 'shell', inline: $modify
+
+end

data/pi_customizer/spec/fixtures/image.img

@@ -0,0 +1 @@
+test

data/pi_customizer/spec/pi_customizer/builder/build_executor_spec.rb

@@ -0,0 +1,64 @@
+# Copyright (c) 2017-2019 Beate Ottenwälder
+#
+# 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.
+
+require_relative '../../spec_helper'
+require 'rspec'
+require 'pi_customizer/build/builder/build_executor'
+require 'pi_customizer/build/environment/environment'
+
+describe PiCustomizer::Builder::BuildExecutor do
+
+  it 'internally converts keys of skip steps to symbols' do
+    build_exec = PiCustomizer::Builder::BuildExecutor.new(PiCustomizer::Environment::EnvironmentControl.new('',''), ['prepare'])
+    expect(build_exec.skip_build_steps).to include(:prepare)
+    expect(build_exec.skip_build_steps).not_to include('prepare')
+  end
+
+
+  it 'honors skipping the build step prepare' do
+    build_exec = PiCustomizer::Builder::BuildExecutor.new(PiCustomizer::Environment::EnvironmentControl.new('',''), [:prepare])
+    expect(build_exec.env).not_to receive(:prepare)
+    build_exec.prepare
+  end
+
+  it 'honors skipping the build step start' do
+    build_exec = PiCustomizer::Builder::BuildExecutor.new(PiCustomizer::Environment::EnvironmentControl.new('',''), [:start])
+    expect(build_exec.env).not_to receive(:start)
+    build_exec.start
+  end
+
+  it 'honors skipping the build step' do
+    build_exec = PiCustomizer::Builder::BuildExecutor.new(PiCustomizer::Environment::EnvironmentControl.new('',''), [:build_image])
+    expect(build_exec.env).not_to receive(:build_image)
+    build_exec.build_image
+  end
+
+  it 'honors skipping the build step clean' do
+    build_exec = PiCustomizer::Builder::BuildExecutor.new(PiCustomizer::Environment::EnvironmentControl.new('',''), [:clean_up])
+    expect(build_exec.env).not_to receive(:clean_up)
+    build_exec.clean_up
+  end
+
+  it 'honors skipping the build step stop' do
+    build_exec = PiCustomizer::Builder::BuildExecutor.new(PiCustomizer::Environment::EnvironmentControl.new('',''), [:stop])
+    expect(build_exec.env).not_to receive(:stop)
+    build_exec.stop
+  end
+end

data/pi_customizer/spec/pi_customizer/environment/aws_spec.rb

@@ -0,0 +1,57 @@
+# Copyright (c) 2017-2019 Beate Ottenwälder
+#
+# 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.
+
+require_relative '../../spec_helper'
+require 'pi_customizer/build/environment/aws/aws'
+require 'fileutils'
+require 'pathname'
+
+module PiCustomizer
+  module Environment
+    RSpec.describe AWS do
+
+      let(:key_name) {'pi-test'}
+
+      it 'creates an ssh key' do
+        AWS.new(nil, '').create_keys(key_name)
+        expect(Pathname.new("ssh/#{key_name}.pem")).to be_file
+        expect(Pathname.new("ssh/#{key_name}.pub")).to be_file
+      end
+
+      it 'deletes an existing ssh key' do
+        aws = AWS.new(nil, '')
+        aws.create_keys(key_name)
+        aws.del_keys(key_name)
+
+        expect(Pathname.new("ssh/#{key_name}.pem")).to_not be_file
+        expect(Pathname.new("ssh/#{key_name}.pub")).to_not be_file
+      end
+
+      after(:each) do
+        if File.file?("ssh/#{key_name}.pub")
+          FileUtils.rm "ssh/#{key_name}.pem"
+        end
+        if File.file?("ssh/#{key_name}.pub")
+          FileUtils.rm "ssh/#{key_name}.pub"
+        end
+      end
+    end
+  end
+end

data/pi_customizer/spec/pi_customizer/environment/environment_builder_factory_spec.rb

@@ -0,0 +1,48 @@
+# Copyright (c) 2017-2019 Beate Ottenwälder
+#
+# 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.
+
+require_relative '../../spec_helper'
+require 'rspec'
+require 'pi_customizer/build/environment/environment_builder_factory'
+require 'pi_customizer/build/environment/docker/docker'
+require 'pi_customizer/build/environment/aws/aws'
+
+module PiCustomizer
+  module Environment
+    RSpec.describe 'environment_factory' do
+
+      it 'creates a vagrant environment when ENV_VAGRANT is specified' do
+        env = Environment::environment_factory(ENV_VAGRANT, '', '')
+        expect(env).to be_a Vagrant
+      end
+
+      it 'creates a docker environment when ENV_DOCKER is specified' do
+        env = Environment::environment_factory(ENV_DOCKER, '', '')
+        expect(env).to be_a Docker
+      end
+
+      it 'creates an AWS environment when ENV_AWS is specified' do
+        env = Environment::environment_factory(ENV_AWS, '', '')
+        expect(env).to be_a AWS
+      end
+
+    end
+  end
+end

data/pi_customizer/spec/pi_customizer/environment/environment_spec.rb

@@ -0,0 +1,75 @@
+# Copyright (c) 2017-2019 Beate Ottenwälder
+#
+# 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.
+
+require_relative '../../spec_helper'
+require 'rspec'
+require 'pi_customizer/build/environment/environment'
+require 'pi_customizer/utils/logex'
+
+RSpec.describe PiCustomizer::Environment::EnvironmentControl do
+
+  let(:environment) {PiCustomizer::Environment::EnvironmentControl.new(nil,nil)}
+
+
+  it 'warns about skipped check steps' do
+    expect($logger).to receive(:warn).with(/skipped/)
+    environment.check
+  end
+
+  it 'warns about skipped prepare steps' do
+    expect($logger).to receive(:warn).with(/skipped/)
+    environment.prepare
+  end
+
+  it 'warns about skipped start steps' do
+    expect($logger).to receive(:warn).with(/skipped/)
+    environment.start
+  end
+
+  it 'warns about skipped build steps' do
+    expect($logger).to receive(:warn).with(/skipped/)
+    environment.build_image
+  end
+
+  it 'warns about skipped publish steps' do
+    expect($logger).to receive(:warn).with(/skipped/)
+    environment.publish
+  end
+
+  it 'warns about skipped publish steps' do
+    expect($logger).to receive(:warn).with(/skipped/)
+    environment.publish
+  end
+
+  it 'warns about skipped clean_up steps' do
+    expect($logger).to receive(:warn).with(/skipped/)
+    environment.clean_up
+  end
+
+  it 'warns about skipped stop steps' do
+    expect($logger).to receive(:warn).with(/skipped/)
+    environment.stop
+  end
+
+  it 'informs about skipped ensure steps' do
+    expect($logger).to receive(:info).with(/skipped/)
+    environment.ensure
+  end
+end

data/pi_customizer/spec/pi_customizer/environment/vagrant/vagrant_file_spec.rb

@@ -0,0 +1,63 @@
+# Copyright (c) 2017-2019 Beate Ottenwälder
+#
+# 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.
+
+require_relative '../../../spec_helper'
+require 'pi_customizer/build/environment/vagrant/vagrant_file'
+require 'pi_customizer/build/workspace/local_workspace'
+require 'fileutils'
+require 'pathname'
+
+module PiCustomizer
+
+  RSpec.describe Environment::VagrantFileRenderer do
+
+    let(:tmp_dir) {'tmp_vagrant_file'}
+    let(:vagrant_file) {Environment::VagrantFile.new(Workspace::LocalWorkspace.new('', tmp_dir, ''), nil)}
+    let(:vagrant_file_builder) {Environment::VagrantFileRenderer.new(vagrant_file)}
+    let(:test_vagrant_file) {File.dirname(__FILE__) + '/../../../fixtures/TestVagrantfile'}
+
+    after(:each) do
+      #FileUtils.rm_rf tmp_dir
+    end
+
+    it 'renders a Vagrantfile in the given temporary directory' do
+      vagrant_file_builder.create_from_template
+      expect(Pathname.new(tmp_dir+'/Vagrantfile')).to be_file
+    end
+
+    it 'renders a Vagrantfile which copies a gem to the vagrant box when the modifier_gem_path is given' do
+      #Given
+      gem_name = 'my_gem.gem'
+      v_file = Environment::VagrantFile.new(Workspace::LocalWorkspace.new('', tmp_dir, gem_name), nil)
+      v_file_builder = Environment::VagrantFileRenderer.new(v_file)
+      #When
+      v_file_builder.create_from_template
+      #Then
+      expect(File.read(tmp_dir+'/Vagrantfile').to_s).to match(/config.vm.provision 'file', source: [-a-zA-Z0-9'\/_]+#{gem_name}/)
+      #expect(File.read(tmp_dir+'/Vagrantfile').to_s).to eq File.read(test_vagrant_file).to_s
+    end
+
+    it 'raises an error if the Vagrantfile.erb does not exist' do
+      vagrant_file.vagrant_template_path = 'some/random/path'
+      expect {vagrant_file_builder.create_from_template}.to raise_error("'Vagrantfile.erb' template not specified. Expected template in path 'some/random/path'")
+    end
+
+  end
+end

data/pi_customizer/spec/pi_customizer/environment/vagrant/vagrant_spec.rb

@@ -0,0 +1,41 @@
+# Copyright (c) 2017-2019 Beate Ottenwälder
+#
+# 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.
+
+require_relative '../../../spec_helper'
+require 'fileutils'
+require 'pathname'
+require 'pi_customizer/build/environment/vagrant/vagrant'
+
+module PiCustomizer
+  module Environment
+    RSpec.describe Vagrant do
+
+      let(:vagrant_env) {Vagrant.new(nil, nil)}
+
+      describe '#check' do
+        it 'checks for the existence of vagrant' do
+          expect(vagrant_env).to receive(:system).with('vagrant -v').and_return(true)
+          vagrant_env.check
+        end
+      end
+
+    end
+  end
+end

data/pi_customizer/spec/pi_customizer/version_spec.rb

@@ -0,0 +1,29 @@
+# Copyright (c) 2017-2019 Beate Ottenwälder
+#
+# 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.
+
+require_relative '../spec_helper'
+require 'rspec'
+require 'pi_customizer/version'
+
+describe PiCustomizer do
+  it 'has a version number' do
+    expect(PiCustomizer::VERSION).not_to be nil
+  end
+end

data/pi_customizer/spec/pi_customizer/workspace/local_workspace_spec.rb

@@ -0,0 +1,74 @@
+# Copyright (c) 2017-2019 Beate Ottenwälder
+#
+# 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.
+
+require_relative '../../spec_helper'
+require 'pi_customizer/build/workspace/local_workspace'
+require 'fileutils'
+require 'pathname'
+
+module PiCustomizer
+  module Workspace
+    RSpec.describe LocalWorkspace do
+
+      it 'uses default values for config_path and tmp_directory when no path is specified' do
+        #Given
+        #When
+        local_config = LocalWorkspace.new('', '', '')
+        #Then
+        expect(local_config.config_path.to_s).to eq DEFAULT_CONFIG_PATH
+        expect(local_config.workspace_directory.to_s).to eq DEFAULT_LOCAL_WORKSPACE_DIRECTORY
+        expect(local_config.modifier_gem_path).to be nil
+      end
+
+      it 'accepts absolute paths for config_path and stores them as absolute paths' do
+        #Given
+        expected_cfg = '/home/test/cfg.json'
+        expected_tmp = '/home/test/tmp'
+        expected_mod = '/home/test/mod.gem'
+        #When
+        local_config = LocalWorkspace.new(expected_cfg, expected_tmp, expected_mod)
+        #Then
+        expect(local_config.config_path.to_s).to eq expected_cfg
+        expect(local_config.workspace_directory.to_s).to eq expected_tmp
+        expect(local_config.modifier_gem_path.to_s).to eq expected_mod
+      end
+
+      it 'accepts relative paths for config_path and stores them as absolute paths' do
+        local_config = LocalWorkspace.new('a', 'b', 'c')
+        expect(local_config.config_path.to_s).to eq File.join(Dir.pwd, '/a')
+        expect(local_config.workspace_directory.to_s).to eq File.join(Dir.pwd, '/b')
+        expect(local_config.modifier_gem_path.to_s).to eq File.join(Dir.pwd, '/c')
+      end
+
+      it 'allows us to check for value equality' do
+        local_config_1 = LocalWorkspace.new('a', 'b', 'c')
+        local_config_2 = LocalWorkspace.new('a', 'b', 'c')
+        expect(local_config_1==local_config_2).to be true
+      end
+
+      it 'allows us to check for value inequality' do
+        local_config_1 = LocalWorkspace.new('a', 'b', 'c')
+        local_config_2 = LocalWorkspace.new('e', 'f', 'g')
+        expect(local_config_1==local_config_2).to be false
+      end
+
+    end
+  end
+end