anima-core 0.3.0 → 1.0.0

data/skills/rspec/examples/core/memoized_helpers.rb

@@ -0,0 +1,139 @@
+# RSpec Core: Memoized Helpers Examples
+# Source: rspec-core gem features/helper_methods/let.feature
+
+# let - lazy evaluation and memoization
+RSpec.describe "let behavior" do
+  let(:user) { build(:user) }
+
+  it "memoizes within an example" do
+    expect(user).to be(user)  # Same object instance
+  end
+
+  it "creates fresh instance for each example" do
+    expect(user.object_id).not_to eq(0)  # New user each time
+  end
+end
+
+# let! - eager evaluation (before hook)
+RSpec.describe "let! behavior" do
+  let!(:user) { create(:user) }
+
+  it "creates user before example runs" do
+    # User already exists in database
+    expect(User.count).to eq(1)
+  end
+end
+
+# When to use let vs let!
+RSpec.describe User do
+  # Use let - value referenced in test body
+  let(:user) { build(:user) }
+
+  it "validates email format" do
+    user.email = "invalid"
+    expect(user).not_to be_valid
+  end
+end
+
+RSpec.describe User, ".active scope" do
+  # Use let! - records must exist for database query
+  let!(:active_user) { create(:user, status: :active) }
+  let!(:inactive_user) { create(:user, status: :inactive) }
+
+  it "returns only active users" do
+    expect(User.active).to contain_exactly(active_user)
+  end
+end
+
+# Overriding let in nested contexts
+RSpec.describe ShoppingCart do
+  subject(:cart) { build(:shopping_cart, items: [item], discount:) }
+
+  let(:discount) { 0 }
+  let(:item) { build(:item, price: 100) }
+
+  it "calculates full price" do
+    expect(cart.total).to eq(100)
+  end
+
+  context "with discount" do
+    let(:discount) { 20 }  # Override parent definition
+
+    it "applies discount" do
+      expect(cart.total).to eq(80)
+    end
+  end
+end
+
+# Using super() to extend parent let
+RSpec.describe "API request" do
+  let(:params) { { name: "Item", price: 10 } }
+
+  context "with discount" do
+    let(:params) { super().merge(discount: 2) }  # Extend parent
+
+    it "includes discount in params" do
+      expect(params).to eq(name: "Item", price: 10, discount: 2)
+    end
+  end
+end
+
+# Named subject - always use named subjects
+RSpec.describe Article do
+  subject(:article) { build(:article, title: "Hello") }
+
+  it "validates presence of body" do
+    expect(article).not_to be_valid
+    expect(article.errors[:body]).to include("can't be blank")
+  end
+end
+
+# Subject for method testing
+RSpec.describe Calculator do
+  subject(:calculator) { build(:calculator) }
+
+  describe "#add" do
+    subject(:result) { calculator.add(2, 3) }
+
+    it { is_expected.to eq(5) }
+  end
+end
+
+# Subject placement - always first in example group
+RSpec.describe UserSerializer do
+  subject(:serializer) { described_class.new(user) }  # First
+  let(:user) { create(:user, name: "Alice") }         # After subject
+
+  it "serializes name" do
+    expect(serializer.as_json[:name]).to eq("Alice")
+  end
+end
+
+# Anti-pattern: let! when let suffices
+RSpec.describe "Unnecessary let!" do
+  # BAD - creates data unnecessarily
+  # let!(:admin) { create(:user, :admin) }
+
+  # GOOD - use let, only creates when referenced
+  let(:admin) { create(:user, :admin) }
+
+  it "validates email format" do
+    user = build(:user, email: "invalid")
+    expect(user).not_to be_valid
+    # admin never used, never created
+  end
+end
+
+# Helper methods for complex setup
+RSpec.describe Order do
+  def create_order_with_items(count)
+    order = build(:order)
+    count.times { order.add_item(build(:item)) }
+    order
+  end
+
+  it "calculates total for multiple items" do
+    order = create_order_with_items(3)
+    expect(order.items.count).to eq(3)
+  end
+end

