perron 0.18.0 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4b7d197a1f26d5fae6c488fe7be6aef6c3818e408d97b5d789f46111db3207be
-  data.tar.gz: 0cb809db9260c8e5ded0626f9d790dfb003b937892c1bbce022bcbdac3e5053d
+  metadata.gz: bdd54bac7e739c0199d3381c1f20aaf15dd5c4dfddec9f57635c0dcf41b66505
+  data.tar.gz: c04dc9b074c2a53803086ee6f9a5a7780a26f930661a0884513185323197ba03
 SHA512:
-  metadata.gz: cc876ae9e8fb6daf1c6496c381efc05eba46fe5bbff9174502480488c34a4dbf5c94d9a360752942a53c395d7df6cb3b9e8342936e8e795b3ab3ccc20f6b3cdd
-  data.tar.gz: 99681d91d5d5ea2ffb8488ba4c93c27b2115aebde8132d6f0c8376a6b3e7819c62aef196b424e244af04d8ada7a12080c181cd0f44cf9d52c79125263c3f849b
+  metadata.gz: 0fdac048810289509dc253a93839fd2df30358a90e463dac6acc3e0cad1171640698e973522d5321b53ca807c56f9a806aeb4bdc972f56773ee0b2693871009b
+  data.tar.gz: 8864e0a699f0cf04cc67c696dee53df33e70cd7abe9d57a34b75312613d332c09d0e675fc46a02a52870f30c0a556bb00c98fd7150c8769af5bd1a1ddb79429c

data/Gemfile.lock

@@ -1,10 +1,10 @@
 PATH
   remote: .
   specs:
-    perron (0.18.0)
+    perron (1.1.0)
       csv
       json
-      mata (~> 0.8.0)
+      mata (~> 0.10.0)
       psych
       rails (>= 7.2.0)
 
@@ -136,11 +136,10 @@ GEM
       net-pop
       net-smtp
     marcel (1.0.4)
-    mata (0.8.0)
+    mata (0.10.0)
       listen (~> 3.0)
       rack (>= 3.0)
     mini_mime (1.1.5)
-    mini_portile2 (2.8.9)
     minitest (5.27.0)
     net-imap (0.5.9)
       date
@@ -152,24 +151,21 @@ GEM
     net-smtp (0.5.1)
       net-protocol
     nio4r (2.7.4)
-    nokogiri (1.18.8)
-      mini_portile2 (~> 2.8.2)
+    nokogiri (1.19.3-aarch64-linux-gnu)
       racc (~> 1.4)
-    nokogiri (1.18.8-aarch64-linux-gnu)
+    nokogiri (1.19.3-aarch64-linux-musl)
       racc (~> 1.4)
-    nokogiri (1.18.8-aarch64-linux-musl)
+    nokogiri (1.19.3-arm-linux-gnu)
       racc (~> 1.4)
-    nokogiri (1.18.8-arm-linux-gnu)
+    nokogiri (1.19.3-arm-linux-musl)
       racc (~> 1.4)
-    nokogiri (1.18.8-arm-linux-musl)
+    nokogiri (1.19.3-arm64-darwin)
       racc (~> 1.4)
-    nokogiri (1.18.8-arm64-darwin)
+    nokogiri (1.19.3-x86_64-darwin)
       racc (~> 1.4)
-    nokogiri (1.18.8-x86_64-darwin)
+    nokogiri (1.19.3-x86_64-linux-gnu)
       racc (~> 1.4)
-    nokogiri (1.18.8-x86_64-linux-gnu)
-      racc (~> 1.4)
-    nokogiri (1.18.8-x86_64-linux-musl)
+    nokogiri (1.19.3-x86_64-linux-musl)
       racc (~> 1.4)
     parallel (1.27.0)
     parser (3.3.8.0)

data/app/controllers/perron/concierge_controller.rb

@@ -0,0 +1,16 @@
+module Perron
+  class ConciergeController < ActionController::Base
+    def show
+      render :show
+    end
+
+    def run_command
+      command = params[:command]
+
+      return redirect_back fallback_location: root_path unless command.start_with?("bin/rails generate content")
+
+      system(command)
+      redirect_back fallback_location: root_path
+    end
+  end
+end

data/app/helpers/perron/markdown_helper.rb

