blush 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 9343c4323c3c9e3de4f2e747f82652949f9b1f6f
+  data.tar.gz: a1b4367b03f0ea9b6387a2d8c32bc5d232cac3fc
+SHA512:
+  metadata.gz: 20f7cf5815f17d1647948e6f1bb9698248614a4408ccd13940468792ceb6224a8a15df1470fc043ab24d41049c17f584b0bf3389629486e4bcda29a1119cb08f
+  data.tar.gz: 72a31b45fd2cda8437d1fd8bac28694c432e087880082c25f3d58a0d59ff80a731e47361f0cf7127daf186f065ad3a195e48a9ddd6e882d4f3f3126ffd755cc1

data/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2016 Grant Colegate
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,29 @@
+# Blush
+
+Make your models fit for presentation. View Models for Rails.
+
+## Installation
+
+```ruby
+gem 'blush'
+```
+
+## Usage
+
+```ruby
+class Comment < ActiveRecord::Base
+  has_presenter
+end
+
+class CommentPresenter < Blush::Presenter
+  def content
+    h.simple_format(object.content)
+  end
+end
+
+# explicitly call the presenter methods
+@comment.presenter.content
+
+# delegate to the model if method doesn't exist on presenter
+@comment.present(:content)
+```

data/lib/blush.rb

@@ -0,0 +1,46 @@
+require 'blush/configuration'
+require 'blush/has_presenter'
+require 'blush/helper_proxy'
+require 'blush/presenter'
+require 'blush/view_context'
+require 'blush/railtie'
+
+##
+# Wrapper module for Blush
+module Blush
+
+  ##
+  # Convenient API for accessing Blush's configuration
+  #
+  # Options include:
+  #  Blush.config.accessor_name to set the default accessor on the model
+  #  Blush.config.helper_name to set the default helper name on the model
+  module_function def config
+    @config ||= Blush::Configuration.new
+  end
+
+  ##
+  # Cache the helpers globally
+  module_function def helpers=(helper_proxy)
+    @helpers = helper_proxy
+  end
+
+  ##
+  # Get the cached helpers
+  module_function def helpers
+    @helpers ||= Blush::HelperProxy.new
+  end
+
+  ##
+  # Cache the view context globally
+  module_function def view_context=(view_context)
+    @view_context = view_context
+  end
+
+  ##
+  # Get the cached view context
+  module_function def view_context
+    @view_context ||= ApplicationController.new.view_context
+  end
+
+end

data/lib/blush/configuration.rb

@@ -0,0 +1,14 @@
+module Blush
+
+  ##
+  # Class to store configuration for Blush
+  class Configuration
+    attr_accessor :accessor_name, :helper_name
+
+    def initialize
+      @accessor_name = :presenter
+      @helper_name = :present
+    end
+  end
+
+end

data/lib/blush/has_presenter.rb

@@ -0,0 +1,38 @@
+module Blush
+
+  ##
+  # Tell a model that it has a presenter
+  #
+  # This is included in all models
+  #
+  # Use with defaults:
+  #  has_presenter
+  #
+  # Use with custom accessor:
+  #  has_presenter :accessor_name
+  #
+  # Use with options:
+  #  has_presenter { class: 'ThingPresenter', helper_name: :foo }
+  module HasPresenter
+    def has_presenter(accessor_name = {}, options = nil)
+      class_attribute :blush_options
+
+      options, accessor_name = accessor_name, options unless options
+      self.blush_options = options
+      self.blush_options[:accessor_name] = accessor_name || Blush.config.accessor_name
+
+      # defines the accessor
+      define_method(self.blush_options[:accessor_name]) do
+        accessor_name = "@#{self.blush_options[:accessor_name]}"
+        presenter_class = (self.blush_options[:class] || "#{self.model_name}Presenter").constantize
+        instance_variable_get(accessor_name) || instance_variable_set(accessor_name, presenter_class.new(self))
+      end
+
+      # defines the helper
+      define_method(self.blush_options[:helper_name] || Blush.config.helper_name) do |method, *args, &block|
+        presenter.try(method, *args, &block) || send(method, *args, &block)
+      end
+    end
+  end
+
+end

data/lib/blush/helper_proxy.rb

@@ -0,0 +1,11 @@
+module Blush
+
+  ##
+  # Proxy helper methods to the view context
+  class HelperProxy
+    def method_missing(method, *args, &block)
+      Blush.view_context.send(method, *args, &block)
+    end
+  end
+
+end

data/lib/blush/presenter.rb

@@ -0,0 +1,37 @@
+module Blush
+
+  ##
+  # The base presenter class. All presenters should inherit from this.
+  class Presenter
+    attr_accessor :object
+
+    def initialize(object)
+      @object = object
+    end
+
+    ##
+    # Alias o to object for convenience
+    alias_method :o, :object
+
+    ##
+    # Access helpers from the view context through HelperProxy
+    def helpers
+      Blush.helpers
+    end
+
+    ##
+    # Alias h to helpers for convenience
+    alias_method :h, :helpers
+
+    ##
+    # Alias localize to helpers.localize for convenience
+    def localize
+      helpers.localize
+    end
+
+    ##
+    # Alias l to localize for convenience
+    alias_method :l, :helpers
+  end
+
+end

data/lib/blush/railtie.rb

@@ -0,0 +1,29 @@
+module Blush
+  class Railtie < Rails::Railtie
+    initializer "blush.setup_action_controller" do |app|
+      ActiveSupport.on_load :action_controller do
+        self.class_eval do
+          include Blush::ViewContext
+
+          before_action :activate_blush
+        end
+      end
+    end
+
+    initializer "blush.setup_action_mailer" do |app|
+      ActiveSupport.on_load :action_mailer do
+        self.class_eval do
+          include Blush::ViewContext
+        end
+      end
+    end
+
+    initializer "blush.setup_orm" do |app|
+      ActiveSupport.on_load :active_record do
+        self.class_eval do
+          extend Blush::HasPresenter
+        end
+      end
+    end
+  end
+end

data/lib/blush/version.rb

@@ -0,0 +1,3 @@
+module Blush
+  VERSION = "0.0.1"
+end

data/lib/blush/view_context.rb

@@ -0,0 +1,21 @@
+module Blush
+
+  ##
+  # Hooks into controllers and mailers to get the curret view context
+  module ViewContext
+    ##
+    # Taps into the call to view_context to caches it
+    def view_context
+      super.tap do |context|
+        Blush.view_context = context
+      end
+    end
+
+    ##
+    # Sets the cached view_context
+    def activate_blush
+      Blush.view_context = view_context
+    end
+  end
+
+end

metadata

@@ -0,0 +1,68 @@
+--- !ruby/object:Gem::Specification
+name: blush
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Grant Colegate
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2016-05-16 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: View Models for Rails
+email:
+- blaknite@thelanbox.com.au
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- lib/blush.rb
+- lib/blush/configuration.rb
+- lib/blush/has_presenter.rb
+- lib/blush/helper_proxy.rb
+- lib/blush/presenter.rb
+- lib/blush/railtie.rb
+- lib/blush/version.rb
+- lib/blush/view_context.rb
+homepage: ''
+licenses: []
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.2.2
+signing_key: 
+specification_version: 4
+summary: View Models for Rails
+test_files: []
+has_rdoc: