oprah 0.1.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 9338c79bdb8b1d23b379817b46c5c2ed1dbf07d1
+  data.tar.gz: 5af6034580ada342dfe5cd69e02f94dbb6deb622
+SHA512:
+  metadata.gz: 2810722883f201f4cea966612128a01f5173ea14c64fb5fd1a30982f944377af6494e5de264198c63d22b7d4d91d9c900d67f329d2bc7e7596c754082da31a3b
+  data.tar.gz: c7d1053a0023d28d258d9b397aac887b1f1718002824c7b8d4d6c742d6148317c2434fc758b54e602455cbf4438ab8aa29343d807ae501c9c256de00a3ab2f12

data/.gitignore

@@ -0,0 +1,14 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+*.bundle
+*.so
+*.o
+*.a
+mkmf.log

data/.travis.yml

@@ -0,0 +1,15 @@
+language: ruby
+sudo: false
+cache: bundler
+script: rake test
+rvm:
+  - 2.3.1
+matrix:
+  global:
+    - BUNDLE_JOBS=4
+before_install:
+  - bundle install --retry=3
+before_update:
+  - bundle update
+notifications:
+  email: false

data/CHANGELOG.md

@@ -0,0 +1,4 @@
+0.1.1
+-----
+
+- Initial public release

data/CONTRIBUTING.md

