vagrant-proxmox 0.0.2

data/spec/actions/create_vm_action_spec.rb

@@ -0,0 +1,167 @@
+require 'spec_helper'
+require 'actions/proxmox_action_shared'
+
+describe VagrantPlugins::Proxmox::Action::CreateVm do
+
+	it_behaves_like VagrantPlugins::Proxmox::Action::ProxmoxAction
+
+	let(:environment) { Vagrant::Environment.new vagrantfile_name: 'dummy_box/Vagrantfile' }
+	let(:env) { {machine: environment.machine(environment.primary_machine_name, :proxmox),
+							 proxmox_nodes: [{node: 'localhost'}],
+							 ui: double('ui').as_null_object} }
+	let(:app) { double('app').as_null_object }
+	let(:task_upid) { 'UPID:localhost:0000F6ED:00F8E25F:5268CD3B:vzcreate:100:vagrant@pve:' }
+
+	subject { described_class.new(app, environment) }
+
+	describe '#call' do
+
+		before do
+			allow(RestClient).to receive(:post).and_return({data: task_upid}.to_json)
+			allow(subject).to receive(:get_free_vm_id).with(env).and_return(100)
+			allow(subject).to receive(:wait_for_completion).and_return('OK')
+		end
+
+		it_behaves_like 'a proxmox action call'
+		it_behaves_like 'a blocking proxmox action'
+
+		describe 'the post request send to create a new virtual machine' do
+
+			context 'with default config' do
+				specify do
+					RestClient.should_receive(:post).
+							with('https://your.proxmox.server/api2/json/nodes/localhost/openvz',
+									 {vmid: 100,
+										hostname: 'box',
+										ostemplate: 'local:vztmpl/template.tgz',
+										password: 'vagrant',
+										memory: 256,
+										description: 'vagrant_test_box'},
+									 anything).
+							and_return({data: task_upid}.to_json)
+					subject.call env
+				end
+			end
+
+			context 'with a specified hostname' do
+				before { env[:machine].config.vm.hostname = 'hostname' }
+				specify do
+					RestClient.should_receive(:post).
+							with('https://your.proxmox.server/api2/json/nodes/localhost/openvz',
+									 {vmid: 100,
+										hostname: 'hostname',
+										ostemplate: 'local:vztmpl/template.tgz',
+										password: 'vagrant',
+										memory: 256,
+										description: 'vagrant_test_box'},
+									 anything).
+							and_return({data: task_upid}.to_json)
+					subject.call env
+				end
+			end
+
+			context 'with a specified ip address' do
+				before { env[:machine].config.vm.stub(:networks) { [[:public_network, {ip: '127.0.0.1'}]] } }
+				specify do
+					RestClient.should_receive(:post).
+							with('https://your.proxmox.server/api2/json/nodes/localhost/openvz',
+									 {vmid: 100,
+										hostname: 'box',
+										ip_address: '127.0.0.1',
+										ostemplate: 'local:vztmpl/template.tgz',
+										password: 'vagrant',
+										memory: 256,
+										description: 'vagrant_test_box'},
+									 anything).
+							and_return({data: task_upid}.to_json)
+					subject.call env
+				end
+			end
+
+		end
+
+		it 'should print a message to the user interface' do
+			env[:ui].should_receive(:info).with 'Creating the virtual machine...'
+			env[:ui].should_receive(:info).with 'Done!'
+			subject.call env
+		end
+
+		it 'should store the node and vmid in env[:machine].id' do
+			subject.call env
+			env[:machine].id.should == 'localhost/100'
+		end
+
+		context 'when the proxmox server responds with an error to the create request' do
+
+			let(:error_exit_status) { ["can't lock container 100", "close (rename) atomic file '/etc/pve/nodes/localhost/openvz/100.conf' failed: File exists"] }
+
+			before { subject.stub :sleep }
+
+			context 'when the proxmox server replies with an exit status describing the error' do
+				it 'should create a virtual machine with another vmid' do
+					expect(subject).to receive(:get_free_vm_id).with(env).twice.and_return(100, 101)
+					expect(subject).to receive(:wait_for_completion).twice.and_return(error_exit_status.sample, 'OK')
+					subject.call env
+					env[:machine].id.should == 'localhost/101'
+				end
+			end
+
+			context 'when the proxmox server replies with a "500 Internal Server Error"' do
+				it 'should create a virtual machine with another vmid' do
+					expect(subject).to receive(:get_free_vm_id).with(env).twice.and_return(100, 101)
+					expect(subject).to receive(:wait_for_completion).and_raise(RestClient::InternalServerError).once
+					expect(subject).to receive(:wait_for_completion).once.and_return('OK')
+					subject.call env
+					env[:machine].id.should == 'localhost/101'
+				end
+			end
+
+			context 'when the create requests fail continuously before the timeout deadline is reached' do
+				it 'should raise a VMCreationError' do
+					expect(subject).to receive(:get_free_vm_id).with(env).exactly(30).times.and_return(100)
+					expect(subject).to receive(:wait_for_completion).exactly(30).times.and_return(error_exit_status.sample)
+					expect { subject.send :call, env }.to raise_error VagrantPlugins::Proxmox::Errors::VMCreationError
+				end
+			end
+
+		end
+
+	end
+
+	describe '#get_free_vm_id' do
+
+		it 'should query the proxmox server for all qemu and openvz machines' do
+			RestClient.should_receive(:get).with('https://your.proxmox.server/api2/json/cluster/resources?type=vm', anything).and_return({data: []}.to_json)
+			subject.send(:get_free_vm_id, env)
+		end
+
+		describe 'find the smallest unused vm_id in the configured range' do
+
+			before { env[:machine].provider_config.vm_id_range = 3..4 }
+
+			context 'when free vm_ids are available' do
+				[
+						{used_vm_ids: {data: []}, smallest_free_in_range: 3},
+						{used_vm_ids: {data: [{vmid: 3}]}, smallest_free_in_range: 4},
+						{used_vm_ids: {data: [{vmid: 1}]}, smallest_free_in_range: 3},
+						{used_vm_ids: {data: [{vmid: 1}, {vmid: 3}]}, smallest_free_in_range: 4},
+				].each do |example|
+					it 'should return the smallest unused vm_id in the configured vm_id_range' do
+						allow(RestClient).to receive(:get).and_return(example[:used_vm_ids].to_json)
+						subject.send(:get_free_vm_id, env).should == example[:smallest_free_in_range]
+					end
+				end
+			end
+
+			context 'when no vm_ids are available' do
+				it 'should throw a no_vm_id_available error' do
+					allow(RestClient).to receive(:get).and_return({data: [{vmid: 1}, {vmid: 2}, {vmid: 3}, {vmid: 4}]}.to_json)
+					expect { subject.send :get_free_vm_id, env }.to raise_error VagrantPlugins::Proxmox::Errors::NoVmIdAvailable
+				end
+			end
+
+		end
+
+	end
+
+end

