view_spec 0.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: db2b2ddc540389235a0c75db6bf93c85e65b854574623ea09b782e24d330d6ad
+  data.tar.gz: f7c9400e0487de9c32c2cd0fa345c4c29e6bdceae3143bdb310c0bd2568c0390
+SHA512:
+  metadata.gz: e8fe0a339f4f6e8b22c212f5f21d70c66bdedf8e1ffb1c56b03ce236025185a2b28a0cce1510fec59ceeab038550689016d998dce823af51d30b61d83c68f3f1
+  data.tar.gz: 6d720f348d61915a323f0217d30af8fa09cb633918a13d4480e65db52c1433dc37b552b5e3abc407eff994e464f5212e90a8d990389d34fb185fe0acea3ab315

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2021-present Mark Perkins
+
+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,51 @@
+# ViewSpec  
+
+ViewSpec lets you create example-led specifications for components, partials and views using an expressive Ruby DSL.
+
+Specs can then be used in your tests, to render previews for development and visual testing or to generate documentation.
+
+```rb
+# button_vspec.rb
+
+ViewSpec.spec ButtonComponent do
+  title "Button (ViewComponent)"
+
+  scenario "default" do
+    preview do
+      render ButtonComponent.new(text: "Button text")
+    end
+  end
+
+  scenario "editable params" do
+    param :text, :string, default: "Button text"
+    param :type, :symbol, default: :button
+
+    preview do
+      render ButtonComponent.new(**params)
+    end
+  end
+  
+  scenario "buttons galore" do
+    preview <<~ERB
+      <%= render ButtonComponent.new(text: "Button 1") %>
+      <%= render ButtonComponent.new(text: "Button 2") %>
+      <%= render ButtonComponent.new(text: "Button 3") %>
+      <%= render ButtonComponent.new(text: "Button 4") %>
+    ERB
+  end
+
+  group "themes" do
+    scenario "primary" do
+      preview { render ButtonComponent.new(text: "Primary", theme: :primary) }
+    end
+
+    scenario "secondary" do
+      preview { render ButtonComponent.new(text: "Secondary", theme: :secondary) }
+    end
+
+    scenario "danger" do
+      preview { render ButtonComponent.new(text: "Danger", theme: :danger) }
+    end
+  end
+end
+```

data/app/views/view_spec/_group.html.erb

@@ -0,0 +1,20 @@
+<%# locals: (group:) %>
+
+<section style="padding: 20px; border: 1px solid #ccc; margin-bottom: 20px;">
+  <header>
+    <h2><%= group.title %></h2>
+    <p>Short identifier: <%= group.short_identifier %></p>
+  </header>
+  <div style="padding-left: 0px;">
+    <h4>Preview:</h4>
+    <div style="padding: 20px; border: 2px dotted #bbb;">
+      <% group.scenarios.each do |scenario| %>
+        <%= scenario.render_preview(params: request.query_parameters) %>
+      <% end %>
+    </div>
+    <h4>Output:</h4>
+    <code>
+      <pre style="padding: 10px; background-color: #eee; display: block;"><% group.scenarios.each do |scenario| -%><%= scenario.render_output(params: request.query_parameters) + "\n" %><% end %></pre>
+    </code>
+  </div>
+</div>

data/app/views/view_spec/_scenario.html.erb

@@ -0,0 +1,17 @@
+<%# locals: (scenario:) %>
+
+<section style="padding: 20px; border: 1px solid #ccc; margin-bottom: 20px;">
+  <header>
+    <h2><%= scenario.title %></h2>
+    <p>Short identifier: <%= scenario.short_identifier %></p>
+  </header>
+
+  <h4>Preview:</h4>
+  <div style="padding: 20px; border: 2px dotted #bbb;">
+    <%= scenario.render_preview(params: request.query_parameters) %>
+  </div>
+  <h4>Output:</h4>
+  <code>
+    <pre style="padding: 10px; background-color: #eee; display: block;"><%= scenario.render_output(params: request.query_parameters) %></pre>
+  </code>
+</section>

