Implement a strings:validate:reference task

This task can validate whether REFERENCE.md is still in sync.

Author: ekohl

lib/puppet-strings/tasks.rb

@@ -8,5 +8,6 @@ module PuppetStrings
   module Tasks
     require 'puppet-strings/tasks/generate.rb'
     require 'puppet-strings/tasks/gh_pages.rb'
+    require 'puppet-strings/tasks/validate.rb'
   end
 end

lib/puppet-strings/tasks/validate.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+require 'puppet-strings'
+require 'tempfile'
+
+namespace :strings do
+  namespace :validate do
+    desc 'Validate the reference is up to date'
+    task :reference, [:patterns, :debug, :backtrace] do |t, args|
+      filename = 'REFERENCE.md'
+
+      unless File.exist?(filename)
+        STDERR.puts "#{filename} does not exist"
+        exit 1
+      end
+
+      patterns = args[:patterns]
+      patterns = patterns.split if patterns
+      patterns ||= PuppetStrings::DEFAULT_SEARCH_PATTERNS
+
+      generated = Tempfile.create do |file|
+        options = {
+          debug: args[:debug] == 'true',
+          backtrace: args[:backtrace] == 'true',
+          json: false,
+          markdown: true,
+          path: file,
+        }
+        PuppetStrings.generate(patterns, options)
+
+        file.read
+      end
+
+      existing = File.read(filename)
+
+      if generated != existing
+        STDERR.puts "#{filename} is outdated"
+        exit 1
+      end
+    end
+  end
+end