jumbotron 0.1.1 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0461cd6ea53300eaf51f0283060767da1ee18a74356d20906bb35f34a369061e
-  data.tar.gz: 89cf5eec83c074a338b5765225933ae5a3be7480853966239d437ac383f09d0b
+  metadata.gz: 919c3aee919ada06d4cee0f0870663c42441797ba0727babc0a00ead86c8630c
+  data.tar.gz: e929ed6604624bab66044aaf40c0cb8a6420aa6e838a044c881480d3b8290af5
 SHA512:
-  metadata.gz: de18ce2882fa4b4a450a6541cb7305456b2e820de3cc71d95dede9fbaec654bef2234c1896aaf16e79cd7fcbc7b11163e2d67634dcf83c8d0a8e9921f2ccbdf9
-  data.tar.gz: b54ecfe4c49d62510fc1ec0ea238858487585171b57d5313f3e297415f834511c74c89a50f05049199addd6c9374fbb8633614d4d95cacc4de7b380248cc5454
+  metadata.gz: 77c1b4deb6fde54b227b0cc3f41212b363dd8745dcc110ef8dffe6fdd9c1ca82f804d1d18545d59742c5a33df233ff6ba07d3ed8af4cf3d8d0f215e1678c17d9
+  data.tar.gz: 17d5b91913fd0ff210c299732ce465f77e40de6a3511b0679f3ef3e81a03fed9e3c1f1bf1fd86bd282ac93e82912dbf96e723775719f0ce5de93d1b5d4fb1887

data/README.md

@@ -2,4 +2,13 @@
 
 Jumbotron is a backend sports-truth Rails Engine.
 
-More information is coming later.
+## Testing
+
+Shared factories for hosts:
+
+```ruby
+require "jumbotron/testing"
+Jumbotron::Testing.install!
+```
+
+Details: [Testing with Jumbotron](docs/testing.md).

data/docs/testing.md

@@ -0,0 +1,62 @@
+# Testing with Jumbotron
+
+Jumbotron ships FactoryBot definitions for engine-owned models. Hosts load
+them explicitly in the test suite — there is no production Railtie and
+FactoryBot is not a runtime gem dependency.
+
+Back to [README](../README.md).
+
+## Setup
+
+```ruby
+# spec/rails_helper.rb (after Rails is loaded)
+require "jumbotron/testing"
+
+Jumbotron::Testing.install! # preferred
+# Jumbotron::Testing.load_factories! # factories-only / advanced
+```
+
+Call `install!` **before** any host `FactoryBot.modify` blocks so shared
+factories exist when you extend them.
+
+## Extending factories
+
+Hosts must not redefine Jumbotron base factories. Use `FactoryBot.modify`:
+
+```ruby
+FactoryBot.modify do
+  factory :jumbotron_game do
+    trait :completed do
+      lifecycle { "completed" }
+    end
+  end
+end
+```
+
+## Packaging and evolution
+
+Factory files live under `spec/factories/**` inside the gem and are included in
+the gemspec. Adding or changing a shared factory is a normal Jumbotron gem
+bump — hosts pick it up on upgrade.
+
+`Jumbotron::Testing.load_factories!` is idempotent (safe to call more than
+once). It loads each factory file under `Jumbotron::Engine.root/spec/factories`
+explicitly; it does not append to global `FactoryBot.definition_file_paths`.
+
+## Responsibilities
+
+| Owner | Responsibility |
+|-------|----------------|
+| Jumbotron | Base factories for Jumbotron-owned models; Testing API; packaging |
+| Host | `install!` in the test boot path; product traits via `FactoryBot.modify` |
+
+## Factory invariant
+
+Base factories construct **persistent model state only**. They must not invoke
+Services, Workflows, ApplicationWorkflows, or external adapters.
+
+## Contributors vs hosts
+
+This guide is the **host Testing API**. Contributors working inside the Jumbotron
+repository also follow workspace test standards and architecture guards under
+`spec/architecture/`.

data/docs/upgrades/0.1.2.md