data/app/views/view_spec/_spec.html.erb

@@ -0,0 +1,10 @@
+<%# locals: (spec:) %>
+
+<div>
+  <h1>Demo: <%= spec.title %></h1>
+  <p>Source path: <%= spec.source_file.app_path %></p>
+
+  <% spec.entries.each do |entry| %>
+    <%= render entry %>
+  <% end %>
+</div>

data/lib/view_spec/config.rb

@@ -0,0 +1,29 @@
+module ViewSpec
+  class Config
+    include Singleton
+
+    delegate_missing_to :config
+
+    def preview_controller
+      config.preview_controller.is_a?(String) ? config.preview_controller.constantize : config.preview_controller
+    end
+
+    class << self
+      def defaults
+        ActiveSupport::OrderedOptions.new.merge!({
+          spec_paths: ["#{Rails.root}/view_specs"],
+          spec_files: [],
+          spec_file_suffix: "_vspec",
+          preview_controller: "ApplicationController",
+          preview_layout: "application"
+        })
+      end
+    end
+
+    private
+
+    def config
+      @config ||= self.class.defaults
+    end
+  end
+end

data/lib/view_spec/dsl/context.rb

@@ -0,0 +1,54 @@
+module ViewSpec
+  module DSL
+    class Context
+      delegate :type, to: :class
+
+      def initialize(subject, lookup_attrs = {}, &block)
+        @subject = Subject.new(subject)
+        set_lookup_attrs(lookup_attrs.to_h)
+        @block = block
+
+        evaluate!
+      end
+
+      def entries
+        @entries ||= []
+      end
+
+      class << self
+        def type
+          @type ||= name.demodulize.underscore.to_sym
+        end
+
+        def lookup_attr(name)
+          lookup_attrs << name.to_sym
+        end
+
+        def lookup_attrs
+          @lookup_attrs ||= []
+        end
+      end
+
+      private
+
+      def lookup_attrs
+        self.class.lookup_attrs.map do |key|
+          [key, public_send(key)]
+        end.to_h
+      end
+
+      def set_lookup_attrs(values_hash)
+        values_hash.each do |key, value|
+          public_send(key, value) if respond_to?(key)
+        end
+      end
+
+      def evaluate!
+        return if @evaluated
+
+        instance_exec(&@block) if @block
+        @evaluated = true
+      end
+    end
+  end
+end

data/lib/view_spec/dsl/controller.rb

@@ -0,0 +1,17 @@
+module ViewSpec
+  module DSL
+    module Controller
+      extend ActiveSupport::Concern
+
+      included do
+        lookup_attr :controller
+      end
+
+      def controller(value = nil)
+        @controller = value unless value.nil?
+        controller = @controller || @outer_scope&.controller || ViewSpec.config.preview_controller
+        controller.is_a?(String) ? controller.camelize.constantize : controller
+      end
+    end
+  end
+end

data/lib/view_spec/dsl/groups.rb

@@ -0,0 +1,16 @@
+module ViewSpec
+  module DSL
+    module Groups
+      extend ActiveSupport::Concern
+
+      def groups
+        entries.filter { _1.is_a?(Group) }
+      end
+
+      def group(name, &block)
+        entries << Group.new(name, lookup_attrs, &block)
+        entries.last
+      end
+    end
+  end
+end

data/lib/view_spec/dsl/layout.rb

@@ -0,0 +1,16 @@
+module ViewSpec
+  module DSL
+    module Layout
+      extend ActiveSupport::Concern
+
+      included do
+        lookup_attr :layout
+      end
+
+      def layout(value = nil)
+        @layout = value unless value.nil?
+        @layout ||= ViewSpec.config.preview_layout
+      end
+    end
+  end
+end

data/lib/view_spec/dsl/params.rb