data/spec/actions/destroy_vm_action_spec.rb

@@ -0,0 +1,37 @@
+require 'spec_helper'
+require 'actions/proxmox_action_shared'
+
+describe VagrantPlugins::Proxmox::Action::DestroyVm do
+
+	let(:environment) { Vagrant::Environment.new vagrantfile_name: 'dummy_box/Vagrantfile' }
+	let(:env) { {machine: environment.machine(environment.primary_machine_name, :proxmox),
+							 proxmox_nodes: [{node: 'localhost'}],
+							 ui: double('ui').as_null_object} }
+
+	subject { described_class.new(-> (_) {}, environment) }
+
+	describe '#call' do
+
+		before do
+			env[:machine].id = 'localhost/100'
+			allow(RestClient).to receive(:delete).and_return({data: 'task_id'}.to_json)
+			allow(RestClient).to receive(:get).and_return({data: {exitstatus: 'OK'}}.to_json)
+		end
+
+		it_behaves_like 'a proxmox action call'
+		it_behaves_like 'a blocking proxmox action'
+
+		it 'should send a post request that deletes the openvz container' do
+			RestClient.should_receive(:delete).with('https://your.proxmox.server/api2/json/nodes/localhost/openvz/100', anything)
+			subject.call env
+		end
+
+		it 'should print a message to the user interface' do
+			env[:ui].should_receive(:info).with 'Destroying the virtual machine...'
+			env[:ui].should_receive(:info).with 'Done!'
+			subject.call env
+		end
+
+	end
+
+end

data/spec/actions/get_node_list_action_spec.rb