@@ -0,0 +1,86 @@
+# Contributing
+
+When contributing to this repository, please first discuss the change you wish
+to make via issue, email, or any other method with the owners of this repository
+before making a change.
+
+Please note we have a code of conduct, please follow it in all your interactions
+with the project.
+
+## Pull Request Process
+
+If you'd like to contribute to Oprah, start by forking the repository on GitHub:
+
+http://github.com/endofunky/oprah
+
+To get all of the dependencies, install the gem first. The best way to get your
+changes merged back into core is as follows:
+
+- If you are about to add a larger feature, open an issue on the GitHub issue
+  tracker to discuss your ideas first. If whatever you're about to implement is
+  already in the issue tracker, please let us know that you picked it up.
+
+- Clone down your fork.
+
+- Create a thoughtfully named topic branch to contain your change.
+
+- Write some code.
+
+- Add tests and make sure everything still passes by running bundle exec rake.
+  This is mandatory for pull requests to be accepted.
+
+- If you are adding new functionality, document it!
+
+- Do not change the version number.
+
+- If necessary, rebase your commits into logical chunks, without errors.
+
+- Push the branch up to GitHub.
+
+- Send a pull request to the endofunky/oprah project.
+
+## Contributor Code of Conduct
+
+As contributors and maintainers of this project, and in the interest of
+fostering an open and welcoming community, we pledge to respect all people who
+contribute through reporting issues, posting feature requests, updating
+documentation, submitting pull requests or patches, and other activities.
+
+We are committed to making participation in this project a harassment-free
+experience for everyone, regardless of level of experience, gender, gender
+identity and expression, sexual orientation, disability, personal appearance,
+body size, race, ethnicity, age, religion, or nationality.
+
+Examples of unacceptable behavior by participants include:
+
+- The use of sexualized language or imagery
+
+- Personal attacks
+
+- Trolling or insulting/derogatory comments
+
+- Public or private harassment
+
+- Publishing other's private information, such as physical or electronic
+  addresses, without explicit permission
+
+- Other unethical or unprofessional conduct.
+
+Project maintainers have the right and responsibility to remove, edit, or
+reject comments, commits, code, wiki edits, issues, and other contributions that
+are not aligned to this Code of Conduct. By adopting this Code of Conduct,
+project maintainers commit themselves to fairly and consistently applying these
+principles to every aspect of managing this project. Project maintainers who do
+not follow or enforce the Code of Conduct may be permanently removed from the
+project team.
+
+This code of conduct applies both within project spaces and in public spaces
+when an individual is representing the project or its community.
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported by opening an issue or contacting one or more of the project
+maintainers.
+
+This Code of Conduct is adapted from the
+[Contributor Covenant](http://contributor-covenant.org), version 1.2.0,
+available at http://contributor-covenant.org/version/1/2/0/

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in sheaf.gemspec
+gemspec

data/LICENSE

@@ -0,0 +1,21 @@
+The MIT License
+
+Copyright (c) 2016 Tobias Svensson <tob@tobiassvensson.co.uk>
+
+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,243 @@
+# Oprah
+
+Opinionated presenters for Rails 5 - without the cruft.
+
+## Table of Contents
+
+* [Overview](#overview)
+* [Installation](#installation)
+* [Getting started](#getting-started)
+  + [ActionController integration](#actioncontroller-integration)
+* [Collections](#collections)
+* [Associations](#associations)
+* [Composition](#composition)
+  + [Performance](#performance)
+  + [Ordering](#ordering)
+* [License](#license)
+* [Author](#author)
+
+## Overview
+
+If you've ever worked on a sufficiently large Rails application you've probably
+experienced the Rails helper mess first hand. Helper methods are annoying to
+locate, hard to test and not terribly expressive.
+
+So why another presenter/decorator library? Oprah was written with a few simple
+goals in mind only covered partially (or not at all) by other gems:
+
+- Lightweight
+- Presenters should be easy to test
+- No monkey patching :monkey::gun:
+- Embrace convention over configuration
+- First-class support for composition (modules and concerns)
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+``` ruby
+gem 'oprah'
+```
+
+And then execute:
+
+```
+$ bundle
+```
+
+## Getting started
+
+Oprah expects a single presenter for each of your classes or modules. If your
+model is called `User` it will look for a class called `UserPresenter`:
+
+``` ruby
+class User
+  def first_name
+    "John"
+  end
+
+  def last_name
+    "Doe"
+  end
+end
+
+class UserPresenter < Oprah::Presenter
+  def name
+    "#{first_name} #{last_name}"
+  end
+end
+```
+
+Oprah will figure out the presenters by itself so you don't have to instantiate
+your presenter classes directly:
+
+``` ruby
+presenter = Oprah.present(User.new)
+
+presenter.name
+# => "John Doe"
+
+```
+
+Of course, all the regular methods on your model are still accessible:
+
+``` ruby
+presenter.first_name
+# => "John"
+```
+
+If you *DO* want to use a specific presenter, you can simply instantiate it
+yourself:
+
+``` ruby
+SomeOtherPresenter.new(User.new)
+```
+
+### ActionController integration
+
+Now, where do we put our presenters? Ideally, you'd want to expose them in your
+controller. Oprah avoids monkey patching and generally it's good to be aware of
+what's going on, even if that means to be (at least a little bit) explicit.
+
+Here's how you can use Oprah presenters from your controller:
+
+``` ruby
+class UserController < ApplicationController
+  def show
+    @user = present User.find(params[:id])
+  end
+end
+```
+
+This will also take care of passing the correct view context to the presenter,
+which you can access with the `#view_context` (or shorter, `#h`) instance
+method.
+
+## Collections
+
+Oprah has basic support for collections with `.present_many`. It will simply
+apply it's `.present` behavior to each object in the given collection:
+
+``` ruby
+users = [User.new, User.new]
+presenters = Oprah.present_many(users)
+
+presenters.first.kind_of?(UserPresenter)
+# => true
+
+presenters.last.kind_of?(UserPresenter)
+# => true
+```
+
+Of course, this works in controllers, too:
+
+``` ruby
+class UserController < ApplicationController
+  def index
+    @users = present_many User.all
+  end
+end
+```
+
+## Associations
+
+You can also automatically use presenters for your associations using the
+`#presents_one` and `#presents_many` macros. Let's say you have the following
+`Project` model:
+
+``` ruby
+class Project
+  has_many :users
+  has_one :owner, class_name: "User"
+end
+```
+
+Oprah lets you easily wrap the associated objects:
+
+``` ruby
+class ProjectPresenter < Oprah::Presenter
+  presents_many :users
+  presents_one :owner
+end
+```
+
+Note that you don't need to explicitly state the association class.
+
+## Composition
+
+Let's say you extraced some behaviour out of your model into a reusable module (or
+`ActiveSupport::Concern`). Oprah lets you write a single, separate presenter for
+this module and automatically chains it to your "main presenter" by walking up the
+ancestor chain of the given object.
+
+Let's say we want to mix a shared `Describable` module into our `User` class from
+above and render the description to HTML:
+
+
+``` ruby
+module Describable
+  def description
+    "*AWESOME*"
+  end
+end
+
+class User
+  include Describable
+end
+
+class DescribablePresenter < Oprah::Presenter
+  def description
+    Kramdown::Document.new(object.description).to_html
+  end
+end
+```
+
+You can now access the methods of both, `UserPresenter` *and*
+`DescribablePresenter`:
+
+``` ruby
+presenter = Oprah.present(User.new)
+
+presenter.description
+=> "<p><em>AWESOME</em></p>\n"
+
+presenter.name
+# => John Doe
+```
+
+### Performance
+
+Of course, looking up all the presenters would imply a performance issue. But
+don't worry, Oprah caches all matching presenters for a class (and busts it's
+cache on code reloads for a smooth development experience).
+
+### Ordering
+
+Oprah walks your object's ancestor chain in reverse. For example, you'd be
+able to access the methods exposed by the `DescribablePresenter` from your
+`UserPresenter`. You can even use `super`:
+
+``` ruby
+class DescribablePresenter < Oprah::Presenter
+  def baz
+    "foo"
+  end
+end
+
+class UserPresenter < Oprah::Presenter
+  def baz
+    super + "bar"
+  end
+end
+
+Oprah.present(User.new).baz
+# => "foobar"
+```
+
+## License
+
+Released under the MIT license. See the LICENSE file for details.
+
+## Author
+
+Tobias Svensson, [@endofunky](https://twitter.com/endofunky), [http://github.com/endofunky](http://github.com/endofunky)

data/Rakefile

@@ -0,0 +1,5 @@
+require File.join(Dir.pwd, 'lib', 'oprah', 'version')
+
+Dir["tasks/**/*.rb"].each { |task| load task }
+
+task default: :test

data/lib/oprah/cache.rb

@@ -0,0 +1,58 @@
+module Oprah
+  # A cache store to keep Object-to-Presenter mappings. This class is
+  # thread-safe.
+  class Cache
+    def initialize
+      @mutex = Mutex.new
+      @mapping = {}
+    end
+
+    # Looks up presenters matching to `object` and stores them in the cache.
+    #
+    # @param object [Object] The presentable object
+    # @return [Array] An array of Presenter classes
+    def lookup(object)
+      @mutex.synchronize do
+        key = class_name_for(object)
+
+        if found  = @mapping[key]
+          return found
+        end
+
+        @mapping[key] = presenter_classes_for(object)
+      end
+    end
+
+    # Clears the presenter cache.
+    #
+    # @return [Boolean]
+    def clear!
+      @mutex.synchronize do
+        @mapping = {}
+      end
+
+      Rails.logger.debug "Oprah cache cleared." if Oprah.debug?
+
+      true
+    end
+
+    private
+
+    def presenter_classes_for(object)
+      class_for(object).ancestors.map do |klass|
+        begin
+          (klass.name + "Presenter").constantize
+        rescue
+        end
+      end.compact.reverse
+    end
+
+    def class_name_for(object)
+      class_for(object).name
+    end
+
+    def class_for(object)
+      object.kind_of?(Class) ? object : object.class
+    end
+  end
+end

data/lib/oprah/controller_helpers.rb

@@ -0,0 +1,46 @@
+module Oprah
+  # Helpers that will be mixed into `ActionController::Base` by
+  # the {Oprah::Railtie}.
+  module ControllerHelpers
+    extend ActiveSupport::Concern
+
+    included do
+      helper_method :present
+      helper_method :present_many
+    end
+
+    # Presents the given `object` using {Presenter.present}.
+    #
+    # Will pass the view context returned from {#oprah_view_context} to the
+    # presenter.
+    #
+    # @param object [Object] The object to present
+    # @param view_context [ActionView::Context] View context to assign
+    # @return [Presenter] Presented object
+    def present(object, view_context: oprah_view_context)
+      Oprah.present(object, view_context: view_context)
+    end
+
+    # Presents the given `objects` using {Presenter.present}.
+    #
+    # Will pass the view context returned from {#oprah_view_context} to the
+    # presenter.
+    #
+    # @param objects [Enumerable] The objects to present
+    # @param view_context [ActionView::Context] View context to assign
+    # @return [Presenter] Presented object
+    def present_many(objects, view_context: oprah_view_context)
+      Oprah.present_many(objects, view_context: view_context)
+    end
+
+    # The view context automatically passed to presented objects.
+    #
+    # You can override this method pass a custom view context to all
+    # presented objects from the controller scope.
+    #
+    # @return [ActionView::Context]
+    def oprah_view_context
+      view_context
+    end
+  end
+end

data/lib/oprah/presenter.rb

@@ -0,0 +1,138 @@
+module Oprah
+  class Presenter
+    # @return [Object] The presented object
+    attr_reader :object
+
+    # @return [ActionView::Base] The view context
+    attr_reader :view_context
+
+    alias :h :view_context
+
+    # @!visibility private
+    @@cache = Oprah::Cache.new
+
+    class << self
+      # Returns the shared presenter cache object.
+      #
+      # @return [Cache]
+      def cache
+        @@cache
+      end
+
+      # Presents the given `object` with all it's matching presenters,
+      # following it's ancestors in reverse.
+      #
+      # @param object [Object] The object to present
+      # @param view_context [ActionView::Context] View context to assign
+      # @return [Presenter] Presented object
+      def present(object, view_context: default_view_context)
+        @@cache.lookup(object).inject(object) do |memo, presenter|
+          presenter.new(memo, view_context: view_context)
+        end
+      end
+
+      # Presents the given `objects` with all their matching presenters.
+      # The individual behavior is the same as `.present`'s.
+      #
+      # @param objects [Enumerable] The objects to present
+      # @param view_context [ActionView::Context] View context to assign
+      # @return [Enumerable] Presented collection
+      def present_many(objects, view_context: default_view_context)
+        objects.map do |object|
+          present(object, view_context: view_context)
+        end
+      end
+
+      # Automatically wrap the objects returned by the given one-to-one
+      # `association` method in presenters.
+      #
+      # @param association [Symbol] Name of the association
+      # @return [Boolean]
+      def presents_one(association)
+        define_method association do
+          self.class.present(
+            object.__send__(association), view_context: view_context)
+        end
+      end
+
+      # Automatically wrap the objects returned by the given one-to-many
+      # or many-to-many `association` method in presenters.
+      #
+      # @param association [Symbol] Name of the association
+      # @return [Boolean]
+      def presents_many(association)
+        define_method association do
+          self.class.present_many(
+            object.__send__(association), view_context: view_context)
+        end
+
+        true
+      end
+
+      # Returns the default view context to use if no view context is explicitly
+      # passed to the presenter.
+      #
+      # @return [ActionView::Context]
+      def default_view_context
+        ActionController::Base.new.view_context
+      end
+    end
+
+    # Initializes a new Presenter.
+    #
+    # @param object [Object] The object to present
+    # @param view_context [ActionView::Context] View context to assign
+    def initialize(object, view_context: self.class.default_view_context)
+      @object = object
+      @view_context = view_context
+    end
+
+    # Delegates all method calls not handled by the presenter to `object`.
+    def method_missing(meth, *args, &block)
+      if respond_to?(meth)
+        object.__send__(meth, *args, &block)
+      else
+        super
+      end
+    end
+
+    # Returns true if either `object` or `self` responds to the given method
+    # name.
+    #
+    # @param method [Symbol] Name of the method
+    # @param include_private [Boolean] Whether to include private methods
+    # @return [Boolean] result
+    def respond_to?(method, include_private = false)
+      super || object.respond_to?(method, include_private)
+    end
+
+    # Returns true if `klass` is the class of `object` or the presenter, or
+    # if `#class` is one of the superclasses of `object`, the presenter or
+    # modules included in `object` or the presenter.
+    #
+    # @param other [Module]
+    # @return [Boolean] result
+    def kind_of?(other)
+      super || object.kind_of?(other)
+    end
+
+    alias :is_a? :kind_of?
+
+    # Returns `true` if `object` or the presenter is an instance of the given
+    # `class`.
+    #
+    # @param klass [Class]
+    # @return [Boolean] result
+    def instance_of?(klass)
+      super || object.instance_of?(klass)
+    end
+
+    # Returns `true` if `object` or the presenter tests positive for equality.
+    #
+    # @param other [Object]
+    # @return [Boolean] result
+    def ==(other)
+      super || object == other
+    end
+  end
+end

data/lib/oprah/railtie.rb

@@ -0,0 +1,17 @@
+require 'rails/railtie'
+
+module Oprah
+  class Railtie < Rails::Railtie
+    initializer "oprah.configure_cache_clear_on_code_reload" do
+      ActiveSupport::Reloader.to_run do
+        Oprah::Presenter.cache.clear!
+      end
+    end
+
+    initializer "oprah.configure_action_controller_helpers" do
+      ActiveSupport.on_load :action_controller do
+        ActionController::Base.include(Oprah::ControllerHelpers)
+      end
+    end
+  end
+end

data/lib/oprah/version.rb

@@ -0,0 +1,4 @@
+module Oprah
+  # @return [String] The Oprah library version.
+  VERSION = "0.1.1"
+end

data/lib/oprah.rb

@@ -0,0 +1,43 @@
+# stdlib
+require 'singleton'
+
+# gems
+require 'active_support/concern'
+require 'active_support/inflector'
+require 'action_controller'
+
+# internal
+require 'oprah/cache'
+require 'oprah/controller_helpers'
+require 'oprah/presenter'
+require 'oprah/version'
+
+require 'oprah/railtie' if defined?(Rails)
+
+# The Oprah namespace.
+module Oprah
+  # @!visibility private
+  def debug?
+    !!ENV["OPRAH_DEBUG"]
+  end
+
+  # Shortcut to {Oprah::Presenter#present}.
+  #
+  # @param object [Object] The object to present
+  # @param view_context [ActionView::Context] View context to assign
+  # @return [Presenter] Presented object
+  def present(object, view_context: Presenter.default_view_context)
+    Presenter.present(object, view_context: view_context)
+  end
+
+  # Shortcut to {Presenter#present_many}.
+  #
+  # @param objects [Enumerable] The objects to present
+  # @param view_context [ActionView::Context] View context to assign
+  # @return [Enumerable] Presented collection
+  def present_many(objects, view_context: Presenter.default_view_context)
+    Presenter.present_many(objects, view_context: view_context)
+  end
+
+  extend self
+end

data/oprah.gemspec

@@ -0,0 +1,31 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'oprah/version'
+
+Gem::Specification.new do |gem|
+  gem.name          = "oprah"
+  gem.version       = Oprah::VERSION
+  gem.authors       = ["Tobias Svensson"]
+  gem.email         = ["tob@tobiassvensson.co.uk"]
+  gem.summary       = "Opinionated presenters for Rails 5 - without the cruft"
+  gem.description   = gem.summary
+  gem.homepage      = "https://github.com/endofunky/oprah"
+  gem.license       = "Apache License, Version 2.0"
+
+  gem.files         = `git ls-files -z`.split("\x0")
+  gem.executables   = gem.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.require_paths = ["lib"]
+
+  gem.has_rdoc = 'yard'
+
+  gem.add_dependency "activesupport", ">= 5.0.0"
+  gem.add_dependency "actionpack", ">= 5.0.0"
+
+  gem.add_development_dependency "yard", "~> 0.9.5"
+  gem.add_development_dependency "redcarpet", "~> 3.3.4"
+  gem.add_development_dependency "bundler", "~> 1.7"
+  gem.add_development_dependency "rake", "~> 10.0"
+  gem.add_development_dependency "minitest", "~> 5.5.1"
+end

data/tasks/bundler.rb

@@ -0,0 +1,5 @@
+require 'bundler/gem_helper'
+
+namespace :gem do
+  Bundler::GemHelper.install_tasks name: 'oprah'
+end

data/tasks/console.rb

@@ -0,0 +1,35 @@
+class RakeConsole
+  GEM = Dir["*.gemspec"].first.sub('.gemspec', '')
+  REQUIRE_PATH = File.join(Dir.pwd, 'lib', GEM)
+
+  module Helpers
+    def reload!
+      puts "Reloading..."
+      $LOADED_FEATURES.select do |feat|
+        feat =~ /\/#{GEM}\//
+      end.each { |file| load file }
+      true
+    end
+  end
+
+  def start
+    require REQUIRE_PATH
+    ARGV.clear
+    Object.include(Helpers)
+
+    begin
+      require 'pry'
+      TOPLEVEL_BINDING.pry
+    rescue LoadError
+      require 'irb'
+      require 'irb/completion'
+      IRB.start
+    end
+  end
+end
+
+desc "Start development console"
+task :console do
+  RakeConsole.new.start
+end
+

data/tasks/minitest.rb

@@ -0,0 +1,8 @@
+require 'rake/testtask'
+
+Rake::TestTask.new do |t|
+  t.libs << "test"
+  t.test_files = FileList['test/**/*_test.rb']
+  t.verbose = false
+end
+

data/tasks/yard.rb

@@ -0,0 +1,16 @@
+require 'yard'
+require 'yard/rake/yardoc_task'
+
+YARD::Rake::YardocTask.new(:doc) do |t|
+  t.files   = ['lib/**/*.rb']
+  t.options = %w{
+    --verbose
+    --markup markdown
+    --readme README.md
+    --tag comment
+    --hide-tag comment
+    --hide-void-return
+    -M
+    redcarpet
+  }
+end

data/test/helper.rb

@@ -0,0 +1,63 @@
+require 'minitest/autorun'
+require 'minitest/pride'
+require 'oprah'
+
+module Fixtures
+  module Entity
+  end
+
+  class EntityPresenter < Oprah::Presenter
+    def foo
+      "foo"
+    end
+  end
+
+  class User
+    include Entity
+
+    def first_name
+      "Foo"
+    end
+
+    def last_name
+      "Bar"
+    end
+
+    private
+
+    def password
+      "baz"
+    end
+  end
+
+  class UserPresenter < Oprah::Presenter
+    def name
+      [first_name, last_name].join(' ')
+    end
+
+    def foo
+      super + "bar"
+    end
+  end
+
+  class Comment
+  end
+
+  class CommentPresenter < Oprah::Presenter
+  end
+
+  class Project
+    def comments
+      Array.new(3) { Comment.new }
+    end
+
+    def owner
+      User.new
+    end
+  end
+
+  class ProjectPresenter < Oprah::Presenter
+    presents_many :comments
+    presents_one :owner
+  end
+end

data/test/oprah/controller_helpers_test.rb

@@ -0,0 +1,65 @@
+require 'helper'
+
+module Oprah
+  class ControllerHelpersTest < Minitest::Test
+    class Controller
+      @@helper_methods = []
+
+      class << self
+        def helper_methods
+          @@helper_methods
+        end
+
+        def helper_method(method)
+          @@helper_methods << method
+        end
+      end
+
+      def view_context
+        :ok
+      end
+
+      include Oprah::ControllerHelpers
+    end
+
+    include Fixtures
+
+    def setup
+      super
+      @controller = Controller.new
+    end
+
+    def test_present
+      presenter = @controller.present(User.new)
+
+      assert_kind_of UserPresenter, presenter
+      assert_kind_of EntityPresenter, presenter
+
+      assert_equal :ok, presenter.view_context
+    end
+
+    def test_present
+      presenters = @controller.present_many([User.new, User.new])
+
+      assert_equal 2, presenters.length
+
+      presenters.each do |presenter|
+        assert_equal "Foo Bar", presenter.name
+        assert_equal :ok, presenter.view_context
+      end
+    end
+
+    def test_present_custom_view_context
+      presenter = @controller.present(User.new, view_context: :foobar)
+      assert_equal :foobar, presenter.view_context
+    end
+
+    def test_helper_method
+      assert_equal [:present, :present_many], Controller.helper_methods
+    end
+
+    def test_oprah_view_context
+      assert_equal @controller.oprah_view_context, @controller.view_context
+    end
+  end
+end

data/test/oprah/oprah_test.rb

@@ -0,0 +1,17 @@
+require 'helper'
+
+module Oprah
+  class Test < Minitest::Test
+    def test_debug
+      old = ENV["OPRAH_DEBUG"]
+
+      ENV["OPRAH_DEBUG"] = nil
+      refute Oprah.debug?
+
+      ENV["OPRAH_DEBUG"] = "1"
+      assert Oprah.debug?
+
+      ENV["OPRAH_DEBUG"] = old
+    end
+  end
+end

data/test/oprah/presenter_test.rb

@@ -0,0 +1,107 @@
+require 'helper'
+
+module Oprah
+  class PresenterTest < Minitest::Test
+    include Fixtures
+
+    def test_cache
+      assert_kind_of Oprah::Cache, Presenter.cache
+      assert_equal Presenter.cache, Presenter.cache
+      assert_equal UserPresenter.cache, Presenter.cache
+    end
+
+    def test_present_many
+      present_many([User.new, User.new]).each do |presenter|
+        assert_equal "Foo Bar", presenter.name
+      end
+    end
+
+    def test_presents_many
+      project = present(Project.new)
+
+      assert_equal 3, project.comments.length
+
+      project.comments.each do |comment|
+        assert_kind_of Comment, comment
+        assert_kind_of CommentPresenter, comment
+      end
+    end
+
+    def test_presents_one
+      project = present(Project.new)
+      owner = project.owner
+
+      assert_kind_of UserPresenter, owner
+      assert_kind_of User, owner
+    end
+
+    def test_presenter_stack_ordering
+      assert_equal "foobar", present(User.new).foo
+    end
+
+    def test_default_view_context_using_present
+      presenter = Presenter.present(User.new)
+      assert_kind_of ActionView::Context, presenter.view_context
+    end
+
+    def test_default_view_context_using_initialize
+      presenter = UserPresenter.new(User.new)
+      assert_kind_of ActionView::Context, presenter.view_context
+    end
+
+    def test_method_missing_delegation
+      assert_equal "Foo Bar", present(User.new).name
+      assert_equal "Foo", present(User.new).first_name
+      assert_equal "Bar", present(User.new).last_name
+    end
+
+    def test_method_missing_wont_delegate_to_private_methods
+      assert_raises NoMethodError do
+        present(User.new).password
+      end
+    end
+
+    def test_kind_of?
+      presenter = present(User.new)
+
+      assert_kind_of User, presenter
+      assert_kind_of UserPresenter, presenter
+      assert_kind_of Entity, presenter
+      assert_kind_of EntityPresenter, presenter
+      refute_kind_of self.class, presenter
+    end
+
+    def test_instance_of?
+      presenter = present(User.new)
+
+      assert_instance_of User, presenter
+      assert_instance_of UserPresenter, presenter
+      refute_instance_of Entity, presenter
+      assert_instance_of EntityPresenter, presenter
+      refute_instance_of self.class, presenter
+    end
+
+    def test_equality
+      project = Project.new
+      project_presenter = Project.new
+
+      user = User.new
+      user_presenter = present(user)
+
+      assert_equal user_presenter, user
+      assert_equal user_presenter, user_presenter
+      refute_equal user_presenter, project
+      refute_equal user_presenter, project_presenter
+    end
+
+    private
+
+    def present_many(*args, &block)
+      Oprah.present_many(*args, &block)
+    end
+
+    def present(*args, &block)
+      Oprah.present(*args, &block)
+    end
+  end
+end

metadata

@@ -0,0 +1,169 @@
+--- !ruby/object:Gem::Specification
+name: oprah
+version: !ruby/object:Gem::Version
+  version: 0.1.1
+platform: ruby
+authors:
+- Tobias Svensson
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2016-08-17 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 5.0.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 5.0.0
+- !ruby/object:Gem::Dependency
+  name: actionpack
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 5.0.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 5.0.0
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.9.5
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.9.5
+- !ruby/object:Gem::Dependency
+  name: redcarpet
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.3.4
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.3.4
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.7'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.7'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 5.5.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 5.5.1
+description: Opinionated presenters for Rails 5 - without the cruft
+email:
+- tob@tobiassvensson.co.uk
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".travis.yml"
+- CHANGELOG.md
+- CONTRIBUTING.md
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- lib/oprah.rb
+- lib/oprah/cache.rb
+- lib/oprah/controller_helpers.rb
+- lib/oprah/presenter.rb
+- lib/oprah/railtie.rb
+- lib/oprah/version.rb
+- oprah.gemspec
+- tasks/bundler.rb
+- tasks/console.rb
+- tasks/minitest.rb
+- tasks/yard.rb
+- test/helper.rb
+- test/oprah/controller_helpers_test.rb
+- test/oprah/oprah_test.rb
+- test/oprah/presenter_test.rb
+homepage: https://github.com/endofunky/oprah
+licenses:
+- Apache License, Version 2.0
+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.5.1
+signing_key: 
+specification_version: 4
+summary: Opinionated presenters for Rails 5 - without the cruft
+test_files:
+- test/helper.rb
+- test/oprah/controller_helpers_test.rb
+- test/oprah/oprah_test.rb
+- test/oprah/presenter_test.rb