action_component 0.1.2 → 0.1.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: c40a85133d9515f6130d1ef47ae902ca393dd071
-  data.tar.gz: 7aab855f6a751caad576ab268505ef2acec1053a
+  metadata.gz: 2f33f7082a98706e560055f13359cde3c1047221
+  data.tar.gz: 71e05e1a88e06f812e0d8323713f71aaacea3f8f
 SHA512:
-  metadata.gz: e8c35cfee98e7bb48b6f11d7b947ed51a6a04d4afed3cf38fa59d0c141258c7afd5bf09e27b0ce9ee02ecbbc36e6c6db4b0bc4af28cdea3b9499da9944778d97
-  data.tar.gz: f2f6ae0fd3847fab3bccf2ac74a3456e9191f94aa6b9e9084a7cee1a98ca70239f307a55c1fba5aa0412a14c547ef9d4e21af1bc5033545ee26f0d37a57c2be9
+  metadata.gz: 73fb3c94cb8d6545196a41a63e75714e6bae851dbadf239ffa9b65c6a8bee22b2a73d0fed95d803be963d8028bf02fb42d2d00a8fc199074993feb9ded023879
+  data.tar.gz: 8152c4885c00c68a1dc7bb4fd99349b425350a7992a472925435e802ba8348543ea7fae7e5a76d7d7656a9a6eaee24893f9bc4b9348ca7b51b79aa1ebce68bce

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    action_component (0.1.2)
+    action_component (0.1.3)
       actionpack (>= 4, < 6)
       activesupport (>= 4, < 6)
       railties (>= 4, < 6)

data/README.md

@@ -86,6 +86,10 @@ class PostComponent < ActionComponent::Base
     div(class: 'post') do
       h2 @post.title
 
+      # This renders a div with a class of 'published-at'
+      # Note the underscore has been replaced with a dash.
+      e.div.published_at "Published at #{l @post.published_at}"
+
       component AuthorComponent, author: @post.author
 
       insert simple_format(@post.content)
@@ -97,7 +101,7 @@ end
 ## More documentation to come
 
 ActionComponent is new.  It works just fine, but at the moment if you need more information than is given above,
-please dive into the (very small) codebase to learn more.
+please dive into the (small) codebase to learn more.
 
 ## Contributing
 

data/lib/action_component.rb

@@ -3,10 +3,19 @@ end
 
 require 'action_component/version'
 
+# Rails integration
+
 require 'action_component/action_controller_rendering'
 require 'action_component/action_view_rendering'
+require 'action_component/railtie'
+
+# Base dependencies
+
+require 'action_component/callbacks'
 require 'action_component/constraints'
 require 'action_component/elements'
+require 'action_component/element_builder'
+
+# Base
 
 require 'action_component/base'
-require 'action_component/railtie'

data/lib/action_component/base.rb

@@ -8,13 +8,14 @@ module ActionComponent
   class Base
     include ActionComponent::Constraints
     include ActionComponent::Elements
+    prepend ActionComponent::Callbacks
 
     delegate :concat, to: :@_view
 
     def self.render(view, opts = {})
       component = new(view, opts)
       component.load
-      component.view
+      component.render_view
       nil
     end
 
@@ -35,6 +36,10 @@ module ActionComponent
       raise ActionComponent::ViewMissingError, "#{self.class.name} must define a view method to be a valid component"
     end
 
+    def render_view
+      view
+    end
+
     private
 
     def method_missing(method, *args, &block)

data/lib/action_component/callbacks.rb

@@ -0,0 +1,29 @@
+module ActionComponent
+  module Callbacks
+    def self.prepended(base)
+      base.class_attribute :before_render_callback_methods, :after_render_callback_methods
+
+      base.before_render_callback_methods = []
+      base.after_render_callback_methods = []
+
+      base.extend ClassMethods
+    end
+
+    module ClassMethods
+      def before_render(*methods)
+        self.before_render_callback_methods += methods
+      end
+
+      def after_render(*methods)
+        self.after_render_callback_methods += methods
+      end
+    end
+
+    def render_view
+      before_render_callback_methods.each { |method| send(method) }
+      result = super
+      after_render_callback_methods.each { |method| send(method) }
+      result
+    end
+  end
+end

data/lib/action_component/element_builder.rb

@@ -0,0 +1,64 @@
+module ActionComponent
+  class ElementBuilder
+    def initialize(base, element_name = nil, classes = nil, id = nil)
+      @base = base
+      @element_name = element_name
+      @classes = classes
+      @id = id
+    end
+
+    def method_missing(method, *args, &block)
+      element_name = @element_name
+      classes = @classes
+      id = @id
+
+      command = method.to_s
+
+      command = command[-1] == '?' ? command[0..-2] : command.gsub('_', '-')
+
+      if element_name
+        if command[-1] == '!'
+          id = command[0..-2]
+        else
+          classes = classes ? "#{classes} #{command}" : command
+        end
+      else
+        element_name = command
+      end
+
+      if !args.empty? || block
+        first, second = args
+
+        if second.is_a?(Hash)
+          build_options(classes, id, second)
+        elsif first.is_a?(Hash)
+          build_options(classes, id, first)
+        elsif first
+          second = build_options(classes, id)
+        else
+          first = build_options(classes, id)
+        end
+
+        @base.send(:element, element_name, first, second, &block)
+      else
+        self.class.new(@base, element_name, classes, id)
+      end
+    end
+
+    private
+
+    def build_options(classes, id, options = {})
+      if classes
+        if options[:class]
+          options[:class] = "#{options[:class]} #{classes}"
+        else
+          options[:class] = classes
+        end
+      end
+
+      options[:id] = id if id
+
+      options
+    end
+  end
+end

