ld-eventsource 2.1.0 → 2.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e62fdcf615bb0c699746e63a929e5eb582b8680cf873659d2be9e7e018fb0a89
-  data.tar.gz: f5f2b5694a3049e4f5dc2fd5f49de948ab6a8d040151d506a5589b0da4bca0f6
+  metadata.gz: b3ce08e7a1cf60a7a5dbbe1dfdaa98c4391a625a05b91e47907e80f02ad5a301
+  data.tar.gz: 35009bae9547b7db1bfbd9e4561e58594d6471d44b379436e43d78894fbcfb6e
 SHA512:
-  metadata.gz: dd8ec3f6a4719860f1bf32bef767917a6b97753b8c9eb060c5478fa93b9115c3090313d5cfe4d00137dd1f764cb4bdfb3af000246718dd446691912f4c17ee1d
-  data.tar.gz: 23a6178d006572791caddbfb372bd9a4c68c5e9f32c272c7b3230008698744e973fcecee8d51b2bfc5471ba99f18190b95e0f074307b77dee81d1274b0416d07
+  metadata.gz: a7c0915fddc58ed5629eda81b30b7d843a7689ae58ebe01e45f0451d125aa4033d8ad47f50832645b64a97662155cd9ff0e2fa077fc269a604f9bc6ef8a5a27d
+  data.tar.gz: 0a0b2dc61b40ec7b48d32ff3449a70712d9e1ea17e2708eb62d7fce68b5f61d722709d6b244efdf908c47d6ed43cc0e70eec8fe80006478658ce3838f837737a

data/README.md

@@ -1,7 +1,7 @@
 LaunchDarkly SSE Client for Ruby
 ================================
 
