puppetlabs-onceover-octocatalog-diff 0.1.10

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: a6b486e1e67a13d86e5747089b2f9c1693f324554cdf19b3071df3dda8a94eac
+  data.tar.gz: 81a700174f35d810220f532a7c012af36ee8cf7e3034419567a160161182967a
+SHA512:
+  metadata.gz: 43dc0769e5c960b7032ff0d777c7ca4cbae024a4b2226fde7fcea4bbc636a4be5054e0c5d55b80a6d2cdff102ae774fe299ef3f48f8b8af2e5ba149e3483aa8b
+  data.tar.gz: 75c5171c3db77aeffe7b92d11c84ddedaef68d65dfc5dc2f7c3d8741cb835b44da36e27144382d8297052d73ee6d1bd207e4086db6546416a457f88ade5f2d1e

data/.devcontainer/devcontainer.json

@@ -0,0 +1,10 @@
+// For format details, see https://aka.ms/devcontainer.json. For config options, see the
+// README at: https://github.com/devcontainers/templates/tree/main/src/debian
+{
+	"name": "Debian",
+	// Or use a Dockerfile or Docker Compose file. More info: https://containers.dev/guide/dockerfile
+	"image": "mcr.microsoft.com/devcontainers/ruby:3.2",
+	"features": {
+		"ghcr.io/devcontainers/features/github-cli:1": {}
+	}
+}

data/.gitattributes

@@ -0,0 +1,2 @@
+# force LF line endings, even when on Windows
+* text eol=lf

data/.github/dependabot.yml

@@ -0,0 +1,17 @@
+version: 2
+updates:
+  # raise PRs for gem updates
+  - package-ecosystem: bundler
+    directory: "/"
+    schedule:
+      interval: daily
+      time: "13:00"
+    open-pull-requests-limit: 10
+
+  # Maintain dependencies for GitHub Actions
+  - package-ecosystem: github-actions
+    directory: "/"
+    schedule:
+      interval: daily
+      time: "13:00"
+    open-pull-requests-limit: 10

data/.github/labeler.yml

@@ -0,0 +1,3 @@
+---
+skip-changelog:
+ - head-branch: ['^release-*']

data/.github/release.yml

@@ -0,0 +1,40 @@
+---
+# https://docs.github.com/en/repositories/releasing-projects-on-github/automatically-generated-release-notes
+
+changelog:
+  exclude:
+    labels:
+      - duplicate
+      - invalid
+      - modulesync
+      - question
+      - skip-changelog
+      - wont-fix
+      - wontfix
+      - github_actions
+
+  categories:
+    - title: Breaking Changes 🛠
+      labels:
+        - backwards-incompatible
+
+    - title: New Features 🎉
+      labels:
+        - enhancement
+
+    - title: Bug Fixes 🐛
+      labels:
+        - bug
+
+    - title: Documentation Updates 📚
+      labels:
+        - documentation
+        - docs
+
+    - title: Dependency Updates ⬆️
+      labels:
+        - dependencies
+
+    - title: Other Changes
+      labels:
+        - "*"

data/.github/workflows/ci.yaml

@@ -0,0 +1,94 @@
+---
+name: "ci"
+
+on:
+  push:
+    branches:
+      - "main"
+  pull_request:
+    branches:
+      - "main"
+  workflow_dispatch:
+
+env:
+  CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }}
+
+jobs:
+  spec:
+    strategy:
+      fail-fast: false
+      matrix:
+        ruby_version:
+          - "3.2"
+          - "4.0"
+        include:
+          - ruby_version: "3.2"
+            puppet_gem_version: "~> 8.0"
+          - ruby_version: "4.0"
+            puppet_gem_version: "~> 9.0"
+        runs_on:
+          - "ubuntu-latest"
+          - "macos-latest"
+          - "ubuntu-24.04-arm"
+    # NOTE: windows-latest is a separate, bespoke job below -- see
+    # spec-windows for why (matches puppetlabs-onceover's own ci.yml pattern).
+    name: "spec (${{ matrix.runs_on }} ruby ${{ matrix.ruby_version }} | puppet ${{ matrix.puppet_gem_version }})"
+    uses: "puppetlabs/cat-github-actions/.github/workflows/gem_ci.yml@main"
+    secrets: "inherit"
+    with:
+      rake_task: "spec"
+      ruby_version: ${{ matrix.ruby_version }}
+      puppet_gem_version: ${{ matrix.puppet_gem_version }}
+      runs_on: ${{ matrix.runs_on }}
+
+  spec-windows:
+    strategy:
+      fail-fast: false
+      matrix:
+        ruby_version:
+          - "3.2"
+          - "4.0"
+        include:
+          - ruby_version: "3.2"
+            puppet_gem_version: "~> 8.0"
+          - ruby_version: "4.0"
+            puppet_gem_version: "~> 9.0"
+    name: "spec (windows-latest ruby ${{ matrix.ruby_version }} | puppet ${{ matrix.puppet_gem_version }})"
+    runs-on: "windows-latest"
+    env:
+      PUPPET_GEM_VERSION: ${{ matrix.puppet_gem_version }}
+      PUPPET_FORGE_TOKEN: ${{ secrets.PUPPET_FORGE_TOKEN || secrets.PUPPET_FORGE_TOKEN_PUBLIC }}
+      BUNDLE_RUBYGEMS___PUPPETCORE__PUPPET__COM: "forge-key:${{ secrets.PUPPET_FORGE_TOKEN || secrets.PUPPET_FORGE_TOKEN_PUBLIC }}"
+    steps:
+      - uses: "actions/checkout@v4"
+      - uses: "ruby/setup-ruby@v1"
+        with:
+          ruby-version: ${{ matrix.ruby_version }}
+          bundler-cache: true
+      - name: "rubocop"
+        run: bundle exec rubocop --format github
+      - name: "spec"
+        run: bundle exec rake spec
+
+  build:
+    needs: "spec"
+    runs-on: "ubuntu-latest"
+    name: "Verify gem builds"
+    steps:
+      - uses: "actions/checkout@v4"
+      - uses: "ruby/setup-ruby@v1"
+        with:
+          ruby-version: "3.4"
+          bundler-cache: true
+      - name: "Verify gem builds"
+        run: "gem build --strict --verbose *.gemspec"
+
+  tests:
+    needs:
+      - "spec"
+      - "spec-windows"
+      - "build"
+    runs-on: "ubuntu-latest"
+    name: "Test suite"
+    steps:
+      - run: "echo Test suite completed"

