avst-cloud 0.1.7

data/lib/avst-cloud/aws_server.rb

@@ -0,0 +1,56 @@
+# Copyright 2015 Adaptavist.com Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+require_relative './cloud_server.rb'
+
+module AvstCloud
+    class AwsServer < AvstCloud::CloudServer
+
+        def stop
+            if @server
+                logger.debug "Stopping #{@server_name}"
+                @server.stop
+                wait_for_state() {|serv| serv.state == 'stopped'}
+                logger.debug "[DONE]\n\n"
+                logger.debug "Server #{@server_name} stopped...".green
+            else
+                raise "Server #{@server_name} does not exist!".red
+            end
+        end
+
+        def start
+            if @server
+                logger.debug "Starting #{@server_name}"
+                @server.start
+                wait_for_state() {|serv| serv.ready?}
+                logger.debug "[DONE]\n\n"
+                logger.debug "Server #{@server_name} started...".green
+            else
+                raise "Server #{@server_name} does not exist!".red
+            end
+        end
+
+        def destroy
+            if @server
+                logger.debug "Killing #{@server_name}"
+                @server.destroy
+                wait_for_state() {|serv| serv.state == 'terminated'}
+                logger.debug "Server #{@server_name} destroyed...".green
+            else
+                raise "Server #{@server_name} does not exist!".red
+            end
+        end
+
+    end
+end

data/lib/avst-cloud/cloud_connection.rb

@@ -0,0 +1,39 @@
+# Copyright 2015 Adaptavist.com Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+require_relative './logging.rb'
+
+module AvstCloud
+    class CloudConnection
+        include Logging
+        attr_accessor :connection, :provider, :provider_user, :provider_pass
+        
+        def initialize(provider, provider_user, provider_pass)
+            @provider = provider
+            @provider_access_user = provider_user
+            @provider_access_pass = provider_pass
+        end
+        
+        # Abstract classes to be implemented per provider
+        UNIMPLEMENTED="Unimplemented..."        
+        
+        def server(server_name, root_user, root_password, os=nil)
+            raise UNIMPLEMENTED
+        end
+
+        def list_known_servers
+           raise UNIMPLEMENTED 
+        end
+    end
+end

data/lib/avst-cloud/cloud_server.rb

@@ -0,0 +1,89 @@
+# Copyright 2015 Adaptavist.com Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+require_relative './logging.rb'
+require_relative './task.rb'
+
+module AvstCloud
+    class CloudServer
+        include Logging
+        attr_accessor :server, :server_name, :ip_address, :access_user, :access_password
+
+        def initialize(server, server_name, ip_address, access_user, access_password)
+            @server = server
+            @ip_address = ip_address
+            @server_name = server_name
+            @access_user = access_user
+            @access_password = access_password
+        end 
+
+        def bootstrap(pre_upload_commands, custom_file_uploads, post_upload_commands, remote_server_debug, debug_structured_log)
+            logger.debug "Bootstrapping #{server_name}...".green
+            run_tasks([AvstCloud::WaitUntilReady.new])
+            disable_tty_task = AvstCloud::DisableRequireTty.new(@access_user)
+            pre_upload_commands_tasks = AvstCloud::SshCommandTask.new(pre_upload_commands, remote_server_debug, debug_structured_log)
+            custom_file_uploads_tasks = AvstCloud::ScpTask.new(custom_file_uploads)
+            post_upload_commands_tasks = AvstCloud::SshCommandTask.new(post_upload_commands, remote_server_debug, debug_structured_log)
+            run_tasks([disable_tty_task, pre_upload_commands_tasks, custom_file_uploads_tasks, post_upload_commands_tasks])
+            logger.debug "Bootstrap done. You can connect to server as #{@access_user} on #{@ip_address}"
+        end
+
+        def provision(git, branch, server_tmp_folder, reference, custom_provisioning_commands, puppet_runner, puppet_runner_prepare, destination_folder)
+            logger.debug "Provisioning #{@server_name}..."
+            provision_task = AvstCloud::CapistranoDeploymentTask.new(git, branch, server_tmp_folder, reference, custom_provisioning_commands, puppet_runner, puppet_runner_prepare, destination_folder)
+            run_tasks([AvstCloud::WaitUntilReady.new, provision_task])
+            logger.debug "Provisioning done. You can connect to server on #{@ip_address}"
+        end
+
+        def post_provisioning_cleanup(custom_commands, os, remote_server_debug, server_tmp_folder)
+            logger.debug "Cleaning up after provisioning #{server_name}..."
+            custom_cleanup_commands = AvstCloud::SshCommandTask.new(custom_commands, remote_server_debug, true)
+            run_tasks([AvstCloud::WaitUntilReady.new, AvstCloud::PostProvisionCleanup.new(os, remote_server_debug, server_tmp_folder), custom_cleanup_commands])
+            logger.debug "Post provisioning cleanup done. You can connect to server as #{@access_user} on #{@ip_address}"
+        end
+
+        def run_tasks(tasks)
+            Array(tasks).each do |task|
+                task.execute self
+            end
+        end
+
+        def status
+            @server.state
+        end
+
+        def wait_for_state(&cond)
+            logger.debug "Waiting for state change...".yellow
+            @server.wait_for(600, 5) do
+                print "."
+                STDOUT.flush
+                cond.call(self)
+            end
+        end
+
+        # Abstract classes to be implemented per provider
+        UNIMPLEMENTED="Unimplemented..."
+        def stop
+            raise UNIMPLEMENTED
+        end
+
+        def start
+            raise UNIMPLEMENTED
+        end
+
+        def destroy
+            raise UNIMPLEMENTED
+        end
+    end
+end