-[![Gem Version](https://badge.fury.io/rb/ld-eventsource.svg)](http://badge.fury.io/rb/ld-eventsource) [![Circle CI](https://circleci.com/gh/launchdarkly/ruby-eventsource/tree/master.svg?style=svg)](https://circleci.com/gh/launchdarkly/ruby-eventsource/tree/master)
+[![Gem Version](https://badge.fury.io/rb/ld-eventsource.svg)](http://badge.fury.io/rb/ld-eventsource) [![Circle CI](https://circleci.com/gh/launchdarkly/ruby-eventsource/tree/main.svg?style=svg)](https://circleci.com/gh/launchdarkly/ruby-eventsource/tree/main)
 
 A client for the [Server-Sent Events](https://www.w3.org/TR/eventsource/) protocol. This implementation runs on a worker thread, and uses the [`http`](https://rubygems.org/gems/http) gem to manage a persistent connection. Its primary purpose is to support the [LaunchDarkly SDK for Ruby](https://github.com/launchdarkly/ruby-client), but it can be used independently.
 

data/lib/ld-eventsource/client.rb

@@ -1,4 +1,5 @@
 require "ld-eventsource/impl/backoff"
+require "ld-eventsource/impl/buffered_line_reader"
 require "ld-eventsource/impl/event_parser"
 require "ld-eventsource/events"
 require "ld-eventsource/errors"
@@ -128,11 +129,12 @@ module SSE
           read: read_timeout,
           connect: connect_timeout
         })
-      @buffer = ""
+      @cxn = nil
       @lock = Mutex.new
 
       @backoff = Impl::Backoff.new(reconnect_time || DEFAULT_RECONNECT_TIME, MAX_RECONNECT_TIME,
         reconnect_reset_interval: reconnect_reset_interval)
+      @first_attempt = true
 
       @on = { event: ->(_) {}, error: ->(_) {} }
       @last_id = last_event_id
@@ -203,47 +205,14 @@ module SSE
     
     def reset_http
       @http_client.close if !@http_client.nil?
-      @cxn = nil
-      @buffer = ""
-    end
-    
-    def read_lines
-      Enumerator.new do |gen|
-        loop do
-          line = read_line
-          break if line.nil?
-          gen.yield line
-        end
-      end
-    end
-    
-    def read_line
-      loop do
-        @lock.synchronize do
-          i = @buffer.index(/[\r\n]/)
-          if !i.nil? && !(i == @buffer.length - 1 && @buffer[i] == "\r")
-            i += 1 if (@buffer[i] == "\r" && @buffer[i + 1] == "\n")
-            return @buffer.slice!(0, i + 1).force_encoding(Encoding::UTF_8)
-          end
-        end
-        return nil if !read_chunk_into_buffer
-      end
+      close_connection
     end
     
-    def read_chunk_into_buffer
-      # If @done is set, it means the Parser has signaled end of response body
-      @lock.synchronize { return false if @done }
-      begin
-        data = @cxn.readpartial
-      rescue HTTP::TimeoutError 
-        # We rethrow this as our own type so the caller doesn't have to know the httprb API
-        raise Errors::ReadTimeoutError.new(@read_timeout)
+    def close_connection
+      @lock.synchronize do
+        @cxn.connection.close if !@cxn.nil?
+        @cxn = nil
       end
-      return false if data == nil
-      @buffer << data
-      # We are piping the content through the parser so that it can handle things like chunked
-      # encoding for us. The content ends up being appended to @buffer via our callback.
-      true
     end
 
     def default_logger
@@ -255,13 +224,16 @@ module SSE
 
     def run_stream
       while !@stopped.value
-        @cxn = nil
+        close_connection
         begin
-          @cxn = connect
+          resp = connect
+          @lock.synchronize do
+            @cxn = resp
+          end
           # There's a potential race if close was called in the middle of the previous line, i.e. after we
           # connected but before @cxn was set. Checking the variable again is a bit clunky but avoids that.
           return if @stopped.value
-          read_stream(@cxn) if !@cxn.nil?
+          read_stream(resp) if !resp.nil?
         rescue => e
           # When we deliberately close the connection, it will usually trigger an exception. The exact type
           # of exception depends on the specific Ruby runtime. But @stopped will always be set in this case.
@@ -283,7 +255,8 @@ module SSE
     def connect
       loop do
         return if @stopped.value
-        interval = @backoff.next_interval
+        interval = @first_attempt ? 0 : @backoff.next_interval
+        @first_attempt = false
         if interval > 0
           @logger.info { "Will retry connection after #{'%.3f' % interval} seconds" } 
           sleep(interval)
@@ -326,7 +299,27 @@ module SSE
       # it can automatically reset itself if enough time passes between failures.
       @backoff.mark_success
 
-      event_parser = Impl::EventParser.new(read_lines)
+      chunks = Enumerator.new do |gen|
+        loop do
+          if @stopped.value
+            break
+          else
+            begin
+              data = cxn.readpartial
+              # readpartial gives us a string, which may not be a valid UTF-8 string because a
+              # multi-byte character might not yet have been fully read, but BufferedLineReader
+              # will handle that.
+            rescue HTTP::TimeoutError 
+              # For historical reasons, we rethrow this as our own type
+              raise Errors::ReadTimeoutError.new(@read_timeout)
+            end
+            break if data.nil?
+            gen.yield data
+          end
+        end
+      end
+      event_parser = Impl::EventParser.new(Impl::BufferedLineReader.lines_from(chunks), @last_id)
+
       event_parser.items.each do |item|
         return if @stopped.value
         case item
@@ -341,7 +334,7 @@ module SSE
 
     def dispatch_event(event)
       @logger.debug { "Received event: #{event}" }
-      @last_id = event.id
+      @last_id = event.id if !event.id.nil?
 
       # Pass the event to the caller
       @on[:event].call(event)
@@ -364,7 +357,7 @@ module SSE
         'Cache-Control' => 'no-cache',
         'User-Agent' => 'ruby-eventsource'
       }
-      h['Last-Event-Id'] = @last_id if !@last_id.nil?
+      h['Last-Event-Id'] = @last_id if !@last_id.nil? && @last_id != ""
       h.merge(@headers)
     end
   end

data/lib/ld-eventsource/events.rb

@@ -11,6 +11,10 @@ module SSE
   #     if there were multiple `data:` lines, they are concatenated with newlines
   # @!attribute id
   #   @return [String] the string that appeared after `id:` in the stream if any, or nil
+  # @!attribute last_event_id
+  #   @return [String] the `id:` value that was most recently seen in an event from
+  #     this stream; this differs from the `id` property in that it retains the same value
+  #     in subsequent events if they do not provide their own `id:`
   #
-  StreamEvent = Struct.new(:type, :data, :id)
+  StreamEvent = Struct.new(:type, :data, :id, :last_event_id)
 end

data/lib/ld-eventsource/impl/backoff.rb

@@ -41,7 +41,11 @@ module SSE
         @last_good_time = nil
         target = ([@base_interval * (2 ** @attempts), @max_interval].min).to_f
         @attempts += 1
-        (target / 2) + @jitter_rand.rand(target / 2)
+        if target == 0
+          0  # in some Ruby versions it's illegal to call rand(0)
+        else
+          (target / 2) + @jitter_rand.rand(target / 2)
+        end
       end
 
       #

data/lib/ld-eventsource/impl/buffered_line_reader.rb

@@ -0,0 +1,82 @@
+
+module SSE
+  module Impl
+    class BufferedLineReader
+      #
+      # Reads a series of data chunks from an enumerator, and returns an enumerator that
+      # parses/aggregates these into text lines. The line terminator may be CR, LF, or
+      # CRLF for each line; terminators are not included in the returned lines. When the
+      # input data runs out, the output enumerator ends and does not include any partially
+      # completed line.
+      #
+      # @param [Enumerator] chunks  an enumerator that will yield strings from a stream -
+      #  these are treated as raw UTF-8 bytes, regardless of the string's declared encoding
+      #  (so it is OK if a multi-byte character is split across chunks); if the declared
+      #  encoding of the chunk is not ASCII-8BIT, it will be changed to ASCII-8BIT in place
+      # @return [Enumerator]  an enumerator that will yield one line at a time in UTF-8
+      #
+      def self.lines_from(chunks)
+        buffer = "".b
+        position = 0
+        line_start = 0
+        last_char_was_cr = false
+
+        Enumerator.new do |gen|
+          chunks.each do |chunk|
+            chunk.force_encoding("ASCII-8BIT")
+            buffer << chunk
+
+            loop do
+              # Search for a line break in any part of the buffer that we haven't yet seen.
+              i = buffer.index(/[\r\n]/, position)
+              if i.nil?
+                # There isn't a line break yet, so we'll keep accumulating data in the buffer, using
+                # position to keep track of where we left off scanning. We can also discard any previously
+                # parsed lines from the buffer at this point.
+                if line_start > 0
+                  buffer.slice!(0, line_start)
+                  line_start = 0
+                end
+                position = buffer.length
+                break
+              end
+
+              ch = buffer[i]
+              if i == 0 && ch == "\n" && last_char_was_cr
+                # This is just the dangling LF of a CRLF pair
+                last_char_was_cr = false
+                i += 1
+                position = i
+                line_start = i
+                next
+              end
+
+              line = buffer[line_start, i - line_start].force_encoding("UTF-8")
+              # Calling force_encoding just declares that we believe the encoding of this string to be
+              # UTF-8 (which is the only encoding allowed in the SSE protocol); it doesn't cause any
+              # re-decoding of the string. The previous line-parsing steps were done on raw 8-bit
+              # strings so that it won't try to do any UTF-8 decoding on intermediate slices.
+
+              last_char_was_cr = false
+              i += 1
+              if ch == "\r"
+                if i == buffer.length
+                  last_char_was_cr = true # We'll break the line here, but be on watch for a dangling LF
+                elsif buffer[i] == "\n"
+                  i += 1
+                end
+              end
+              if i == buffer.length
+                buffer = ""
+                i = 0
+              end
+              position = i
+              line_start = i
+              gen.yield line
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ld-eventsource/impl/event_parser.rb

@@ -20,10 +20,12 @@ module SSE
       #
       # Constructs an instance of EventParser.
       #
-      # @param [Enumerator] lines  an enumerator that will yield one line of text at a time
+      # @param [Enumerator] lines  an enumerator that will yield one line of text at a time;
+      #   the lines should not include line terminators
       #
-      def initialize(lines)
+      def initialize(lines, last_event_id = nil)
         @lines = lines
+        @last_event_id = last_event_id
         reset_buffers
       end
 
@@ -31,17 +33,19 @@ module SSE
       def items
         Enumerator.new do |gen|
           @lines.each do |line|
-            line.chomp!
             if line.empty?
               event = maybe_create_event
               reset_buffers
               gen.yield event if !event.nil?
-            else
-              case line
-                when /^(\w+): ?(.*)$/
-                  item = process_field($1, $2)
-                  gen.yield item if !item.nil?
-              end
+            elsif (pos = line.index(':'))
+              name = line.slice(0...pos)
+
+              pos += 1  # skip colon
+              pos += 1 if pos < line.length && line[pos] == ' '  # skip optional single space, per SSE spec
+              line = line.slice(pos..-1)
+
+              item = process_field(name, line)
+              gen.yield item if !item.nil?
             end
           end
         end
@@ -53,6 +57,7 @@ module SSE
         @id = nil
         @type = nil
         @data = ""
+        @have_data = false
       end
 
       def process_field(name, value)
@@ -60,10 +65,17 @@ module SSE
           when "event"
             @type = value.to_sym
           when "data"
-            @data << "\n" if !@data.empty?
-            @data << value
+            if @have_data
+              @data << "\n" << value
+            else
+              @data = value
+            end
+            @have_data = true
           when "id"
-            @id = value
+            if !value.include?("\x00")
+              @id = value
+              @last_event_id = value
+            end
           when "retry"
             if /^(?<num>\d+)$/ =~ value
               return SetRetryInterval.new(num.to_i)
@@ -73,8 +85,8 @@ module SSE
       end
 
       def maybe_create_event
-        return nil if @data.empty?
-        StreamEvent.new(@type || :message, @data, @id)
+        return nil if !@have_data
+        StreamEvent.new(@type || :message, @data, @id, @last_event_id)
       end
     end
   end

data/lib/ld-eventsource/version.rb

@@ -1,3 +1,3 @@
 module SSE
-  VERSION = "2.1.0"
+  VERSION = "2.2.1"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: ld-eventsource
 version: !ruby/object:Gem::Version
-  version: 2.1.0
+  version: 2.2.1
 platform: ruby
 authors:
 - LaunchDarkly
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-08-11 00:00:00.000000000 Z
+date: 2022-06-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -107,36 +107,16 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- ".circleci/config.yml"
-- ".gitignore"
-- ".ldrelease/circleci/linux/execute.sh"
-- ".ldrelease/circleci/mac/execute.sh"
-- ".ldrelease/circleci/template/build.sh"
-- ".ldrelease/circleci/template/gems-setup.sh"
-- ".ldrelease/circleci/template/prepare.sh"
-- ".ldrelease/circleci/template/publish.sh"
-- ".ldrelease/circleci/template/test.sh"
-- ".ldrelease/circleci/template/update-version.sh"
-- ".ldrelease/circleci/windows/execute.ps1"
-- ".ldrelease/config.yml"
-- CHANGELOG.md
-- Gemfile
 - LICENSE
 - README.md
-- ld-eventsource.gemspec
 - lib/ld-eventsource.rb
 - lib/ld-eventsource/client.rb
 - lib/ld-eventsource/errors.rb
 - lib/ld-eventsource/events.rb
 - lib/ld-eventsource/impl/backoff.rb
+- lib/ld-eventsource/impl/buffered_line_reader.rb
 - lib/ld-eventsource/impl/event_parser.rb
 - lib/ld-eventsource/version.rb
-- scripts/gendocs.sh
-- scripts/release.sh
-- spec/backoff_spec.rb
-- spec/client_spec.rb
-- spec/event_parser_spec.rb
-- spec/http_stub.rb
 homepage: https://github.com/launchdarkly/ruby-eventsource
 licenses:
 - Apache-2.0
@@ -156,12 +136,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.15
+rubygems_version: 3.3.16
 signing_key: 
 specification_version: 4
 summary: LaunchDarkly SSE client
-test_files:
-- spec/backoff_spec.rb
-- spec/client_spec.rb
-- spec/event_parser_spec.rb
-- spec/http_stub.rb
+test_files: []

data/.circleci/config.yml

@@ -1,39 +0,0 @@
-# This CircleCI configuration was generated by Releaser for a specific release. It is not to be used
-# for regular CI builds. Be aware that rerunning this build may cause it to repeat release actions
-# such as publishing to a package manager. However, it will not perform any Git actions other than
-# reading the repository.
-version: 2.1
-workflows:
-  test:
-    jobs:
-      - release_linux:
-          context: org-global
-jobs:
-  release_linux:
-    docker:
-      - image: cimg/ruby:2.5
-    environment:
-      LD_RELEASE_CIRCLECI_TYPE: linux
-      LD_RELEASE_BRANCH: "master"
-      LD_RELEASE_CIRCLECI_BRANCH: ""
-      LD_RELEASE_DOCS_GITHUB_PAGES: ""
-      LD_RELEASE_DOCS_TITLE: ""
-      LD_RELEASE_PROJECT: "ruby-eventsource"
-      LD_RELEASE_PROJECT_TEMPLATE: "ruby"
-      LD_RELEASE_VERSION: "2.1.0"
-    steps:
-      - checkout
-      - run:
-          name: "Releaser: prepare"
-          command: .ldrelease/circleci/mac/execute.sh prepare .ldrelease/circleci/template/prepare.sh
-      - run:
-          name: "Releaser: build"
-          command: .ldrelease/circleci/mac/execute.sh build .ldrelease/circleci/template/build.sh
-      - run:
-          name: "Releaser: test"
-          command: .ldrelease/circleci/mac/execute.sh test .ldrelease/circleci/template/test.sh
-      - run:
-          name: "Releaser: publish"
-          command: .ldrelease/circleci/mac/execute.sh publish .ldrelease/circleci/template/publish.sh
-      - store_artifacts:
-          path: artifacts

data/.gitignore

@@ -1,17 +0,0 @@
-/.bundle/
-/.yardoc
-/_yardoc/
-/coverage/
-/doc/
-/pkg/
-/spec/reports/
-/tmp/
-*.bundle
-*.so
-*.o
-*.a
-mkmf.log
-*.gem
-.DS_Store
-rspec
-Gemfile.lock

data/.ldrelease/circleci/linux/execute.sh

@@ -1,18 +0,0 @@
-#!/bin/bash
-
-set -ue
-
-# Performs a delegated release step in a CircleCI Linux container. This mechanism is described
-# in scripts/circleci/README.md. All of the necessary environment variables should already be
-# in the generated CircleCI configuration.
-
-mkdir -p artifacts
-
-export LD_RELEASE_TEMP_DIR=/tmp/project-releaser-temp
-mkdir -p ${LD_RELEASE_TEMP_DIR}
-
-STEP="$1"
-SCRIPT="$2"
-echo
-echo "[${STEP}] executing ${SCRIPT}"
-"./${SCRIPT}"

data/.ldrelease/circleci/mac/execute.sh

@@ -1,18 +0,0 @@
-#!/bin/bash
-
-set -ue
-
-# Performs a delegated release step in a CircleCI Mac container. This mechanism is described
-# in scripts/circleci/README.md. All of the necessary environment variables should already be
-# in the generated CircleCI configuration.
-
-mkdir -p artifacts
-
-export LD_RELEASE_TEMP_DIR=/tmp/project-releaser-temp
-mkdir -p ${LD_RELEASE_TEMP_DIR}
-
-STEP="$1"
-SCRIPT="$2"
-echo
-echo "[${STEP}] executing ${SCRIPT}"
-"./${SCRIPT}"

data/.ldrelease/circleci/template/build.sh

@@ -1,19 +0,0 @@
-#!/bin/bash
-
-set -ue
-
-# Standard build.sh for Ruby-based projects that publish a gem
-
-echo "Using gem $(gem --version)"
-
-#shellcheck source=/dev/null
-source "$(dirname "$0")/gems-setup.sh"
-
-echo; echo "Installing dependencies"
-${BUNDLER_COMMAND} install
-
-# Build Ruby Gem - this assumes there is a single .gemspec file in the main project directory
-# Note that the gemspec must be able to get the project version either from $LD_RELEASE_VERSION,
-# or from somewhere in the source code that the project-specific update-version.sh has updated.
-echo "Running gem build"
-gem build ./*.gemspec || { echo "gem build failed" >&2; exit 1; }

data/.ldrelease/circleci/template/gems-setup.sh

@@ -1,16 +0,0 @@
-#!/bin/bash
-
-# helper script to set GEM_HOME, PATH, and BUNDLER_COMMAND for Ruby - must be sourced, not executed
-
-mkdir -p "${LD_RELEASE_TEMP_DIR}/gems"
-export GEM_HOME="${LD_RELEASE_TEMP_DIR}/gems"
-export PATH="${GEM_HOME}/bin:${PATH}"
-
-# also, determine whether we'll need to run a specific version of Bundler
-
-GEMSPEC_BUNDLER_VERSION=$(sed -n -e "s/.*['\"]bundler['\"], *['\"]\([^'\"]*\)['\"]/\1/p" ./*.gemspec | tr -d ' ')
-if [ -n "${GEMSPEC_BUNDLER_VERSION}" ]; then
-  BUNDLER_COMMAND="bundler _${GEMSPEC_BUNDLER_VERSION}_"
-else
-  BUNDLER_COMMAND="bundler"
-fi

data/.ldrelease/circleci/template/prepare.sh

@@ -1,17 +0,0 @@
-#!/bin/bash
-
-set -ue
-
-echo "Using gem $(gem --version)"
-
-#shellcheck source=/dev/null
-source "$(dirname "$0")/gems-setup.sh"
-
-# If the gemspec specifies a certain version of bundler, we need to make sure we install that version.
-echo "Installing bundler"
-if [ -n "${GEMSPEC_BUNDLER_VERSION:-}" ]; then
-  GEMSPEC_OPTIONS="-v ${GEMSPEC_BUNDLER_VERSION}"
-else
-  GEMSPEC_OPTIONS=""
-fi
-gem install bundler ${GEMSPEC_OPTIONS} || { echo "installing bundler failed" >&2; exit 1; }

data/.ldrelease/circleci/template/publish.sh

@@ -1,19 +0,0 @@
-#!/bin/bash
-
-set -ue
-
-# Standard publish.sh for Ruby-based projects - we can assume build.sh has already been run
-
-#shellcheck source=/dev/null
-source "$(dirname "$0")/gems-setup.sh"
-
-# If we're running in CircleCI, the RubyGems credentials will be in an environment
-# variable and should be copied to the variable the gem command expects
-if [ -n "${LD_RELEASE_RUBYGEMS_API_KEY:-}" ]; then
-  export GEM_HOST_API_KEY="${LD_RELEASE_RUBYGEMS_API_KEY}"
-fi
-
-# Since all Releaser builds are clean builds, we can assume that the only .gem file here
-# is the one we just built
-echo "Running gem push"
-gem push ./*.gem || { echo "gem push failed" >&2; exit 1; }

data/.ldrelease/circleci/template/test.sh

@@ -1,10 +0,0 @@
-#!/bin/bash
-
-set -ue
-
-# Standard test.sh for Ruby-based projects
-
-#shellcheck source=/dev/null
-source "$(dirname "$0")/gems-setup.sh"
-
-${BUNDLER_COMMAND} exec rspec spec

data/.ldrelease/circleci/template/update-version.sh

@@ -1,8 +0,0 @@
-#!/bin/bash
-
-set -ue
-
-# Standard update-version.sh for Ruby-based projects - this will work only if the version string
-# is in a source file under lib/ that has a line like his: VERSION = "2.0.0"
-
-"$(dirname "$0")/../update-version-constant.sh" lib '*.rb'

data/.ldrelease/circleci/windows/execute.ps1

@@ -1,19 +0,0 @@
-param(
-    [string]$step,
-    [string]$script
-)
-
-# Performs a delegated release step in a CircleCI Windows container using PowerShell. This
-# mechanism is described in scripts/circleci/README.md. All of the necessary environment
-# variables should already be in the generated CircleCI configuration.
-
-$ErrorActionPreference = "Stop"
-
-New-Item -Path "./artifacts" -ItemType "directory" -Force | Out-Null
-
-$env:LD_RELEASE_TEMP_DIR = "$env:TEMP\project-releaser-temp"
-New-Item -Path $env:LD_RELEASE_TEMP_DIR -ItemType "directory" -Force | Out-Null
-
-Write-Host
-Write-Host "[$step] executing $script"
-& "./$script"