# # Author:: Daniel DeLeo () # Copyright:: Copyright 2012-2019, Chef Software Inc. # License:: Apache License, Version 2.0 # # 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 "spec_helper" require "chef/node/immutable_collections" describe Chef::Node::ImmutableMash do before do @data_in = { "top" => { "second_level" => "some value" }, "top_level_2" => %w{array of values}, "top_level_3" => [{ "hash_array" => 1, "hash_array_b" => 2 }], "top_level_4" => { "level2" => { "key" => "value" } }, } @immutable_mash = Chef::Node::ImmutableMash.new(@data_in) end it "does not have any unaudited methods" do unaudited_methods = Hash.instance_methods - Object.instance_methods - Chef::Node::Mixin::ImmutablizeHash::DISALLOWED_MUTATOR_METHODS - Chef::Node::Mixin::ImmutablizeHash::ALLOWED_METHODS expect(unaudited_methods).to be_empty end it "element references like regular hash" do expect(@immutable_mash[:top][:second_level]).to eq("some value") end it "element references like a regular Mash" do expect(@immutable_mash[:top_level_2]).to eq(%w{array of values}) end it "converts Hash-like inputs into ImmutableMash's" do expect(@immutable_mash[:top]).to be_a(Chef::Node::ImmutableMash) end it "converts array inputs into ImmutableArray's" do expect(@immutable_mash[:top_level_2]).to be_a(Chef::Node::ImmutableArray) end it "converts arrays of hashes to ImmutableArray's of ImmutableMashes" do expect(@immutable_mash[:top_level_3].first).to be_a(Chef::Node::ImmutableMash) end it "converts nested hashes to ImmutableMashes" do expect(@immutable_mash[:top_level_4]).to be_a(Chef::Node::ImmutableMash) expect(@immutable_mash[:top_level_4][:level2]).to be_a(Chef::Node::ImmutableMash) end # we only ever absorb VividMashes from other precedence levels, which already have # been coerced to only have string keys, so we do not need to do that work twice (performance). it "does not call convert_value like Mash/VividMash" do @mash = Chef::Node::ImmutableMash.new({ test: "foo", "test2" => "bar" }) expect(@mash[:test]).to eql("foo") expect(@mash["test2"]).to eql("bar") end describe "to_hash" do before do @copy = @immutable_mash.to_hash end it "converts an immutable mash to a new mutable hash" do expect(@copy).to be_instance_of(Hash) end it "converts an immutable nested mash to a new mutable hash" do expect(@copy["top_level_4"]["level2"]).to be_instance_of(Hash) end it "converts an immutable nested array to a new mutable array" do expect(@copy["top_level_2"]).to be_instance_of(Array) end it "should create a mash with the same content" do expect(@copy).to eq(@immutable_mash) end it "should allow mutation" do expect { @copy["m"] = "m" }.not_to raise_error end end describe "dup" do before do @copy = @immutable_mash.dup end it "converts an immutable mash to a new mutable hash" do expect(@copy).to be_instance_of(Mash) end it "converts an immutable nested mash to a new mutable hash" do expect(@copy["top_level_4"]["level2"]).to be_instance_of(Mash) end it "converts an immutable nested array to a new mutable array" do expect(@copy["top_level_2"]).to be_instance_of(Array) end it "should create a mash with the same content" do expect(@copy).to eq(@immutable_mash) end it "should allow mutation" do expect { @copy["m"] = "m" }.not_to raise_error end end describe "to_h" do before do @copy = @immutable_mash.to_h end it "converts an immutable mash to a new mutable hash" do expect(@copy).to be_instance_of(Hash) end it "converts an immutable nested mash to a new mutable hash" do expect(@copy["top_level_4"]["level2"]).to be_instance_of(Hash) end it "converts an immutable nested array to a new mutable array" do expect(@copy["top_level_2"]).to be_instance_of(Array) end it "should create a mash with the same content" do expect(@copy).to eq(@immutable_mash) end it "should allow mutation" do expect { @copy["m"] = "m" }.not_to raise_error end end %i{ []= clear default= default_proc= delete delete_if keep_if merge! update reject! replace select! shift write write! unlink unlink! }.each do |mutator| it "doesn't allow mutation via `#{mutator}'" do expect { @immutable_mash.send(mutator) }.to raise_error(Chef::Exceptions::ImmutableAttributeModification) end end it "returns a mutable version of itself when duped" do mutable = @immutable_mash.dup mutable[:new_key] = :value expect(mutable[:new_key]).to eq(:value) end end describe Chef::Node::ImmutableArray do before do @immutable_array = Chef::Node::ImmutableArray.new(%w{foo bar baz} + Array(1..3) + [nil, true, false, [ "el", 0, nil ] ]) immutable_mash = Chef::Node::ImmutableMash.new({ "m" => "m" }) @immutable_nested_array = Chef::Node::ImmutableArray.new(["level1", @immutable_array, immutable_mash]) end ## # Note: other behaviors, such as immutibilizing input data, are tested along # with ImmutableMash, above ### %i{ << []= clear collect! compact! default= default_proc= delete delete_at delete_if fill flatten! insert keep_if map! merge! pop push reject! reverse! replace select! shift slice! sort! sort_by! uniq! unshift }.each do |mutator| it "does not allow mutation via `#{mutator}" do expect { @immutable_array.send(mutator) }.to raise_error(Chef::Exceptions::ImmutableAttributeModification) end end it "does not have any unaudited methods" do unaudited_methods = Array.instance_methods - Object.instance_methods - Chef::Node::Mixin::ImmutablizeArray::DISALLOWED_MUTATOR_METHODS - Chef::Node::Mixin::ImmutablizeArray::ALLOWED_METHODS expect(unaudited_methods).to be_empty end it "can be duped even if some elements can't" do @immutable_array.dup end it "returns a mutable version of itself when duped" do mutable = @immutable_array.dup mutable[0] = :value expect(mutable[0]).to eq(:value) end describe "to_a" do before do @copy = @immutable_nested_array.to_a end it "converts an immutable array to a new mutable array" do expect(@copy).to be_instance_of(Array) end it "converts an immutable nested array to a new mutable array" do expect(@copy[1]).to be_instance_of(Array) end it "converts an immutable nested mash to a new mutable hash" do expect(@copy[2]).to be_instance_of(Hash) end it "should create an array with the same content" do expect(@copy).to eq(@immutable_nested_array) end it "should allow mutation" do expect { @copy << "m" }.not_to raise_error end end describe "dup" do before do @copy = @immutable_nested_array.dup end it "converts an immutable array to a new mutable array" do expect(@copy).to be_instance_of(Array) end it "converts an immutable nested array to a new mutable array" do expect(@copy[1]).to be_instance_of(Array) end it "converts an immutable nested mash to a new mutable hash" do expect(@copy[2]).to be_instance_of(Mash) end it "should create an array with the same content" do expect(@copy).to eq(@immutable_nested_array) end it "should allow mutation" do expect { @copy << "m" }.not_to raise_error end end describe "to_array" do before do @copy = @immutable_nested_array.to_array end it "converts an immutable array to a new mutable array" do expect(@copy).to be_instance_of(Array) end it "converts an immutable nested array to a new mutable array" do expect(@copy[1]).to be_instance_of(Array) end it "converts an immutable nested mash to a new mutable hash" do expect(@copy[2]).to be_instance_of(Hash) end it "should create an array with the same content" do expect(@copy).to eq(@immutable_nested_array) end it "should allow mutation" do expect { @copy << "m" }.not_to raise_error end end describe "#[]" do it "works with array slices" do expect(@immutable_array[1, 2]).to eql(%w{bar baz}) end end end