@@ -4,10 +4,11 @@ require "perron/markdown"
 
 module Perron
   module MarkdownHelper
-    def markdownify(content = nil, process: [], &block)
+    def markdownify(content = nil, process: nil, resource: nil, &block)
       text = block_given? ? capture(&block).strip_heredoc : content
+      processors = (process.nil? || process.empty?) ? Perron.configuration.default_processors : process
 
-      Perron::Markdown.render(text, processors: process)
+      Perron::Markdown.render(text, processors: processors, resource: resource || @resource)
     end
   end
 end

data/app/helpers/perron/meta_tags_helper.rb

@@ -2,16 +2,10 @@
 
 module Perron
   module MetaTagsHelper
-    def meta_tags(options = {}) = Perron::Metatags.new(resource.metadata).render(options)
+    def meta_tags(options = {})
+      metadata = (@metadata || {}).merge(@resource&.metadata || {})
 
-    private
-
-    Resource = Data.define(:path, :collection, :metadata, :published_at)
-
-    def resource
-      return Resource.new(request.path, nil, @metadata, nil) if @metadata.present?
-
-      @resource || Resource.new(request.path, nil, {}, nil)
+      Perron::Metatags.new(metadata).render(options)
     end
   end
 end

data/app/helpers/perron/paginate_helper.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+module Perron
+  module PaginateHelper
+    def paginate(scope, page: nil, **options)
+      page ||= (params[:page] || 1).to_i
+      resource_class = scope.model_class
+
+      config = resource_class.configuration.pagination
+      per_page = options[:per_page] || config.per_page
+      page_path_template = options[:path_template] || config.path_template
+
+      route = find_index_route(resource_class)
+      base_path = route_path(route)
+
+      use_query_params = Rails.env.development? || Rails.env.local?
+      paginate = Paginate.new(scope, page: page, per_page: per_page, base_path: base_path, page_path_template: page_path_template, use_query_params: use_query_params)
+
+      [paginate, paginate.items]
+    end
+
+    private
+
+    def find_index_route(resource_class)
+      controller_name = resource_class.name.demodulize.sub("Controller", "").underscore.pluralize
+
+      Rails.application.routes.routes.find do |r|
+        r.defaults[:controller] == "content/#{controller_name}" &&
+          r.defaults[:action] == "index"
+      end
+    end
+
+    def route_path(route)
+      return "/#{route.name}/" unless route
+
+      path_spec = route.path.spec.to_s
+      path_spec.sub(/\(.*?\)/, "").gsub(/:[^\/]+/, "").sub(/\/$/, "") + "/"
+    end
+  end
+end

data/app/views/perron/concierge/show.html.erb

