puppet 6.2.0-universal-darwin → 6.3.0-universal-darwin

data/man/man5/puppet.conf.5

@@ -1,7 +1,7 @@
 .\" generated with Ronn/v0.7.3
 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 .
-.TH "PUPPETCONF" "5" "January 2019" "Puppet, Inc." "Puppet manual"
+.TH "PUPPETCONF" "5" "February 2019" "Puppet, Inc." "Puppet manual"
 \fBThis page is autogenerated; any changes will get overwritten\fR
 .
 .SH "Configuration settings"
@@ -876,7 +876,7 @@ The time to wait for data to be read from an HTTP connection\. If nothing is rea
 The HTTP User\-Agent string to send when making network requests\.
 .
 .IP "\(bu" 4
-\fIDefault\fR: Puppet/6\.2\.0 Ruby/2\.4\.1\-p111 (x86_64\-linux)
+\fIDefault\fR: Puppet/6\.3\.0 Ruby/2\.4\.1\-p111 (x86_64\-linux)
 .
 .IP "" 0
 .

data/man/man8/puppet-agent.8

@@ -1,7 +1,7 @@
 .\" generated with Ronn/v0.7.3
 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 .
-.TH "PUPPET\-AGENT" "8" "January 2019" "Puppet, Inc." "Puppet manual"
+.TH "PUPPET\-AGENT" "8" "February 2019" "Puppet, Inc." "Puppet manual"
 .
 .SH "NAME"
 \fBpuppet\-agent\fR \- The puppet agent daemon

data/man/man8/puppet-apply.8

@@ -1,7 +1,7 @@
 .\" generated with Ronn/v0.7.3
 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 .
-.TH "PUPPET\-APPLY" "8" "January 2019" "Puppet, Inc." "Puppet manual"
+.TH "PUPPET\-APPLY" "8" "February 2019" "Puppet, Inc." "Puppet manual"
 .
 .SH "NAME"
 \fBpuppet\-apply\fR \- Apply Puppet manifests locally

data/man/man8/puppet-catalog.8

@@ -1,7 +1,7 @@
 .\" generated with Ronn/v0.7.3
 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 .
-.TH "PUPPET\-CATALOG" "8" "January 2019" "Puppet, Inc." "Puppet manual"
+.TH "PUPPET\-CATALOG" "8" "February 2019" "Puppet, Inc." "Puppet manual"
 .
 .SH "NAME"
 \fBpuppet\-catalog\fR \- Compile, save, view, and convert catalogs\.

data/man/man8/puppet-config.8

@@ -1,7 +1,7 @@
 .\" generated with Ronn/v0.7.3
 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 .
-.TH "PUPPET\-CONFIG" "8" "January 2019" "Puppet, Inc." "Puppet manual"
+.TH "PUPPET\-CONFIG" "8" "February 2019" "Puppet, Inc." "Puppet manual"
 .
 .SH "NAME"
 \fBpuppet\-config\fR \- Interact with Puppet\'s settings\.

data/man/man8/puppet-describe.8

@@ -1,7 +1,7 @@
 .\" generated with Ronn/v0.7.3
 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 .
-.TH "PUPPET\-DESCRIBE" "8" "January 2019" "Puppet, Inc." "Puppet manual"
+.TH "PUPPET\-DESCRIBE" "8" "February 2019" "Puppet, Inc." "Puppet manual"
 .
 .SH "NAME"
 \fBpuppet\-describe\fR \- Display help about resource types

data/man/man8/puppet-device.8

@@ -1,7 +1,7 @@
 .\" generated with Ronn/v0.7.3
 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 .
-.TH "PUPPET\-DEVICE" "8" "January 2019" "Puppet, Inc." "Puppet manual"
+.TH "PUPPET\-DEVICE" "8" "February 2019" "Puppet, Inc." "Puppet manual"
 .
 .SH "NAME"
 \fBpuppet\-device\fR \- Manage remote network devices

