gestart-showcase 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 2fd017b78a3588a69ad0bb67759b8ce42f54ceea685a568bf7f37fd74297a602
+  data.tar.gz: 284a480294e3603197899f9143f1414daeb94b0159a4d5bdccacb6139a69fbe6
+SHA512:
+  metadata.gz: 595db0c75c8855199d60a7bc6ca9a07cec8d6d96855f93fea7d540ea19f7b524ed5cc83c0a7339951a5d1f12fd3dc8e9a53d23df676f00f2ee4026e162a4885e
+  data.tar.gz: b393e943f26c68e32d1703c3e71c5000c5e617f3bc1d55d3664fc98056b8655179a1a5e6a19cdd0f34e7e9819fe9cb009c5a5a92116751faa8b08773955d3e10

data/.github/workflows/ci.yml

@@ -0,0 +1,29 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+jobs:
+  rspec:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: '3.4.9'
+          bundler-cache: true
+      - run: bundle exec rspec
+
+  rspec-frozen:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: '3.4.9'
+          bundler-cache: true
+      - run: bundle exec rspec
+        env:
+          RUBYOPT: '--enable-frozen-string-literal'

data/.gitignore

@@ -0,0 +1,19 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+gemfiles/*.gemfile.lock
+

data/.rspec

@@ -0,0 +1,2 @@
+
+

data/.tool-versions

@@ -0,0 +1 @@
+ruby 3.4.9

data/CHANGELOG.md

@@ -0,0 +1,49 @@
+# v1.0.0 — the fork
+
+Gestart fork of [`showcase`](https://github.com/welaika/showcase) 0.2.5, the last
+upstream release, dated 16/03/2014.
+
+**Why.** `Showcase::Presenter` sits under roughly 430 call sites in Gestart, and
+it arrived as a dependency of `admino` rather than as a choice. Once admino was
+forked, this was the last third-party code left in the rendering path of every
+index page and every presenter. Rewriting it was rejected: the presenter is
+already a `SimpleDelegator`, but one that overrides `class`, `kind_of?`, `is_a?`
+and `instance_of?` so they answer as the record does — `form_for`, `render`,
+`polymorphic_path` and `dom_id` all lean on that, and no test covers it.
+
+The full decision lives in the application repo: `docs/decisioni/admino.md`.
+
+**What changed from 0.2.5.**
+
+* Pruned what Gestart never calls: the `LinkTo`, `Seo` and `Share` traits, the
+  `SeoMetaBuilder` and `FirstNonblank` helpers, `Traits::Base` (which only those
+  traits used) and the presenter generator. Their specs went with them.
+* `Traits::Record` **stays whole**, `box` included. It was listed as dead and it
+  is not: `dom_id` reaches the rendered page through admino's table presenter,
+  which asks `resource.respond_to?(:dom_id)` and, when it does, writes an `id` on
+  every row. Removing it would have silently dropped `id="tool_1"` from every
+  index table.
+* `traits/record.rb` now requires `ConfigObject` and `HtmlOptions` explicitly.
+  Upstream got them for free because `link_to.rb` required them first; with that
+  file gone, the constants stopped loading.
+* Suite runnable on Ruby 3.4 and Rails 8.1: `RailsViewContext` is built with an
+  explicit lookup context, `RSpecHtmlMatchers` is included explicitly, and
+  `appraisal`, `coveralls` and the Rails 3.2/4 gemfiles are gone.
+
+**Maintenance.** This fork gets repaired, not extended: it is fixed when Rails
+breaks it, and nothing more.
+
+---
+
+# Version 0.2.5
+
+* Smarter HtmlOptions (extracted CSS class logic to HtmlClassAttribute)
+
+# Version 0.2.4
+
+* Added missing ActiveSupport requires
+
+# Version 0.2.3
+
+* Fix missing namespace in HtmlOptions and FirstNonblank helpers
+

data/Gemfile

@@ -0,0 +1,3 @@
+source 'https://rubygems.org'
+
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2013 Stefano Verna
+
+MIT License
+
+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,179 @@
+# gestart-showcase
+
+A simple but powerful exhibit/presenter implementation.
+
+> **This is a maintenance fork.** `gestart-showcase` is Gestart's fork of
+> [`showcase`](https://github.com/welaika/showcase) 0.2.5, whose last upstream
+> release is dated 16/03/2014. It exists because the presenter layer sits under
+> roughly 430 call sites in Gestart, and upstream will get no further fixes.
+>
+> **It gets repaired, not extended.** It is fixed when Rails breaks it, and
+> nothing more.
+>
+> Compared to upstream: the namespace is `GestartShowcase::`, and the `LinkTo`,
+> `Seo` and `Share` traits, the `SeoMetaBuilder` and `FirstNonblank` helpers and
+> the presenter generator are gone — Gestart never called them. `Traits::Record`
+> stays, `box` included. See [`CHANGELOG.md`](CHANGELOG.md).
+
+## Why should I use presenters in my Rails app?
+
+See [Avdi's Exhibits introductory post](http://devblog.avdi.org/2012/06/04/displaycase-gem-now-available/).
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'gestart-showcase'
+```
+
+And then execute:
+
+```
+$ bundle
+```
+
+Or install it yourself as:
+
+```
+$ gem install gestart-showcase
+```
+
+## Usage
+
+With Rails, you're already set, move on! With Padrino, include `GestartShowcase::Helpers::Present`
+in your app `helpers` block.
+
+```ruby
+helpers do
+  include GestartShowcase::Helpers::Present
+end
+```
+
+You can now instantiate new presenters in your controller/views using the
+included helpers:
+
+```ruby
+# this is the object that needs to be presented
+person = Person.new
+
+# automatically infers presenter class to use based on person's class name
+present(person) # => returns a PersonPresenter instance
+
+# you can also explicitly tell what presenter to use
+present(person, AdminPresenter) # => returns an AdminPresenter instance
+
+# explicit presenter and context
+present(person, PersonPresenter, context)
+
+# maps each person in the collection with a presenter
+present_collection([person]) # => returns an array of PersonPresenters
+```
+
+Define your presenters i.e. in a `app/presenters` folder:
+
+```ruby
+class ProjectPresenter < GestartShowcase::Presenter
+  # automatically wraps the attribute into a PersonPresenter
+  presents :person
+
+  # automatically wraps the attribute into an AdminPresenter
+  presents :person, with: AdminPresenter
+
+  # expects project.task to return an enumerable. automatically wraps each task
+  # in a TaskPresenter presenter
+  presents_collection :tasks
+
+  # you can use `view_context`, or the shortcut `h`, to access the context.
+  # `object` refers to the object being presented
+  def title
+    h.link_to object.title, object
+  end
+end
+```
+
+## Rails
+
+### Traits
+
+Please [read the tests](https://github.com/gestartcloudsrl/gestart-showcase/tree/main/lib/gestart_showcase/traits)
+for a detailed explanation of each method available.
+
+#### `GestartShowcase::Traits::Record`
+
+To be used to present ActiveModel-based records. Inside your presenter, include
+the trait like this:
+
+```ruby
+class ProjectPresenter < GestartShowcase::Presenter
+  include GestartShowcase::Traits::Record
+end
+```
+
+##### `#dom_id`
+
+```ruby
+present(@project).dom_id # => "project_12"
+```
+
+##### `#dom_class`
+
+```ruby
+present(@project).dom_class # => "project"
+```
+
+##### `#box`
+
+Super useful in acceptance testing to check the presence of a record inside a
+view:
+
+```erb
+<% present(@project).box(class: 'big') do %>
+  <p>Hi there!</p>
+<% end %>
+```
+
+Produces the following:
+
+```html
+<div class="project big" id="project_12">
+  <p>Hi there</p>
+</div>
+```
+
+Additional HTML attributes can be optionally specified within a config block
+inside the presenter:
+
+```ruby
+class ProjectPresenter < GestartShowcase::Presenter
+  include GestartShowcase::Traits::Record
+
+  box do |c|
+    c.html_options class: 'another-class', role: 'project'
+  end
+end
+```
+
+## Testing
+
+Install gems:
+
+```
+$ bundle
+$ rake appraisal:install
+```
+
+Launch tests:
+
+```
+rake appraisal
+```
+
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/Rakefile

@@ -0,0 +1,14 @@
+require 'rubygems'
+require 'bundler/setup'
+require 'appraisal'
+
+desc 'Default: run specs'
+task default: :spec
+
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new do |t|
+  t.pattern = "spec/**/*_spec.rb"
+end
+
+Bundler::GemHelper.install_tasks
+

