blanks 1.0.0

data/spec/blanks/association_proxy_spec.rb

@@ -0,0 +1,214 @@
+# frozen_string_literal: true
+
+require "spec_helper"
+
+RSpec.describe Blanks::AssociationProxy do
+  let(:form_class) do
+    Class.new(Blanks::Base) do
+      attribute :url, :string
+    end
+  end
+
+  before do
+    stub_const("ItemForm", form_class)
+  end
+
+  describe "#new" do
+    it "creates a new form instance" do
+      proxy = described_class.new("ItemForm")
+
+      item = proxy.new(url: "https://example.com")
+
+      expect(item).to be_a(ItemForm)
+    end
+
+    it "adds the instance to the collection" do
+      proxy = described_class.new("ItemForm")
+
+      proxy.new(url: "https://example.com")
+
+      expect(proxy.count).to eq(1)
+    end
+
+    it "passes attributes to the form" do
+      proxy = described_class.new("ItemForm")
+
+      item = proxy.new(url: "https://example.com")
+
+      expect(item.url).to eq("https://example.com")
+    end
+  end
+
+  describe "#build" do
+    it "is an alias for new" do
+      proxy = described_class.new("ItemForm")
+
+      item = proxy.build(url: "https://example.com")
+
+      expect(item).to be_a(ItemForm)
+    end
+  end
+
+  describe "#push" do
+    it "adds a record to the collection" do
+      proxy = described_class.new("ItemForm")
+      item = ItemForm.new(url: "https://example.com")
+
+      proxy.push(item)
+
+      expect(proxy.count).to eq(1)
+    end
+
+    it "returns self for chaining" do
+      proxy = described_class.new("ItemForm")
+      item = ItemForm.new(url: "https://example.com")
+
+      result = proxy.push(item)
+
+      expect(result).to eq(proxy)
+    end
+  end
+
+  describe "#<<" do
+    it "is an alias for push" do
+      proxy = described_class.new("ItemForm")
+      item = ItemForm.new(url: "https://example.com")
+
+      proxy << item
+
+      expect(proxy.count).to eq(1)
+    end
+  end
+
+  describe "#each" do
+    it "iterates over the collection" do
+      proxy = described_class.new("ItemForm")
+      proxy.new(url: "first")
+      proxy.new(url: "second")
+
+      urls = []
+      proxy.each { |item| urls << item.url }
+
+      expect(urls).to eq(["first", "second"])
+    end
+  end
+
+  describe "#size" do
+    it "returns the number of items" do
+      proxy = described_class.new("ItemForm")
+      proxy.new(url: "first")
+      proxy.new(url: "second")
+
+      expect(proxy.size).to eq(2)
+    end
+  end
+
+  describe "#count" do
+    it "is an alias for size" do
+      proxy = described_class.new("ItemForm")
+      proxy.new(url: "first")
+
+      expect(proxy.count).to eq(1)
+    end
+  end
+
+  describe "#length" do
+    it "is an alias for size" do
+      proxy = described_class.new("ItemForm")
+      proxy.new(url: "first")
+
+      expect(proxy.length).to eq(1)
+    end
+  end
+
+  describe "#empty?" do
+    it "returns true when collection is empty" do
+      proxy = described_class.new("ItemForm")
+
+      expect(proxy.empty?).to be(true)
+    end
+
+    it "returns false when collection has items" do
+      proxy = described_class.new("ItemForm")
+      proxy.new(url: "first")
+
+      expect(proxy.empty?).to be(false)
+    end
+  end
+
+  describe "#any?" do
+    it "returns false when collection is empty" do
+      proxy = described_class.new("ItemForm")
+
+      expect(proxy.any?).to be(false)
+    end
+
+    it "returns true when collection has items" do
+      proxy = described_class.new("ItemForm")
+      proxy.new(url: "first")
+
+      expect(proxy.any?).to be(true)
+    end
+  end
+
+  describe "#[]" do
+    it "returns item at index" do
+      proxy = described_class.new("ItemForm")
+      proxy.new(url: "first")
+      proxy.new(url: "second")
+
+      expect(proxy[1].url).to eq("second")
+    end
+  end
+
+  describe "#clear" do
+    it "removes all items from collection" do
+      proxy = described_class.new("ItemForm")
+      proxy.new(url: "first")
+      proxy.new(url: "second")
+
+      proxy.clear
+
+      expect(proxy.count).to eq(0)
+    end
+  end
+
+  describe "#to_a" do
+    it "returns the underlying array" do
+      proxy = described_class.new("ItemForm")
+      item1 = proxy.new(url: "first")
+      item2 = proxy.new(url: "second")
+
+      expect(proxy.to_a).to eq([item1, item2])
+    end
+  end
+
+  describe "#valid?" do
+    it "returns true when all items are valid" do
+      valid_form_class = Class.new(Blanks::Base) do
+        attribute :url, :string
+        validates :url, presence: true
+      end
+      stub_const("ValidForm", valid_form_class)
+
+      proxy = described_class.new("ValidForm")
+      proxy.new(url: "https://example.com")
+
+      expect(proxy.valid?).to be(true)
+    end
+
+    it "returns false when any item is invalid" do
+      valid_form_class = Class.new(Blanks::Base) do
+        attribute :url, :string
+        validates :url, presence: true
+      end
+      stub_const("ValidForm", valid_form_class)
+
+      proxy = described_class.new("ValidForm")
+      proxy.new(url: "https://example.com")
+      proxy.new(url: nil)
+
+      expect(proxy.valid?).to be(false)
+    end
+  end
+end