data/lib/avst-cloud/logging.rb

@@ -0,0 +1,36 @@
+# Copyright 2015 Adaptavist.com Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+require 'logger'
+
+module Logging
+  def self.included(base)
+    class << base
+      def logger
+        @logger ||= Logger.new($stdout)
+      end
+
+      def logger=(logger)
+        @logger = logger
+      end
+    end
+  end
+
+  def logger
+    self.class.logger
+  end
+  def logger=(logger)
+    @logger = logger
+  end
+end

data/lib/avst-cloud/rackspace_connection.rb

@@ -0,0 +1,141 @@
+# Copyright 2015 Adaptavist.com Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+require_relative './cloud_connection.rb'
+
+module AvstCloud
+    
+    class RackspaceConnection < AvstCloud::CloudConnection
+        
+        attr_accessor :region
+
+        def initialize(provider_access_user, provider_access_pass, region=:lon)
+            super('rackspace',provider_access_user, provider_access_pass)
+            @region = region
+        end
+        
+        def server(server_name, root_user, root_password, os=nil)
+            server = find_fog_server(server_name)
+            if !root_user
+                root_user = "root"
+            end
+            AvstCloud::RackspaceServer.new(server, server_name, server.public_ip_address, root_user, root_password)
+        end
+
+        def create_server(server_name, image_id, flavor_id='4')
+            server_number, os="ubuntu14"
+            
+            logger.debug "Creating Rackspace server:"
+            logger.debug "server_name      - #{server_name}"
+            logger.debug "flavor_id        - #{flavor_id}"
+            logger.debug "image_id         - #{image_id}"
+
+            unless server_name and image_id
+                raise "Please provide server_name, image_id and flavor_id"
+            end
+
+            # Check existing server
+            existing_server = find_fog_server(server_name, false)
+            if existing_server && existing_server.state != 'SHUTOFF'
+                logger.debug "Server found in state: #{existing_server.state}"
+                raise "Server with the same name found!"
+            elsif existing_server && existing_server.state == 'SHUTOFF'
+                logger.debug "Server found and is stopped, restarting it."
+                existing_server.reboot 'HARD'
+                result_server = AvstCloud::RackspaceServer.new(existing_server, server_name, nil, nil , nil)
+                result_server.wait_for_state() {|serv| serv.ready?}
+                logger.debug "[DONE]\n\n"
+                logger.debug "The server was successfully re-started.\n\n"
+            else
+                # create server
+                server = connect.servers.create :name => server_name,
+                                                :flavor_id => flavor_id,
+                                                :image_id => image_id
+                begin
+                    result_server = AvstCloud::RackspaceServer.new(server, server_name, nil, nil , nil)
+                    # Check every 5 seconds to see if server is in the active state (ready?).
+                    # If the server has not been built in 5 minutes (600 seconds) an exception will be raised.
+                    result_server.wait_for_state() {|serv| serv.ready?}
+                    logger.debug "[DONE]\n\n"
+
+                    logger.debug "The server has been successfully created, to login onto the server:\n\n"
+                    logger.debug "\t ssh #{server.username}@#{server.public_ip_address}\n\n"
+
+                rescue Fog::Errors::TimeoutError
+                    logger.debug "[TIMEOUT]\n\n"
+                    logger.debug "This server is currently #{server.progress}% into the build process and is taking longer to complete than expected."
+                    logger.debug "You can continute to monitor the build process through the web console at https://mycloud.rackspace.com/\n\n"
+                    raise "Timeout while creating Rackspace server #{server_name}"
+                end
+                logger.debug "The #{server.username} password is #{server.password}\n\n"
+            end
+            result_server.access_user = server.username
+            result_server.access_password = server.password
+            result_server.ip_address =  server.public_ip_address
+            result_server
+        end
+
+        def server_status(server_name)
+            server = find_fog_server(server_name, false)
+            if server
+                server.state
+            else
+                'not_created'
+            end
+        end
+
+        def list_flavours
+            connect.flavors.each do |fl|
+                logger.debug fl.inspect
+            end
+        end
+
+        def list_images
+            connect.images.each do |im|
+                logger.debug im.inspect
+            end
+        end
+        
+        # Returns list of servers from fog
+        def list_known_servers
+            connect.servers.all
+        end
+
+        def find_fog_server(server_name, should_fail=true)
+            serv = connect.servers.find{|serv| serv.name == server_name}
+            unless serv
+                if should_fail
+                    logger.debug "Server not found for name: #{server_name}"
+                    raise "Server not found for name: #{server_name}"
+                end
+            end
+            serv
+        end
+
+    private
+        def connect
+            unless @connection
+                logger.debug "Creating new connection to rackspace: #{@provider_user} #{@provider_pass} #{@region}"
+                @connection = Fog::Compute.new({
+                    :provider             => 'rackspace',
+                    :rackspace_username   => @provider_access_user,
+                    :rackspace_api_key    => @provider_access_pass,
+                    :version => :v2,  # Use Next Gen Cloud Servers
+                    :rackspace_region => @region
+                })
+            end
+            @connection
+        end
+    end
+end