data/lib/action_component/elements.rb

@@ -66,5 +66,9 @@ module ActionComponent
 
       nil
     end
+
+    def e
+      ElementBuilder.new(self)
+    end
   end
 end

data/lib/action_component/version.rb

@@ -1,3 +1,3 @@
 module ActionComponent
-  VERSION = "0.1.2"
+  VERSION = "0.1.3"
 end

data/spec/action_component/base_spec.rb

@@ -10,7 +10,7 @@ RSpec.describe ActionComponent::Base do
     it "makes a new component, then calls load and view, returning nil" do
       component = instance_double(ActionComponent::Base)
       expect(component).to receive(:load).ordered
-      expect(component).to receive(:view).ordered
+      expect(component).to receive(:render_view).ordered
 
       expect(ActionComponent::Base).to receive(:new)
         .with(view, {option: 'value'})

data/spec/action_component/callbacks_spec.rb

@@ -0,0 +1,38 @@
+require 'spec_helper'
+
+RSpec.describe ActionComponent::Callbacks do
+  class FakeComponent
+    prepend ActionComponent::Callbacks
+
+    before_render :test1
+    before_render :test2
+    after_render :test3
+
+    def test1
+    end
+
+    def test2
+    end
+
+    def test3
+    end
+
+    def view
+    end
+
+    def render_view
+      view
+    end
+  end
+
+  subject { FakeComponent.new }
+
+  it "calls the before and after callbacks" do
+    expect(subject).to receive(:test1).ordered
+    expect(subject).to receive(:test2).ordered
+    expect(subject).to receive(:view).ordered.and_return('result')
+    expect(subject).to receive(:test3).ordered
+
+    expect(subject.render_view).to eq 'result'
+  end
+end

data/spec/action_component/element_builder_spec.rb

@@ -0,0 +1,53 @@
+require 'spec_helper'
+
+RSpec.describe ActionComponent::ElementBuilder do
+  class FakeBase
+    def element(*args, &block)
+      [*args, block]
+    end
+  end
+
+  let(:base) { FakeBase.new }
+
+  subject { ActionComponent::ElementBuilder.new(base) }
+
+  it "builds a simple element" do
+    expect(subject.simple("test")).to eq ['simple', 'test', {}, nil]
+  end
+
+  it "builds an element with a class" do
+    expect(subject.simple.blue("test")).to eq ['simple', 'test', {class: 'blue'}, nil]
+  end
+
+  it "builds an element with two classes" do
+    expect(subject.simple.blue.loud("test")).to eq ['simple', 'test', {class: 'blue loud'}, nil]
+  end
+
+  it "builds an element with an id" do
+    expect(subject.simple.blue!("test")).to eq ['simple', 'test', {id: 'blue'}, nil]
+  end
+
+  it "converts underscores to dashes" do
+    expect(subject.simple.strong_blue("test")).to eq ['simple', 'test', {class: 'strong-blue'}, nil]
+  end
+
+  it "does not convert underscores to dashes if the method ends in a ?" do
+    expect(subject.simple.strong_blue?("test")).to eq ['simple', 'test', {class: 'strong_blue'}, nil]
+  end
+
+  it "merges classes with ones specified in the hash" do
+    expect(subject.simple.blue("test", testy: "very", class: "strong")).to eq ['simple', 'test', {testy: "very", class: 'strong blue'}, nil]
+  end
+
+  it "passes just a block" do
+    block = -> {}
+
+    expect(subject.simple.blue(&block)).to eq ['simple', {class: 'blue'}, nil, block]
+  end
+
+  it "passes a block with a hash" do
+    block = -> {}
+
+    expect(subject.simple.blue(testy: "very", &block)).to eq ['simple', {testy: "very", class: 'blue'}, nil, block]
+  end
+end

data/spec/action_component/elements_spec.rb

@@ -121,4 +121,10 @@ RSpec.describe ActionComponent::Elements do
       end
     end
   end
+
+  describe "#e" do
+    it "returns an ElementBuilder" do
+      expect(subject.send(:e)).to be_a ActionComponent::ElementBuilder
+    end
+  end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: action_component
 version: !ruby/object:Gem::Version
-  version: 0.1.2
+  version: 0.1.3
 platform: ruby
 authors:
 - Roger Nesbitt
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-11-29 00:00:00.000000000 Z
+date: 2016-11-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: actionpack
@@ -102,12 +102,16 @@ files:
 - lib/action_component/action_controller_rendering.rb
 - lib/action_component/action_view_rendering.rb
 - lib/action_component/base.rb
+- lib/action_component/callbacks.rb
 - lib/action_component/constraints.rb
+- lib/action_component/element_builder.rb
 - lib/action_component/elements.rb
 - lib/action_component/railtie.rb
 - lib/action_component/version.rb
 - spec/action_component/base_spec.rb
+- spec/action_component/callbacks_spec.rb
 - spec/action_component/constraints_spec.rb
+- spec/action_component/element_builder_spec.rb
 - spec/action_component/elements_spec.rb
 - spec/fake_view.rb
 - spec/spec_helper.rb
@@ -137,7 +141,9 @@ specification_version: 4
 summary: React-style components for Rails
 test_files:
 - spec/action_component/base_spec.rb
+- spec/action_component/callbacks_spec.rb
 - spec/action_component/constraints_spec.rb
+- spec/action_component/element_builder_spec.rb
 - spec/action_component/elements_spec.rb
 - spec/fake_view.rb
 - spec/spec_helper.rb