data/man/man8/puppet-doc.8

@@ -1,7 +1,7 @@
 .\" generated with Ronn/v0.7.3
 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 .
-.TH "PUPPET\-DOC" "8" "January 2019" "Puppet, Inc." "Puppet manual"
+.TH "PUPPET\-DOC" "8" "February 2019" "Puppet, Inc." "Puppet manual"
 .
 .SH "NAME"
 \fBpuppet\-doc\fR \- Generate Puppet references

data/man/man8/puppet-epp.8

@@ -1,7 +1,7 @@
 .\" generated with Ronn/v0.7.3
 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 .
-.TH "PUPPET\-EPP" "8" "January 2019" "Puppet, Inc." "Puppet manual"
+.TH "PUPPET\-EPP" "8" "February 2019" "Puppet, Inc." "Puppet manual"
 .
 .SH "NAME"
 \fBpuppet\-epp\fR \- Interact directly with the EPP template parser/renderer\.

data/man/man8/puppet-facts.8

@@ -1,7 +1,7 @@
 .\" generated with Ronn/v0.7.3
 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 .
-.TH "PUPPET\-FACTS" "8" "January 2019" "Puppet, Inc." "Puppet manual"
+.TH "PUPPET\-FACTS" "8" "February 2019" "Puppet, Inc." "Puppet manual"
 .
 .SH "NAME"
 \fBpuppet\-facts\fR \- Retrieve and store facts\.

data/man/man8/puppet-filebucket.8

@@ -1,7 +1,7 @@
 .\" generated with Ronn/v0.7.3
 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 .
-.TH "PUPPET\-FILEBUCKET" "8" "January 2019" "Puppet, Inc." "Puppet manual"
+.TH "PUPPET\-FILEBUCKET" "8" "February 2019" "Puppet, Inc." "Puppet manual"
 .
 .SH "NAME"
 \fBpuppet\-filebucket\fR \- Store and retrieve files in a filebucket

data/man/man8/puppet-generate.8

@@ -1,7 +1,7 @@
 .\" generated with Ronn/v0.7.3
 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 .
-.TH "PUPPET\-GENERATE" "8" "January 2019" "Puppet, Inc." "Puppet manual"
+.TH "PUPPET\-GENERATE" "8" "February 2019" "Puppet, Inc." "Puppet manual"
 .
 .SH "NAME"
 \fBpuppet\-generate\fR \- Generates Puppet code from Ruby definitions\.

data/man/man8/puppet-help.8

@@ -1,7 +1,7 @@
 .\" generated with Ronn/v0.7.3
 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 .
-.TH "PUPPET\-HELP" "8" "January 2019" "Puppet, Inc." "Puppet manual"
+.TH "PUPPET\-HELP" "8" "February 2019" "Puppet, Inc." "Puppet manual"
 .
 .SH "NAME"
 \fBpuppet\-help\fR \- Display Puppet help\.

data/man/man8/puppet-key.8

@@ -1,7 +1,7 @@
 .\" generated with Ronn/v0.7.3
 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 .
-.TH "PUPPET\-KEY" "8" "January 2019" "Puppet, Inc." "Puppet manual"
+.TH "PUPPET\-KEY" "8" "February 2019" "Puppet, Inc." "Puppet manual"
 .
 .SH "NAME"
 \fBpuppet\-key\fR \- Create, save, and remove certificate keys\.

data/man/man8/puppet-lookup.8

@@ -1,10 +1,10 @@
 .\" generated with Ronn/v0.7.3
 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 .
-.TH "PUPPET\-LOOKUP" "8" "January 2019" "Puppet, Inc." "Puppet manual"
+.TH "LOOKUP" "8" "February 2019" "Puppet, Inc." "Puppet manual"
 .
 .SH "NAME"
-\fBpuppet\-lookup\fR \- Interactive Hiera lookup
+\fBlookup\fR \- Interactive Hiera lookup
 .
 .SH "SYNOPSIS"
 Does Hiera lookups from the command line\.

