voxpupuli-test 14.0.0 → 15.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2dcdc2312c0db968dcddca73a0eaf60ad5539c0379b2b2eefb002be318d0cb30
-  data.tar.gz: beb9801b4df1e885457200039cc349e57051daa338a650017c34fb749e8bc2e0
+  metadata.gz: 9baef4ad6c44c840232ce31f3a50f1f9df2bcc74e6f5328e9326cb3e573b4d5d
+  data.tar.gz: '059f4f301334843412b89c5fae8661bd73391a054967fa242148c882f1fe6053'
 SHA512:
-  metadata.gz: '029d81551fb4428b08a9d0c82e17a04b95e14770e34fc1893a245a2cb7f77f2dd7497cada13203d172ad09fd2dbaf7538b9e701c40c08804ec408e07c989f45f'
-  data.tar.gz: 59542f5c3ea5340aeb0202591aed64738672a5e72d5052320054b1e01ce8a1df790f3386e1f3f287c887dbf2e283d5d39ae605f47b0ce79d6be738dd343f85c9
+  metadata.gz: d6e97e07aa6c82ec706730423e21ab6e9ac2dd0b417fa0c438aa736e017f2f35d8d64a870c0a9776b93ed1b4c4f85f85ea932b7470fc9af18f38014a892c6bd3
+  data.tar.gz: 01365a55df6996d99bda1a08fa3d9ee6c2ab70c865a0f31ec515bf92f6c496387243f06c901761bece9d46f5e07ba52aa7bc1abe087fca4f1a852ba5cdbf86ee

data/README.md