data/gestart-showcase.gemspec

@@ -0,0 +1,29 @@
+# -*- encoding: utf-8 -*-
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'gestart_showcase/version'
+
+Gem::Specification.new do |gem|
+  gem.name          = 'gestart-showcase'
+  gem.version       = GestartShowcase::VERSION
+  gem.authors       = ['Gestart Cloud S.r.l.', 'Stefano Verna']
+  gem.email         = ['dev@gestart.net']
+  gem.description   = %q{Gestart fork of showcase 0.2.5, pruned of what Gestart does not use}
+  gem.summary       = %q{Gestart fork of showcase: the presenter layer behind every Gestart view}
+  gem.homepage      = 'https://github.com/gestartcloudsrl/gestart-showcase'
+  gem.license       = 'MIT'
+
+  gem.files         = `git ls-files`.split($/)
+  gem.executables   = gem.files.grep(%r{^bin/}).map { |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.require_paths = ['lib']
+
+  gem.required_ruby_version = '>= 3.1'
+
+  gem.add_dependency 'activesupport'
+
+  gem.add_development_dependency 'rspec'
+  gem.add_development_dependency 'rails'
+  gem.add_development_dependency 'rspec-html-matchers'
+  gem.add_development_dependency 'ostruct'
+end

data/lib/gestart-showcase.rb

@@ -0,0 +1 @@
+require 'gestart_showcase'

data/lib/gestart_showcase/errors.rb

@@ -0,0 +1,5 @@
+module GestartShowcase
+  class PresenterClassNotFound < RuntimeError
+  end
+end
+

data/lib/gestart_showcase/helpers/config_object.rb

@@ -0,0 +1,28 @@
+require 'ostruct'
+
+module GestartShowcase
+  module Helpers
+    class ConfigObject
+      def initialize(context, &block)
+        @config_block = block
+        @context = context
+      end
+
+      def to_struct
+        OpenStruct.new(to_hash)
+      end
+
+      def to_hash
+        @result = {}
+        @context.instance_exec(self, &@config_block)
+        @result.symbolize_keys
+      end
+
+      def method_missing(name, *args, &block)
+        name = name.to_s.gsub(/=$/, '')
+        @result[name.to_sym] = args.first
+      end
+    end
+  end
+end
+

data/lib/gestart_showcase/helpers/html_class_attribute.rb

@@ -0,0 +1,23 @@
+module GestartShowcase
+  module Helpers
+    class HtmlClassAttribute
+      def initialize(value = nil)
+        @css_classes = value.to_s.strip.split(/\s+/)
+      end
+
+      def <<(value)
+        value = value.to_s.strip.split(/\s+/)
+        @css_classes += value
+      end
+
+      def to_html_attribute
+        if @css_classes.any?
+          @css_classes.uniq.join(' ')
+        else
+          nil
+        end
+      end
+    end
+  end
+end
+

data/lib/gestart_showcase/helpers/html_options.rb

@@ -0,0 +1,32 @@
+require 'gestart_showcase/helpers/html_class_attribute'
+
+module GestartShowcase
+  module Helpers
+    class HtmlOptions
+      def initialize(options = {})
+        @options = (options || {}).symbolize_keys
+      end
+
+      def add_class!(css_class)
+        merge_attrs!(class: css_class)
+      end
+
+      def merge_attrs!(options = {})
+        new_options = (options || {}).symbolize_keys
+
+        if new_options[:class]
+          class_attr = HtmlClassAttribute.new(@options[:class])
+          class_attr << new_options[:class]
+          new_options[:class] = class_attr.to_html_attribute
+        end
+
+        @options.merge!(new_options)
+      end
+
+      def to_h
+        @options.dup
+      end
+    end
+  end
+end
+

data/lib/gestart_showcase/helpers/module_method_builder.rb

@@ -0,0 +1,21 @@
+require 'active_support/core_ext/object/blank'
+
+module GestartShowcase
+  module Helpers
+    module ModuleMethodBuilder
+      def define_module_method(name_chunks, &block)
+        method_name = Array(name_chunks).map(&:to_s).map(&:presence).compact.join("_")
+        if method_defined?(method_name)
+          false
+        else
+          method_module = Module.new do
+            define_method(method_name, &block)
+          end
+          include(method_module)
+          true
+        end
+      end
+    end
+  end
+end
+

data/lib/gestart_showcase/helpers/present.rb

@@ -0,0 +1,50 @@
+require 'active_support/concern'
+require 'active_support/inflector'
+require 'active_support/core_ext/hash/keys'
+
+require 'gestart_showcase/errors'
+
+module GestartShowcase
+  module Helpers
+    module Present
+      extend ActiveSupport::Concern
+
+      def presenter_context
+        if respond_to? :view_context
+          view_context
+        else
+          self
+        end
+      end
+
+      def present(obj, klass = nil, context = presenter_context, options = {})
+        options.assert_valid_keys(:nil_presenter)
+
+        if obj || options.fetch(:nil_presenter, false)
+          klass ||= presenter_class(obj)
+          if klass.nil?
+            raise GestartShowcase::PresenterClassNotFound, "Unable to guess a presenter class for #{obj.inspect}!"
+          end
+          klass.new(obj, context)
+        else
+          nil
+        end
+      end
+
+      def present_collection(obj, klass = nil, context = presenter_context, options = {})
+        obj.map { |o| present(o, klass, context, options) }
+      end
+
+      private
+
+      def presenter_class(obj)
+        (obj.class.ancestors - obj.class.included_modules).each do |k|
+          klass = "#{k.name}Presenter".safe_constantize
+          return klass if klass
+        end
+        nil
+      end
+    end
+  end
+end
+

data/lib/gestart_showcase/presenter.rb

@@ -0,0 +1,64 @@
+require 'delegate'
+require 'gestart_showcase/helpers/present'
+require 'gestart_showcase/helpers/module_method_builder'
+require 'active_support/core_ext/array/extract_options'
+require 'active_support/core_ext/hash/keys'
+
+module GestartShowcase
+  class Presenter < SimpleDelegator
+    include Helpers::Present
+    extend Helpers::ModuleMethodBuilder
+
+    attr_reader :view_context
+
+    alias_method :object, :__getobj__
+    alias_method :h, :view_context
+    alias_method :try, :__send__
+    alias_method :__decorator_class__, :class
+
+    def initialize(obj, context)
+      super(obj)
+      @view_context = context
+    end
+
+    def class
+      object.class
+    end
+
+    def kind_of?(klass)
+      object.kind_of?(klass)
+    end
+    alias_method :is_a?, :kind_of?
+
+    def instance_of?(klass)
+      object.instance_of?(klass)
+    end
+
+    def self.presents(*args)
+      wrap_methods(args, :present)
+    end
+
+    def self.presents_collection(*args)
+      wrap_methods(args, :present_collection)
+    end
+
+    private
+
+    def self.wrap_methods(args, method)
+      options = args.extract_options!
+      options.assert_valid_keys(:with, :nil_presenter)
+      presenter_klass = options.fetch(:with, nil)
+
+      args.each do |attr|
+        define_module_method attr do
+          send(method,
+               object.send(attr),
+               presenter_klass,
+               view_context,
+               options.slice(:nil_presenter))
+        end
+      end
+    end
+  end
+end
+

data/lib/gestart_showcase/railtie.rb

@@ -0,0 +1,12 @@
+require 'gestart_showcase/traits'
+
+module GestartShowcase
+  class Railtie < Rails::Railtie
+    initializer "action_view.initialize_showcase" do
+      ActiveSupport.on_load(:action_view) do
+        ActionView::Base.send :include, GestartShowcase::Helpers::Present
+      end
+    end
+  end
+end
+

data/lib/gestart_showcase/traits/record.rb

@@ -0,0 +1,64 @@
+require 'gestart_showcase/helpers/config_object'
+require 'gestart_showcase/helpers/html_options'
+
+module GestartShowcase
+  module Traits
+
+    module Record
+      extend ActiveSupport::Concern
+
+      module ClassMethods
+        def box(&block)
+          @box_config_block = block
+        end
+
+        def __box_config_block__
+          @box_config_block
+        end
+      end
+
+      def dom_id
+        record_identifier.dom_id(self)
+      end
+
+      def dom_class
+        record_identifier.dom_class(self)
+      end
+
+      def box(*args, &block)
+        options = args.extract_options!
+        tag = args.pop || :div
+
+        config_block = self.__decorator_class__.__box_config_block__
+        config_options = if config_block
+                           Helpers::ConfigObject.new(self, &config_block).to_struct.html_options
+                         else
+                           {}
+                         end
+
+        html_options = Helpers::HtmlOptions.new(config_options)
+        html_options.merge_attrs!(options)
+        html_options.add_class!(dom_class)
+        html_options.merge_attrs!(id: dom_id)
+
+        h.content_tag(tag, html_options.to_h) do
+          h.capture(self, &block)
+        end
+      end
+
+      private
+
+      def record_identifier
+        if defined?(ActionView::RecordIdentifier)
+          ActionView::RecordIdentifier
+        elsif defined?(ActionController::RecordIdentifier)
+          ActionController::RecordIdentifier
+        else
+          raise 'No RecordIdentifier found!'
+        end
+      end
+    end
+
+  end
+end
+

data/lib/gestart_showcase/traits.rb

@@ -0,0 +1,6 @@
+require 'gestart_showcase/traits/record'
+
+module GestartShowcase
+  module Traits
+  end
+end

data/lib/gestart_showcase/version.rb

@@ -0,0 +1,4 @@
+module GestartShowcase
+  VERSION = "1.0.0"
+end
+

data/lib/gestart_showcase.rb

@@ -0,0 +1,7 @@
+require 'gestart_showcase/version'
+require 'gestart_showcase/presenter'
+require 'gestart_showcase/railtie' if defined?(Rails)
+
+module GestartShowcase
+end
+

data/spec/fixtures.rb

@@ -0,0 +1,112 @@
+class RailsViewContext < ActionView::Base
+  include ActionView::Helpers::TagHelper
+
+  def initialize(*)
+    super(ActionView::LookupContext.new([]), {}, nil)
+  end
+
+  def capture(*args, &block)
+    block.call(*args)
+  end
+end
+
+class Model
+  extend ActiveModel::Naming
+
+  def to_key
+    Array('1')
+  end
+end
+
+class Person < Struct.new(:name)
+end
+
+class Customer < Person
+end
+
+class EnterpriseCustomer < Customer
+end
+
+class Project < Struct.new(:name)
+  def owner
+    Person.new("Stefano Verna")
+  end
+
+  def collaborators
+    [ Person.new("Ju Liu") ]
+  end
+
+  def first_collaborator
+    collaborators.first
+  end
+
+  def owner_child
+  end
+
+  def foobar
+  end
+
+  def dummy
+    "foobar"
+  end
+end
+
+class PersonPresenter < GestartShowcase::Presenter
+  def sex
+    'male'
+  end
+
+  def bold_name
+    h.bold(object.name)
+  end
+end
+
+class AdminPresenter < PersonPresenter
+  def bold_name
+    h.bold("Admin #{object.name}")
+  end
+end
+
+class ProjectPresenter < GestartShowcase::Presenter
+  presents :owner, with: AdminPresenter
+  presents_collection :collaborators
+  presents :owner_child
+  presents :foobar, nil_presenter: true
+
+  def name
+    "Presented #{object.name}"
+  end
+
+  def owner
+    super
+  end
+
+  def bold_name
+    h.bold(object.name)
+  end
+
+  def first_collaborator
+    present(object.first_collaborator)
+  end
+end
+
+class NilClassPresenter < GestartShowcase::Presenter
+  def hi
+    "hi!"
+  end
+end
+
+class Context
+  include GestartShowcase::Helpers::Present
+
+  def bold(text)
+    "**#{text}**"
+  end
+end
+
+class Shop
+  def owner
+    Person.new("Stefano Verna")
+  end
+end
+

data/spec/gestart_showcase/helpers/html_class_attribute_spec.rb

@@ -0,0 +1,83 @@
+require 'spec_helper'
+
+module GestartShowcase
+  module Helpers
+    describe HtmlClassAttribute do
+      let(:attribute) { HtmlClassAttribute.new(string) }
+      let(:string) { nil }
+
+      describe '.to_html_attribute' do
+        subject { attribute.to_html_attribute }
+
+        context 'nil' do
+          let(:string) { nil }
+          it { should be_nil }
+        end
+
+        context 'empty' do
+          let(:string) { '' }
+          it { should be_nil }
+        end
+
+        context 'whitespaces only' do
+          let(:string) { '  ' }
+          it { should be_nil }
+        end
+
+        context 'with trailing spaces' do
+          let(:string) { '  foo  ' }
+          it { should eq 'foo' }
+        end
+
+        context 'with multiple classes' do
+          let(:string) { '  foo bar ' }
+          it { should eq 'foo bar' }
+        end
+      end
+
+      describe '#<<' do
+        before do
+          attribute << addition
+        end
+
+        subject { attribute.to_html_attribute }
+
+        context 'with no existing class attribute' do
+          let(:string) { nil }
+          let(:addition) { '  foo  ' }
+
+          it { should eq 'foo' }
+        end
+
+        context 'with empty class attribute' do
+          let(:string) { '' }
+          let(:addition) { 'foo' }
+
+          it { should eq 'foo' }
+        end
+
+        context 'with existing class attribute' do
+          let(:string) { 'bar' }
+          let(:addition) { 'foo' }
+
+          it { should eq 'bar foo' }
+        end
+
+        context 'with the same css class' do
+          let(:string) { 'foo bar' }
+          let(:addition) { 'foo' }
+
+          it { should eq 'foo bar' }
+        end
+
+        context 'multiple additions' do
+          let(:string) { 'foo bar' }
+          let(:addition) { 'foo qux' }
+
+          it { should eq 'foo bar qux' }
+        end
+      end
+    end
+  end
+end
+

data/spec/gestart_showcase/helpers/html_options_spec.rb

@@ -0,0 +1,37 @@
+require 'spec_helper'
+
+module GestartShowcase
+  module Helpers
+    describe HtmlOptions do
+      let(:options) { HtmlOptions.new(attributes) }
+      let(:attributes) { {} }
+
+      it 'takes a hash of attributes' do
+        expect(options.to_h).to eq attributes
+      end
+
+      describe '#merge_attrs!' do
+        let(:attributes) { { 'id' => 'bar', 'data-alert' => 'true' } }
+
+        it 'merges attributes with the passed ones' do
+          options.merge_attrs!('data-method' => 'post', 'id' => 'foo')
+          expect(options.to_h).to eq({
+            :'data-alert' => 'true',
+            :'data-method' => 'post',
+            :'id' => 'foo'
+          })
+        end
+
+        context 'css classes' do
+          let(:attributes) { { 'class' => 'foo bar' } }
+
+          it 'merges them appropriately' do
+            options.merge_attrs!('class' => 'foo qux')
+            expect(options.to_h).to eq(class: 'foo bar qux')
+          end
+        end
+      end
+    end
+  end
+end
+

data/spec/gestart_showcase/helpers/present_spec.rb

@@ -0,0 +1,53 @@
+require 'spec_helper'
+
+module GestartShowcase
+  module Helpers
+    describe Present do
+      let(:object) { Person.new('Steve Ballmer') }
+      let(:subclass_object) { EnterpriseCustomer.new('Tito Traves') }
+      let(:object_with_no_presenter) { Shop.new }
+      let(:context) { Context.new }
+
+      describe '.present' do
+        it 'instantiates a new presenter, inferring the presenter class' do
+          PersonPresenter.stub(:new).with(object, context).and_return 'Presenter'
+          context.present(object).should == 'Presenter'
+        end
+        context 'with a superclass presenter' do
+          it "instantiates a new presenter, searching presenter class in object ancestors chain" do
+            PersonPresenter.stub(:new).with(subclass_object, context).and_return 'Presenter'
+            context.present(subclass_object).should == 'Presenter'
+          end
+        end
+        context 'with no existing presenter class' do
+          it "raises a PresenterClassNotFound error" do
+            expect {
+              context.present(object_with_no_presenter)
+            }.to raise_error(GestartShowcase::PresenterClassNotFound)
+          end
+        end
+        it 'uses the specified presenter class, when passed' do
+          ProjectPresenter.stub(:new).with(object, context).and_return 'Presenter'
+          context.present(object, ProjectPresenter).should == 'Presenter'
+        end
+        it 'uses the specified context, when passed' do
+          different_context = double
+          context.present(object, ProjectPresenter, different_context).view_context.should == different_context
+        end
+      end
+
+      describe '.present_collection' do
+        it 'returns a presenter for each object in the collection' do
+          collection = [ Person.new('Mark'), Person.new('Luke') ]
+
+          PersonPresenter.stub(:new).with(collection[0], context).and_return 'foo'
+          PersonPresenter.stub(:new).with(collection[1], context).and_return 'bar'
+
+          presented_collection = context.present_collection(collection)
+          presented_collection.should == [ 'foo', 'bar' ]
+        end
+      end
+    end
+  end
+end
+

data/spec/gestart_showcase/presenter_spec.rb

@@ -0,0 +1,71 @@
+require 'spec_helper'
+
+describe GestartShowcase::Presenter do
+  let(:context) { Context.new }
+  let(:object) { Project.new('GestartShowcase') }
+  let(:subject) { ProjectPresenter.new(object, context) }
+
+  it 'takes the object and a context as parameters' do
+    subject.object.should == object
+    subject.view_context.should == context
+  end
+
+  it 'preserves original .class' do
+    subject.class.should == Project
+  end
+
+  it 'should be kind of original class' do
+    subject.should be_kind_of Project
+  end
+
+  it 'should be instance of original class' do
+    subject.should be_instance_of Project
+  end
+
+  it 'delegates methods to object' do
+    subject.dummy.should == 'foobar'
+  end
+
+  it 'allows overriding of methods' do
+    subject.name.should == 'Presented GestartShowcase'
+  end
+
+  it 'implements :try method the right way' do
+    subject.try(:name).should == 'Presented GestartShowcase'
+  end
+
+  it 'allows .h as shortcut to access the context' do
+    subject.bold_name.should == '**GestartShowcase**'
+  end
+
+  describe '.present' do
+    it 'passes the context' do
+      subject.first_collaborator.bold_name.should == '**Ju Liu**'
+    end
+  end
+
+  describe '#presents' do
+    it 'wraps the specified attributes inside a presenter' do
+      subject.owner.sex.should == 'male'
+    end
+    it 'passes the context' do
+      subject.owner.bold_name.should == '**Admin Stefano Verna**'
+    end
+    it 'returns null if nil_presenter is false or undefined' do
+      subject.owner_child.should be_nil
+    end
+    it 'returns a null presenter if nil_presenter is true' do
+      subject.foobar.hi.should eq "hi!"
+    end
+  end
+
+  describe '#presents_collection' do
+    it 'wraps the specified collection attributes inside a presenter' do
+      subject.collaborators.first.sex.should == 'male'
+    end
+    it 'passes the context' do
+      subject.collaborators.first.bold_name.should == '**Ju Liu**'
+    end
+  end
+end
+

data/spec/gestart_showcase/traits/record_spec.rb

@@ -0,0 +1,59 @@
+require 'spec_helper'
+
+module GestartShowcase::Traits
+  describe Record do
+
+    let(:view) { RailsViewContext.new }
+    let(:record) { Model.new }
+    let(:presenter) {
+      Class.new(GestartShowcase::Presenter) do
+        include Record
+
+        box do |c|
+          c.html_options role: 'actor', class: 'first'
+        end
+      end
+    }
+    subject { presenter.new(record, view) }
+
+    describe '#dom_id' do
+      it 'returns a CSS ID for the model' do
+        expect(subject.dom_id).to eq 'model_1'
+      end
+    end
+
+    describe '#dom_class' do
+      it 'returns a CSS class for model' do
+        expect(subject.dom_class).to eq 'model'
+      end
+    end
+
+    describe '#box' do
+      it 'wraps content inside an element that uniquely identifies the record' do
+        result = subject.box { "foo" }
+        expect(result).to have_tag(:div, with: { class: 'model', id: 'model_1' })
+      end
+
+      it 'adds attributes specified within box block' do
+        result = subject.box { "foo" }
+        expect(result).to have_tag(:div, with: { role: 'actor', class: 'first' })
+      end
+
+      context 'with a specified tag' do
+        it 'uses it' do
+          result = subject.box(:span) { "foo" }
+          expect(result).to have_tag(:span)
+        end
+      end
+
+      context 'with some class' do
+        it 'uses it' do
+          result = subject.box(class: 'bar') { "foo" }
+          expect(result).to have_tag(:div, with: { class: 'model bar'})
+        end
+      end
+    end
+
+  end
+end
+

data/spec/helpers/config_object_spec.rb

@@ -0,0 +1,45 @@
+require 'spec_helper'
+
+module GestartShowcase::Helpers
+  describe ConfigObject do
+
+    let(:context_class) {
+      Class.new do
+        def foo
+          'foo'
+        end
+
+        def bar
+          'bar'
+        end
+      end
+    }
+    let(:context) { context_class.new }
+
+    describe 'to_hash' do
+      it 'accepts attr=() notation' do
+        result = ConfigObject.new(context) do |c|
+          c.first = foo
+          c.second = bar
+          c.third = '3rd'
+        end.to_hash
+
+        hash = { first: 'foo', second: 'bar', third: '3rd' }
+        expect(result).to eq hash
+      end
+
+      it 'accepts attr() notation' do
+        result = ConfigObject.new(context) do |c|
+          c.first foo
+          c.second bar
+          c.third '3rd'
+        end.to_hash
+
+        hash = { first: 'foo', second: 'bar', third: '3rd' }
+        expect(result).to eq hash
+      end
+    end
+
+  end
+end
+

data/spec/spec_helper.rb

@@ -0,0 +1,12 @@
+require 'rspec-html-matchers'
+
+require 'rails'
+require 'gestart_showcase'
+require 'active_model'
+require 'action_view'
+
+require_relative './fixtures'
+
+RSpec.configure do |config|
+  config.include RSpecHtmlMatchers
+end

metadata

@@ -0,0 +1,150 @@
+--- !ruby/object:Gem::Specification
+name: gestart-showcase
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Gestart Cloud S.r.l.
+- Stefano Verna
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  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'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec-html-matchers
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: ostruct
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Gestart fork of showcase 0.2.5, pruned of what Gestart does not use
+email:
+- dev@gestart.net
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".github/workflows/ci.yml"
+- ".gitignore"
+- ".rspec"
+- ".tool-versions"
+- CHANGELOG.md
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- gestart-showcase.gemspec
+- lib/gestart-showcase.rb
+- lib/gestart_showcase.rb
+- lib/gestart_showcase/errors.rb
+- lib/gestart_showcase/helpers/config_object.rb
+- lib/gestart_showcase/helpers/html_class_attribute.rb
+- lib/gestart_showcase/helpers/html_options.rb
+- lib/gestart_showcase/helpers/module_method_builder.rb
+- lib/gestart_showcase/helpers/present.rb
+- lib/gestart_showcase/presenter.rb
+- lib/gestart_showcase/railtie.rb
+- lib/gestart_showcase/traits.rb
+- lib/gestart_showcase/traits/record.rb
+- lib/gestart_showcase/version.rb
+- spec/fixtures.rb
+- spec/gestart_showcase/helpers/html_class_attribute_spec.rb
+- spec/gestart_showcase/helpers/html_options_spec.rb
+- spec/gestart_showcase/helpers/present_spec.rb
+- spec/gestart_showcase/presenter_spec.rb
+- spec/gestart_showcase/traits/record_spec.rb
+- spec/helpers/config_object_spec.rb
+- spec/spec_helper.rb
+homepage: https://github.com/gestartcloudsrl/gestart-showcase
+licenses:
+- MIT
+metadata: {}
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.1'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.9
+specification_version: 4
+summary: 'Gestart fork of showcase: the presenter layer behind every Gestart view'
+test_files:
+- spec/fixtures.rb
+- spec/gestart_showcase/helpers/html_class_attribute_spec.rb
+- spec/gestart_showcase/helpers/html_options_spec.rb
+- spec/gestart_showcase/helpers/present_spec.rb
+- spec/gestart_showcase/presenter_spec.rb
+- spec/gestart_showcase/traits/record_spec.rb
+- spec/helpers/config_object_spec.rb
+- spec/spec_helper.rb