@@ -0,0 +1,36 @@
+module ViewSpec
+  module DSL
+    module Params
+      extend ActiveSupport::Concern
+
+      def param(name, cast_type = nil, **options)
+        param_definitions << {name:, cast_type:, options:}
+      end
+
+      def params
+        raise ":params cannot be accessed outside of the preview context"
+      end
+
+      def resolve_params(values_hash = {})
+        values_hash = values_hash.to_h.with_indifferent_access
+        param_set = ParamSet.new
+
+        param_definitions.each do |props|
+          value = values_hash[props[:name]]
+          param_set.add(props[:name], props[:cast_type], value:, **props[:options])
+        end
+
+        other_params = values_hash.reject { param_set.include?(_1) }
+        param_set.add(other_params)
+
+        param_set
+      end
+
+      private
+
+      def param_definitions
+        @param_definitions ||= []
+      end
+    end
+  end
+end

data/lib/view_spec/dsl/scenarios.rb

@@ -0,0 +1,22 @@
+module ViewSpec
+  module DSL
+    module Scenarios
+      extend ActiveSupport::Concern
+
+      def scenarios(include_grouped: false)
+        entries.map do |entry|
+          if entry.type == :scenario
+            entry
+          elsif include_grouped && entry.type == :group
+            entry.scenarios
+          end
+        end.compact.flatten
+      end
+
+      def scenario(name, &block)
+        entries << Scenario.new(name, lookup_attrs, &block)
+        entries.last
+      end
+    end
+  end
+end

data/lib/view_spec/dsl/title.rb

@@ -0,0 +1,12 @@
+module ViewSpec
+  module DSL
+    module Title
+      extend ActiveSupport::Concern
+
+      def title(value = nil)
+        @title = value unless value.nil?
+        @title ||= @subject&.to_title
+      end
+    end
+  end
+end

data/lib/view_spec/dsl.rb

@@ -0,0 +1,18 @@
+module ViewSpec
+  module DSL
+    extend ActiveSupport::Concern
+
+    class_methods do
+      def spec(subject, &block)
+        source_path = caller_locations(1..1).first.absolute_path
+        registry.add(source_path, subject, &block)
+      end
+
+      def registry
+        @registry ||= Registry.new
+      end
+
+      alias_method :specs, :registry
+    end
+  end
+end

data/lib/view_spec/engine.rb

@@ -0,0 +1,23 @@
+require "rails"
+
+module ViewSpec
+  class Engine < Rails::Engine
+    isolate_namespace ViewSpec
+
+    config.view_spec = ViewSpec.config
+
+    config.after_initialize do |app|
+      if !app.config.cache_classes
+        opts = config.view_spec
+        reloader = Reloader.new(opts.spec_files, opts.spec_paths) do
+          ViewSpec.load!
+        end
+
+        Rails.application.reloaders << reloader
+        reloader.execute
+      else
+        ViewSpec.load!
+      end
+    end
+  end
+end

data/lib/view_spec/error.rb

@@ -0,0 +1,4 @@
+module ViewSpec
+  class Error < StandardError
+  end
+end

data/lib/view_spec/group.rb

@@ -0,0 +1,24 @@
+module ViewSpec
+  class Group < DSL::Context
+    include DSL::Title
+    include DSL::Layout
+    include DSL::Scenarios
+    include DSL::Controller
+
+    def short_identifier
+      @subject.to_short_identifier
+    end
+
+    def spec
+      @outer_scope
+    end
+
+    def to_param
+      short_identifier
+    end
+
+    def to_partial_path
+      "view_spec/group"
+    end
+  end
+end

data/lib/view_spec/helpers/spec_helper.rb

@@ -0,0 +1,9 @@
+module ViewSpec
+  module SpecHelper
+    def view_specs
+      ViewSpec.specs
+    end
+
+    module_function :view_specs
+  end
+end

data/lib/view_spec/param.rb