data/man/man8/puppet-man.8

@@ -1,7 +1,7 @@
 .\" generated with Ronn/v0.7.3
 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 .
-.TH "PUPPET\-MAN" "8" "January 2019" "Puppet, Inc." "Puppet manual"
+.TH "PUPPET\-MAN" "8" "February 2019" "Puppet, Inc." "Puppet manual"
 .
 .SH "NAME"
 \fBpuppet\-man\fR \- Display Puppet manual pages\.

data/man/man8/puppet-module.8

@@ -1,7 +1,7 @@
 .\" generated with Ronn/v0.7.3
 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 .
-.TH "PUPPET\-MODULE" "8" "January 2019" "Puppet, Inc." "Puppet manual"
+.TH "PUPPET\-MODULE" "8" "February 2019" "Puppet, Inc." "Puppet manual"
 .
 .SH "NAME"
 \fBpuppet\-module\fR \- Creates, installs and searches for modules on the Puppet Forge\.

data/man/man8/puppet-node.8

@@ -1,7 +1,7 @@
 .\" generated with Ronn/v0.7.3
 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 .
-.TH "PUPPET\-NODE" "8" "January 2019" "Puppet, Inc." "Puppet manual"
+.TH "PUPPET\-NODE" "8" "February 2019" "Puppet, Inc." "Puppet manual"
 .
 .SH "NAME"
 \fBpuppet\-node\fR \- View and manage node definitions\.

data/man/man8/puppet-parser.8

@@ -1,7 +1,7 @@
 .\" generated with Ronn/v0.7.3
 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 .
-.TH "PUPPET\-PARSER" "8" "January 2019" "Puppet, Inc." "Puppet manual"
+.TH "PUPPET\-PARSER" "8" "February 2019" "Puppet, Inc." "Puppet manual"
 .
 .SH "NAME"
 \fBpuppet\-parser\fR \- Interact directly with the parser\.

data/man/man8/puppet-plugin.8

@@ -1,7 +1,7 @@
 .\" generated with Ronn/v0.7.3
 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 .
-.TH "PUPPET\-PLUGIN" "8" "January 2019" "Puppet, Inc." "Puppet manual"
+.TH "PUPPET\-PLUGIN" "8" "February 2019" "Puppet, Inc." "Puppet manual"
 .
 .SH "NAME"
 \fBpuppet\-plugin\fR \- Interact with the Puppet plugin system\.

data/man/man8/puppet-report.8

@@ -1,7 +1,7 @@
 .\" generated with Ronn/v0.7.3
 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 .
-.TH "PUPPET\-REPORT" "8" "January 2019" "Puppet, Inc." "Puppet manual"
+.TH "PUPPET\-REPORT" "8" "February 2019" "Puppet, Inc." "Puppet manual"
 .
 .SH "NAME"
 \fBpuppet\-report\fR \- Create, display, and submit reports\.

data/man/man8/puppet-resource.8

@@ -1,7 +1,7 @@
 .\" generated with Ronn/v0.7.3
 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 .
-.TH "PUPPET\-RESOURCE" "8" "January 2019" "Puppet, Inc." "Puppet manual"
+.TH "PUPPET\-RESOURCE" "8" "February 2019" "Puppet, Inc." "Puppet manual"
 .
 .SH "NAME"
 \fBpuppet\-resource\fR \- The resource abstraction layer shell

data/man/man8/puppet-script.8

@@ -1,7 +1,7 @@
 .\" generated with Ronn/v0.7.3
 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 .
-.TH "PUPPET\-SCRIPT" "8" "January 2019" "Puppet, Inc." "Puppet manual"
+.TH "PUPPET\-SCRIPT" "8" "February 2019" "Puppet, Inc." "Puppet manual"
 .
 .SH "NAME"
 \fBpuppet\-script\fR \- Run a puppet manifests as a script without compiling a catalog

data/man/man8/puppet-ssl.8

