arista-eos 1.1.0

data/lib/puppet_x/eos/provider.rb

@@ -0,0 +1,86 @@
+#
+# Copyright (c) 2014, Arista Networks, Inc.
+# All rights reserved.
+#
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions are
+# met:
+#
+#   Redistributions of source code must retain the above copyright notice,
+#   this list of conditions and the following disclaimer.
+#
+#   Redistributions in binary form must reproduce the above copyright
+#   notice, this list of conditions and the following disclaimer in the
+#   documentation and/or other materials provided with the distribution.
+#
+#   Neither the name of Arista Networks nor the names of its
+#   contributors may be used to endorse or promote products derived from
+#   this software without specific prior written permission.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+# "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+# LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+# A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL ARISTA NETWORKS
+# BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
+# BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
+# WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE
+# OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+# IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+#
+require 'rbeapi/client'
+
+##
+# PuppetX namespace
+module PuppetX
+  ##
+  # Eos namesapece
+  module Eos
+    ##
+    # EapiProviderMixin module
+    module EapiProviderMixin
+      def prefetch(resources)
+        provider_hash = instances.each_with_object({}) do |provider, hsh|
+          hsh[provider.name] = provider
+        end
+
+        resources.each_pair do |name, resource|
+          resource.provider = provider_hash[name] if provider_hash[name]
+        end
+      end
+
+      ##
+      # Instance of Rbeapi::Client::Node used to sending and receiving
+      # eAPI messages.  In addition, the node object provides access to
+      # Ruby Client for eAPI API modules used to configure EOS resources.
+      #
+      # @return [Node] An instance of Rbeapi::Client::Node used to send
+      #   and receive eAPI messages
+      def node
+        return @node if @node
+        Rbeapi::Client.load_config(ENV['RBEAPI_CONF']) if ENV['RBEAPI_CONF']
+        connection_name = ENV['RBEAPI_CONNECTION'] || 'localhost'
+        @node = Rbeapi::Client.connect_to(connection_name)
+      end
+
+      ##
+      # validate checkes the set of opts that have been configured for a
+      # resource against the required options.  If any of the required options
+      # are missing, this method will fail.
+      #
+      # @api private
+      #
+      # @param [Hash] :opts The set of options configured on the resource
+      #
+      # @param [Array] :req The set of required option keys
+      def validate(req, opts = {})
+        missing = req.reject { |k| opts[k] }
+        errors = !missing.empty?
+        msg = "Invalid options #{opts.inspect} missing: #{missing.join(', ')}"
+        fail Puppet::Error, msg if errors
+      end
+      private :validate
+    end
+  end
+end

data/lib/puppet_x/eos/utils/helpers.rb