@@ -74,6 +74,12 @@ To autocorrect Ruby files:
 bundle exec rake rubocop:autocorrect
 ```
 
+To generate or refresh a `.rubocop_todo.yml` file:
+
+```sh
+bundle exec rake rubocop:regenerate_todo
+```
+
 ## Rake tasks
 
 ### `check:trailing_whitespace`
@@ -107,6 +113,21 @@ The tasks that currently support this feature include `lint` and `rubocop`.
 
 Note that if multiple tasks all attempt to output CodeClimate reports in a single rake call, then only the final task will be able store its report.
 
+## Shared examples
+
+Shared examples are provided for things that are easy to get wrong in a custom type or provider.
+They are opt-in, so add the ones that apply to your type:
+
+```ruby
+require 'spec_helper'
+
+describe Puppet::Type.type(:mytool_config) do
+  it_behaves_like 'a type that works with `puppet generate types`'
+end
+```
+
+See [`lib/voxpupuli/test/shared_examples/`](lib/voxpupuli/test/shared_examples) for what is available.
+
 ## Fact handling
 
 The recommended method is using [rspec-puppet-facts](https://github.com/mcanevet/rspec-puppet-facts) and is set up by default. This means the tests are writting as follows:

data/lib/voxpupuli/test/rake/rubocop.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require 'rubocop/rake_task'
+
 RuboCop::RakeTask.new(:rubocop) do |task|
   # These make the rubocop experience maybe slightly less terrible
   task.options = ['--debug', '--display-style-guide', '--extra-details']
@@ -19,3 +20,15 @@ RuboCop::RakeTask.new(:rubocop) do |task|
     task.options += ['--format', 'CodeclimateFormatter', '--out', ENV['CODECLIMATE_REPORT_FILE']]
   end
 end
+
+namespace :rubocop do
+  # Do not use the `RuboCop::RakeTask` here, because it also adds the autocorrect tasks again.
+  desc 'Generate or refresh the RuboCop TODO file'
+  task :regenerate_todo do
+    require 'rubocop/cli'
+
+    status = RuboCop::CLI.new.run(%w[--regenerate-todo --no-auto-gen-timestamp])
+
+    abort "RuboCop failed with status #{status}" unless status.zero?
+  end
+end

data/lib/voxpupuli/test/shared_examples/providers.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+# Shared examples for the providers of custom types.
+#
+#   describe Puppet::Type.type(:my_type).provider(:my_provider) do
+#     it_behaves_like 'a documented provider'
+#   end
+
+# A provider's `desc` ends up in REFERENCE.md, like a type's.
+RSpec.shared_examples 'a documented provider' do
+  it 'has documentation' do
+    expect(described_class.doc.to_s.strip).not_to be_empty
+  end
+end

data/lib/voxpupuli/test/shared_examples/types.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+require 'puppet/generate/models/type/type'
+
+# Shared examples for custom types.
+#
+#   describe Puppet::Type.type(:my_type) do
+#     it_behaves_like 'a type that works with `puppet generate types`'
+#     it_behaves_like 'a documented type'
+#     it_behaves_like 'an ensurable type'
+#   end
+
+# `puppet generate types` accepts less than `Puppet::Type` does, and a module
+# only finds out when an r10k deployment using `--generate-types` fails.
+RSpec.shared_examples 'a type that works with `puppet generate types`' do
+  it 'does not raise an error' do
+    expect { Puppet::Generate::Models::Type::Type.new(described_class) }.not_to raise_error
+  end
+end
+
+# Anything undocumented here is an empty entry in REFERENCE.md.
+RSpec.shared_examples 'a documented type' do
+  it 'has documentation' do
+    expect(described_class.doc.to_s.strip).not_to be_empty
+  end
+
+  it 'documents all parameters and properties' do
+    attributes = described_class.validproperties + described_class.parameters
+
+    undocumented = attributes.reject do |name|
+      klass = described_class.attrclass(name) || described_class.paramclass(name)
+      klass && !klass.doc.to_s.strip.empty?
+    end
+
+    expect(undocumented).to be_empty
+  end
+end
+
+# For types that manage a thing that can be created and removed. Types that use
+# `ensure` for something else, e.g. `[:purgable, :purged]`, don't want this.
+RSpec.shared_examples 'an ensurable type' do
+  it 'is ensurable' do
+    expect(described_class.propertybyname(:ensure)).not_to be_nil
+  end
+
+  it 'supports present and absent' do
+    values = described_class.propertybyname(:ensure)&.value_collection&.values
+
+    expect(values).to include(:present, :absent)
+  end
+end

data/lib/voxpupuli/test/shared_examples.rb

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+
+require_relative 'shared_examples/types'
+require_relative 'shared_examples/providers'

data/lib/voxpupuli/test/spec_helper.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require 'voxpupuli/test/facts'
+require 'voxpupuli/test/shared_examples'
 require 'rspec-puppet'
 
 spec_path = File.expand_path(File.join(Dir.pwd, 'spec'))

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: voxpupuli-test
 version: !ruby/object:Gem::Version
-  version: 14.0.0
+  version: 15.0.0
 platform: ruby
 authors:
 - Vox Pupuli
@@ -173,16 +173,22 @@ dependencies:
   name: rspec-puppet
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '5.0'
+        version: '5'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '7'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '5.0'
+        version: '5'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '7'
 - !ruby/object:Gem::Dependency
   name: rspec-puppet-facts
   requirement: !ruby/object:Gem::Requirement
@@ -229,14 +235,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.85.1
+        version: 1.91.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.85.1
+        version: 1.91.0
 - !ruby/object:Gem::Dependency
   name: rubocop-rake
   requirement: !ruby/object:Gem::Requirement
@@ -255,16 +261,22 @@ dependencies:
   name: rubocop-rspec
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '3.9'
+    - - "<"
       - !ruby/object:Gem::Version
-        version: 3.9.0
+        version: '3.11'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '3.9'
+    - - "<"
       - !ruby/object:Gem::Version
-        version: 3.9.0
+        version: '3.11'
 - !ruby/object:Gem::Dependency
   name: voxpupuli-puppet-lint-plugins
   requirement: !ruby/object:Gem::Requirement
@@ -318,6 +330,9 @@ files:
 - lib/voxpupuli/test/rake/spec.rb
 - lib/voxpupuli/test/rake/validate.rb
 - lib/voxpupuli/test/rubocop_formatters/codeclimate.rb
+- lib/voxpupuli/test/shared_examples.rb
+- lib/voxpupuli/test/shared_examples/providers.rb
+- lib/voxpupuli/test/shared_examples/types.rb
 - lib/voxpupuli/test/spec_helper.rb
 - rubocop.yml
 homepage: https://github.com/voxpupuli/voxpupuli-test
@@ -338,7 +353,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.3
+rubygems_version: 4.0.20
 specification_version: 4
 summary: Helpers for testing Vox Pupuli modules
 test_files: []