@@ -0,0 +1,34 @@
+require "active_model"
+module ViewSpec
+  class Param
+    include ::ActionView::Helpers::SanitizeHelper
+
+    attr_reader :name, :options
+
+    def initialize(name, cast_type = nil, value: nil, default: nil, **type_options)
+      @name = name.to_sym
+      @cast_type = cast_type
+      @value = value
+      @default = default
+      @type_options = type_options
+    end
+
+    def value
+      type.cast(raw_value)
+    end
+
+    def type
+      @type ||= Type.for(@cast_type, **@type_options)
+    end
+
+    def to_pair
+      [name, value]
+    end
+
+    private
+
+    def raw_value
+      sanitize(@value) || @default
+    end
+  end
+end

data/lib/view_spec/param_set.rb

@@ -0,0 +1,32 @@
+module ViewSpec
+  class ParamSet
+    include Enumerable
+
+    delegate :each, to: :@params
+
+    def initialize
+      @params = []
+    end
+
+    def add(name, cast_type = nil, value: nil, **options)
+      if name.is_a?(Hash)
+        @params += name.map { Param.new(_1, value: _2) }
+      else
+        @params << Param.new(name, cast_type, value:, **options)
+      end
+      @params.uniq!(&:name)
+    end
+
+    def names
+      @params.map(&:name)
+    end
+
+    def include?(name)
+      names.include?(name)
+    end
+
+    def to_h
+      @params.map { _1.to_pair }.to_h
+    end
+  end
+end

data/lib/view_spec/registry.rb

@@ -0,0 +1,54 @@
+module ViewSpec
+  class Registry
+    include Enumerable
+
+    delegate :each, to: :@specs
+
+    def initialize
+      @specs = []
+      @source_files = {}
+    end
+
+    def add(source_path, subject, &block)
+      delete(subject)
+
+      source_file = source_file(source_path)
+      @specs << Spec.new(source_file, subject, &block)
+      @specs.last
+    end
+
+    def source_file(path)
+      @source_files[path.to_s] ||= SourceFile.new(path)
+    end
+
+    def find(subject)
+      find_where({subject:})
+    end
+
+    def has?(...)
+      !!find(...)
+    end
+
+    def delete(subject)
+      index = @specs.index { _1.subject == subject }
+      @specs.delete_at(index) unless index.nil?
+    end
+
+    def clear!
+      @specs.clear
+      @source_files.clear
+    end
+
+    def find_where(conditions)
+      where(conditions).first
+    end
+
+    def where(conditions)
+      @specs.filter do |spec|
+        !!conditions.each do |key, value|
+          break false unless spec.respond_to?(key) && (spec.public_send(key) == value)
+        end
+      end
+    end
+  end
+end

data/lib/view_spec/reloader.rb

@@ -0,0 +1,15 @@
+module ViewSpec
+  class Reloader
+    delegate :execute, to: :@file_watcher
+
+    def initialize(files = [], paths = [], &callback)
+      paths_hash = paths.map { [_1, ["rb"]] }.to_h
+
+      @file_watcher = ActiveSupport::FileUpdateChecker.new(files, paths_hash, &callback)
+    end
+
+    def updated?
+      @file_watcher.execute_if_updated
+    end
+  end
+end

data/lib/view_spec/renderable.rb

@@ -0,0 +1,36 @@
+module ViewSpec
+  class Renderable
+    class CurrentTemplate
+      attr_accessor :short_identifier
+    end
+
+    def initialize(identifier, tpl = nil, &block)
+      @identifier = identifier
+      @block = tpl ? -> { render inline: tpl } : block
+    end
+
+    def render_in(view_context)
+      render_context(view_context).instance_exec(&@block)&.strip&.html_safe
+    end
+
+    private
+
+    def render_context(view_context)
+      view_context = view_context.clone
+
+      unless view_context.instance_variable_get(:@current_template)
+        current_template = CurrentTemplate.new
+        current_template.short_identifier = @identifier
+        view_context.instance_variable_set(:@current_template, current_template)
+      end
+
+      view_context.assigns.each do |key, value|
+        view_context.define_singleton_method(key) do
+          instance_variable_get(:"@#{key}") || {}
+        end
+      end
+
+      view_context
+    end
+  end
+end