data/lib/avst-cloud/rackspace_server.rb

@@ -0,0 +1,58 @@
+# Copyright 2015 Adaptavist.com Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+require_relative './cloud_server.rb'
+
+module AvstCloud
+    class RackspaceServer < AvstCloud::CloudServer
+
+        def stop
+            if @server
+                logger.debug "Stopping #{@server_name}"
+
+                shutdown_command = AvstCloud::SshCommandTask.new(['shutdown -h now'])
+                run_tasks([AvstCloud::WaitUntilReady.new, shutdown_command])
+                logger.debug "Waiting for SHUTOFF state..."
+                wait_for_state() {|serv| serv.state == 'SHUTOFF'}
+                logger.debug "[DONE]\n\n"
+                logger.debug "Server #{@server_name} stopped...".green
+            else
+                raise "Server #{@server_name} does not exist!".red
+            end
+        end
+        
+        def start
+            if @server
+                logger.debug "Starting #{@server_name}"
+                @server.reboot 'HARD'
+                logger.debug "Waiting for ACTIVE state..."
+                wait_for_state() {|serv| serv.ready?}
+                logger.debug "[DONE]\n\n"
+                logger.debug "Server #{@server_name} started...".green
+            else
+                raise "Server #{@server_name} does not exist!".red
+            end
+        end
+
+        def destroy
+            if @server
+                logger.debug "Killing #{@server_name}"
+                @server.destroy
+                logger.debug "Server #{@server_name} destroyed...".green
+            else
+                raise "Server #{@server_name} does not exist!".red
+            end
+        end
+    end
+end

data/lib/avst-cloud/task.rb