@@ -0,0 +1,29 @@
+# Upgrade: Jumbotron 0.1.2
+
+**From:** `0.1.1`  
+**To:** `0.1.2`
+
+Additive host Testing API. No runtime or public consumer contract break.
+
+## Host-facing change
+
+| Change | Host impact |
+|--------|-------------|
+| `Jumbotron::Testing.install!` | Preferred host entry to load shared FactoryBot definitions |
+| Factories packaged in the gem | `spec/factories/**` is included in the gemspec (was missing in 0.1.1) |
+
+## Setup
+
+```ruby
+# spec/rails_helper.rb (after Rails is loaded)
+require "jumbotron/testing"
+Jumbotron::Testing.install!
+```
+
+Details: [Testing with Jumbotron](../testing.md).
+
+## Upgrade checklist
+
+1. Bump gem to `0.1.2` (or `>= 0.1.2`).
+2. Replace any host glob of `Jumbotron::Engine.root.join("spec/factories/**/*.rb")` with `Jumbotron::Testing.install!`.
+3. Ensure `factory_bot` or `factory_bot_rails` remains in the host test group.

data/lib/jumbotron/testing.rb

@@ -0,0 +1,54 @@
+# frozen_string_literal: true
+
+module Jumbotron
+  # Explicit host/test entry for shared FactoryBot definitions and related
+  # testing bootstrap. Not loaded in production via Railtie.
+  module Testing
+    class << self
+      # Preferred host entry. Currently loads factories; reserved for future
+      # shared testing setup (helpers, config checks).
+      def install!
+        load_factories!
+      end
+
+      # Load Jumbotron FactoryBot definitions exactly once.
+      # Loads files under Engine.root/spec/factories explicitly (does not mutate
+      # global definition_file_paths / find_definitions).
+      def load_factories!
+        return if factories_loaded?
+
+        require_factory_bot!
+        factory_files.each { |path| Kernel.load(path) }
+        @factories_loaded = true
+        true
+      end
+
+      def factories_loaded?
+        @factories_loaded == true
+      end
+
+      # Reset loader state (specs only). Does not undefine FactoryBot factories.
+      def reset_factories_loaded_flag!
+        @factories_loaded = false
+      end
+
+      def factories_path
+        Jumbotron::Engine.root.join("spec/factories")
+      end
+
+      private
+
+      def require_factory_bot!
+        require "factory_bot"
+      rescue LoadError
+        raise LoadError,
+              "Jumbotron::Testing requires the factory_bot gem. " \
+              "Add `factory_bot` or `factory_bot_rails` to your host test group."
+      end
+
+      def factory_files
+        Dir[factories_path.join("**/*.rb").to_s]
+      end
+    end
+  end
+end

data/lib/jumbotron/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Jumbotron
-  VERSION = "0.1.1"
+  VERSION = "0.1.2"
 end

data/spec/factories/jumbotron/bookmaker.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+FactoryBot.define do
+  factory :jumbotron_bookmaker, class: "Jumbotron::Bookmaker" do
+    sequence(:name) { |n| "Bookmaker #{n}" }
+    observed_at { Time.current }
+    changed_at { Time.current }
+  end
+end

data/spec/factories/jumbotron/game.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+FactoryBot.define do
+  factory :jumbotron_game, class: "Jumbotron::Game" do
+    league { association :jumbotron_league }
+    season { association :jumbotron_season, league: league }
+    observed_at { Time.current }
+    changed_at { Time.current }
+  end
+end

data/spec/factories/jumbotron/game_participant.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+FactoryBot.define do
+  factory :jumbotron_game_participant, class: "Jumbotron::GameParticipant" do
+    association :game, factory: :jumbotron_game
+    association :team, factory: :jumbotron_team
+    observed_at { Time.current }
+    changed_at { Time.current }
+  end
+end

data/spec/factories/jumbotron/league.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+FactoryBot.define do
+  factory :jumbotron_league, class: "Jumbotron::League" do
+    association :sport, factory: :jumbotron_sport
+    sequence(:name) { |n| "League #{n}" }
+  end
+end

data/spec/factories/jumbotron/line_observation.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+FactoryBot.define do
+  factory :jumbotron_line_observation, class: "Jumbotron::LineObservation" do
+    association :game, factory: :jumbotron_game
+    association :bookmaker, factory: :jumbotron_bookmaker
+    association :observation_batch, factory: :jumbotron_observation_batch
+    market { "spread" }
+    outcome { "home" }
+    source { "observed" }
+    line_value { BigDecimal("-3.5") }
+    price_american { -110 }
+    observed_at { Time.current }
+    changed_at { Time.current }
+  end
+end