data/lib/view_spec/scenario.rb

@@ -0,0 +1,58 @@
+module ViewSpec
+  class Scenario < DSL::Context
+    include DSL::Title
+    include DSL::Params
+    include DSL::Layout
+    include DSL::Controller
+
+    class NoPreviewError < StandardError; end
+
+    def preview(tpl = nil, &block)
+      @preview = tpl || block
+    end
+
+    def render_preview(params: {}, assigns: {}, layout: false, raw: false)
+      assigns[:params] = resolve_params(params).to_h
+      html = render(renderable_preview, layout:, assigns:)
+
+      raw ? CGI.unescapeHTML(html) : html
+    end
+
+    def render_output(*args, **kwargs)
+      render_preview(*args, **kwargs, raw: true)
+    end
+
+    def name
+      @subject.to_s
+    end
+
+    def short_identifier
+      @subject.to_short_identifier
+    end
+
+    def to_param
+      short_identifier
+    end
+
+    def to_partial_path
+      "view_spec/scenario"
+    end
+
+    private
+
+    def renderable_preview
+      if @preview.is_a?(String)
+        Renderable.new(short_identifier, @preview)
+      elsif @preview.is_a?(Proc)
+        Renderable.new(short_identifier, &@preview)
+      else
+        raise NoPreviewError, "no preview defined for scenario `#{short_identifier}`"
+      end
+    end
+
+    def render(*args, layout: false, assigns: {}, **kwargs, &block)
+      layout = self.layout if layout == true
+      controller.render(*args, layout:, assigns:, **kwargs, &block)
+    end
+  end
+end

data/lib/view_spec/source_file.rb

@@ -0,0 +1,55 @@
+module ViewSpec
+  class SourceFile
+    attr_reader :absolute_path
+
+    delegate_missing_to :absolute_path
+    delegate :to_s, to: :absolute_path
+
+    def initialize(absolute_path)
+      @absolute_path = Pathname(absolute_path)
+    end
+
+    def normalized_name
+      basename(".rb").to_s.delete_suffix(ViewSpec.config.spec_file_suffix)
+    end
+
+    def relative_path
+      spec_file? ? absolute_path.relative_path_from(base_path) : app_path
+    end
+
+    def lookup_path
+      relative_dirname = relative_path.dirname.to_s.delete_prefix(".")
+      [relative_dirname.presence, normalized_name].compact.join("/")
+    end
+
+    def app_path
+      absolute_path.relative_path_from(Rails.root)
+    end
+
+    def spec_file?
+      absolute_path.to_s.end_with?("#{ViewSpec.config.spec_file_suffix}.rb")
+    end
+
+    alias_method :to_path, :to_s
+    alias_method :to_pathname, :absolute_path
+
+    private
+
+    def base_path
+      base_paths.find { descendant_of?(_1) }
+    end
+
+    def base_paths
+      Utils.normalize_paths(ViewSpec.config.spec_paths)
+    end
+
+    def descendant_of?(directory_path)
+      directory_segments = File.expand_path(directory_path).split("/")
+      path_segments.slice(0, directory_segments.size) == directory_segments
+    end
+
+    def path_segments
+      absolute_path.to_s.split("/")
+    end
+  end
+end

data/lib/view_spec/spec.rb

@@ -0,0 +1,37 @@
+module ViewSpec
+  class Spec < DSL::Context
+    include DSL::Title
+    include DSL::Layout
+    include DSL::Groups
+    include DSL::Scenarios
+    include DSL::Controller
+
+    attr_reader :subject, :source_file
+
+    def initialize(source_file, subject, &block)
+      @source_file = source_file
+
+      super(subject, nil, &block)
+    end
+
+    def short_identifier
+      @subject.to_short_identifier
+    end
+
+    def lookup_path
+      if @source_file.spec_file?
+        @source_file.lookup_path
+      else
+        short_identifier
+      end
+    end
+
+    def to_param
+      lookup_path
+    end
+
+    def to_partial_path
+      "view_spec/spec"
+    end
+  end
+end