data/spec/blanks/associations_spec.rb

@@ -0,0 +1,185 @@
+# frozen_string_literal: true
+
+require "spec_helper"
+
+RSpec.describe Blanks::Associations do
+  describe ".has_one" do
+    it "defines a reader method" do
+      nested_class = Class.new(Blanks::Base)
+      stub_const("PhotoForm", nested_class)
+
+      form_class = Class.new(Blanks::Base) do
+        has_one :photo
+      end
+
+      form = form_class.new
+
+      expect(form).to respond_to(:photo)
+    end
+
+    it "defines a setter method" do
+      nested_class = Class.new(Blanks::Base)
+      stub_const("PhotoForm", nested_class)
+
+      form_class = Class.new(Blanks::Base) do
+        has_one :photo
+      end
+
+      form = form_class.new
+
+      expect(form).to respond_to(:photo=)
+    end
+
+    it "defines a build method" do
+      nested_class = Class.new(Blanks::Base) do
+        attribute :url, :string
+      end
+      stub_const("PhotoForm", nested_class)
+
+      form_class = Class.new(Blanks::Base) do
+        has_one :photo
+      end
+
+      form = form_class.new
+
+      expect(form).to respond_to(:build_photo)
+    end
+
+    it "infers class name from association name" do
+      nested_class = Class.new(Blanks::Base) do
+        attribute :url, :string
+      end
+      stub_const("CoverPhotoForm", nested_class)
+
+      form_class = Class.new(Blanks::Base) do
+        has_one :cover_photo
+      end
+
+      form = form_class.new
+      photo = form.build_cover_photo(url: "test")
+
+      expect(photo).to be_a(CoverPhotoForm)
+    end
+
+    it "accepts explicit class_name option" do
+      nested_class = Class.new(Blanks::Base) do
+        attribute :url, :string
+      end
+      stub_const("CustomForm", nested_class)
+
+      form_class = Class.new(Blanks::Base) do
+        has_one :photo, class_name: "CustomForm"
+      end
+
+      form = form_class.new
+      photo = form.build_photo(url: "test")
+
+      expect(photo).to be_a(CustomForm)
+    end
+
+    it "builds associated form with attributes" do
+      nested_class = Class.new(Blanks::Base) do
+        attribute :url, :string
+      end
+      stub_const("PhotoForm", nested_class)
+
+      form_class = Class.new(Blanks::Base) do
+        has_one :photo
+      end
+
+      form = form_class.new
+      photo = form.build_photo(url: "https://example.com")
+
+      expect(photo.url).to eq("https://example.com")
+    end
+
+    it "sets the built form on the association" do
+      nested_class = Class.new(Blanks::Base) do
+        attribute :url, :string
+      end
+      stub_const("PhotoForm", nested_class)
+
+      form_class = Class.new(Blanks::Base) do
+        has_one :photo
+      end
+
+      form = form_class.new
+      form.build_photo(url: "https://example.com")
+
+      expect(form.photo.url).to eq("https://example.com")
+    end
+  end
+
+  describe ".has_many" do
+    it "defines a reader method" do
+      nested_class = Class.new(Blanks::Base)
+      stub_const("ImageForm", nested_class)
+
+      form_class = Class.new(Blanks::Base) do
+        has_many :images
+      end
+
+      form = form_class.new
+
+      expect(form).to respond_to(:images)
+    end
+
+    it "defines a setter method" do
+      nested_class = Class.new(Blanks::Base)
+      stub_const("ImageForm", nested_class)
+
+      form_class = Class.new(Blanks::Base) do
+        has_many :images
+      end
+
+      form = form_class.new
+
+      expect(form).to respond_to(:images=)
+    end
+
+    it "returns an association proxy" do
+      nested_class = Class.new(Blanks::Base)
+      stub_const("ImageForm", nested_class)
+
+      form_class = Class.new(Blanks::Base) do
+        has_many :images
+      end
+
+      form = form_class.new
+
+      expect(form.images).to be_a(Blanks::AssociationProxy)
+    end
+
+    it "infers class name from singular association name" do
+      nested_class = Class.new(Blanks::Base) do
+        attribute :url, :string
+      end
+      stub_const("ImageForm", nested_class)
+
+      form_class = Class.new(Blanks::Base) do
+        has_many :images
+      end
+
+      form = form_class.new
+      image = form.images.new(url: "test")
+
+      expect(image).to be_a(ImageForm)
+    end
+
+    it "accepts explicit class_name option" do
+      nested_class = Class.new(Blanks::Base) do
+        attribute :url, :string
+      end
+      stub_const("CustomForm", nested_class)
+
+      form_class = Class.new(Blanks::Base) do
+        has_many :items, class_name: "CustomForm"
+      end
+
+      form = form_class.new
+      item = form.items.new(url: "test")
+
+      expect(item).to be_a(CustomForm)
+    end
+  end
+end