@@ -0,0 +1,271 @@
+<!doctype html>
+<html>
+  <head>
+    <title>Welcome to Perron</title>
+    <meta charset="utf-8">
+
+    <link rel="icon" href="/icon.png" type="image/png">
+    <link rel="apple-touch-icon" href="/icon.png" sizes="512x512">
+
+    <style>
+      * { margin: 0; padding: 0; box-sizing: border-box; }
+      ul { list-style: none; }
+
+      a {
+        color: #1f2937;
+
+        &:hover: { text-decoration: none; }
+      }
+
+      body {
+        padding: 2rem 1rem;
+        min-height: 100vh;
+        font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif;
+        line-height: 1.6;
+        color: #1f2937;
+        background: linear-gradient(135deg, #f9fafb 0%, #f3f4f6 100%);
+      }
+
+      .hero {
+        max-width: 72rem;
+        margin: 0 auto 4rem;
+        padding: 3rem 0;
+
+        h1 {
+          font-size: clamp(2rem, 5vw, 3.5rem);
+          font-weight: 900;
+          text-align: center;
+          color: #111827;
+          letter-spacing: -.025em;
+        }
+
+        ul {
+          display: grid;
+          row-gap: 1rem;
+          margin: 1rem auto 0;
+          max-width: 48rem;
+          padding: 1rem;
+          background: white;
+          border-radius: .5rem;
+          border: 1px solid #e5e7eb;
+
+          li {
+            border-radius: .5rem;
+
+            p { font-weight: 600; }
+
+            div {
+              display: grid;
+              grid-template-columns: 1fr min-content;
+              margin-top: .25rem;
+              padding: .75rem 1rem;
+              background-color: rgb(248 250 252);
+              border-radius: .5rem;
+            }
+
+            code {
+              font-size: .875rem;
+              font-family: "SF Mono", Monaco, "Cascadia Code", monospace;
+              font-weight: 500;
+              color: rgb(51 65 85);
+              overflow: auto;
+              white-space: nowrap;
+              user-select: all;
+            }
+
+            svg {
+              width: 1.125rem;
+              aspect-ratio: 1/1;
+              color: rgb(100 116 139);
+            }
+
+            input[type=submit] {
+              border: 0;
+              padding: .25rem 1rem;
+              font-size: .875rem;
+              font-weight: 300;
+              color: white;
+              background-color: rgb(249 115 22);
+              border-radius: .25rem;
+              transition: background-color 300ms ease;
+              cursor: pointer;
+
+              &:hover {
+                background-color: rgb(251 146 60);
+              }
+            }
+          }
+        }
+      }
+
+      .info {
+        display: grid;
+        gap: 2rem;
+        max-width: 6xl;
+        margin: 0 auto;
+        overflow-x: clip;
+
+        @media (min-width: 768px) {
+          grid-template-columns: repeat(auto-fit, minmax(280px, 1fr));
+        }
+
+        li {
+          &:nth-child(odd) {
+            @media (min-width: 640px) {
+              transform: rotate(-1deg);
+            }
+          }
+
+          &:nth-child(even) {
+            @media (min-width: 640px) {
+              transform: rotate(1deg);
+            }
+          }
+        }
+
+        a {
+          display: block;
+          padding: 2rem 1.5rem;
+          text-decoration: none;
+          background: white;
+          border: 1px solid #e5e7eb;
+          border-radius: 1rem;
+          transition: all 300ms ease;
+
+          &:hover {
+            transform: translateY(-4px);
+            box-shadow: 0 20px 25px -5px rgb(0 0 0 / .1);
+          }
+
+          h2 {
+            font-size: 1.25rem;
+            font-weight: 700;
+            color: #111827;
+          }
+
+          p {
+            margin-top: .25rem;
+            color: #4b5563;
+            line-height: 1.7;
+
+            a {
+              color: #f97316;
+              text-decoration: none;
+              font-weight: 500;
+              transition: color 200ms ease;
+
+              &:hover {
+                color: #ea580c;
+                text-decoration: underline;
+              }
+            }
+          }
+        }
+      }
+
+      .versions {
+        display: flex;
+        align-items: center;
+        justify-content: center;
+        column-gap: 1.5rem;
+        margin-top: 2rem;
+        font-family: "SF Mono", Monaco, "Cascadia Code", monospace;
+        text-align: center;
+        color: #6b7280;
+        font-size: .75rem;
+      }
+    </style>
+  </head>
+
+  <body>
+    <section class="hero">
+      <h1>Welcome to Perron</h1>
+
+      <ul>
+        <li>
+          <p>
+            Create a collection
+          </p>
+
+          <div>
+            <code>bin/rails generate content Post</code>
+
+            <%= form_with url: perron_run_command_path do |form| %>
+              <%= form.hidden_field :command, value: "bin/rails generate content Post" %>
+
+              <% if defined?(Content::Post) %>
+                <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 256 256" fill="currentColor"><path d="M128,24A104,104,0,1,0,232,128,104.11,104.11,0,0,0,128,24Zm45.66,85.66-56,56a8,8,0,0,1-11.32,0l-24-24a8,8,0,0,1,11.32-11.32L112,148.69l50.34-50.35a8,8,0,0,1,11.32,11.32Z"/></svg>
+              <% else %>
+                <%= form.submit "Run" %>
+              <% end %>
+            <% end %>
+          </div>
+        </li>
+
+        <li>
+          <p>
+            Create your first content
+          </p>
+
+          <div>
+            <code>bin/rails generate content Post --new "My first post"</code>
+
+            <%= form_with url: perron_run_command_path do |form| %>
+              <%= form.hidden_field :command, value: 'bin/rails generate content Post --new' %>
+
+              <% if File.file?("app/content/posts/untitled.md") %>
+                <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 256 256" fill="currentColor"><path d="M128,24A104,104,0,1,0,232,128,104.11,104.11,0,0,0,128,24Zm45.66,85.66-56,56a8,8,0,0,1-11.32,0l-24-24a8,8,0,0,1,11.32-11.32L112,148.69l50.34-50.35a8,8,0,0,1,11.32,11.32Z"/></svg>
+              <% else %>
+                <%= form.submit "Run" %>
+              <% end %>
+            <% end %>
+          </div>
+        </li>
+
+        <li>
+          <p>
+            Run the server, and visit <code><a href="/posts/">http://localhost:3000/posts/</a></code>
+          </p>
+
+          <div>
+            <code>bin/dev</code>
+          </div>
+        </li>
+      </ul>
+    </section>
+
+    <ul class="info">
+      <li>
+        <a href="https://perron.railsdesigner.com/docs/">
+          <h2>Documentation</h2>
+
+          <p>Visit the docs for more</p>
+        </a>
+      </li>
+
+      <li>
+        <a href="https://perron.railsdesigner.com/library/">
+          <h2>Library</h2>
+
+          <p>Check out the library for snippets, components and templates</p>
+        </a>
+      </li>
+
+      <li>
+        <a href="https://github.com/Rails-Designer/perron">
+          <h2>GitHub</h2>
+
+          <p>Check out Perron's source</p>
+        </a>
+      </li>
+    </ul>
+
+    <div class="versions">
+      <span>Ruby <%= RUBY_VERSION %></span>
+
+      <span>Rails <%= Rails.version %></span>
+
+      <span>Perron <%= Perron::VERSION %></span>
+    </div>
+  </body>
+</html>

data/lib/generators/rails/content/USAGE

@@ -12,6 +12,7 @@ Options:
     --force-plural                  Use plural form for model name and class
     --[no-]include-root             Include root action and route
                                     (default: true for pages, false otherwise)
+    --inline                        Render show action inline instead of using view template
 
 Examples:
     Generate basic content scaffold:
@@ -29,6 +30,17 @@ Examples:
     Adds route:
         resources :posts, module: :content, only: %w[index show]
 
+    Generate inline show action:
+        rails generate content Post --inline
+
+    Creates controller with inline rendering:
+        def show
+          @resource = Content::Post.find!(params[:id])
+          render @resource.inline
+        end
+
+    Skips creating app/views/content/posts/show.html.erb
+
     Generate pages scaffold with root:
         rails generate content Page
 
@@ -48,17 +60,22 @@ Examples:
     Creates data source files in app/content/data/ and adds
     .sources and .template_source class methods to the model.
 
-    Adds .sources and .template_source class methods to model.
-
     Create new content file from template:
         rails generate content Post --new
         rails generate content Post --new "My First Post"
 
     Creates a new content file in app/content/posts/ using:
-        1. YYYY-MM-DD-template.*.tt (if exists, with date prefix)
-        2. template.*.tt (if exists, without date prefix)
+        1. Template file with strftime patterns (e.g., %Y-%m-%d-title.md.tt)
+        2. Template file without strftime patterns (e.g., template.md.tt)
         3. Empty file with frontmatter dashes (if no template)
 
+    Template filename examples:
+        %Y-%m-%d-title.md.tt    → 2026-03-10-my-post.md
+        %s-title.md.tt          → 1741737600-my-post.md
+        %d-title.md.tt          → 10-my-post.md
+        title.md.tt             → my-post.md
+        %Y-%m.md.tt             → 2026-03.md
+
     Template files support ERB:
         ---
         title: <%= @title %>

data/lib/generators/rails/content/content_generator.rb

@@ -13,6 +13,7 @@ module Rails
         desc: "Create a new content file from template instead of generating scaffold"
       class_option :data, type: :array, default: [], banner: "source1(.ext) source2(.ext)",
         desc: "Specify data sources with optional extensions (defaults to .yml)"
+      class_option :inline, type: :boolean, default: false, desc: "Render show action inline instead of using a view template"
 
       argument :actions, type: :array, default: %w[index show], banner: "actions", desc: "Specify which actions to generate (index/show)"
 
@@ -53,6 +54,8 @@ module Rails
         empty_directory view_directory
 
         actions.each do |action|
+          next if action == "show" && options[:inline]
+
           template "#{action}.html.erb.tt", File.join(view_directory, "#{action}.html.erb")
         end
       end
@@ -84,15 +87,12 @@ module Rails
         return if @content_mode
         return unless should_include_root?
 
-        inject_into_class "app/controllers/content/#{plural_file_name}_controller.rb", "Content::#{plural_class_name}Controller" do
-          <<~RUBY
-            def root
-              @resource = Content::#{class_name}.root
+        controller_file = "app/controllers/content/#{plural_file_name}_controller.rb"
+        return unless File.exist?(File.join(destination_root, controller_file))
 
-              render :show
-            end
-          RUBY
-        end
+        root_action = "  def root\n    @resource = Content::#{class_name}.root\n\n    render :show\n  end\n\n"
+
+        inject_into_file controller_file, root_action, after: "class Content::#{plural_class_name}Controller < ApplicationController\n"
       end
 
       def create_root_content_file
@@ -129,16 +129,20 @@ module Rails
       def pages_controller? = plural_file_name == "pages"
 
       def template_file
-        @template_file ||= Dir.glob(File.join(content_directory, "{YYYY-MM-DD-,}template.*.tt")).first
+        @template_file ||= Dir.glob(File.join(content_directory, "*.tt")).first
       end
 
       def filename_from_template
         @filename_from_template ||= begin
           return "untitled.md" unless template_file
 
-          File.basename(template_file, ".tt").tap do |name|
-            name.gsub!("YYYY-MM-DD", Time.current.strftime("%Y-%m-%d"))
-            name.sub!("template", @content_title ? @content_title.parameterize : "untitled")
+          name = File.basename(template_file, ".tt")
+          name = Time.current.strftime(name)
+
+          if name.include?("title")
+            name.sub("title", @content_title ? @content_title.parameterize : "untitled")
+          else
+            name
           end
         end
       end

data/lib/generators/rails/content/templates/controller.rb.tt

@@ -3,11 +3,17 @@ class Content::<%= plural_class_name %>Controller < ApplicationController
   def index
     @resources = Content::<%= class_name %>.all
   end
+<%- if actions.include?("show") -%>
 
+<%- end -%>
 <%- end -%>
 <%- if actions.include?("show") -%>
   def show
     @resource = Content::<%= class_name %>.find!(params[:id])
+<%- if options[:inline] -%>
+
+    render @resource.inline
+<%- end -%>
   end
 <%- end -%>
 end

data/lib/generators/rails/content/templates/model.rb.tt

@@ -2,7 +2,7 @@ class Content::<%= class_name %> < Perron::Resource
 <% if data_sources? -%>
   sources <%= data_sources.map { ":#{it}" }.join(", ") %>
 
-  def self.source_template(sources)
+  def self.source_template(source)
     <<~MARKDOWN
     ---
     ---

data/lib/perron/assets/icon.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="400" height="400" fill="none" viewBox="0 0 400 400"><path fill="#f97316" d="M177.101 221.582a8.59 8.59 0 0 1 8.587-8.587h68.524q23.93 0 40.424-16.458 16.728-16.697 16.728-46.99 0-22.66-17.425-40.549-17.424-18.129-39.727-18.128H126.636c-8.836 0-16 7.163-16 16v244.766a8.364 8.364 0 1 1-16.727 0V89.696c0-8.837 7.164-16 16-16h144.303q29.272 0 51.576 23.137 22.303 23.136 22.303 52.714 0 36.495-21.606 58.678-21.606 21.944-52.273 21.944h-68.524a8.587 8.587 0 0 1-8.587-8.587m20 34.348a8.59 8.59 0 0 1 8.587-8.587h48.524q24.162 0 44.606-11.926 20.678-12.165 33.222-34.825 12.778-22.66 12.778-51.045 0-36.733-27.414-64.88-27.182-28.145-63.192-28.145H93.182c-8.837 0-16 7.163-16 16v299.114a8.364 8.364 0 1 1-16.727 0V55.348c0-8.837 7.163-16 16-16h177.757q28.111 0 52.97 15.266t39.495 40.788q14.868 25.522 14.868 54.145 0 32.44-14.868 59.155-14.87 26.477-39.495 41.265-24.394 14.55-52.97 14.55h-48.524a8.59 8.59 0 0 1-8.587-8.587m20 34.348a8.587 8.587 0 0 1 8.587-8.587h28.524q24.86 0 47.626-10.018 22.768-10.257 39.495-27.431 16.96-17.412 26.95-41.981 9.99-24.806 9.99-52.714 0-33.393-16.96-62.732-16.959-29.578-45.768-46.99-28.575-17.65-61.333-17.651H59.727c-8.836 0-16 7.163-16 16v353.462a8.364 8.364 0 0 1-16.727 0V21c0-8.837 7.163-16 16-16h211.212q37.172 0 69.697 20.036 32.526 19.799 51.808 53.192Q395 111.62 395 149.547q0 33.871-11.384 62.494-11.383 28.385-30.667 47.228-19.283 18.844-44.838 29.339-25.555 10.257-53.899 10.257h-28.524a8.59 8.59 0 0 1-8.587-8.587m-73.01 41.358a8.364 8.364 0 0 1-16.727 0V124.043c0-8.836 7.163-16 16-16h110.848q16.495 0 28.344 12.404 12.08 12.404 12.08 29.1 0 46.274-40.424 46.274h-88.524a8.587 8.587 0 1 1 0-17.174h88.524q11.152 0 17.424-6.44t6.273-22.66q0-10.495-6.97-17.412-6.737-6.918-16.727-6.918h-94.121c-8.837 0-16 7.164-16 16z" style="mix-blend-mode:multiply"/></svg>

data/lib/perron/collection.rb

@@ -16,7 +16,7 @@ module Perron
     end
 
     def all(resource_class = "Content::#{name.classify}".safe_constantize)
-      Perron::Relation.new(load_resources(resource_class).select(&:published?))
+      Perron::Relation.new(load_resources(resource_class).select(&:published?), resource_class)
     end
     alias_method :resources, :all
 
@@ -52,6 +52,7 @@ module Perron
 
       Dir.glob("#{@collection_path}/**/*.*")
         .select { allowed_extensions.include?(File.extname(it)) }
+        .reject { File.basename(it, ".*").downcase == "readme" }
         .map { resource_class.new(it) }
     end
   end

data/lib/perron/configuration.rb

@@ -15,6 +15,8 @@ module Perron
 
       @config.output = "output"
 
+      @config.output_server_strict = true
+
       @config.mode = :standalone
 
       @config.live_reload = false
@@ -35,8 +37,12 @@ module Perron
 
       @config.markdown_options = {}
 
+      @config.default_processors = []
+
       @config.search_scope = []
 
+      @config.cache_data_sources = false
+
       @config.sitemap = ActiveSupport::OrderedOptions.new
       @config.sitemap.enabled = false
       @config.sitemap.priority = 0.5
@@ -47,6 +53,9 @@ module Perron
 
       @config.metadata = ActiveSupport::OrderedOptions.new
       @config.metadata.title_separator = " — "
+
+      @config.before_build = nil
+      @config.after_build = nil
     end
 
     def input = Rails.root.join("app", "content")
@@ -61,6 +70,22 @@ module Perron
       @additional_routes || (mode.integrated? ? [] : %w[root_path])
     end
 
+    def deploy
+      @deploy ||= ActiveSupport::OrderedOptions.new.tap do |config|
+        def config.method_missing(method_name, *args, &block)
+          if method_name.to_s.end_with?("=")
+            super
+          else
+            self[method_name] ||= ActiveSupport::OrderedOptions.new
+          end
+        end
+
+        def config.respond_to_missing?(method_name, include_private = false)
+          !method_name.to_s.end_with?("=") || super
+        end
+      end
+    end
+
     attr_writer :additional_routes
 
     def url
@@ -78,8 +103,8 @@ module Perron
       end
     end
 
-    def respond_to_missing?(method_name)
-      @config.respond_to?(method_name) || super
+    def respond_to_missing?(method_name, ...)
+      @config.respond_to?(method_name, ...) || super
     end
   end
 end

data/lib/perron/data_source/class_methods.rb

@@ -17,6 +17,14 @@ module Perron
           all.find { it[:id] == id || it["id"] == id }
         end
 
+        def find!(id)
+          data_source = all.find { it[:id] == id || it["id"] == id }
+
+          return data_source if data_source
+
+          raise Errors::DataSourceNotFoundError, "Row not found with id: #{id}"
+        end
+
         def count = all.size
 
         def first = all.first