@@ -0,0 +1,288 @@
+# Copyright 2015 Adaptavist.com Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+require_relative './logging.rb'
+
+module AvstCloud
+    class Task
+        include Logging
+        def initialize(debug = false)
+            @debug = debug
+        end
+        def execute(server)
+            raise 'Unimplemented...'
+        end
+    end
+
+    class SshTask < AvstCloud::Task
+        include Logging
+        def execute(server)
+            unless server.ip_address
+                logger.error 'Can not find host'.red
+                raise 'Can not find ip address, access_user or access_password'
+            end
+
+            unless server.access_user
+                logger.error 'Access user not found. Please provide username for this server.'.red
+                raise 'Access user not found. Please provide username for this server.'
+            end
+
+            unless server.access_password
+                logger.error 'Password not found. Please provide password or pem key for this server.'.red
+                raise 'Password not found. Please provide root_password in config. for this server.'
+            end
+
+            logger.debug "Using #{server.access_user}@#{server.ip_address} with #{server.access_password} to perform ssh task."
+            attempts = 1
+            success = false
+            max_attempts = 50
+            while attempts < max_attempts and !success
+                begin
+                    Net::SSH.start(server.ip_address, server.access_user, :password => server.access_password, :keys => [server.access_password]) do |session|
+                        ssh_command session
+                    end
+                    success = true
+                rescue Errno::ECONNREFUSED
+                    logger.debug "Connection refused. Server may not have booted yet. Sleeping #{attempts}/#{max_attempts}"
+                    sleep(10)
+                    attempts=attempts+1
+                rescue Errno::ETIMEDOUT
+                    logger.debug "Connection timed out. Server may not have booted yet. Sleeping #{attempts}/#{max_attempts}"
+                    sleep(10)
+                    attempts=attempts+1
+                end
+            end
+            unless success
+                logger.error 'Bootstrapping: failed to find server to connect to'
+                raise 'Bootstrapping: failed to find server to connect to'
+            end
+        end
+
+        def ssh_command(session)
+            raise 'Unimplemented...'
+        end
+    end
+
+    class SshCommandTask < AvstCloud::SshTask
+        include Logging
+
+        def initialize(cmds, debug = false, structured_log = false)
+            @cmds = cmds
+            @debug = debug
+            @structured_log = structured_log
+        end
+
+        def ssh_command(session)
+            Array(@cmds).each do |cmd|
+                next unless cmd
+                cmd.strip!
+                next if cmd == ""
+                logger.debug("Running command on server as root: sudo su -c \"#{cmd}\"")
+                start_time = Time.now
+
+                session.exec!("sudo su -c \"#{cmd}\"") do |ch, stream, data|
+                    if @debug
+                        logger.debug "Got this on the #{stream} stream: "
+                        if @structured_log && logger.methods.include?(:log_structured_code)
+                            logger.log_structured_code(data)
+                        else
+                            logger.debug(data)
+                        end
+                    end
+                end
+                total_time = Time.now - start_time
+                logger.debug("Completed in #{total_time} seconds")
+            end
+        end
+    end
+
+    # In case Requiretty is set in sudoers disable it for bootstrapping and provisioning
+    # for user that performs it
+    class DisableRequireTty < AvstCloud::SshTask
+        include Logging
+        def initialize(for_user)
+            @for_user = for_user
+        end
+        def ssh_command(session)
+            session.open_channel do |channel|
+                channel.request_pty do |ch, success|
+                    raise 'Error requesting pty' unless success
+
+                    ch.send_channel_request('shell') do |ch, success|
+                        raise 'Error opening shell' unless success
+                    end
+                end
+                channel.on_data do |ch, data|
+                    if @debug
+                        STDOUT.print data
+                    end
+                end
+                channel.on_extended_data do |ch, type, data|
+                    STDOUT.print "Error: #{data}\n"
+                end
+                channel.send_data("sudo su -c 'echo 'Defaults:#{@for_user}\\ \\!requiretty' >> /etc/sudoers'\n")
+                channel.send_data("exit\n")
+                session.loop
+            end
+        end
+    end
+
+    class WaitUntilReady < AvstCloud::SshTask
+        include Logging
+
+        def ssh_command(session)
+            session.open_channel do |channel|
+                channel.request_pty do |ch, success|
+                    raise 'Error requesting pty' unless success
+
+                    ch.send_channel_request("shell") do |ch, success|
+                        raise 'Error opening shell' unless success
+                    end
+                end
+                channel.on_data do |ch, data|
+                    if @debug
+                        STDOUT.print data
+                    end
+                end
+                channel.on_extended_data do |ch, type, data|
+                    STDOUT.print "Error: #{data}\n"
+                end
+                channel.send_data("echo \"ready\"\n")
+                channel.send_data("exit\n")
+                session.loop
+            end
+        end
+    end
+
+    class CapistranoDeploymentTask < AvstCloud::Task
+        include Logging
+
+        def initialize(git, branch, server_tmp_folder = "/tmp/avst_cloud_tmp_#{Time.now.to_i}", reference = nil, custom_provisioning_commands = [], puppet_runner = nil, puppet_runner_prepare = nil, destination_folder = '/var/opt/puppet')
+            unless git and (branch or reference)
+                logger.debug "You have to provide git repo url #{git} and git branch #{branch} or git tag reference #{reference}".red
+                raise "You have to provide git repo url #{git} and git branch #{branch} or git tag reference #{reference}"
+            end
+
+            @git = git
+            @branch = branch
+            @server_tmp_folder = server_tmp_folder
+            @reference = reference
+            @custom_provisioning_commands = custom_provisioning_commands || []
+            @puppet_runner = puppet_runner
+            @puppet_runner_prepare = puppet_runner_prepare
+            @destination_folder = destination_folder || '/var/opt/puppet'
+        end
+
+        def execute(server)
+            unless server.ip_address
+                logger.error 'Can not find host'.red
+                raise 'Can not find ip address, access_user or access_password'
+            end
+
+            unless server.access_user
+                logger.error 'Access user not found. Please provide username for this server.'.red
+                raise 'Access user not found. Please provide username for this server.'
+            end
+
+            unless server.access_password
+                logger.error 'Password not found. Please provide password or pem key for this server.'.red
+                raise 'Password not found. Please provide root_password in config. for this server.'
+            end
+
+            logger.debug "Using #{server.access_user}@#{server.ip_address} with #{server.access_password}"
+
+
+            # Initiate capistrano deploy script to download the laters code and provision the server
+            require 'capistrano/all'
+            require 'capistrano/setup'
+            require 'capistrano/deploy'
+            Dir.glob("#{File.dirname __dir__}/capistrano/tasks/*.rake").each { |r| load r }
+            # cap production deploy
+            ENV['cap_git_repo_url'] = @git
+            ENV['cap_branch_name'] = @branch
+            ENV['cap_reference_name'] = @reference
+            ENV['cap_ip_address'] = server.ip_address
+            ENV['cap_access_password'] = server.access_password
+            ENV['cap_access_user'] = server.access_user
+            ENV['server_name'] = server.server_name
+            ENV['puppet_runner'] = @puppet_runner
+            ENV['puppet_runner_prepare'] = @puppet_runner_prepare
+            ENV['avst_cloud_tmp_folder'] = @server_tmp_folder
+            ENV['custom_provisioning_commands'] = @custom_provisioning_commands.to_json
+            ENV['destination_folder'] = @destination_folder
+            logger.debug "Using git #{@git} branch #{@branch} to provision #{server.ip_address}"
+
+            Capistrano::Application.invoke('production')
+            Capistrano::Application.invoke('deploy')
+            logger.debug "You can connect to server on #{server.ip_address}"
+        end
+    end
+
+    class PostProvisionCleanup < AvstCloud::SshCommandTask
+
+        def initialize(os, debug, tmp_folder = "/tmp/avst_cloud_tmp_#{Time.now.to_i}")
+            super(make_commands(os, tmp_folder), debug, false)
+        end
+
+        def make_commands(os, tmp_folder)
+            cmds = []
+            case os
+                when /ubuntu/, /debian/
+                    cmds << 'apt-get clean'
+
+                when /centos/, /redhat/
+                    cmds << 'yum clean all'
+            end
+            cmds << "rm -rf #{tmp_folder}"
+            cmds
+        end
+    end
+
+    class ScpTask < AvstCloud::Task
+        include Logging
+
+        def initialize(files)
+            @files = files
+        end
+
+        def execute(server)
+            unless server.ip_address
+                logger.error 'Can not find host'.red
+                raise 'Can not find ip address, access_user or access_password'
+            end
+
+            unless server.access_user
+                logger.error 'Access user not found. Please provide username for this server.'.red
+                raise 'Access user not found. Please provide username for this server.'
+            end
+
+            unless server.access_password
+                logger.error 'Password not found. Please provide password or pem key for this server.'.red
+                raise 'Password not found. Please provide root_password in config. for this server.'
+            end
+
+            logger.debug "Using #{server.access_user}@#{server.ip_address} with #{server.access_password}"
+            Net::SCP.start( server.ip_address, server.access_user, :password => server.access_password, :keys => [server.access_password] ) do |scp|
+                @files.each do |local_file, remote_path|
+                    upload_file(scp, local_file, remote_path)
+                end
+            end
+        end
+
+        def upload_file(scp, local_path, remote_path)
+            logger.debug("Uploading file on server: #{local_path} to #{remote_path}")
+            scp.upload!( local_path, remote_path)
+        end
+    end
+end