data/spec/blanks/attributes_extraction_spec.rb

@@ -0,0 +1,138 @@
+# frozen_string_literal: true
+
+require "spec_helper"
+
+RSpec.describe "Attributes extraction" do
+  describe "#model_attributes" do
+    it "returns hash of form attributes" do
+      form_class = Class.new(Blanks::Base) do
+        attribute :title, :string
+        attribute :content, :string
+      end
+
+      form = form_class.new(title: "hello", content: "world")
+
+      expect(form.model_attributes).to eq("title" => "hello", "content" => "world")
+    end
+
+    it "excludes associations" do
+      nested_class = Class.new(Blanks::Base) do
+        attribute :url, :string
+      end
+      stub_const("PhotoForm", nested_class)
+
+      form_class = Class.new(Blanks::Base) do
+        has_one :photo
+        attribute :title, :string
+      end
+
+      form = form_class.new(title: "test")
+      form.build_photo(url: "https://example.com")
+
+      expect(form.model_attributes.keys).to eq(["title"])
+    end
+
+    it "includes nil values" do
+      form_class = Class.new(Blanks::Base) do
+        attribute :title, :string
+        attribute :count, :integer
+      end
+
+      form = form_class.new(title: "test")
+
+      expect(form.model_attributes).to eq("title" => "test", "count" => nil)
+    end
+  end
+
+  describe "#attributes" do
+    it "returns hash with nested attributes" do
+      nested_class = Class.new(Blanks::Base) do
+        attribute :url, :string
+      end
+      stub_const("PhotoForm", nested_class)
+
+      form_class = Class.new(Blanks::Base) do
+        has_one :photo
+        attribute :title, :string
+      end
+
+      form = form_class.new(title: "test")
+      form.build_photo(url: "https://example.com")
+
+      expect(form.attributes).to eq(
+        "title" => "test",
+        "photo_attributes" => { "url" => "https://example.com" }
+      )
+    end
+
+    it "includes has_many associations as array" do
+      nested_class = Class.new(Blanks::Base) do
+        attribute :url, :string
+      end
+      stub_const("ImageForm", nested_class)
+
+      form_class = Class.new(Blanks::Base) do
+        has_many :images
+        attribute :title, :string
+      end
+
+      form = form_class.new(title: "test")
+      form.images.new(url: "https://example.com/1.jpg")
+      form.images.new(url: "https://example.com/2.jpg")
+
+      expect(form.attributes).to eq(
+        "title" => "test",
+        "images_attributes" => [
+          { "url" => "https://example.com/1.jpg" },
+          { "url" => "https://example.com/2.jpg" }
+        ]
+      )
+    end
+
+    it "recursively converts nested associations" do
+      deepest_class = Class.new(Blanks::Base) do
+        attribute :caption, :string
+      end
+      stub_const("CaptionForm", deepest_class)
+
+      nested_class = Class.new(Blanks::Base) do
+        has_one :caption
+        attribute :url, :string
+      end
+      stub_const("PhotoForm", nested_class)
+
+      form_class = Class.new(Blanks::Base) do
+        has_one :photo
+        attribute :title, :string
+      end
+
+      form = form_class.new(title: "test")
+      form.build_photo(url: "https://example.com")
+      form.photo.build_caption(caption: "test caption")
+
+      expect(form.attributes).to eq(
+        "title" => "test",
+        "photo_attributes" => {
+          "url" => "https://example.com",
+          "caption_attributes" => { "caption" => "test caption" }
+        }
+      )
+    end
+
+    it "omits nil associations" do
+      nested_class = Class.new(Blanks::Base) do
+        attribute :url, :string
+      end
+      stub_const("PhotoForm", nested_class)
+
+      form_class = Class.new(Blanks::Base) do
+        has_one :photo
+        attribute :title, :string
+      end
+
+      form = form_class.new(title: "test")
+
+      expect(form.attributes).to eq("title" => "test")
+    end
+  end
+end