@@ -0,0 +1,25 @@
+require 'spec_helper'
+require 'actions/proxmox_action_shared'
+
+describe VagrantPlugins::Proxmox::Action::GetNodeList do
+
+	let(:environment) { Vagrant::Environment.new vagrantfile_name: 'dummy_box/Vagrantfile' }
+	let(:env) { {machine: environment.machine(environment.primary_machine_name, :proxmox)} }
+
+	subject { described_class.new(-> (_) {}, environment) }
+
+	describe '#call' do
+
+		before {allow(RestClient).to receive(:get).and_return({data: [{node: 'localhost'}]}.to_json)}
+
+		it_behaves_like 'a proxmox action call'
+
+		it 'should store the node list in env[:proxmox_nodes]' do
+			RestClient.should_receive(:get).with('https://your.proxmox.server/api2/json/nodes', anything)
+			subject.call env
+			env[:proxmox_nodes].should == [{node: 'localhost'}]
+		end
+
+	end
+
+end

data/spec/actions/is_created_action_spec.rb

@@ -0,0 +1,35 @@
+require 'spec_helper'
+require 'actions/proxmox_action_shared'
+
+describe VagrantPlugins::Proxmox::Action::IsCreated do
+
+	let(:environment) { Vagrant::Environment.new vagrantfile_name: 'dummy_box/Vagrantfile' }
+	let(:env) { {machine: environment.machine(environment.primary_machine_name, :proxmox)} }
+
+	subject { described_class.new(-> (_) {}, environment) }
+
+	describe '#call' do
+
+		before{allow(env[:machine].provider).to receive(:state).and_return(Vagrant::MachineState.new nil, nil, nil)}
+
+		it_behaves_like 'a proxmox action call'
+
+		context 'when the machine is stopped' do
+			before do
+				allow(env[:machine].provider).to receive(:state).and_return(Vagrant::MachineState.new :stopped, '', '')
+				subject.call env
+			end
+			specify { env[:result].should == true }
+		end
+
+		context 'when the machine is not created' do
+			before do
+				allow(env[:machine].provider).to receive(:state).and_return(Vagrant::MachineState.new :not_created, '', '')
+				subject.call env
+			end
+			specify { env[:result].should == false }
+		end
+
+	end
+
+end

data/spec/actions/is_stopped_action_spec.rb

@@ -0,0 +1,34 @@
+require 'spec_helper'
+require 'actions/proxmox_action_shared'
+
+describe VagrantPlugins::Proxmox::Action::IsStopped do
+
+	let(:environment) { Vagrant::Environment.new vagrantfile_name: 'dummy_box/Vagrantfile' }
+	let(:env) { {machine: environment.machine(environment.primary_machine_name, :proxmox)} }
+
+	subject { described_class.new(-> (_) {}, environment) }
+
+	describe '#call' do
+
+		before { allow(env[:machine].provider).to receive(:state).and_return(Vagrant::MachineState.new nil, nil, nil) }
+
+		it_behaves_like 'a proxmox action call'
+
+		context 'when the machine is stopped' do
+			before do
+				allow(env[:machine].provider).to receive(:state).and_return(Vagrant::MachineState.new :stopped, '', '')
+				subject.call env
+			end
+			specify { env[:result].should == true }
+		end
+
+		context 'when the machine is running' do
+			before do
+				allow(env[:machine].provider).to receive(:state).and_return(Vagrant::MachineState.new :running, '', '')
+				subject.call env
+			end
+			specify { env[:result].should == false }
+		end
+	end
+
+end

data/spec/actions/message_already_running_action_spec.rb

@@ -0,0 +1,23 @@
+require 'spec_helper'
+require 'actions/proxmox_action_shared'
+
+describe VagrantPlugins::Proxmox::Action::MessageAlreadyRunning do
+
+	let(:environment) { Vagrant::Environment.new vagrantfile_name: 'dummy_box/Vagrantfile' }
+	let(:env) { {ui: double('ui').as_null_object} }
+
+	subject { described_class.new(-> (_) {}, environment) }
+
+	before { VagrantPlugins::Proxmox::Plugin.setup_i18n }
+
+	describe '#call' do
+
+		it_behaves_like 'a proxmox action call'
+
+		specify do
+			expect(env[:ui]).to receive(:info).with 'The virtual machine is already up and running'
+			subject.call env
+		end
+	end
+
+end