@@ -1,7 +1,7 @@
 .\" generated with Ronn/v0.7.3
 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 .
-.TH "PUPPET\-SSL" "8" "January 2019" "Puppet, Inc." "Puppet manual"
+.TH "PUPPET\-SSL" "8" "February 2019" "Puppet, Inc." "Puppet manual"
 .
 .SH "NAME"
 \fBpuppet\-ssl\fR \- Manage SSL keys and certificates for puppet SSL clients

data/man/man8/puppet-status.8

@@ -1,7 +1,7 @@
 .\" generated with Ronn/v0.7.3
 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 .
-.TH "PUPPET\-STATUS" "8" "January 2019" "Puppet, Inc." "Puppet manual"
+.TH "PUPPET\-STATUS" "8" "February 2019" "Puppet, Inc." "Puppet manual"
 .
 .SH "NAME"
 \fBpuppet\-status\fR \- View puppet server status\.

data/man/man8/puppet.8

@@ -1,7 +1,7 @@
 .\" generated with Ronn/v0.7.3
 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 .
-.TH "PUPPET" "8" "January 2019" "Puppet, Inc." "Puppet manual"
+.TH "PUPPET" "8" "February 2019" "Puppet, Inc." "Puppet manual"
 .
 .SH "NAME"
 \fBpuppet\fR
@@ -25,4 +25,4 @@ Specialized:
 catalog Compile, save, view, and convert catalogs\. describe Display help about resource types device Manage remote network devices doc Generate Puppet references epp Interact directly with the EPP template parser/renderer\. facts Retrieve and store facts\. filebucket Store and retrieve files in a filebucket generate Generates Puppet code from Ruby definitions\. node View and manage node definitions\. parser Interact directly with the parser\. script Run a puppet manifests as a script without compiling a catalog ssl Manage SSL keys and certificates for puppet SSL clients
 .
 .P
-See \'puppet help \fIsubcommand\fR \fIaction\fR\' for help on a specific subcommand action\. See \'puppet help \fIsubcommand\fR\' for help on a specific subcommand\. Puppet v6\.2\.0
+See \'puppet help \fIsubcommand\fR \fIaction\fR\' for help on a specific subcommand action\. See \'puppet help \fIsubcommand\fR\' for help on a specific subcommand\. Puppet v6\.3\.0

data/spec/unit/application_spec.rb

@@ -664,10 +664,17 @@ describe Puppet::Application do
     it "should log an exception that is raised" do
       our_exception = Puppet::DevError.new("test exception")
       Puppet::Util::Log.expects(:newdestination).with(test_arg).raises(our_exception)
-      Puppet.expects(:log_exception).with(our_exception)
+      Puppet.expects(:log_and_raise).with(our_exception, anything)
       @app.handle_logdest_arg(test_arg)
     end
 
+    it "should exit when an exception is raised" do
+      our_exception = Puppet::DevError.new("test exception")
+      Puppet::Util::Log.expects(:newdestination).with(test_arg).raises(our_exception)
+      Puppet.expects(:log_and_raise).with(our_exception, anything).raises(our_exception)
+      expect { @app.handle_logdest_arg(test_arg) }.to raise_error(Puppet::DevError)
+    end
+
     it "should set the new log destination" do
       Puppet::Util::Log.expects(:newdestination).with(test_arg)
       @app.handle_logdest_arg(test_arg)

data/spec/unit/confine/false_spec.rb

@@ -12,6 +12,33 @@ describe Puppet::Confine::False do
     expect { Puppet::Confine.new }.to raise_error(ArgumentError)
   end
 
