bolt 1.8.0 → 1.8.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5e9fd995a1caaab8cc183d8e20404f29ac10509586099832df91ddb45829aed5
-  data.tar.gz: d45036383b14dbc2df9cedccf2bc9a669febab613161e37ef680228dd42fd50e
+  metadata.gz: 65bfdfb39627ab98263d43ab9fd6389eaeca02f809091a85d169da3e56b7cdf4
+  data.tar.gz: 2184a841229576fe544824d8bf1bd687e1c319411651f29beffab00a5bd0e971
 SHA512:
-  metadata.gz: 83bedc800fcfb5f1449ed873a189dc32845efa1311670332bcc8ab746ac83c3c5453c8bf1a6e6640a5abaa403bebbdce5d6ff1c26dce3ab28b2a13e49dd2081c
-  data.tar.gz: d7ec493dcc3289ae3fa24b6edf3a663677044929fec82e5d7f7498ab0540c3fb475aa83aa17492afe4a1d544291ec357f4132b79bfe5e10a1d783696c057f0d3
+  metadata.gz: af1ccedbc0ba492c0b3acc69f0b250c0dc48e32ee63f8ce6e9bfa8ef259e4dd2bdbe659a0d0e3a3f80ea4a731c394cc7c7582833a93ad7f0af07e05e0d1a0535
+  data.tar.gz: 65c4688066c5f2af97e22941820cb5c3cc7805a40f103a36d97c43c833f101f93957d3576aa1126046c64be67d06ebf4e2b59f7960f9678ce47985e6c00693dc

data/bolt-modules/ctrl/lib/puppet/functions/ctrl/do_until.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+# Repeat the block until it returns a truthy value. Returns the value.
+Puppet::Functions.create_function(:'ctrl::do_until') do
+  # @example Run a task until it succeeds
+  #   ctrl::do_until || {
+  #     run_task('test', $target, _catch_errors => true).ok?
+  #   }
+  dispatch :do_until do
+    block_param
+  end
+
+  def do_until
+    until (x = yield); end
+    x
+  end
+end

data/bolt-modules/ctrl/lib/puppet/functions/ctrl/sleep.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+# Sleeps for specified number of seconds.
+Puppet::Functions.create_function(:'ctrl::sleep') do
+  # @param period Time to sleep (in seconds)
+  # @example Sleep for 5 seconds
+  #   ctrl::sleep(5)
+  dispatch :sleeper do
+    required_param 'Numeric', :period
+    return_type 'Undef'
+  end
+
+  def sleeper(period)
+    sleep(period)
+    nil
+  end
+end

data/bolt-modules/file/lib/puppet/functions/file/read.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+# Read a file and return its contents.
+Puppet::Functions.create_function(:'file::read', Puppet::Functions::InternalFunction) do
+  # @param filename Absolute path or Puppet file path.
+  # @example Read a file from disk
+  #   file::read('/tmp/i_dumped_this_here')
+  # @example Read a file from the modulepath
+  #   file::read('example/files/VERSION')
+  dispatch :read do
+    scope_param
+    required_param 'String', :filename
+    return_type 'String'
+  end
+
+  def read(scope, filename)
+    found = Puppet::Parser::Files.find_file(filename, scope.compiler.environment)
+    unless found && Puppet::FileSystem.exist?(found)
+      raise Puppet::ParseErrorWithIssue.from_issue_and_stack(
+        Puppet::Pops::Issues::NO_SUCH_FILE_OR_DIRECTORY, file: filename
+      )
+    end
+
+    File.read(found)
+  end
+end

data/bolt-modules/file/lib/puppet/functions/file/write.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+# Write a string to a file.
+Puppet::Functions.create_function(:'file::write') do
+  # @param filename Absolute path.
+  # @param content File content to write.
+  # @example Write a file to disk
+  #   file::write('C:/Users/me/report', $apply_result.first.report)
+  dispatch :write do
+    required_param 'String', :filename
+    required_param 'String', :content
+    return_type 'Undef'
+  end
+
+  def write(filename, content)
+    File.write(filename, content)
+    nil
+  end
+end

data/bolt-modules/system/lib/puppet/functions/system/env.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+# Get an environment variable.
+Puppet::Functions.create_function(:'system::env') do
+  # @param name Environment variable name.
+  # @example Get the USER environment variable
+  #   system::env('USER')
+  dispatch :env do
+    required_param 'String', :name
+    return_type 'String'
+  end
+
+  def env(name)
+    ENV[name].freeze
+  end
+end

data/lib/bolt/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Bolt
-  VERSION = '1.8.0'
+  VERSION = '1.8.1'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: bolt
 version: !ruby/object:Gem::Version
-  version: 1.8.0
+  version: 1.8.1
 platform: ruby
 authors:
 - Puppet
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2019-01-03 00:00:00.000000000 Z
+date: 2019-01-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: addressable
@@ -316,6 +316,11 @@ files:
 - bolt-modules/boltlib/lib/puppet/functions/without_default_logging.rb
 - bolt-modules/boltlib/types/planresult.pp
 - bolt-modules/boltlib/types/targetspec.pp
+- bolt-modules/ctrl/lib/puppet/functions/ctrl/do_until.rb
+- bolt-modules/ctrl/lib/puppet/functions/ctrl/sleep.rb
+- bolt-modules/file/lib/puppet/functions/file/read.rb
+- bolt-modules/file/lib/puppet/functions/file/write.rb
+- bolt-modules/system/lib/puppet/functions/system/env.rb
 - exe/bolt
 - exe/bolt-inventory-pdb
 - lib/bolt.rb