data/spec/actions/message_already_stopped_action_spec.rb

@@ -0,0 +1,23 @@
+require 'spec_helper'
+require 'actions/proxmox_action_shared'
+
+describe VagrantPlugins::Proxmox::Action::MessageAlreadyStopped do
+
+	let(:environment) { Vagrant::Environment.new vagrantfile_name: 'dummy_box/Vagrantfile' }
+	let(:env) { {ui: double('ui').as_null_object} }
+
+	subject { described_class.new(-> (_) {}, environment) }
+
+	before { VagrantPlugins::Proxmox::Plugin.setup_i18n }
+
+	describe '#call' do
+
+		it_behaves_like 'a proxmox action call'
+
+		specify do
+			expect(env[:ui]).to receive(:info).with 'The virtual machine is already stopped'
+			subject.call env
+		end
+	end
+
+end

data/spec/actions/message_not_created_action_spec.rb

@@ -0,0 +1,23 @@
+require 'spec_helper'
+require 'actions/proxmox_action_shared'
+
+describe VagrantPlugins::Proxmox::Action::MessageNotCreated do
+
+	let(:environment) { Vagrant::Environment.new vagrantfile_name: 'dummy_box/Vagrantfile' }
+	let(:env) { {ui: double('ui').as_null_object} }
+
+	subject { described_class.new(-> (_) {}, environment) }
+
+	before { VagrantPlugins::Proxmox::Plugin.setup_i18n }
+
+	describe '#call' do
+
+		it_behaves_like 'a proxmox action call'
+
+		specify do
+			expect(env[:ui]).to receive(:info).with 'The virtual machine is not created on the server!'
+			subject.call env
+		end
+	end
+
+end

data/spec/actions/proxmox_action_shared.rb

@@ -0,0 +1,74 @@
+shared_examples VagrantPlugins::Proxmox::Action::ProxmoxAction do
+
+	let(:environment) { Vagrant::Environment.new vagrantfile_name: 'dummy_box/Vagrantfile'}
+	let(:env) { {machine: environment.machine(environment.primary_machine_name, :proxmox),
+							 proxmox_nodes: [{node: 'localhost'}]} }
+	let(:task_upid) { 'UPID:localhost:0000F6ED:00F8E25F:5268CD3B:vzcreate:100:vagrant@pve:' }
+
+	describe '#wait_for_completion' do
+
+		context 'when the task is completed' do
+			before { allow(subject).to receive(:get_task_exitstatus).and_return('OK') }
+			it 'should return the tasks exit status' do
+				subject.send(:wait_for_completion, task_upid, 'localhost', env, '').should == 'OK'
+			end
+		end
+
+		context 'when the task times out' do
+			before do
+				allow(subject).to receive(:get_task_exitstatus).and_return(nil)
+				Retryable.disable
+			end
+			it 'should raise an timeout error' do
+				expect { subject.send(:wait_for_completion, task_upid, 'localhost', env, '') }.to raise_error VagrantPlugins::Proxmox::Errors::Timeout
+			end
+			after { Retryable.enable }
+		end
+
+	end
+
+	describe '#get_task_exitstatus' do
+
+		it 'should request the task state from the proxmox server' do
+			RestClient.should_receive(:get).with("https://your.proxmox.server/api2/json/nodes/localhost/tasks/#{task_upid}/status", anything).
+					and_return({data: {}}.to_json)
+			subject.send(:get_task_exitstatus, task_upid, 'localhost', env)
+		end
+
+		context 'the task has exited' do
+			it 'should return the exit status' do
+				allow(RestClient).to receive(:get).and_return({data: {upid: task_upid, status: 'stopped', exitstatus: 'OK'}}.to_json)
+				subject.send(:get_task_exitstatus, task_upid, 'localhost', env).should == 'OK'
+			end
+		end
+
+		context 'the task is still running' do
+			it 'should return nil' do
+				allow(RestClient).to receive(:get).and_return({data: {upid: task_upid, status: 'running'}}.to_json)
+				subject.send(:get_task_exitstatus, task_upid, 'localhost', env).should == nil
+			end
+		end
+
+	end
+
+end
+
+shared_examples 'a proxmox action call' do
+
+	describe 'when done' do
+		it 'should call the next action' do
+			expect(subject).to receive(:next_action).with env
+			subject.call env
+		end
+	end
+
+end
+
+shared_examples 'a blocking proxmox action' do
+
+	it 'waits for completion of the server task' do
+		subject.should receive(:wait_for_completion)
+		subject.call env
+	end
+
+end