@@ -0,0 +1,34 @@
+#
+# Copyright (c) 2015, Arista Networks, Inc.
+# All rights reserved.
+#
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions are
+# met:
+#
+#   Redistributions of source code must retain the above copyright notice,
+#   this list of conditions and the following disclaimer.
+#
+#   Redistributions in binary form must reproduce the above copyright
+#   notice, this list of conditions and the following disclaimer in the
+#   documentation and/or other materials provided with the distribution.
+#
+#   Neither the name of Arista Networks nor the names of its
+#   contributors may be used to endorse or promote products derived from
+#   this software without specific prior written permission.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+# "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+# LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+# A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL ARISTA NETWORKS
+# BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
+# BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
+# WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE
+# OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+# IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+#
+
+IPADDR_REGEXP = /^(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.){3}
+                (?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$/x

data/metadata.json

@@ -0,0 +1,20 @@
+{
+  "name": "aristanetworks-eos",
+  "version": "1.1.0",
+  "author": "Arista Networks, EOS+",
+  "summary": "Arista Networks types and providers for configuring EOS devices",
+  "license": "BSD-3-Clause",
+  "source": "https://github.com/arista-eosplus/puppet-eos",
+  "project_page": "http://puppet-eos.readthedocs.org/",
+  "issues_url": "https://github.com/arista-eosplus/puppet-eos/issues",
+  "dependencies": [
+  ],
+  "operatingsystem_support": [
+    {
+      "operatingsystem":"AristaEOS",
+      "operatingsystemrelease":[ "4.13.7M", "4.14" ]
+    }
+  ],
+  "tags": ["network", "netdev", "arista", "eos"]
+}
+

data/spec/fixtures/README

@@ -0,0 +1,61 @@
+# README for fixtures
+
+This file contains a list of the fixture files in the fixtures folder along
+with the tests that implement the fixtures.  This file needs to be maintained
+in order to void fixture file "bloat" in this folder.
+
+The file format is "filename" followed by a list of modules that implement
+that fixture file.
+
+## Fixtures
+
+###vlans.json
+* spec/unit/puppet/provider/eos_vlan_spec.rb
+
+###interfaces.json
+* spec/unit/puppet/provider/eos_interface_spec.rb
+
+###ethernet.json
+* spec/unit/puppet/provider/eos_ethernet_spec.rb
+
+###ipinterfaces.json
+* spec/unit/puppet/provider/eos_ipinterface_spec.rb
+
+###switchports.json
+* spec/unit/puppet/provider/eos_switchport_spec.rb
+
+###portchannels.json
+* spec/unit/puppet/provider/eos_portchannel_spec.rb
+
+###vxlan.json
+* spec/unit/puppet/provider/eos_vxlan_spec.rb
+
+###snmp.json
+* spec/unit/puppet/provider/eos_snmp_spec.rb
+
+###mlag.json
+* spec/unit/puppet/provider/eos_mlag_spec.rb
+* spec/unit/puppet/provider/eos_mlag_interface_spec.rb
+
+###ntp.json
+* spec/unit/puppet/provider/eos_ntp_config_spec.rb
+* spec/unit/puppet/provider/eos_ntp_server_spec.rb
+
+###logging.json
+* spec/unit/puppet/provider/eos_logging_host_spec.rb
+
+###ospf.json
+* spec/unit/puppet/provider/eos_ospf_instnace_spec.rb
+* spec/unit/puppet/provider/eos_ospf_interface_spec.rb
+
+###varp.json
+* spec/unit/puppet/provider/eos_varp_spec.rb
+* spec/unit/puppet/provider/eos_varp_interface_spec.rb
+
+###stp.json
+* spec/unit/puppet/provider/eos_stp_config_spec.rb
+
+###system.json
+* spec/unit/puppet/provider/eos_system_spec.rb
+
+

data/spec/fixtures/ethernet.json

@@ -0,0 +1,9 @@
+{
+    "Ethernet1": {
+        "type": "ethernet",
+        "description": "test interface",
+        "shutdown": false,
+        "flowcontrol_send": "on",
+        "flowcontrol_receive": "on"
+    }
+}

data/spec/fixtures/fixture_stp.yaml

@@ -0,0 +1,11 @@
+---
+:mode: mstp
+:interfaces:
+  Ethernet1:
+    :portfast: true
+    :portfast_type: network
+    :bpduguard: true
+  Ethernet2:
+    :portfast: true
+    :portfast_type: normal
+    :bpduguard: false

data/spec/fixtures/fixture_vxlan_get.yaml

@@ -0,0 +1,11 @@
+---
+:type: vxlan
+:description: test interface
+:shutdown: false
+:source_interface: Loopback0
+:multicast_group: 239.10.10.10
+:udp_port: 4789
+:flood_list: ['1.1.1.1', '3.3.3.3']
+:vlans:
+  '10':
+    :vni: '10'

data/spec/fixtures/ospf.json

@@ -0,0 +1,13 @@
+{
+    "1": {
+        "router_id": "1.1.1.1",
+        "areas": {
+            "0.0.0.0": ["192.168.10.0/24"]
+        }
+    },
+    "interfaces": {
+        "Ethernet1": {
+            "network_type": "point-to-point"
+        }
+    }
+}

data/spec/fixtures/snmp.json

@@ -0,0 +1,6 @@
+{
+    "contact": "network operations",
+    "location": "data center",
+    "source_interface": "Loopback0",
+    "chassis_id": "1234567890"
+}

data/spec/fixtures/varp.json

@@ -0,0 +1,11 @@
+{
+    "mac_address": "aa:bb:cc:dd:ee:ff",
+    "interfaces": {
+        "Vlan1234": {
+            "addresses": [
+                "1.1.1.1",
+                "2.2.2.2"
+            ]
+        }
+    }
+}

data/spec/spec_helper.rb

@@ -0,0 +1,27 @@
+# encoding: utf-8
+require 'simplecov'
+require 'simplecov-json'
+require 'simplecov-rcov'
+SimpleCov.formatters =
+  [
+    SimpleCov::Formatter::HTMLFormatter,
+    SimpleCov::Formatter::JSONFormatter,
+    SimpleCov::Formatter::RcovFormatter
+  ]
+SimpleCov.start do
+  add_filter '/spec/'
+  add_filter '/.bundle/'
+end
+
+require 'pry'
+require 'puppetlabs_spec_helper/puppet_spec_helper'
+
+dir = File.expand_path(File.dirname(__FILE__))
+Dir["#{dir}/support/**/*.rb"].sort.each { |f| require f }
+
+RSpec.configure do |config|
+  # rspec configuration
+  config.mock_with :rspec do |rspec_config|
+    rspec_config.syntax = :expect
+  end
+end

data/spec/support/fixtures.rb

@@ -0,0 +1,74 @@
+# encoding: utf-8
+
+require 'pathname'
+require 'yaml'
+require 'json'
+
+##
+# Fixtures implements a global container to store fixture data loaded from the
+# filesystem.
+class Fixtures
+  def self.[](name)
+    @fixtures[name]
+  end
+
+  def self.[]=(name, value)
+    @fixtures[name] = value
+  end
+
+  def self.clear
+    @fixtures = {}
+  end
+
+  clear
+
+  ##
+  # save an object and saves it as a fixture in the filesystem.
+  #
+  # @param [Symbol] key The fixture name without the `fixture_` prefix or
+  #   `.json` suffix.
+  #
+  # @param [Object] obj The object to serialize to JSON and write to the
+  #   fixture file.
+  #
+  # @option opts [String] :dir ('/path/to/fixtures') The fixtures directory,
+  #   defaults to the full path of spec/fixtures/ relative to the root of the
+  #   module.
+  def self.save(key, obj, opts = {})
+    dir = opts[:dir] || File.expand_path('../../fixtures', __FILE__)
+    file = Pathname.new(File.join(dir, "fixture_#{key}.yaml"))
+    fail ArgumentError, "Error, file #{file} exists" if file.exist?
+    File.open(file, 'w+') { |f| f.puts YAML.dump(obj) }
+  end
+end
+
+##
+# FixtureHelpers provides instance methods for RSpec test cases that aid in the
+# loading and caching of fixture data.
+module FixtureHelpers
+  ##
+  # fixture loads a JSON fixture from the spec/fixtures/ directory, prefixed
+  # with fixture_.  Given the name 'foo' the file
+  # `spec/fixtures/fixture_foo.json` will be loaded and returned.  This method
+  # is memoized across the life of the process.
+  #
+  # @param [Symbol] key The fixture name without the `fixture_` prefix or
+  #   `.json` suffix.
+  #
+  # @option opts [String] :dir ('/path/to/fixtures') The fixtures directory,
+  #   defaults to the full path of spec/fixtures/ relative to the root of the
+  #   module.
+  def fixture(key, opts = {})
+    memo = Fixtures[key]
+    return memo if memo
+    dir = opts[:dir] || File.expand_path('../../fixtures', __FILE__)
+
+    yaml = Pathname.new(File.join(dir, "fixture_#{key}.yaml"))
+    json = Pathname.new(File.join(dir, "fixture_#{key}.json"))
+
+    Fixtures[key] = if yaml.exist?; then YAML.load(File.read(yaml))
+                    elsif json.exist?; then JSON.load(File.read(json))
+                    else fail "could not load YAML or JSON fixture #{key}"
+                    end
+  end
+end

data/spec/support/shared_examples_for_providers.rb

@@ -0,0 +1,7 @@
+RSpec.shared_examples 'provider resource methods' do |opts = {}|
+  opts.each_pair do |method, value|
+    it "#{method} is #{value}" do
+      expect(subject.send(method)).to eq(value)
+    end
+  end
+end

data/spec/support/shared_examples_for_types.rb

@@ -0,0 +1,451 @@
+# encoding: utf-8
+
+RSpec.shared_examples 'property' do
+  it 'is a property' do
+    expect(described_class.attrtype(attribute)).to eq(:property)
+  end
+end
+
+RSpec.shared_examples 'parameter' do
+  it 'is a parameter' do
+    expect(described_class.attrtype(attribute)).to eq(:param)
+  end
+end
+
+RSpec.shared_examples 'an ensurable type' do |opts = { name: 'emanon' }|
+  describe 'ensure' do
+    let(:catalog) { Puppet::Resource::Catalog.new }
+    let(:type) do
+      described_class.new(name: opts[:name], catalog: catalog)
+    end
+
+    let(:attribute) { :ensure }
+    subject { described_class.attrclass(attribute) }
+
+    include_examples 'property'
+    include_examples '#doc Documentation'
+
+    %w(absent present).each do |val|
+      it "accepts #{val.inspect}" do
+        type[attribute] = val
+      end
+    end
+
+    %w(true false).each do |val|
+      it "rejects #{val.inspect}" do
+        expect { type[attribute] = val }.to raise_error Puppet::ResourceError
+      end
+    end
+  end
+end
+
+RSpec.shared_examples 'boolean parameter' do
+  it 'is a parameter' do
+    expect(described_class.attrtype(attribute)).to eq(:param)
+  end
+
+  include_examples 'boolean value'
+end
+
+RSpec.shared_examples 'boolean' do |opts|
+  attribute = opts[:attribute]
+  fail unless attribute
+  name = opts[:name] || 'emanon'
+
+  describe "#{attribute}" do
+    let(:catalog) { Puppet::Resource::Catalog.new }
+    let(:attribute) { attribute }
+    let(:type) { described_class.new(name: name, catalog: catalog) }
+    subject { described_class.attrclass(attribute) }
+
+    include_examples 'boolean value'
+    include_examples '#doc Documentation'
+    include_examples 'rejects values', [0, [1], { two: :three }]
+  end
+end
+
+RSpec.shared_examples 'boolean value' do
+  [true, false, 'true', 'false', :true, :false].each do |val|
+    it "accepts #{val.inspect}" do
+      type[attribute] = val
+    end
+
+    it "munges #{val.inspect} to #{val.to_s.intern.inspect}" do
+      type[attribute] = val
+      expect(type[attribute]).to eq(val.to_s.intern)
+    end
+  end
+
+  [1, -1, { foo: 1 }, [1], 'baz', nil].each do |val|
+    it "rejects #{val.inspect} with Puppet::Error" do
+      expect { type[attribute] = val }.to raise_error Puppet::Error
+    end
+  end
+end
+
+RSpec.shared_examples 'name is the namevar' do
+  describe 'name' do
+    let(:catalog) { Puppet::Resource::Catalog.new }
+    let(:type) do
+      described_class.new(name: 'emanon', catalog: catalog)
+    end
+
+    let(:attribute) { :name }
+    subject { described_class.attrclass(attribute) }
+
+    include_examples '#doc Documentation'
+
+    it 'is a parameter' do
+      expect(described_class.attrtype(:name)).to eq(:param)
+    end
+
+    ['Engineering'].each do |val|
+      it "accepts #{val.inspect}" do
+        type[attribute] = val
+      end
+    end
+
+    [0, %w(Marketing Sales), { two: :three }].each do |val|
+      it "rejects #{val.inspect}" do
+        expect { type[attribute] = val }
+          .to raise_error Puppet::ResourceError, /is invalid, must be a String/
+      end
+    end
+  end
+end
+
+RSpec.shared_examples '#doc Documentation' do
+  it '#doc is a String' do
+    expect(subject.doc).to be_a_kind_of(String)
+  end
+
+  it '#doc is not only whitespace' do
+    expect(subject.doc.gsub(/\s+/, '')).not_to be_empty
+  end
+end
+
+RSpec.shared_examples 'rejected parameter values' do
+  [{ two: :three }, nil, :undef, :undefined, 'foobar'].each do |val|
+    it "rejects #{val.inspect} with a Puppet::Error" do
+      expect { type[attribute] = val }.to raise_error Puppet::Error
+    end
+  end
+end
+
+RSpec.shared_examples 'channel group id value' do
+  [1, 10, 100, 1000].each do |val|
+    it "accepts #{val.inspect}" do
+      type[attribute] = val
+    end
+  end
+
+  it 'munges [10, 20] to 10' do
+    type[attribute] = [10, 20]
+    expect(type[attribute]).to eq('10')
+  end
+
+  [-1, 1001, 8192, 'asdf', { foo: 1 }, true, false, nil].each do |val|
+    it "rejects #{val.inspect} with a Puppet::Error" do
+      expect { type[attribute] = val }.to raise_error Puppet::Error
+    end
+  end
+end
+
+RSpec.shared_examples 'vlan id value' do
+  [1, 10, 100, 4094].each do |val|
+    it "accepts #{val.inspect}" do
+      type[attribute] = val
+    end
+  end
+
+  it 'munges [10, 20] to 10' do
+    type[attribute] = [10, 20]
+    expect(type[attribute]).to eq(10)
+  end
+
+  [-1, 4096, 8192, 'asdf', { foo: 1 }, true, false, nil].each do |val|
+    it "rejects #{val.inspect} with a Puppet::Error" do
+      expect { type[attribute] = val }.to raise_error Puppet::Error
+    end
+  end
+end
+
+RSpec.shared_examples 'vlan range value' do
+  [1, 10, 100, 4094].each do |val|
+    it "munges #{val.inspect} to [#{val}]" do
+      type[attribute] = val
+      expect(type[attribute]).to eq([val])
+    end
+  end
+
+  it 'munges [10, 20] to [10, 20]' do
+    type[attribute] = [10, 20]
+    expect(type[attribute]).to eq([10, 20])
+  end
+
+  [-1, 4096, 8192, 'asdf', { foo: 1 }, true, false, nil].each do |val|
+    it "rejects #{val.inspect} with a Puppet::Error" do
+      expect { type[attribute] = val }.to raise_error Puppet::Error
+    end
+  end
+end
+
+RSpec.shared_examples 'vlan range string value' do
+  %w(1 10 100 4094).each do |val|
+    it "munges #{val.inspect} to [#{val}]" do
+      type[attribute] = val
+      expect(type[attribute]).to eq([val])
+    end
+  end
+
+  it 'munges [10, 20] to ["10", "20"]' do
+    type[attribute] = [10, 20]
+    expect(type[attribute]).to eq([10, 20])
+  end
+
+  [-1, 4096, '8192', 'asdf', { foo: 1 }, true, false, nil].each do |val|
+    it "rejects #{val.inspect} with a Puppet::Error" do
+      expect { type[attribute] = val }.to raise_error Puppet::Error
+    end
+  end
+end
+
+RSpec.shared_examples 'interface list value' do
+  ['Ethernet1', 'Ethernet2', 'ethernet 4/2'].each do |val|
+    it "accepts #{val.inspect}" do
+      type[attribute] = val
+      expect(type[attribute]).to eq([val])
+    end
+  end
+
+  [-1, 4096, 8192, 'asdf', { foo: 1 }, true, false, nil].each do |val|
+    it "rejects #{val.inspect} with a Puppet::Error" do
+      expect { type[attribute] = val }.to raise_error Puppet::Error
+    end
+  end
+end
+
+RSpec.shared_examples 'array of strings property' do |opts|
+  attribute = opts[:attribute]
+  name = opts[:name] || 'emanon'
+  describe "#{attribute}" do
+    let(:catalog) { Puppet::Resource::Catalog.new }
+    let(:type) { described_class.new(name: name, catalog: catalog) }
+    let(:attribute) { attribute }
+    subject { described_class.attrclass(attribute) }
+
+    include_examples '#doc Documentation'
+    include_examples 'array of strings value'
+  end
+end
+
+RSpec.shared_examples 'array of strings value' do
+  ['foo', 'bar', 'foo bar baz'].each do |val|
+    it "accepts #{val.inspect}" do
+      type[attribute] = val
+      expect(type[attribute]).to eq([val])
+    end
+  end
+
+  [-1, 4096, 8192, { foo: 1 }, true, false, nil].each do |val|
+    it "rejects #{val.inspect} with a Puppet::Error" do
+      expect { type[attribute] = val }.to raise_error Puppet::Error
+    end
+  end
+end
+
+RSpec.shared_examples 'numeric parameter' do |opts|
+  min = opts[:min]
+  max = opts[:max]
+  [min, max].each do |val|
+    it "accepts #{val.inspect}" do
+      type[attribute] = val
+      expect(type[attribute]).to eq(val)
+    end
+  end
+
+  [min, min.to_s, " #{min}", " #{min} ", "#{min} "].each do |val|
+    it "munges #{val.inspect} to #{min}" do
+      type[attribute] = val
+      expect(type[attribute]).to eq(val.to_i)
+    end
+  end
+
+  it "munges [#{min}, #{max}] to #{min}" do
+    type[attribute] = [min, max]
+    expect(type[attribute]).to eq(min)
+  end
+end
+
+RSpec.shared_examples 'description property' do
+  it 'is a property' do
+    expect(described_class.attrtype(attribute)).to eq(:property)
+  end
+
+  ['Engineering VLAN'].each do |desc|
+    it "accepts #{desc.inspect}" do
+      type[attribute] = desc
+    end
+  end
+
+  [0, [1], { two: :three }].each do |val|
+    it "rejects #{val.inspect}" do
+      expect { type[attribute] = val }.to raise_error Puppet::ResourceError
+    end
+  end
+end
+
+RSpec.shared_examples 'speed property' do
+  include_examples 'property'
+
+  %w(auto 1g 10g 40g 56g 100g 100m 10m).each do |val|
+    it "accepts #{val.inspect}" do
+      type[attribute] = val
+    end
+  end
+
+  [0, 15, '0', '15', { two: :three }, 'abc'].each do |val|
+    it "rejects #{val.inspect} with Puppet::ResourceError" do
+      expect { type[attribute] = val }.to raise_error Puppet::ResourceError
+    end
+  end
+end
+
+RSpec.shared_examples 'duplex property' do
+  include_examples 'property'
+
+  %w(auto full half).each do |val|
+    it "accepts #{val.inspect}" do
+      type[attribute] = val
+    end
+  end
+
+  [0, 15, '0', '15', { two: :three }, 'abc'].each do |val|
+    it "rejects #{val.inspect} with Puppet::ResourceError" do
+      expect { type[attribute] = val }.to raise_error Puppet::ResourceError
+    end
+  end
+end
+
+RSpec.shared_examples 'flowcontrol property' do
+  it 'is a property' do
+    expect(described_class.attrtype(attribute)).to eq(:property)
+  end
+
+  %w(desired on off).each do |val|
+    it "accepts #{val.inspect}" do
+      type[attribute] = val
+    end
+
+    it "munges #{val.inspect} to #{val.intern.inspect}" do
+      type[attribute] = val
+      expect(type[attribute]).to eq(val.intern)
+    end
+  end
+
+  [0, 15, '0', '15', { two: :three }, 'abc'].each do |val|
+    it "rejects #{val.inspect} with Puppet::ResourceError" do
+      expect { type[attribute] = val }.to raise_error Puppet::ResourceError
+    end
+  end
+end
+
+RSpec.shared_examples 'enabled type' do
+  describe 'enable' do
+    let(:catalog) { Puppet::Resource::Catalog.new }
+    let(:type) do
+      described_class.new(name: 'emanon', catalog: catalog)
+    end
+
+    let(:attribute) { :enable }
+    subject { described_class.attrclass(attribute) }
+
+    it 'is a property' do
+      expect(described_class.attrtype(attribute)).to eq(:property)
+    end
+
+    include_examples '#doc Documentation'
+    include_examples 'boolean value'
+  end
+end
+
+RSpec.shared_examples 'string' do |opts|
+  attribute = opts[:attribute]
+  fail unless attribute
+  name = opts[:name] || 'emanon'
+
+  describe "#{attribute}" do
+    let(:catalog) { Puppet::Resource::Catalog.new }
+    let(:attribute) { attribute }
+    let(:type) { described_class.new(name: name, catalog: catalog) }
+    subject { described_class.attrclass(attribute) }
+
+    include_examples 'string value'
+    include_examples '#doc Documentation'
+    include_examples 'rejects values', [0, [1], { two: :three }]
+  end
+end
+
+RSpec.shared_examples 'string value' do
+  ['Engineering'].each do |val|
+    it "accepts #{val.inspect}" do
+      type[attribute] = val
+    end
+  end
+
+  [0, [1], { two: :three }].each do |val|
+    it "rejects #{val.inspect}" do
+      expect { type[attribute] = val }
+        .to raise_error Puppet::ResourceError, /is invalid, must be a String/
+    end
+  end
+
+  [%w(Marketing Sales)].each do |val|
+    it "munges #{val.inspect} to #{val.first.inspect}" do
+      type[attribute] = val
+      expect(type[attribute]).to eq(val.first)
+    end
+  end
+end
+
+RSpec.shared_examples 'rejects values' do |values|
+  [*values].each do |val|
+    it "rejects #{val.inspect} with a Puppet::Error" do
+      expect { type[attribute] = val }.to raise_error Puppet::Error
+    end
+  end
+end
+
+RSpec.shared_examples 'accepts values' do |values|
+  [*values].each do |val|
+    it "accepts #{val.inspect}" do
+      type[attribute] = val
+    end
+
+    it "munges #{val.inspect} to #{val.intern.inspect}" do
+      type[attribute] = val
+      expect(type[attribute]).to eq(val.intern)
+    end
+  end
+end
+
+RSpec.shared_examples 'accepts values without munging' do |values|
+  [*values].each do |val|
+    it "accepts #{val.inspect}" do
+      type[attribute] = val
+    end
+
+    it "munges #{val.inspect} to #{val.inspect} (no munging)" do
+      type[attribute] = val
+      expect(type[attribute]).to eq(val)
+    end
+  end
+end
+
+RSpec.shared_examples 'it has a string property' do |attribute|
+  describe "#{attribute}" do
+    let(:attribute) { attribute }
+    include_examples '#doc Documentation'
+    include_examples 'string value'
+  end
+end