data/.github/workflows/labeler.yaml

@@ -0,0 +1,15 @@
+---
+name: 🏷️ Pull Request Labeler
+
+on:
+  - pull_request_target
+
+jobs:
+  labeler:
+    permissions:
+      contents: read
+      pull-requests: write
+    name: Labeler
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/labeler@v6

data/.github/workflows/mend.yml

@@ -0,0 +1,14 @@
+name: "mend"
+
+on:
+  pull_request:
+    branches:
+      - "main"
+  schedule:
+    - cron: "0 0 * * *"
+  workflow_dispatch:
+
+jobs:
+  mend:
+    uses: "puppetlabs/cat-github-actions/.github/workflows/tooling_mend_ruby.yml@main"
+    secrets: "inherit"

data/.github/workflows/nightly.yml

@@ -0,0 +1,62 @@
+name: "nightly"
+
+on:
+  schedule:
+    - cron: "0 0 * * *"
+  workflow_dispatch:
+
+jobs:
+  spec:
+    strategy:
+      fail-fast: false
+      matrix:
+        ruby_version:
+          - "3.2"
+          - "4.0"
+        include:
+          - ruby_version: "3.2"
+            puppet_gem_version: "~> 8.0"
+          - ruby_version: "4.0"
+            puppet_gem_version: "~> 9.0"
+        runs_on:
+          - "ubuntu-latest"
+          - "macos-latest"
+          - "ubuntu-24.04-arm"
+    # See ci.yaml's spec-windows job for the separate Windows lane.
+    name: "spec (${{ matrix.runs_on }} ruby ${{ matrix.ruby_version }} | puppet ${{ matrix.puppet_gem_version }})"
+    uses: "puppetlabs/cat-github-actions/.github/workflows/gem_ci.yml@main"
+    secrets: "inherit"
+    with:
+      rake_task: "spec"
+      ruby_version: ${{ matrix.ruby_version }}
+      puppet_gem_version: ${{ matrix.puppet_gem_version }}
+      runs_on: ${{ matrix.runs_on }}
+
+  spec-windows:
+    strategy:
+      fail-fast: false
+      matrix:
+        ruby_version:
+          - "3.2"
+          - "4.0"
+        include:
+          - ruby_version: "3.2"
+            puppet_gem_version: "~> 8.0"
+          - ruby_version: "4.0"
+            puppet_gem_version: "~> 9.0"
+    name: "spec (windows-latest ruby ${{ matrix.ruby_version }} | puppet ${{ matrix.puppet_gem_version }})"
+    runs-on: "windows-latest"
+    env:
+      PUPPET_GEM_VERSION: ${{ matrix.puppet_gem_version }}
+      PUPPET_FORGE_TOKEN: ${{ secrets.PUPPET_FORGE_TOKEN || secrets.PUPPET_FORGE_TOKEN_PUBLIC }}
+      BUNDLE_RUBYGEMS___PUPPETCORE__PUPPET__COM: "forge-key:${{ secrets.PUPPET_FORGE_TOKEN || secrets.PUPPET_FORGE_TOKEN_PUBLIC }}"
+    steps:
+      - uses: "actions/checkout@v4"
+      - uses: "ruby/setup-ruby@v1"
+        with:
+          ruby-version: ${{ matrix.ruby_version }}
+          bundler-cache: true
+      - name: "rubocop"
+        run: bundle exec rubocop --format github
+      - name: "spec"
+        run: bundle exec rake spec

data/.github/workflows/release.yaml

@@ -0,0 +1,16 @@
+name: "release"
+
+on:
+  workflow_dispatch:
+   inputs:
+    target:
+      description: "The target for the release. This can be a commit sha or a branch."
+      required: false
+      default: "main"
+
+jobs:
+  release:
+    uses: "puppetlabs/cat-github-actions/.github/workflows/gem_release.yml@main"
+    with:
+      target: "${{ github.event.inputs.target }}"
+    secrets: "inherit"

data/.github/workflows/release_prep.yml

@@ -0,0 +1,20 @@
+name: "release prep"
+
+on:
+  workflow_dispatch:
+   inputs:
+    target:
+      description: "The target for the release. This can be a commit sha or a branch."
+      required: false
+      default: "main"
+    version:
+      description: "Version of gem to be released."
+      required: true
+
+jobs:
+  release_prep:
+    uses: "puppetlabs/cat-github-actions/.github/workflows/gem_release_prep.yml@main"
+    with:
+      target: "${{ github.event.inputs.target }}"
+      version: "${{ github.event.inputs.version }}"
+    secrets: "inherit"