data/lib/view_spec/subject.rb

@@ -0,0 +1,42 @@
+module ViewSpec
+  class Subject
+    include Comparable
+
+    delegate :to_s, to: :value
+
+    attr_reader :value
+
+    def initialize(value)
+      @value = value
+    end
+
+    def to_title
+      @title ||= to_short_identifier.titleize
+    end
+
+    def to_identifier
+      @identifier ||= to_parameterized_path
+    end
+
+    def to_short_identifier
+      @short_identifier ||= to_identifier.split("/").last
+    end
+
+    def <=>(other)
+      if other.is_a?(self.class)
+        to_identifier.casecmp other.to_identifier
+      else
+        value <=> other
+      end
+    end
+
+    def to_parameterized_path
+      to_path.parameterize
+    end
+
+    def to_path
+      path = @value.to_s.underscore.gsub(/\s+/, "_").delete_suffix(".rb")
+      path.gsub(/(_component|\/component)$/, "")
+    end
+  end
+end

data/lib/view_spec/type.rb

@@ -0,0 +1,39 @@
+module ViewSpec
+  class Type
+    TYPES = %i[boolean date date_time decimal float integer string symbol time]
+
+    delegate :cast, to: :value_caster
+
+    def initialize(**options)
+      @options = options
+    end
+
+    def type
+      self.class.name.demodulize.to_sym
+    end
+
+    class << self
+      def for(type, ...)
+        return new(...) unless type.in?(TYPES)
+
+        "ViewSpec::Types::#{type.to_s.camelize}".constantize.new(...)
+      end
+    end
+
+    private
+
+    def value_caster
+      @value_caster ||= begin
+        "::ActiveModel::Type::#{self.class.name.demodulize}".constantize.new
+      rescue NameError
+        NoopValueCaster.new
+      end
+    end
+  end
+
+  class NoopValueCaster
+    def cast(value)
+      value
+    end
+  end
+end

data/lib/view_spec/types/boolean.rb

@@ -0,0 +1,6 @@
+module ViewSpec
+  module Types
+    class Boolean < Type
+    end
+  end
+end

data/lib/view_spec/types/date.rb

@@ -0,0 +1,6 @@
+module ViewSpec
+  module Types
+    class Date < Type
+    end
+  end
+end

data/lib/view_spec/types/date_time.rb

@@ -0,0 +1,6 @@
+module ViewSpec
+  module Types
+    class DateTime < Type
+    end
+  end
+end

data/lib/view_spec/types/decimal.rb

@@ -0,0 +1,6 @@
+module ViewSpec
+  module Types
+    class Decimal < Type
+    end
+  end
+end

data/lib/view_spec/types/float.rb

@@ -0,0 +1,6 @@
+module ViewSpec
+  module Types
+    class Float < Type
+    end
+  end
+end

data/lib/view_spec/types/integer.rb

@@ -0,0 +1,6 @@
+module ViewSpec
+  module Types
+    class Integer < Type
+    end
+  end
+end

data/lib/view_spec/types/string.rb

@@ -0,0 +1,6 @@
+module ViewSpec
+  module Types
+    class String < Type
+    end
+  end
+end

data/lib/view_spec/types/symbol.rb

@@ -0,0 +1,9 @@
+module ViewSpec
+  module Types
+    class Symbol < Type
+      def cast(value)
+        value.to_sym
+      end
+    end
+  end
+end

data/lib/view_spec/types/time.rb

@@ -0,0 +1,6 @@
+module ViewSpec
+  module Types
+    class Time < Type
+    end
+  end
+end

data/lib/view_spec/utils.rb