data/spec/actions/read_ssh_info_action_spec.rb

@@ -0,0 +1,32 @@
+require 'spec_helper'
+require 'actions/proxmox_action_shared'
+
+describe VagrantPlugins::Proxmox::Action::ReadSSHInfo do
+
+	let(:environment) { Vagrant::Environment.new vagrantfile_name: 'dummy_box/Vagrantfile' }
+	let(:env) { {machine: environment.machine(environment.primary_machine_name, :proxmox)} }
+
+	subject { described_class.new(-> (_) {}, environment) }
+
+	describe '#call' do
+
+		it_behaves_like 'a proxmox action call'
+
+		context 'when no ip address is configured' do
+			it 'should write no ssh info into env[:machine_ssh_info]' do
+				subject.call env
+				env[:machine_ssh_info].should == nil
+			end
+		end
+
+		context 'when an ip address is configured' do
+			before { env[:machine].config.vm.stub(:networks) { [[:public_network, {ip: '127.0.0.1'}]] } }
+			it 'should write the ssh info into env[:machine_ssh_info]' do
+				subject.call env
+				env[:machine_ssh_info].should == {host: '127.0.0.1', port: 22}
+			end
+		end
+
+	end
+
+end

data/spec/actions/read_state_action_spec.rb

@@ -0,0 +1,54 @@
+require 'spec_helper'
+require 'actions/proxmox_action_shared'
+
+describe VagrantPlugins::Proxmox::Action::ReadState do
+
+	let(:environment) { Vagrant::Environment.new vagrantfile_name: 'dummy_box/Vagrantfile' }
+	let(:env) { {machine: environment.machine(environment.primary_machine_name, :proxmox)} }
+
+	subject { described_class.new(-> (_) {}, environment) }
+
+	describe '#call' do
+
+		it_behaves_like 'a proxmox action call'
+
+		context 'when no machine id is defined' do
+			specify do
+				subject.call env
+				env[:machine_state_id].should == :not_created
+			end
+		end
+
+		context 'when the machine is not created' do
+			before { env[:machine].id = 'localhost/100' }
+			specify do
+				RestClient.should_receive(:get).with('https://your.proxmox.server/api2/json/nodes/localhost/openvz/100/status/current', anything).
+						and_raise(RestClient::InternalServerError)
+				subject.call env
+				env[:machine_state_id].should == :not_created
+			end
+		end
+
+		context 'when the machine is stopped' do
+			before { env[:machine].id = 'localhost/100' }
+			specify do
+				RestClient.should_receive(:get).with('https://your.proxmox.server/api2/json/nodes/localhost/openvz/100/status/current', anything).
+						and_return({data: {status: 'stopped'}}.to_json)
+				subject.call env
+				env[:machine_state_id].should == :stopped
+			end
+		end
+
+		context 'when the machine is running' do
+			before { env[:machine].id = 'localhost/100' }
+			specify do
+				RestClient.should_receive(:get).with('https://your.proxmox.server/api2/json/nodes/localhost/openvz/100/status/current', anything).
+						and_return({data: {status: 'running'}}.to_json)
+				subject.call env
+				env[:machine_state_id].should == :running
+			end
+		end
+
+	end
+
+end

data/spec/actions/shutdown_vm_action_spec.rb

@@ -0,0 +1,37 @@
+require 'spec_helper'
+require 'actions/proxmox_action_shared'
+
+describe VagrantPlugins::Proxmox::Action::ShutdownVm do
+
+	let(:environment) { Vagrant::Environment.new vagrantfile_name: 'dummy_box/Vagrantfile' }
+	let(:env) { {machine: environment.machine(environment.primary_machine_name, :proxmox),
+							 proxmox_nodes: [{node: 'localhost'}],
+							 ui: double('ui').as_null_object} }
+
+	subject { described_class.new(-> (_) {}, environment) }
+
+	describe '#call' do
+
+		before do
+			env[:machine].id = 'localhost/100'
+			allow(RestClient).to receive(:post).and_return({data: 'task_id'}.to_json)
+			allow(RestClient).to receive(:get).and_return({data: {exitstatus: 'OK'}}.to_json)
+		end
+
+		it_behaves_like 'a proxmox action call'
+		it_behaves_like 'a blocking proxmox action'
+
+		it 'should send a post request that shuts down the openvz container' do
+			RestClient.should_receive(:post).with('https://your.proxmox.server/api2/json/nodes/localhost/openvz/100/status/shutdown', nil, anything)
+			subject.call env
+		end
+
+		it 'should print a message to the user interface' do
+			env[:ui].should_receive(:info).with 'Shutting down the virtual machine...'
+			env[:ui].should_receive(:info).with 'Done!'
+			subject.call env
+		end
+
+	end
+
+end