data/.gitignore

@@ -0,0 +1,11 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/examples.txt
+/spec/reports/
+/tmp/
+vendor/

data/.rubocop.yml

@@ -0,0 +1,19 @@
+---
+inherit_from: .rubocop_todo.yml
+
+
+AllCops:
+  NewCops: enable
+  DisplayCopNames: true
+  ExtraDetails: true
+  DisplayStyleGuide: true
+  TargetRubyVersion: 3.2
+  Exclude:
+    - vendor/**/*
+    - .vendor/**/*
+
+# .gitattributes forces LF line endings everywhere, including Windows.
+# The default EnforcedStyle is "native", which demands CRLF on Windows --
+# that's incompatible with this repo's own LF-everywhere policy.
+Layout/EndOfLine:
+  EnforcedStyle: lf

data/.rubocop_todo.yml

@@ -0,0 +1,197 @@
+# This configuration was generated by
+# `rubocop --auto-gen-config`
+# on 2026-09-14 19:16:07 UTC using RuboCop version 1.90.0.
+# The point is for the user to remove these configuration records
+# one by one as the offenses are removed from the code base.
+# Note that changes in the inspected code, or installation of new
+# versions of RuboCop, may require this file to be generated again.
+
+# Offense count: 1
+# This cop supports safe autocorrection (--autocorrect).
+Layout/HeredocIndentation:
+  Exclude:
+    - 'lib/puppetlabs-onceover/octocatalog-diff/cli.rb'
+
+# Offense count: 1
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: AllowDoxygenCommentStyle, AllowGemfileRubyComment, AllowRBSInlineAnnotation, AllowSteepAnnotation, AllowYARDCommentBlockSeparator.
+Layout/LeadingCommentSpace:
+  Exclude:
+    - 'lib/puppetlabs-onceover/octocatalog-diff/cli.rb'
+
+# Offense count: 10
+# This cop supports safe autocorrection (--autocorrect).
+Layout/SpaceAfterComma:
+  Exclude:
+    - 'lib/puppetlabs-onceover/octocatalog-diff/cli.rb'
+
+# Offense count: 1
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: EnforcedStyle, EnforcedStyleForEmptyBraces, SpaceBeforeBlockParameters.
+# SupportedStyles: space, no_space
+# SupportedStylesForEmptyBraces: space, no_space
+Layout/SpaceInsideBlockBraces:
+  Exclude:
+    - 'lib/puppetlabs-onceover/octocatalog-diff/cli.rb'
+
+# Offense count: 2
+# This cop supports safe autocorrection (--autocorrect).
+Lint/ErbNewArguments:
+  Exclude:
+    - 'lib/puppetlabs-onceover/octocatalog-diff/cli.rb'
+
+# Offense count: 2
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: IgnoreEmptyBlocks, AllowUnusedKeywordArguments.
+Lint/UnusedBlockArgument:
+  Exclude:
+    - 'lib/puppetlabs-onceover/octocatalog-diff/cli.rb'
+
+# Offense count: 1
+# Configuration parameters: AllowedMethods, AllowedPatterns, CountRepeatedAttributes.
+Metrics/AbcSize:
+  Max: 188
+
+# Offense count: 4
+# Configuration parameters: CountComments, CountAsOne, AllowedMethods, AllowedPatterns.
+# AllowedMethods: refine
+# cli_spec.rb's outer `RSpec.describe` block is a narrow, deliberate addition
+# (not machine-generated): it exercises every branch of cli.rb's single
+# 163-line inline `run` block (all three octocatalog-diff exit codes, both
+# r10k exit-status branches, and the module-cache hit/miss branch), which
+# means many small `it` blocks living under one `describe`/`context` nest.
+Metrics/BlockLength:
+  Max: 120
+  Exclude:
+    - 'spec/puppetlabs-onceover/octocatalog-diff/cli_spec.rb'
+
+# Offense count: 1
+# Configuration parameters: CountComments, CountAsOne.
+Metrics/ClassLength:
+  Max: 124
+
+# Offense count: 1
+# Configuration parameters: AllowedMethods, AllowedPatterns.
+Metrics/CyclomaticComplexity:
+  Max: 17
+
+# Offense count: 1
+# Configuration parameters: CountComments, CountAsOne, AllowedMethods, AllowedPatterns.
+Metrics/MethodLength:
+  Max: 122
+
+# Offense count: 1
+# Configuration parameters: AllowedMethods, AllowedPatterns.
+Metrics/PerceivedComplexity:
+  Max: 17
+
+# Offense count: 1
+# Configuration parameters: ExpectMatchingDefinition, CheckDefinitionPathHierarchy, CheckDefinitionPathHierarchyRoots, Regex, IgnoreExecutableScripts, AllowedAcronyms.
+# CheckDefinitionPathHierarchyRoots: lib, spec, test, src
+# AllowedAcronyms: CLI, DSL, ACL, API, ASCII, CPU, CSS, DNS, EOF, GUID, HTML, HTTP, HTTPS, ID, IP, JSON, LHS, QPS, RAM, RHS, RPC, SLA, SMTP, SQL, SSH, TCP, TLS, TTL, UDP, UI, UID, UUID, URI, URL, UTF8, VM, XML, XMPP, XSRF, XSS
+# 'lib/puppetlabs-onceover/octocatalog-diff.rb' is a permanent exclusion, not
+# a todo: its filename must literally match puppetlabs-onceover's plugin
+# loader require path (gem_name.sub('puppetlabs-onceover-', 'puppetlabs-onceover/')),
+# so it can never be renamed to snake_case. 'Rakefile.rb' here is just
+# rubocop's own normalized display name for the real 'Rakefile'.
+# 'spec/puppetlabs-onceover/octocatalog-diff_spec.rb' is the same permanent
+# exclusion, mirrored into spec/: rspec's own convention names a lib file's
+# spec by appending '_spec' to its exact basename, so this file's name is
+# forced to inherit the hyphen too.
+Naming/FileName:
+  Exclude:
+    - 'Rakefile.rb'
+    - 'lib/puppetlabs-onceover/octocatalog-diff.rb'
+    - 'spec/puppetlabs-onceover/octocatalog-diff_spec.rb'
+
+# Offense count: 1
+# This cop supports unsafe autocorrection (--autocorrect-all).
+# Configuration parameters: EnforcedStyleForLeadingUnderscores.
+# SupportedStylesForLeadingUnderscores: disallowed, required, optional
+Naming/MemoizedInstanceVariableName:
+  Exclude:
+    - 'lib/puppetlabs-onceover/octocatalog-diff/cli.rb'
+
+# Offense count: 1
+# This cop supports unsafe autocorrection (--autocorrect-all).
+Security/JSONLoad:
+  Exclude:
+    - 'lib/puppetlabs-onceover/octocatalog-diff/cli.rb'
+
+# Offense count: 2
+# Configuration parameters: AllowedConstants.
+Style/Documentation:
+  Exclude:
+    - 'spec/**/*'
+    - 'test/**/*'
+    - 'lib/puppetlabs-onceover/octocatalog-diff.rb'
+    - 'lib/puppetlabs-onceover/octocatalog-diff/cli.rb'
+
+# Offense count: 1
+# This cop supports safe autocorrection (--autocorrect).
+Style/FileWrite:
+  Exclude:
+    - 'lib/puppetlabs-onceover/octocatalog-diff/cli.rb'
+
+# Offense count: 2
+# This cop supports unsafe autocorrection (--autocorrect-all).
+Style/GlobalStdStream:
+  Exclude:
+    - 'lib/puppetlabs-onceover/octocatalog-diff/cli.rb'
+
+# Offense count: 4
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: EnforcedStyle, EnforcedShorthandSyntax, UseHashRocketsWithSymbolValues, PreferHashRocketsForNonAlnumEndingSymbols.
+# SupportedStyles: ruby19, hash_rockets, no_mixed_keys, ruby19_no_mixed_keys
+# SupportedShorthandSyntax: always, never, either, consistent, either_consistent
+Style/HashSyntax:
+  Exclude:
+    - 'Rakefile'
+    - 'lib/puppetlabs-onceover/octocatalog-diff/cli.rb'
+
+# Offense count: 1
+# This cop supports unsafe autocorrection (--autocorrect-all).
+# Configuration parameters: EnforcedStyle, AllowedMethods, AllowedPatterns.
+# SupportedStyles: predicate, comparison
+Style/NumericPredicate:
+  Exclude:
+    - 'spec/**/*'
+    - 'lib/puppetlabs-onceover/octocatalog-diff/cli.rb'
+
+# Offense count: 1
+# This cop supports safe autocorrection (--autocorrect).
+Style/StderrPuts:
+  Exclude:
+    - 'lib/puppetlabs-onceover/octocatalog-diff/cli.rb'
+
+# Offense count: 12
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: EnforcedStyle, ConsistentQuotesInMultiline.
+# SupportedStyles: single_quotes, double_quotes
+Style/StringLiterals:
+  Exclude:
+    - 'lib/puppetlabs-onceover/octocatalog-diff.rb'
+    - 'lib/puppetlabs-onceover/octocatalog-diff/cli.rb'
+
+# Offense count: 10
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: EnforcedStyle.
+# SupportedStyles: single_quotes, double_quotes
+Style/StringLiteralsInInterpolation:
+  Exclude:
+    - 'lib/puppetlabs-onceover/octocatalog-diff/cli.rb'
+
+# Offense count: 1
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: EnforcedStyleForMultiline.
+# SupportedStylesForMultiline: comma, consistent_comma, diff_comma, no_comma
+Style/TrailingCommaInHashLiteral:
+  Exclude:
+    - 'lib/puppetlabs-onceover/octocatalog-diff/cli.rb'
+
+# Offense count: 3
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: AllowHeredoc, AllowURI, AllowQualifiedName, URISchemes, AllowRBSInlineAnnotation, AllowCopDirectives, AllowedPatterns, SplitStrings.
+# URISchemes: http, https
+Layout/LineLength:
+  Max: 151