@@ -0,0 +1,9 @@
+module ViewSpec
+  module Utils
+    def normalize_paths(paths)
+      paths.map { File.absolute_path(_1, Rails.root) }
+    end
+
+    module_function :normalize_paths
+  end
+end

data/lib/view_spec/version.rb

@@ -0,0 +1,3 @@
+module ViewSpec
+  VERSION = "0.0.0"
+end

data/lib/view_spec.rb

@@ -0,0 +1,38 @@
+require "zeitwerk"
+require "active_support"
+require "view_spec/version"
+
+loader = Zeitwerk::Loader.for_gem
+loader.tag = "view_spec"
+loader.inflector.inflect "dsl" => "DSL"
+loader.push_dir("#{__dir__}/view_spec", namespace: ViewSpec)
+loader.collapse("#{__dir__}/view_spec/helpers")
+loader.enable_reloading if ENV["RAILS_ENV"] == "development"
+loader.setup
+
+module ViewSpec
+  include DSL
+
+  class << self
+    def config
+      @config ||= Config.instance
+    end
+
+    def configure(&block)
+      yield config
+    end
+
+    def load!
+      registry.clear!
+
+      Utils.normalize_paths(config.spec_paths).each do |specs_path|
+        spec_files = Dir.glob("#{specs_path}/**/*#{config.spec_file_suffix}.rb")
+        spec_files.each { load _1 }
+      end
+
+      Utils.normalize_paths(config.spec_files).each { load _1 }
+    end
+  end
+end
+
+require "view_spec/engine"

metadata

@@ -0,0 +1,125 @@
+--- !ruby/object:Gem::Specification
+name: view_spec
+version: !ruby/object:Gem::Version
+  version: 0.0.0
+platform: ruby
+authors:
+- Mark Perkins
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2025-04-20 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: zeitwerk
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '2.6'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '2.6'
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.1'
+- !ruby/object:Gem::Dependency
+  name: activemodel
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.1'
+description:
+email:
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE.txt
+- README.md
+- app/views/view_spec/_group.html.erb
+- app/views/view_spec/_scenario.html.erb
+- app/views/view_spec/_spec.html.erb
+- lib/view_spec.rb
+- lib/view_spec/config.rb
+- lib/view_spec/dsl.rb
+- lib/view_spec/dsl/context.rb
+- lib/view_spec/dsl/controller.rb
+- lib/view_spec/dsl/groups.rb
+- lib/view_spec/dsl/layout.rb
+- lib/view_spec/dsl/params.rb
+- lib/view_spec/dsl/scenarios.rb
+- lib/view_spec/dsl/title.rb
+- lib/view_spec/engine.rb
+- lib/view_spec/error.rb
+- lib/view_spec/group.rb
+- lib/view_spec/helpers/spec_helper.rb
+- lib/view_spec/param.rb
+- lib/view_spec/param_set.rb
+- lib/view_spec/registry.rb
+- lib/view_spec/reloader.rb
+- lib/view_spec/renderable.rb
+- lib/view_spec/scenario.rb
+- lib/view_spec/source_file.rb
+- lib/view_spec/spec.rb
+- lib/view_spec/subject.rb
+- lib/view_spec/type.rb
+- lib/view_spec/types/boolean.rb
+- lib/view_spec/types/date.rb
+- lib/view_spec/types/date_time.rb
+- lib/view_spec/types/decimal.rb
+- lib/view_spec/types/float.rb
+- lib/view_spec/types/integer.rb
+- lib/view_spec/types/string.rb
+- lib/view_spec/types/symbol.rb
+- lib/view_spec/types/time.rb
+- lib/view_spec/utils.rb
+- lib/view_spec/version.rb
+homepage: https://github.com/lookbook-hq/view_spec
+licenses:
+- MIT
+metadata: {}
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.1.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.3.3
+signing_key:
+specification_version: 4
+summary: ViewSpec lets you create example-led specifications for components, partials
+  and views using an expressive Ruby DSL
+test_files: []