data/spec/factories/jumbotron/observation_batch.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+FactoryBot.define do
+  factory :jumbotron_observation_batch, class: "Jumbotron::ObservationBatch" do
+    provider { "espn" }
+    adapter_scope { "espn_nfl" }
+    observed_at { Time.current }
+    metadata { {} }
+  end
+end

data/spec/factories/jumbotron/provider_identity.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+FactoryBot.define do
+  factory :jumbotron_provider_identity, class: "Jumbotron::ProviderIdentity" do
+    association :target, factory: :jumbotron_sport
+    provider { "espn" }
+    object_namespace { "sport" }
+    sequence(:provider_id) { |n| "ext-#{n}" }
+  end
+end

data/spec/factories/jumbotron/schedule_group.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+FactoryBot.define do
+  factory :jumbotron_schedule_group, class: "Jumbotron::ScheduleGroup" do
+    association :season, factory: :jumbotron_season
+    season_phase { association :jumbotron_season_phase, season: season }
+    kind { "week" }
+    sequence(:number) { |n| n }
+    name { "Week #{number}" }
+  end
+end

data/spec/factories/jumbotron/season.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+FactoryBot.define do
+  factory :jumbotron_season, class: "Jumbotron::Season" do
+    association :league, factory: :jumbotron_league
+    sequence(:name) { |n| "Season #{n}" }
+  end
+end

data/spec/factories/jumbotron/season_phase.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+FactoryBot.define do
+  factory :jumbotron_season_phase, class: "Jumbotron::SeasonPhase" do
+    association :season, factory: :jumbotron_season
+    sequence(:name) { |n| "Phase #{n}" }
+  end
+end

data/spec/factories/jumbotron/sport.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+FactoryBot.define do
+  factory :jumbotron_sport, class: "Jumbotron::Sport" do
+    sequence(:name) { |n| "Sport #{n}" }
+  end
+end

data/spec/factories/jumbotron/team.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+FactoryBot.define do
+  factory :jumbotron_team, class: "Jumbotron::Team" do
+    sequence(:name) { |n| "Team #{n}" }
+    observed_at { Time.current }
+    changed_at { Time.current }
+  end
+end

data/spec/factories/jumbotron/venue.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+FactoryBot.define do
+  factory :jumbotron_venue, class: "Jumbotron::Venue" do
+    sequence(:name) { |n| "Venue #{n}" }
+    observed_at { Time.current }
+    changed_at { Time.current }
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: jumbotron
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.1.2
 platform: ruby
 authors:
 - matt-taylor
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2026-08-21 00:00:00.000000000 Z
+date: 2026-08-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: command_tower
@@ -205,11 +205,27 @@ files:
 - db/migrate/20260813000001_create_jumbotron_schedule_groups.rb
 - db/migrate/20260814000001_create_jumbotron_line_observations.rb
 - db/migrate/20260820000001_add_progress_to_jumbotron_games.rb
+- docs/testing.md
+- docs/upgrades/0.1.2.md
 - lib/jumbotron.rb
 - lib/jumbotron/client.rb
 - lib/jumbotron/engine.rb
+- lib/jumbotron/testing.rb
 - lib/jumbotron/version.rb
 - lib/tasks/jumbotron_schedules.rake
+- spec/factories/jumbotron/bookmaker.rb
+- spec/factories/jumbotron/game.rb
+- spec/factories/jumbotron/game_participant.rb
+- spec/factories/jumbotron/league.rb
+- spec/factories/jumbotron/line_observation.rb
+- spec/factories/jumbotron/observation_batch.rb
+- spec/factories/jumbotron/provider_identity.rb
+- spec/factories/jumbotron/schedule_group.rb
+- spec/factories/jumbotron/season.rb
+- spec/factories/jumbotron/season_phase.rb
+- spec/factories/jumbotron/sport.rb
+- spec/factories/jumbotron/team.rb
+- spec/factories/jumbotron/venue.rb
 homepage: https://github.com/matt-taylor/jumbotron
 licenses:
 - MIT