Replace Enzyme snapshot tests with React Testing Library (RTL) behavioral tests in Foreman plugin projects. Use when converting snapshot tests for React 18 migration.

2026-04-283

investigate-bug

ianballou/cosmic-unconscious

Systematic approach to investigating software bugs

2026-04-203

ruby-rails

ianballou/cosmic-unconscious

Ruby on Rails conventions and patterns for Foreman ecosystem projects

2026-04-173

code-explorer

ianballou/cosmic-unconscious

How to navigate and explain unfamiliar codebases effectively

2026-04-173

design-feature

ianballou/cosmic-unconscious

Feature design methodology — requirements gathering, design, story breakdown

2026-04-173

name	katello-testing
description	Katello test patterns, factories, and conventions

Katello Testing

Running Tests

All rake/rails commands run from the sibling foreman/ directory.

All: cd ../foreman && bundle exec rake test:katello:test TESTOPTS="-v"
Single file: cd ../foreman && bundle exec ruby -Itest ../katello/test/path.rb
Single method: add -n test_method_name
React: npx jest webpack/path/to/test

Test Organization

Model tests: test/models/katello/
Controller tests: test/controllers/katello/api/v2/
Action tests: test/actions/katello/
Factories: test/factories/
Fixtures: test/fixtures/

Patterns

Uses Minitest, not RSpec (for most tests)
Factories use FactoryBot: FactoryBot.create(:katello_repository)
Controller tests inherit from ActionController::TestCase
Action tests stub Pulp interactions

Gotchas

(Add entries as discovered)