+  describe "when passing in a lambda as a value for lazy evaluation" do
+    it "should accept it" do
+      confine = Puppet::Confine::False.new(lambda { false })
+      expect(confine.values).to eql([false])
+    end
+
+    describe "when enforcing cache-positive behavior" do
+      def cached_value_of(confine)
+        confine.instance_variable_get(:@cached_value)
+      end
+
+      it "should cache a false value" do
+        confine = Puppet::Confine::False.new(lambda { false })
+        confine.values
+
+        expect(cached_value_of(confine)).to eql([false])
+      end
+
+      it "should not cache a true value" do
+        confine = Puppet::Confine::False.new(lambda { true })
+        confine.values
+
+        expect(cached_value_of(confine)).to be_nil
+      end
+    end
+  end
+
   describe "when testing values" do
     before { @confine = Puppet::Confine::False.new("foo") }
 

data/spec/unit/confine/true_spec.rb

@@ -12,6 +12,33 @@ describe Puppet::Confine::True do
     expect { Puppet::Confine::True.new }.to raise_error(ArgumentError)
   end
 
+  describe "when passing in a lambda as a value for lazy evaluation" do
+    it "should accept it" do
+      confine = Puppet::Confine::True.new(lambda { true })
+      expect(confine.values).to eql([true])
+    end
+
+    describe "when enforcing cache-positive behavior" do
+      def cached_value_of(confine)
+        confine.instance_variable_get(:@cached_value)
+      end
+
+      it "should cache a true value" do
+        confine = Puppet::Confine::True.new(lambda { true })
+        confine.values
+
+        expect(cached_value_of(confine)).to eql([true])
+      end
+
+      it "should not cache a false value" do
+        confine = Puppet::Confine::True.new(lambda { false })
+        confine.values
+
+        expect(cached_value_of(confine)).to be_nil
+      end
+    end
+  end
+
   describe "when testing values" do
     before do
       @confine = Puppet::Confine::True.new("foo")

data/spec/unit/defaults_spec.rb

@@ -110,20 +110,6 @@ describe "Defaults" do
     end
   end
 
-  describe 'server vs server_list' do
-    it 'should warn when both settings are set in code' do
-      Puppet.expects(:deprecation_warning).with('Attempted to set both server and server_list. Server setting will not be used.', :SERVER_DUPLICATION)
-      Puppet.settings[:server] = 'test_server'
-      Puppet.settings[:server_list] = ['one', 'two']
-    end
-
-    it 'should warn when both settings are set by command line' do
-      Puppet.expects(:deprecation_warning).with('Attempted to set both server and server_list. Server setting will not be used.', :SERVER_DUPLICATION)
-      Puppet.settings.handlearg("--server_list", "one,two")
-      Puppet.settings.handlearg("--server", "test_server")
-    end
-  end
-
   describe 'manage_internal_file_permissions' do
     describe 'on windows', :if => Puppet::Util::Platform.windows? do
       it 'should default to false' do

data/spec/unit/functions/group_by_spec.rb

@@ -0,0 +1,40 @@
+require 'spec_helper'
+
+require 'puppet_spec/compiler'
+require 'matchers/resource'
+
+describe 'the group_by function' do
+  include PuppetSpec::Compiler
+  include Matchers::Resource
+
+  context 'for an array' do
+    it 'groups by item' do
+      manifest = "notify { String(group_by([a, b, ab]) |$s| { $s.length }): }"
+      expect(compile_to_catalog(manifest)).to have_resource("Notify[{1 => ['a', 'b'], 2 => ['ab']}]")
+    end
+
+    it 'groups by index, item' do
+      manifest = "notify { String(group_by([a, b, ab]) |$i, $s| { $i%2 + $s.length }): }"
+      expect(compile_to_catalog(manifest)).to have_resource("Notify[{1 => ['a'], 2 => ['b', 'ab']}]")
+    end
+  end
+
+  context 'for a hash' do
+    it 'groups by key-value pair' do
+      manifest = "notify { String(group_by(a => [1, 2], b => [1]) |$kv| { $kv[1].length }): }"
+      expect(compile_to_catalog(manifest)).to have_resource("Notify[{2 => [['a', [1, 2]]], 1 => [['b', [1]]]}]")
+    end
+
+    it 'groups by key, value' do
+      manifest = "notify { String(group_by(a => [1, 2], b => [1]) |$k, $v| { $v.length }): }"
+      expect(compile_to_catalog(manifest)).to have_resource("Notify[{2 => [['a', [1, 2]]], 1 => [['b', [1]]]}]")
+    end
+  end
+
+  context 'for a string' do
+    it 'fails' do
+      manifest = "notify { String(group_by('something') |$s| { $s.length }): }"
+      expect { compile_to_catalog(manifest) }.to raise_error(Puppet::PreformattedError)
+    end
+  end
+end