data/CHANGELOG.md

@@ -0,0 +1,61 @@
+<!-- markdownlint-disable MD024 -->
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/) and this project adheres to [Semantic Versioning](http://semver.org).
+
+## [v0.1.10](https://github.com/puppetlabs/puppetlabs-onceover-octocatalog-diff/tree/v0.1.10) - 2026-09-14
+
+[Full Changelog](https://github.com/puppetlabs/puppetlabs-onceover-octocatalog-diff/compare/v0.1.9...v0.1.10)
+
+### Other
+
+- Add rspec unit tests and SimpleCov coverage (CAT-2842) [#8](https://github.com/puppetlabs/puppetlabs-onceover-octocatalog-diff/pull/8) ([actowery](https://github.com/actowery))
+- Pin facter to Puppetcore source, matching puppet [#7](https://github.com/puppetlabs/puppetlabs-onceover-octocatalog-diff/pull/7) ([actowery](https://github.com/actowery))
+- Regenerate .rubocop_todo.yml per CAT-2806's literal instruction [#6](https://github.com/puppetlabs/puppetlabs-onceover-octocatalog-diff/pull/6) ([actowery](https://github.com/actowery))
+- Rename default branch to main, fix CI/version/devcontainer gaps missed on first pass (CAT-2800/2801/2805 follow-up) [#5](https://github.com/puppetlabs/puppetlabs-onceover-octocatalog-diff/pull/5) ([actowery](https://github.com/actowery))
+- Remove transitive voxpupuli-test rake dependency from Rakefile [#4](https://github.com/puppetlabs/puppetlabs-onceover-octocatalog-diff/pull/4) ([actowery](https://github.com/actowery))
+- Rename gem to puppetlabs-onceover-octocatalog-diff (CAT-2801/2802/2804) [#3](https://github.com/puppetlabs/puppetlabs-onceover-octocatalog-diff/pull/3) ([actowery](https://github.com/actowery))
+- Add CODEOWNERS (CAT-2799) [#2](https://github.com/puppetlabs/puppetlabs-onceover-octocatalog-diff/pull/2) ([actowery](https://github.com/actowery))
+- CAT-2800: Migrate release workflows to shared cat-github-actions, fix dead ownership guard [#1](https://github.com/puppetlabs/puppetlabs-onceover-octocatalog-diff/pull/1) ([actowery](https://github.com/actowery))
+
+## [v0.1.9](https://github.com/puppetlabs/puppetlabs-onceover-octocatalog-diff/tree/v0.1.9) - 2022-05-19
+
+[Full Changelog](https://github.com/puppetlabs/puppetlabs-onceover-octocatalog-diff/compare/v0.1.8...v0.1.9)
+
+## [v0.1.8](https://github.com/puppetlabs/puppetlabs-onceover-octocatalog-diff/tree/v0.1.8) - 2021-05-25
+
+[Full Changelog](https://github.com/puppetlabs/puppetlabs-onceover-octocatalog-diff/compare/v0.1.7...v0.1.8)
+
+## [v0.1.7](https://github.com/puppetlabs/puppetlabs-onceover-octocatalog-diff/tree/v0.1.7) - 2017-03-22
+
+[Full Changelog](https://github.com/puppetlabs/puppetlabs-onceover-octocatalog-diff/compare/v0.1.6...v0.1.7)
+
+## [v0.1.6](https://github.com/puppetlabs/puppetlabs-onceover-octocatalog-diff/tree/v0.1.6) - 2017-03-20
+
+[Full Changelog](https://github.com/puppetlabs/puppetlabs-onceover-octocatalog-diff/compare/v0.1.5...v0.1.6)
+
+## [v0.1.5](https://github.com/puppetlabs/puppetlabs-onceover-octocatalog-diff/tree/v0.1.5) - 2017-03-15
+
+[Full Changelog](https://github.com/puppetlabs/puppetlabs-onceover-octocatalog-diff/compare/v0.1.4...v0.1.5)
+
+## [v0.1.4](https://github.com/puppetlabs/puppetlabs-onceover-octocatalog-diff/tree/v0.1.4) - 2017-03-14
+
+[Full Changelog](https://github.com/puppetlabs/puppetlabs-onceover-octocatalog-diff/compare/v0.1.3...v0.1.4)
+
+## [v0.1.3](https://github.com/puppetlabs/puppetlabs-onceover-octocatalog-diff/tree/v0.1.3) - 2017-03-13
+
+[Full Changelog](https://github.com/puppetlabs/puppetlabs-onceover-octocatalog-diff/compare/v0.1.2...v0.1.3)
+
+## [v0.1.2](https://github.com/puppetlabs/puppetlabs-onceover-octocatalog-diff/tree/v0.1.2) - 2017-03-13
+
+[Full Changelog](https://github.com/puppetlabs/puppetlabs-onceover-octocatalog-diff/compare/v0.1.1...v0.1.2)
+
+## [v0.1.1](https://github.com/puppetlabs/puppetlabs-onceover-octocatalog-diff/tree/v0.1.1) - 2017-03-13
+
+[Full Changelog](https://github.com/puppetlabs/puppetlabs-onceover-octocatalog-diff/compare/v0.1.0...v0.1.1)
+
+## [v0.1.0](https://github.com/puppetlabs/puppetlabs-onceover-octocatalog-diff/tree/v0.1.0) - 2017-03-13
+
+[Full Changelog](https://github.com/puppetlabs/puppetlabs-onceover-octocatalog-diff/compare/1e6e0aea6f2fd28209c9c647fba768e139373a3b...v0.1.0)

data/CODEOWNERS

@@ -0,0 +1 @@
+* @puppetlabs/devx

data/Gemfile

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+# For puppetcore, set GEM_SOURCE_PUPPETCORE = 'https://rubygems-puppetcore.puppet.com'
+gemsource_default = ENV['GEM_SOURCE'] || 'https://rubygems.org'
+gemsource_puppetcore = if ENV['GEM_SOURCE']
+                         gemsource_default
+                       elsif ENV['PUPPET_FORGE_TOKEN'] && !ENV['PUPPET_FORGE_TOKEN'].empty?
+                         'https://rubygems-puppetcore.puppet.com'
+                       else
+                         ENV['GEM_SOURCE_PUPPETCORE'] || gemsource_default
+                       end
+source gemsource_default
+
+# Specify your gem's dependencies in puppetlabs-onceover-octocatalog-diff.gemspec
+gemspec
+
+# Route through gemsource_puppetcore so CI can resolve puppet ~> 9.0 from the
+# private Puppetcore registry (public rubygems.org tops out at puppet 8.10.0).
+# When PUPPET_FORGE_TOKEN is unset (e.g. fork PRs, local dev without a token),
+# gemsource_puppetcore falls through to gemsource_default (public rubygems.org)
+# and no auth is attempted against Puppetcore.
+gem 'puppet', ENV['PUPPET_GEM_VERSION'] || '~> 8', source: gemsource_puppetcore
+
+# facter is a runtime dependency of puppet, but pinning `puppet`'s own source
+# does NOT pin its transitive dependencies to that same source -- bundler
+# still resolves facter from whichever source(s) declare it, so without this
+# explicit pin facter would silently keep resolving from public rubygems.org
+# (built from the public facter repo) even when puppet itself correctly comes
+# from Puppetcore (built from the private facter-private source). Pin it
+# explicitly so both come from the same place.
+gem 'facter', source: gemsource_puppetcore
+
+# Puppet on Ruby 3.3 / 3.4 has some missing dependencies
+gem 'syslog', '~> 0.3' if RUBY_VERSION >= '3.4'
+
+# Windows platform runtime deps. The published puppet/openvox rubygems.org
+# artefacts are built on Linux and guard `ffi` / `win32ole` with build-host
+# platform checks, so those deps never make it into the Linux-published
+# artefact. Ruby 3.4+ removed win32ole from default gems, making the missing
+# declaration fatal at require-time on Windows. Declaring them here in the
+# Gemfile is evaluated on the install host at bundle time, so bundler pulls
+# them on Windows only.
+platforms :mingw, :x64_mingw, :mswin do
+  gem 'ffi', '>= 1.15.5', '< 1.17.0', '!= 1.16.0', '!= 1.16.1', '!= 1.16.2'
+  gem 'win32ole', '>= 1.8', '< 2.0'
+end
+
+group :development do
+  gem 'rake', '~> 13.3'
+  gem 'rubocop'
+  gem 'simplecov'
+end

data/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2017 Dylan Ratcliffe
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,36 @@
+# Octocatalog-diff Onceover plugin
+
+This plugin adds the `run diff` command to [puppetlabs-onceover](https://github.com/puppetlabs/puppetlabs-onceover). Instead of testing that all if your catalogs compile, it compiles two versions of each catalog and returns you the differences. This is great for ensuring that changed that you were intending to make have had the desired effect and scope.
+
+Kudos to Kevin and the team at GitHub for actually building [octocatalog-diff](https://github.com/github/octocatalog-diff)!
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'puppetlabs-onceover-octocatalog-diff'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install puppetlabs-onceover-octocatalog-diff
+
+## Usage
+
+`puppetlabs-onceover run diff --from development --to production`
+
+All config follows the normal [onceover](https://github.com/puppetlabs/puppetlabs-onceover) configuration.
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/puppetlabs/puppetlabs-onceover-octocatalog-diff.
+
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).

data/Rakefile

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+require 'rubocop/rake_task'
+
+RSpec::Core::RakeTask.new(:spec)
+RuboCop::RakeTask.new(:rubocop)
+
+task :default => :spec
+task :test => %i[rubocop spec]
+
+begin
+  require 'rubygems'
+  require 'github_changelog_generator/task'
+rescue LoadError
+  # Do nothing if no required gem installed
+else
+  GitHubChangelogGenerator::RakeTask.new :changelog do |config|
+    config.exclude_labels = %w[duplicate question invalid wontfix wont-fix skip-changelog github_actions]
+    config.user = 'puppetlabs'
+    config.project = 'puppetlabs-onceover-octocatalog-diff'
+    gem_version = Gem::Specification.load("#{config.project}.gemspec").version
+    config.future_release = "v#{gem_version}"
+  end
+end

data/bin/console

@@ -0,0 +1,15 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require 'bundler/setup'
+require 'puppetlabs-onceover/octocatalog-diff'
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require 'irb'
+IRB.start

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/lib/puppetlabs-onceover/octocatalog-diff/cli.rb

@@ -0,0 +1,163 @@
+# frozen_string_literal: true
+
+class PuppetlabsOnceover
+  class CLI
+    class Run
+      class Diff
+        def self.command
+          @cmd ||= Cri::Command.define do
+            name 'diff'
+            usage 'diff'
+            summary "Diff two versions of the controlrepo's compiled catalogs"
+            description <<-DESCRIPTION
+This uses octocatalog-diff to run diffs on all things in the test matrix
+instead of actually testing them. Requires two branches, tags or
+revisions to compare between.
+            DESCRIPTION
+
+            option :f,  :from, 'branch to compare from', argument: :required
+            option :t,  :to,   'branch to compare to', argument: :required
+
+            run do |opts, args, cmd|
+              require 'facter'
+              require 'colored'
+
+              #TODO: Allow for custom arguments
+              repo        = PuppetlabsOnceover::Controlrepo.new(opts)
+              test_config = PuppetlabsOnceover::TestConfig.new(repo.onceover_yaml, opts)
+              num_threads = (Facter.value('processors')['count'] / 2)
+              tests = test_config.run_filters(PuppetlabsOnceover::Test.deduplicate(test_config.spec_tests))
+
+              @queue = tests.inject(Queue.new, :push)
+              @results = []
+
+              @threads = Array.new(num_threads) do
+                Thread.new do
+                  r10k_cache_dir = Dir.mktmpdir('r10k_cache')
+                  r10k_config = {
+                    'cachedir' => r10k_cache_dir,
+                  }
+                  logger.debug "Creating r10k cache for thread at #{r10k_cache_dir}"
+                  File.write("#{r10k_cache_dir}/r10k.yaml",r10k_config.to_yaml)
+
+                  until @queue.empty?
+                    test = @queue.shift
+
+                    logger.info "Preparing environment for #{test.classes[0].name} on #{test.nodes[0].name}"
+                    logger.debug "Creating temp directory"
+                    tempdir = Dir.mktmpdir(test.to_s)
+                    logger.debug "Temp directory created at #{tempdir}"
+
+                    logger.debug "Copying controlrepo to #{tempdir}"
+                    FileUtils.copy_entry(repo.root,tempdir)
+
+                    # Copy all of the factsets over in reverse order so that
+                    # local ones override vendored ones
+                    logger.debug "Deploying vendored factsets"
+                    deduped_factsets = repo.facts_files.reverse.to_h do |file|
+                      [File.basename(file), file]
+                    end
+
+                    deduped_factsets.each_value do |path|
+                      facts = JSON.load(File.read(path))
+                      File.open("#{tempdir}/spec/factsets/#{File.basename(path,'.*')}.yaml", 'w') { |f| f.write facts.to_yaml }
+                    end
+
+                    if File.directory?("#{r10k_cache_dir}/modules")
+                      logger.debug "Copying modules from thread cache to #{tempdir}"
+                      FileUtils.copy_entry("#{r10k_cache_dir}/modules","#{tempdir}/modules")
+                    end
+
+                    logger.info "Deploying Puppetfile for #{test.classes[0].name} on #{test.nodes[0].name}"
+                    r10k_cmd = "r10k puppetfile install --verbose --color --puppetfile #{repo.puppetfile} --config #{r10k_cache_dir}/r10k.yaml"
+                    Open3.popen3(r10k_cmd, :chdir => tempdir) do |stdin, stdout, stderr, wait_thr|
+                      exit_status = wait_thr.value
+                      if exit_status.exitstatus != 0
+                        STDOUT.puts stdout.read
+                        STDERR.puts stderr.read
+                        abort "R10k encountered an error, see the logs for details"
+                      end
+                    end
+
+                    # TODO: Improve the way this works so that it doesn't blat site.pp
+                    logger.debug "Creating before script that overwrites site.pp"
+                    class_name = test.classes[0].name
+                    template_dir = File.expand_path('../../../templates',File.dirname(__FILE__))
+                    template = File.read(File.expand_path("./change_manifest.rb.erb",template_dir))
+                    File.write("#{tempdir}/bootstrap_script.rb",ERB.new(template, trim_mode: '-').result(binding))
+                    FileUtils.chmod("u=rwx","#{tempdir}/bootstrap_script.rb")
+
+                    logger.debug "Getting Puppet binary"
+                    binary = `which puppet`.chomp
+
+                    logger.debug "Running Octocatalog diff"
+                    logger.info "Compiling catalogs for #{test.classes[0].name} on #{test.nodes[0].name}"
+
+                    command_prefix = ENV['BUNDLE_GEMFILE'] ? 'bundle exec ' : ''
+                    bootstrap_env = "--bootstrap-environment GEM_HOME=#{ENV['GEM_HOME']}" if ENV['GEM_HOME']
+
+                    command_args = [
+                      '--fact-file',
+                      "#{tempdir}/spec/factsets/#{test.nodes[0].name}.yaml",
+                      '--from',
+                      opts[:from],
+                      '--to',
+                      opts[:to],
+                      '--basedir',
+                      tempdir,
+                      '--puppet-binary',
+                      binary,
+                      '--bootstrap-script',
+                      "'#{tempdir}/bootstrap_script.rb'",
+                      '--hiera-config',
+                      repo.hiera_config_file,
+                      '--pass-env-vars',
+                      ENV.keys.keep_if {|k| k =~ /^RUBY|^BUNDLE/ }.join(','),
+                      bootstrap_env
+                    ]
+
+                    cmd = "#{command_prefix}octocatalog-diff #{command_args.join(' ')}"
+                    logger.debug "Running: #{cmd}"
+                    Open3.popen3(cmd) do |stdin, stdout, stderr, wait_thr|
+                      exit_status = wait_thr.value
+                      @results << {
+                        stdout: stdout.read,
+                        stderr: stderr.read,
+                        exit_status: exit_status.exitstatus,
+                        test: test
+                      }
+                    end
+                    logger.info "Storing results for #{test.classes[0].name} on #{test.nodes[0].name}"
+
+                    logger.debug "Backing up modules to thread cache #{tempdir}"
+                    FileUtils.mv("#{tempdir}/modules","#{r10k_cache_dir}/modules",:force => true)
+
+                    logger.debug "Removing temporary build cache"
+                    FileUtils.rm_r(tempdir)
+                  end
+
+                  FileUtils.rm_r(r10k_cache_dir)
+                end
+              end
+
+              @threads.each(&:join)
+              @results.each do |result|
+                puts "#{"Test:".bold} #{result[:test].classes[0].name} on #{result[:test].nodes[0].name}"
+                puts "#{"Exit:".bold} #{result[:exit_status]}"
+                puts "#{"Status:".bold} #{"changes".yellow}" if result[:exit_status] == 2
+                puts "#{"Status:".bold} #{"no differences".green}" if result[:exit_status] == 0
+                puts "#{"Status:".bold} #{"failed".red}" if result[:exit_status] == 1
+                puts "#{"Results:".bold}\n#{result[:stdout]}\n" if result[:exit_status] == 2
+                puts "#{"Errors:".bold}\n#{result[:stderr]}\n" if result[:exit_status] == 1
+                puts ""
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end
+
+# Register itself
+PuppetlabsOnceover::CLI::Run.command.add_command(PuppetlabsOnceover::CLI::Run::Diff.command)

data/lib/puppetlabs-onceover/octocatalog-diff/version.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+class PuppetlabsOnceover
+  module Octocatalog
+    module Diff
+      VERSION = '0.1.10'
+    end
+  end
+end

data/lib/puppetlabs-onceover/octocatalog-diff.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+require "puppetlabs-onceover/octocatalog-diff/version"
+require "puppetlabs-onceover/octocatalog-diff/cli"
+
+class PuppetlabsOnceover
+  module Octocatalog
+    module Diff
+    end
+  end
+end

data/puppetlabs-onceover-octocatalog-diff.gemspec

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+lib = File.expand_path('lib', __dir__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'puppetlabs-onceover/octocatalog-diff/version'
+
+Gem::Specification.new do |spec| # rubocop:disable Gemspec/RequireMFA
+  spec.name          = 'puppetlabs-onceover-octocatalog-diff'
+  spec.version       = PuppetlabsOnceover::Octocatalog::Diff::VERSION
+  spec.authors       = ['Puppet, Inc.']
+  spec.email         = ['modules-team@puppet.com']
+
+  spec.summary       = 'Adds octocatalog-diff functionality to onceover'
+  spec.description   = "Allows Onceover users to use their existing factsets to check what affect given changes will have on a role's compiled catalog"
+  spec.homepage      = 'https://github.com/puppetlabs/puppetlabs-onceover-octocatalog-diff'
+  spec.license       = 'MIT'
+  spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+
+  spec.bindir        = 'exe'
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ['lib']
+
+  spec.required_ruby_version = Gem::Requirement.new('>= 3.2')
+
+  spec.add_dependency 'octocatalog-diff', '~> 2.3'
+  spec.add_dependency 'puppetlabs-onceover', '~> 5.0'
+end

data/templates/change_manifest.rb.erb

@@ -0,0 +1,22 @@
+#!/usr/bin/env ruby
+
+require 'puppetlabs-onceover/controlrepo'
+
+repo = PuppetlabsOnceover::Controlrepo.new()
+tempdir = Dir.pwd
+
+FileUtils.copy_entry("<%= tempdir %>/modules","#{tempdir}/modules")
+system("r10k puppetfile install --verbose --color --puppetfile '<%= repo.puppetfile %>'")
+
+
+if repo.config['manifest']
+  manifest_dir = "#{tempdir}/#{repo.config['manifest']}"
+else
+  manifest_dir = "#{tempdir}/manifests"
+end
+
+FileUtils.rm_r(Dir["#{manifest_dir}/*"])
+
+somefile = File.open("#{manifest_dir}/site.pp", "w")
+somefile.puts "include <%= class_name %>"
+somefile.close

metadata

@@ -0,0 +1,99 @@
+--- !ruby/object:Gem::Specification
+name: puppetlabs-onceover-octocatalog-diff
+version: !ruby/object:Gem::Version
+  version: 0.1.10
+platform: ruby
+authors:
+- Puppet, Inc.
+autorequire:
+bindir: exe
+cert_chain: []
+date: 2026-09-15 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: octocatalog-diff
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.3'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.3'
+- !ruby/object:Gem::Dependency
+  name: puppetlabs-onceover
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+description: Allows Onceover users to use their existing factsets to check what affect
+  given changes will have on a role's compiled catalog
+email:
+- modules-team@puppet.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".devcontainer/devcontainer.json"
+- ".gitattributes"
+- ".github/dependabot.yml"
+- ".github/labeler.yml"
+- ".github/release.yml"
+- ".github/workflows/ci.yaml"
+- ".github/workflows/labeler.yaml"
+- ".github/workflows/mend.yml"
+- ".github/workflows/nightly.yml"
+- ".github/workflows/release.yaml"
+- ".github/workflows/release_prep.yml"
+- ".gitignore"
+- ".rubocop.yml"
+- ".rubocop_todo.yml"
+- CHANGELOG.md
+- CODEOWNERS
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- lib/puppetlabs-onceover/octocatalog-diff.rb
+- lib/puppetlabs-onceover/octocatalog-diff/cli.rb
+- lib/puppetlabs-onceover/octocatalog-diff/version.rb
+- puppetlabs-onceover-octocatalog-diff.gemspec
+- templates/change_manifest.rb.erb
+homepage: https://github.com/puppetlabs/puppetlabs-onceover-octocatalog-diff
+licenses:
+- MIT
+metadata: {}
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.2'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.4.19
+signing_key:
+specification_version: 4
+summary: Adds octocatalog-diff functionality to onceover
+test_files: []