anima-core 0.2.1 → 1.0.0

data/skills/rspec/examples/rails/transactions.rb

@@ -0,0 +1,254 @@
+# RSpec Rails: Transactions and Database Examples
+# Source: rspec-rails gem features/Transactions.md
+
+# Database transactions in RSpec Rails.
+# Each example runs in a transaction that's rolled back after.
+# Location: spec/rails_helper.rb configuration
+
+# Default transactional behavior
+RSpec.describe Widget, type: :model do
+  describe "transaction isolation" do
+    it "has no widgets initially" do
+      expect(Widget.count).to eq(0)
+    end
+
+    it "has one widget after creating" do
+      Widget.create!(name: "Test")
+      expect(Widget.count).to eq(1)
+    end
+
+    it "has no widgets again (previous was rolled back)" do
+      expect(Widget.count).to eq(0)
+    end
+  end
+end
+
+# Using let! for setup within transaction
+RSpec.describe "let! with transactions" do
+  let!(:widget) { create(:widget) }
+
+  it "widget exists in first example" do
+    expect(Widget.count).to eq(1)
+    expect(Widget.first).to eq(widget)
+  end
+
+  it "widget exists in second example (recreated)" do
+    # let! runs before each example
+    expect(Widget.count).to eq(1)
+  end
+end
+
+# before(:example) vs before(:context)
+RSpec.describe "before hooks and transactions" do
+  describe "before(:example)" do
+    before(:example) { create(:widget, name: "Example Widget") }
+
+    it "creates widget for each example" do
+      expect(Widget.count).to eq(1)
+    end
+
+    it "has fresh widget in next example" do
+      expect(Widget.count).to eq(1)
+      expect(Widget.first.name).to eq("Example Widget")
+    end
+  end
+
+  describe "before(:context)" do
+    # WARNING: Data created in before(:context) persists across examples
+    # and is NOT rolled back. Must clean up manually.
+
+    before(:context) do
+      @context_widget = Widget.create!(name: "Context Widget")
+    end
+
+    after(:context) do
+      @context_widget.destroy
+    end
+
+    before(:example) do
+      # Must reload to avoid stale data within transaction
+      @context_widget.reload
+    end
+
+    it "uses shared context widget" do
+      expect(@context_widget.name).to eq("Context Widget")
+    end
+
+    it "also sees the context widget" do
+      expect(Widget.find(@context_widget.id)).to be_present
+    end
+  end
+end
+
+# Testing transactions explicitly
+RSpec.describe "Explicit transaction testing" do
+  describe "rollback behavior" do
+    it "rolls back on error" do
+      expect {
+        Widget.transaction do
+          Widget.create!(name: "Will be rolled back")
+          raise ActiveRecord::Rollback
+        end
+      }.not_to change(Widget, :count)
+    end
+
+    it "commits without error" do
+      expect {
+        Widget.transaction do
+          Widget.create!(name: "Will be committed")
+        end
+      }.to change(Widget, :count).by(1)
+    end
+  end
+end
+
+# Configuration example (for rails_helper.rb)
+RSpec.describe "Transaction configuration" do
+  # Enable transactional fixtures (default)
+  # RSpec.configure do |config|
+  #   config.use_transactional_fixtures = true
+  # end
+
+  it "demonstrates transactional isolation" do
+    widget = create(:widget)
+    expect(Widget.count).to eq(1)
+
+    # After this test, widget won't exist
+  end
+end
+
+# Database Cleaner for non-transactional scenarios
+# (e.g., JavaScript tests with Selenium)
+RSpec.describe "Database Cleaner setup", skip: "documentation only" do
+  # Configuration example:
+  #
+  # RSpec.configure do |config|
+  #   config.before(:suite) do
+  #     DatabaseCleaner.strategy = :transaction
+  #     DatabaseCleaner.clean_with(:truncation)
+  #   end
+  #
+  #   config.around(:each) do |example|
+  #     DatabaseCleaner.cleaning do
+  #       example.run
+  #     end
+  #   end
+  #
+  #   # Use truncation for JS tests
+  #   config.before(:each, js: true) do
+  #     DatabaseCleaner.strategy = :truncation
+  #   end
+  #
+  #   config.after(:each, js: true) do
+  #     DatabaseCleaner.strategy = :transaction
+  #   end
+  # end
+end
+
+# Testing database constraints
+RSpec.describe "Database constraints" do
+  describe "unique constraint" do
+    let!(:widget) { create(:widget, name: "Unique") }
+
+    it "raises error on duplicate" do
+      expect {
+        create(:widget, name: "Unique")
+      }.to raise_error(ActiveRecord::RecordNotUnique)
+    end
+  end
+
+  describe "foreign key constraint" do
+    let(:widget) { create(:widget) }
+    let!(:component) { create(:component, widget:) }
+
+    it "prevents deletion of referenced record" do
+      expect {
+        widget.destroy!
+      }.to raise_error(ActiveRecord::InvalidForeignKey)
+    end
+  end
+end
+
+# Testing with specific database features
+RSpec.describe "Database-specific testing" do
+  describe "locking" do
+    let!(:widget) { create(:widget, count: 0) }
+
+    it "uses pessimistic locking" do
+      Widget.transaction do
+        locked = Widget.lock.find(widget.id)
+        locked.update!(count: locked.count + 1)
+      end
+
+      expect(widget.reload.count).to eq(1)
+    end
+  end
+
+  describe "advisory locks" do
+    it "obtains and releases lock", skip: "database-specific" do
+      Widget.with_advisory_lock("test_lock") do
+        # Critical section
+        expect(Widget.advisory_lock_exists?("test_lock")).to be true
+      end
+    end
+  end
+end
+
+# Testing seeds
+RSpec.describe "Database seeds", type: :model do
+  # Usually seeds are loaded once in test setup
+  # Here's how to test seed data
+
+  describe "seed data" do
+    before(:context) do
+      # Load seeds if needed
+      # Rails.application.load_seed
+    end
+
+    it "creates default categories" do
+      expect(Category.count).to be > 0
+    end
+
+    it "creates admin user" do
+      expect(User.find_by(role: "admin")).to be_present
+    end
+  end
+end
+
+# Testing database migrations
+RSpec.describe "Migration testing", skip: "run separately" do
+  describe "up migration" do
+    it "adds new column" do
+      # Assuming a pending migration adds 'status' column
+      ActiveRecord::Migrator.up(
+        ActiveRecord::Migrator.migrations_paths,
+        20240101000000
+      )
+
+      expect(Widget.column_names).to include("status")
+    end
+  end
+
+  describe "down migration" do
+    it "removes column" do
+      ActiveRecord::Migrator.down(
+        ActiveRecord::Migrator.migrations_paths,
+        20240101000000
+      )
+
+      expect(Widget.column_names).not_to include("status")
+    end
+  end
+end
+
+# Parallel testing considerations
+RSpec.describe "Parallel test isolation" do
+  # Each parallel worker has its own database
+  # Transactions work within each worker
+
+  it "works in parallel environment" do
+    # Create data - won't conflict with other workers
+    widget = create(:widget)
+    expect(widget).to be_persisted
+  end
+end