data/skills/rspec/examples/core/metadata_filtering.rb

@@ -0,0 +1,144 @@
+# RSpec Core: Metadata and Filtering Examples
+# Source: rspec-core gem features/filtering/*.feature
+
+# Adding metadata to examples
+RSpec.describe "API" do
+  it "handles fast requests", :fast do
+  end
+
+  it "handles slow requests", :slow, timeout: 30 do
+  end
+
+  it "requires authentication", authorized: true do
+  end
+end
+
+# Adding metadata to groups
+RSpec.describe PaymentGateway, :integration, :external do
+  it "processes payment" do
+  end
+end
+
+# Accessing metadata in examples
+RSpec.describe "Metadata access" do
+  it "can read its own metadata" do |example|
+    expect(example.metadata[:description]).to eq("can read its own metadata")
+    expect(example.metadata[:file_path]).to include("_spec.rb")
+  end
+end
+
+# Focus filtering - run only focused examples
+RSpec.configure do |config|
+  config.filter_run_when_matching :focus
+end
+
+RSpec.describe "Debugging" do
+  it "skipped example" do
+  end
+
+  fit "focused example - only this runs" do  # fit = it with :focus
+  end
+
+  it "another skipped example" do
+  end
+end
+
+# Exclusion filtering
+RSpec.configure do |config|
+  config.filter_run_excluding :slow
+  config.filter_run_excluding broken: true
+end
+
+RSpec.describe "Suite" do
+  it "runs normally" do
+  end
+
+  it "skipped - marked slow", :slow do
+  end
+
+  it "skipped - marked broken", broken: true do
+  end
+end
+
+# Skip and pending
+RSpec.describe "Skip examples" do
+  xit "skipped with xit" do
+  end
+
+  it "skipped with skip call" do
+    skip "Not implemented yet"
+  end
+
+  it "skipped via metadata", skip: "Waiting on API" do
+  end
+end
+
+RSpec.describe "Pending examples" do
+  it "pending - expected to fail" do
+    pending "Waiting for feature X"
+    expect(1 + 1).to eq(3)  # Fails, but marked pending
+  end
+
+  # If pending test passes, RSpec fails it (unexpected pass)
+end
+
+# Conditional hooks with metadata
+RSpec.configure do |config|
+  config.before(:example, :db) do
+    DatabaseCleaner.start
+  end
+
+  config.after(:example, :db) do
+    DatabaseCleaner.clean
+  end
+
+  config.around(:example, :vcr) do |example|
+    VCR.use_cassette(example.metadata[:description]) do
+      example.run
+    end
+  end
+end
+
+RSpec.describe UserService, :db do
+  it "creates user" do  # DatabaseCleaner runs automatically
+    expect { UserService.create(name: "Alice") }.to change(User, :count).by(1)
+  end
+end
+
+RSpec.describe ExternalAPI, :vcr do
+  it "fetches data" do  # VCR cassette used automatically
+    response = ExternalAPI.fetch
+    expect(response).to be_success
+  end
+end
+
+# Aggregate failures - continue after first failure
+RSpec.describe "Response validation" do
+  it "validates all response fields" do
+    response = Client.make_request
+
+    aggregate_failures "response validation" do
+      expect(response.status).to eq(200)
+      expect(response.headers).to include("Content-Type" => "application/json")
+      expect(response.body).to include("success")
+      # All expectations run, failures collected
+    end
+  end
+end
+
+# Aggregate failures via metadata
+RSpec.describe Client, :aggregate_failures do
+  it "validates response" do
+    response = Client.make_request
+    expect(response.status).to eq(200)
+    expect(response.body).to include("success")
+    # Both run even if first fails
+  end
+end
+
+# Global aggregate failures
+RSpec.configure do |config|
+  config.define_derived_metadata do |meta|
+    meta[:aggregate_failures] = true
+  end
+end

data/skills/rspec/examples/core/shared_examples.rb