data/spec/unit/functions/index_spec.rb

@@ -0,0 +1,184 @@
+require 'puppet'
+require 'spec_helper'
+require 'puppet_spec/compiler'
+
+require 'shared_behaviours/iterative_functions'
+
+describe 'the index function' do
+  include PuppetSpec::Compiler
+
+  context "should be callable on Array with" do
+    it 'a lambda to compute match' do
+      catalog = compile_to_catalog(<<-MANIFEST)
+        $a = [1,2,3]
+        $n = $a.index |$v| { $v == 2 }
+        file { "$n": ensure => present }
+      MANIFEST
+      expect(catalog.resource(:file, "1")['ensure']).to eq('present')
+    end
+
+    it 'a lambda taking two arguments to compute match' do
+      catalog = compile_to_catalog(<<-MANIFEST)
+        $a = [6,6,6]
+        $n = $a.index |$i, $v| { $i == 2 }
+        file { "$n": ensure => present }
+      MANIFEST
+      expect(catalog.resource(:file, "2")['ensure']).to eq('present')
+    end
+
+    it 'a given value' do
+      catalog = compile_to_catalog(<<-MANIFEST)
+        $a = [1,2,3]
+        $n = $a.index(3)
+        file { "$n": ensure => present }
+      MANIFEST
+      expect(catalog.resource(:file, "2")['ensure']).to eq('present')
+    end
+  end
+
+  context "should be callable on Hash with" do
+    it 'a lambda to compute match' do
+      catalog = compile_to_catalog(<<-MANIFEST)
+        $h = {1 => 10, 2 => 20, 3 => 30 }
+        $n = $h.index |$v| { $v == 20 }
+        file { "$n": ensure => present }
+      MANIFEST
+      expect(catalog.resource(:file, "2")['ensure']).to eq('present')
+    end
+
+    it 'a lambda taking two arguments to compute match' do
+      catalog = compile_to_catalog(<<-MANIFEST)
+        $h = {1 => 10, 2 => 20, 3 => 30 }
+        $n = $h.index |$k, $v| { $k == 3 }
+        file { "$n": ensure => present }
+      MANIFEST
+      expect(catalog.resource(:file, "3")['ensure']).to eq('present')
+    end
+
+    it 'a given value' do
+      catalog = compile_to_catalog(<<-MANIFEST)
+        $h = {1 => 10, 2 => 20, 3 => 30 }
+        $n = $h.index(20)
+        file { "$n": ensure => present }
+      MANIFEST
+      expect(catalog.resource(:file, "2")['ensure']).to eq('present')
+    end
+  end
+
+  context "should be callable on String with" do
+    it 'a lambda to compute match' do
+      catalog = compile_to_catalog(<<-MANIFEST)
+        $s = "foobarfuu"
+        $n = $s.index |$v| { $v == 'o' }
+        file { "$n": ensure => present }
+      MANIFEST
+      expect(catalog.resource(:file, "1")['ensure']).to eq('present')
+    end
+
+    it 'a lambda taking two arguments to compute match' do
+      catalog = compile_to_catalog(<<-MANIFEST)
+        $s = "foobarfuu"
+        $n = $s.index |$i, $v| { $i == 2 }
+        file { "$n": ensure => present }
+      MANIFEST
+      expect(catalog.resource(:file, "2")['ensure']).to eq('present')
+    end
+
+    it 'a given value returns index of first found substring given as a string' do
+      catalog = compile_to_catalog(<<-MANIFEST)
+        $s = "foobarfuu"
+        $n = $s.index('fu')
+        file { "$n": ensure => present }
+      MANIFEST
+      expect(catalog.resource(:file, "6")['ensure']).to eq('present')
+    end
+
+    it 'a given value returns index of first found substring given as a regexp' do
+      catalog = compile_to_catalog(<<-MANIFEST)
+        $s = "foobarfuub"
+        $n = $s.index(/f(oo|uu)b/)
+        file { "$n": ensure => present }
+      MANIFEST
+      expect(catalog.resource(:file, "0")['ensure']).to eq('present')
+    end
+  end
+
+  context "should be callable on an iterable" do
+    it 'for example a reverse_each' do
+      catalog = compile_to_catalog(<<-MANIFEST)
+        $a = [1,2,3]
+        $n = $a.reverse_each.index |$v| { $v == 1 }
+        file { "$n": ensure => present }
+      MANIFEST
+      expect(catalog.resource(:file, "2")['ensure']).to eq('present')
+    end
+  end
+
+  context 'stops iteration when result is known' do
+    it 'true when boolean true is found' do
+      catalog = compile_to_catalog(<<-MANIFEST)
+        $a = [1,2,3]
+        $n = $a.index |$i, $v| { if $i == 0 { true } else { fail("unwanted") } }
+        file { "$n": ensure => present }
+      MANIFEST
+
+      expect(catalog.resource(:file, "0")['ensure']).to eq('present')
+    end
+  end
+
+  context 'returns undef when value is not found' do
+    it 'when using array and a lambda' do
+      catalog = compile_to_catalog(<<-MANIFEST)
+        $a = [1,2,3]
+        $n = $a.index |$v| { $v == 'blue' }
+        file { "test": ensure => if $n =~ Undef { present } else {absent} }
+      MANIFEST
+      expect(catalog.resource(:file, "test")['ensure']).to eq('present')
+    end
+
+    it 'when using array and a value' do
+      catalog = compile_to_catalog(<<-MANIFEST)
+        $a = [1,2,3]
+        $n = $a.index('blue')
+        file { "test": ensure => if $n =~ Undef { present } else {absent} }
+      MANIFEST
+      expect(catalog.resource(:file, "test")['ensure']).to eq('present')
+    end
+
+    it 'when using a hash and a lambda' do
+      catalog = compile_to_catalog(<<-MANIFEST)
+        $h = {1 => 10, 2 => 20, 3 => 30}
+        $n = $h.index |$v| { $v == 'blue' }
+        file { "test": ensure => if $n =~ Undef { present } else {absent} }
+      MANIFEST
+      expect(catalog.resource(:file, "test")['ensure']).to eq('present')
+    end
+
+    it 'when using a hash and a value' do
+      catalog = compile_to_catalog(<<-MANIFEST)
+        $h = {1 => 10, 2 => 20, 3 => 30}
+        $n = $h.index('blue')
+        file { "test": ensure => if $n =~ Undef { present } else {absent} }
+      MANIFEST
+      expect(catalog.resource(:file, "test")['ensure']).to eq('present')
+    end
+
+    it 'when using a String and a lambda' do
+      catalog = compile_to_catalog(<<-MANIFEST)
+        $s = "foobarfuub"
+        $n = $s.index() |$v| { false }
+        file { "test": ensure => if $n =~ Undef { present } else {absent} }
+      MANIFEST
+      expect(catalog.resource(:file, "test")['ensure']).to eq('present')
+    end
+
+    it 'when using a String and a value' do
+      catalog = compile_to_catalog(<<-MANIFEST)
+        $s = "foobarfuub"
+        $n = $s.index('banana')
+        file { "test": ensure => if $n =~ Undef { present } else {absent} }
+      MANIFEST
+      expect(catalog.resource(:file, "test")['ensure']).to eq('present')
+    end
+  end
+end