data/skills/rspec/examples/rails/view_specs.rb

@@ -0,0 +1,252 @@
+# RSpec Rails: View Specs Examples
+# Source: rspec-rails gem features/view_specs/
+
+# View specs test templates in isolation.
+# Three-step pattern: assign, render, assert.
+# Location: spec/views/
+
+# Basic view spec
+RSpec.describe "widgets/index", type: :view do
+  let(:widgets) { create_list(:widget, 2, :with_names) }
+
+  before { assign(:widgets, widgets) }
+
+  it "displays all widgets" do
+    render
+
+    widgets.each do |widget|
+      expect(rendered).to include(widget.name)
+    end
+  end
+end
+
+# Testing specific elements
+RSpec.describe "widgets/show", type: :view do
+  let(:widget) { create(:widget, name: "Slicer", price: 99) }
+
+  before { assign(:widget, widget) }
+
+  it "displays the widget name" do
+    render
+    expect(rendered).to match(/Slicer/)
+  end
+
+  it "displays the widget price" do
+    render
+    expect(rendered).to include("$99")
+  end
+end
+
+# Explicit template rendering
+RSpec.describe "rendering the widget template", type: :view do
+  let(:widget) { create(:widget, name: "Dicer") }
+
+  before { assign(:widget, widget) }
+
+  it "renders with explicit template path" do
+    render template: "widgets/widget"
+    expect(rendered).to include("Dicer")
+  end
+end
+
+# Rendering with layouts
+RSpec.describe "widgets/widget", type: :view do
+  let(:widget) { create(:widget, name: "Blender") }
+
+  before { assign(:widget, widget) }
+
+  context "with application layout" do
+    it "includes header from layout" do
+      render template: "widgets/widget", layout: "layouts/application"
+
+      expect(rendered).to include("Application Header")
+      expect(rendered).to include("Blender")
+    end
+  end
+
+  context "with admin layout" do
+    it "includes admin navigation" do
+      render template: "widgets/widget", layout: "layouts/admin"
+
+      expect(rendered).to include("Admin Navigation")
+    end
+  end
+end
+
+# Testing partials
+RSpec.describe "widgets/_widget", type: :view do
+  let(:widget) { create(:widget, name: "Grinder") }
+
+  it "renders the widget partial with locals" do
+    render partial: "widgets/widget", locals: { widget: }
+
+    expect(rendered).to include("Grinder")
+  end
+end
+
+# Testing collection rendering
+RSpec.describe "widgets/_widget", type: :view do
+  let(:widgets) { build_list(:widget, 3) }
+
+  it "renders each widget in collection" do
+    render partial: "widgets/widget", collection: widgets
+
+    widgets.each do |widget|
+      expect(rendered).to include(widget.name)
+    end
+  end
+end
+
+# Stubbing view helpers
+RSpec.describe "secrets/index", type: :view do
+  context "when user is admin" do
+    before { allow(view).to receive(:admin?).and_return(true) }
+
+    it "displays admin section" do
+      render
+      expect(rendered).to include("Secret admin area")
+    end
+  end
+
+  context "when user is not admin" do
+    before { allow(view).to receive(:admin?).and_return(false) }
+
+    it "hides admin section" do
+      render
+      expect(rendered).not_to include("Secret admin area")
+    end
+  end
+end
+
+# Stubbing current_user
+RSpec.describe "dashboard/index", type: :view do
+  let(:user) { build(:user, name: "John") }
+
+  before { allow(view).to receive(:current_user).and_return(user) }
+
+  it "greets the current user" do
+    render
+    expect(rendered).to include("Welcome, John")
+  end
+end
+
+# Testing forms
+RSpec.describe "widgets/new", type: :view do
+  before { assign(:widget, Widget.new) }
+
+  it "renders the new widget form" do
+    render
+
+    expect(rendered).to have_selector("form[action='/widgets'][method='post']")
+    expect(rendered).to have_selector("input[name='widget[name]']")
+    expect(rendered).to have_selector("input[type='submit']")
+  end
+end
+
+# Testing edit forms with existing record
+RSpec.describe "widgets/edit", type: :view do
+  let(:widget) { create(:widget, name: "Existing Widget") }
+
+  before { assign(:widget, widget) }
+
+  it "populates form with widget values" do
+    render
+
+    expect(rendered).to have_selector("form[action='/widgets/#{widget.id}']")
+    expect(rendered).to have_selector("input[name='widget[name]'][value='Existing Widget']")
+  end
+end
+
+# Testing conditional content
+RSpec.describe "widgets/show", type: :view do
+  let(:widget) { create(:widget, :published) }
+
+  before { assign(:widget, widget) }
+
+  context "when widget is published" do
+    it "shows published badge" do
+      render
+      expect(rendered).to include("Published")
+    end
+  end
+
+  context "when widget is draft" do
+    let(:widget) { create(:widget, :draft) }
+
+    it "shows draft badge" do
+      render
+      expect(rendered).to include("Draft")
+    end
+  end
+end
+
+# Testing links
+RSpec.describe "widgets/index", type: :view do
+  let(:widgets) { create_list(:widget, 2) }
+
+  before { assign(:widgets, widgets) }
+
+  it "links to each widget" do
+    render
+
+    widgets.each do |widget|
+      expect(rendered).to have_link(widget.name, href: widget_path(widget))
+    end
+  end
+
+  it "links to new widget" do
+    render
+    expect(rendered).to have_link("New Widget", href: new_widget_path)
+  end
+end
+
+# Using Capybara matchers in view specs
+RSpec.describe "widgets/show", type: :view do
+  let(:widget) { create(:widget, name: "Test Widget", description: "A great widget") }
+
+  before { assign(:widget, widget) }
+
+  it "renders widget details" do
+    render
+
+    expect(rendered).to have_css("h1", text: "Test Widget")
+    expect(rendered).to have_css("p.description", text: "A great widget")
+  end
+end
+
+# Testing empty states
+RSpec.describe "widgets/index", type: :view do
+  context "with no widgets" do
+    before { assign(:widgets, []) }
+
+    it "shows empty state message" do
+      render
+      expect(rendered).to include("No widgets found")
+    end
+  end
+end
+
+# Testing content_for blocks
+RSpec.describe "widgets/show", type: :view do
+  let(:widget) { create(:widget, name: "Widget") }
+
+  before { assign(:widget, widget) }
+
+  it "sets page title via content_for" do
+    render
+
+    expect(view.content_for(:title)).to eq("Widget")
+  end
+end
+
+# Access view helpers defined in the application
+RSpec.describe "widgets/show", type: :view do
+  let(:widget) { create(:widget, price: 1000) }
+
+  before { assign(:widget, widget) }
+
+  it "formats currency using helper" do
+    render
+    expect(rendered).to include("$1,000.00")
+  end
+end