@@ -0,0 +1,145 @@
+# RSpec Core: Shared Examples & Shared Context
+# Source: rspec-core gem features/example_groups/shared_examples.feature
+
+# shared_examples - reusable test assertions
+RSpec.shared_examples "a collection" do
+  let(:collection) { build(:collection, items: [7, 2, 4]) }
+
+  context "initialized with 3 items" do
+    it "reports correct size" do
+      expect(collection.size).to eq(3)
+    end
+  end
+
+  describe "#include?" do
+    context "with item in collection" do
+      it "returns true" do
+        expect(collection.include?(7)).to be(true)
+      end
+    end
+
+    context "with item not in collection" do
+      it "returns false" do
+        expect(collection.include?(9)).to be(false)
+      end
+    end
+  end
+end
+
+RSpec.describe CustomArray do
+  it_behaves_like "a collection"
+end
+
+RSpec.describe CustomSet do
+  it_behaves_like "a collection"
+end
+
+# Passing data via positional parameters
+RSpec.shared_examples "measurable" do |expected_size|
+  it "has size #{expected_size}" do
+    expect(subject.size).to eq(expected_size)
+  end
+end
+
+RSpec.describe Bucket do
+  subject(:bucket) { build(:bucket, :with_items, items_count: 3) }
+
+  it_behaves_like "measurable", 3
+end
+
+# Passing data via keyword arguments (recommended)
+RSpec.shared_examples "validatable" do |required: [], optional: []|
+  required.each do |attr|
+    it "validates presence of #{attr}" do
+      subject.send("#{attr}=", nil)
+      expect(subject).not_to be_valid
+    end
+  end
+end
+
+RSpec.describe User do
+  subject(:user) { build(:user) }
+
+  it_behaves_like "validatable", required: [:email, :name]
+end
+
+# Passing data via block (runtime context)
+RSpec.shared_examples "a container" do
+  it "is not empty" do
+    expect(collection).not_to be_empty
+  end
+end
+
+RSpec.describe "custom container" do
+  it_behaves_like "a container" do
+    let(:collection) { build_list(:item, 3) }  # Defined at runtime
+  end
+end
+
+# shared_context - reusable setup (no assertions)
+RSpec.shared_context "authenticated user" do
+  let(:current_user) { create(:user) }
+
+  before do
+    sign_in(current_user)
+  end
+end
+
+RSpec.describe DashboardController do
+  include_context "authenticated user"
+
+  it "shows dashboard" do
+    get :index
+    expect(response).to be_successful
+  end
+end
+
+# shared_context with metadata auto-inclusion
+RSpec.shared_context "with admin", :admin do
+  let(:current_user) { create(:user, :admin) }
+
+  before { sign_in(current_user) }
+end
+
+RSpec.configure do |config|
+  config.include_context "with admin", :admin
+end
+
+RSpec.describe AdminController, :admin do
+  it "allows admin access" do  # Context auto-included
+    get :index
+    expect(response).to be_successful
+  end
+end
+
+# it_behaves_like vs include_examples
+# PREFER it_behaves_like - creates nested context, safe
+RSpec.describe Controller do
+  it_behaves_like "user actions", :admin    # Nested: "behaves like user actions"
+  it_behaves_like "user actions", :regular  # Separate context, no conflicts
+end
+
+# AVOID include_examples multiple times - method conflicts
+# describe Controller do
+#   include_examples "user actions", :admin
+#   include_examples "user actions", :regular  # BAD: Overrides let definitions!
+# end
+
+# When to use shared examples
+# GOOD: Interface compliance testing
+RSpec.shared_examples "timestamped model" do
+  it { is_expected.to respond_to(:created_at) }
+  it { is_expected.to respond_to(:updated_at) }
+end
+
+RSpec.describe User do
+  subject(:user) { build(:user) }
+
+  it_behaves_like "timestamped model"
+end
+
+RSpec.describe Post do
+  subject(:post) { build(:post) }
+
+  it_behaves_like "timestamped model"
+end