data/spec/actions/start_vm_action_spec.rb

@@ -0,0 +1,47 @@
+require 'spec_helper'
+require 'actions/proxmox_action_shared'
+
+describe VagrantPlugins::Proxmox::Action::StartVm do
+
+	let(:environment) { Vagrant::Environment.new vagrantfile_name: 'dummy_box/Vagrantfile' }
+	let(:env) { {machine: environment.machine(environment.primary_machine_name, :proxmox),
+							 proxmox_nodes: [{node: 'localhost'}],
+							 ui: double('ui').as_null_object} }
+
+	subject { described_class.new(-> (_) {}, environment) }
+
+	describe '#call' do
+
+		before do
+			env[:machine].id = 'localhost/100'
+			allow(RestClient).to receive(:post).and_return({data: 'task_id'}.to_json)
+			allow(RestClient).to receive(:get).and_return({data: {exitstatus: 'OK'}}.to_json)
+			allow(env[:machine].communicate).to receive(:ready?).and_return true
+		end
+
+		it_behaves_like 'a proxmox action call'
+		it_behaves_like 'a blocking proxmox action'
+
+		it 'should send a post request that starts the openvz container' do
+			RestClient.should_receive(:post).with('https://your.proxmox.server/api2/json/nodes/localhost/openvz/100/status/start', nil, anything)
+			subject.call env
+		end
+
+		it 'should print a message to the user interface' do
+			env[:ui].should_receive(:info).with 'Starting the virtual machine...'
+			env[:ui].should_receive(:info).with 'Done!'
+			env[:ui].should_receive(:info).with 'Waiting for SSH connection...'
+			env[:ui].should_receive(:info).with 'Done!'
+			subject.call env
+		end
+
+		it 'should periodically call env[:machine].communicate.ready? to check for ssh access' do
+			expect(env[:machine].communicate).to receive(:ready?).and_return false
+			expect(subject).to receive(:sleep).with 1
+			expect(env[:machine].communicate).to receive(:ready?).and_return true
+			subject.call env
+		end
+
+	end
+
+end

data/spec/actions/stop_vm_action_spec.rb

@@ -0,0 +1,37 @@
+require 'spec_helper'
+require 'actions/proxmox_action_shared'
+
+describe VagrantPlugins::Proxmox::Action::StopVm do
+
+	let(:environment) { Vagrant::Environment.new vagrantfile_name: 'dummy_box/Vagrantfile' }
+	let(:env) { {machine: environment.machine(environment.primary_machine_name, :proxmox),
+							 proxmox_nodes: [{node: 'localhost'}],
+							 ui: double('ui').as_null_object} }
+
+	subject { described_class.new(-> (_) {}, environment) }
+
+	describe '#call' do
+
+		before do
+			env[:machine].id = 'localhost/100'
+			allow(RestClient).to receive(:post).and_return({data: 'task_id'}.to_json)
+			allow(RestClient).to receive(:get).and_return({data: {exitstatus: 'OK'}}.to_json)
+		end
+
+		it_behaves_like 'a proxmox action call'
+		it_behaves_like 'a blocking proxmox action'
+
+		it 'should send a post request that stops the openvz container' do
+			RestClient.should_receive(:post).with('https://your.proxmox.server/api2/json/nodes/localhost/openvz/100/status/stop', nil, anything)
+			subject.call env
+		end
+
+		it 'should print a message to the user interface' do
+			env[:ui].should_receive(:info).with 'Stopping the virtual machine...'
+			env[:ui].should_receive(:info).with 'Done!'
+			subject.call env
+		end
+
+	end
+
+end