perron 0.17.0 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fbf1b0d5483938df7b88423f3ecd72bffaf938eadcc49a3001a34fcb0156dfb9
-  data.tar.gz: cd8871c7ef91a102a45bcebbcdc8bbf385db3a83ffb34948cd0d3e49c14d8237
+  metadata.gz: 72473e733aa6ec4313dc71e66b2a949dea6497b427e304cb4656be0d0a5fbc86
+  data.tar.gz: 37a57b14891cf3fef0dfb1a4c98b414852fdd1bd3f3e377c674e15673f6d2547
 SHA512:
-  metadata.gz: 4d21cfbf61b54fb704990a23cbbf73285364e37ab722246c0202ecea37616398edcfe3fc9f841bc3cae9100108cb61e37200780c0e0ef667515f6e27319498e4
-  data.tar.gz: bed9e2b68bf2a5697a72a6b3bcb2dfcdb6898b93e31b6bc68b169583462d9e4a4f3e345dec8470077b2566dd31860e8ca97ce83cd82b8a01aff889ad0d5a7d14
+  metadata.gz: 478b181f494c2c0ac54e996c0d9f289c7694bedbcd203fd435c9222ecdd07ad6c5a3f5e8baeb497ee2f77499e3580f0f915439d2feba1edf8ab42385285a7e96
+  data.tar.gz: 19750396f542ac909322aa5cd3ed247dc10a03509ab521bdb75dd0ae705c502e80b3431737d5c34eb42bcacda17c0ef0c35889cb65561339646f6eb7a2ee1e58

data/Gemfile

@@ -4,7 +4,7 @@ source "https://rubygems.org"
 
 gemspec
 
-gem "rails", "~> 7.2.0"
+gem "appraisal"
 
 group :development do
   gem "standard", "~> 1.50.0"

data/Gemfile.lock

@@ -1,9 +1,10 @@
 PATH
   remote: .
   specs:
-    perron (0.17.0)
+    perron (1.0.0)
       csv
       json
+      mata (~> 0.8.0)
       psych
       rails (>= 7.2.0)
 
@@ -81,6 +82,10 @@ GEM
       minitest (>= 5.1)
       securerandom (>= 0.3)
       tzinfo (~> 2.0, >= 2.0.5)
+    appraisal (2.5.0)
+      bundler
+      rake
+      thor (>= 0.14.0)
     ast (2.4.3)
     base64 (0.3.0)
     benchmark (0.4.1)
@@ -97,6 +102,14 @@ GEM
     drb (2.2.3)
     erb (5.0.1)
     erubi (1.13.1)
+    ffi (1.17.3-aarch64-linux-gnu)
+    ffi (1.17.3-aarch64-linux-musl)
+    ffi (1.17.3-arm-linux-gnu)
+    ffi (1.17.3-arm-linux-musl)
+    ffi (1.17.3-arm64-darwin)
+    ffi (1.17.3-x86_64-darwin)
+    ffi (1.17.3-x86_64-linux-gnu)
+    ffi (1.17.3-x86_64-linux-musl)
     globalid (1.2.1)
       activesupport (>= 6.1)
     i18n (1.14.7)
@@ -109,6 +122,10 @@ GEM
     json (2.12.2)
     language_server-protocol (3.17.0.5)
     lint_roller (1.1.0)
+    listen (3.10.0)
+      logger
+      rb-fsevent (~> 0.10, >= 0.10.3)
+      rb-inotify (~> 0.9, >= 0.9.10)
     logger (1.7.0)
     loofah (2.24.1)
       crass (~> 1.0.2)
@@ -119,6 +136,9 @@ GEM
       net-pop
       net-smtp
     marcel (1.0.4)
+    mata (0.8.0)
+      listen (~> 3.0)
+      rack (>= 3.0)
     mini_mime (1.1.5)
     mini_portile2 (2.8.9)
     minitest (5.27.0)
@@ -202,6 +222,9 @@ GEM
       zeitwerk (~> 2.6)
     rainbow (3.1.1)
     rake (13.3.0)
+    rb-fsevent (0.11.2)
+    rb-inotify (0.11.1)
+      ffi (~> 1.0)
     rdoc (6.14.2)
       erb
       psych (>= 4.0.0)
@@ -267,10 +290,10 @@ PLATFORMS
   x86_64-linux-musl
 
 DEPENDENCIES
+  appraisal
   debug (~> 1.11.0)
   minitest (~> 5.25, >= 5.25.5)
   perron!
-  rails (~> 7.2.0)
   rake (~> 13.3.0)
   rouge (~> 4.6.0)
   standard (~> 1.50.0)

data/app/controllers/perron/concierge_controller.rb

@@ -0,0 +1,13 @@
+module Perron
+  class ConciergeController < ActionController::Base
+    def show
+      render :show
+    end
+
+    def run_command
+      system(params[:command])
+
+      redirect_back fallback_location: root_path
+    end
+  end
+end

data/app/controllers/perron/searches_controller.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+module Perron
+  class SearchesController < ApplicationController
+    before_action :force_json, only: %w[show]
+
+    def show
+      resources = search_scope.flat_map(&:all)
+      index = resources.map do |resource|
+        base_fields(resource).merge(additional_search_fields(resource))
+      end
+
+      render json: index
+    end
+
+    private
+
+    def force_json
+      request.format = :json
+    end
+
+    def search_scope
+      Perron
+        .configuration
+        .search_scope
+        .map { "Content::#{it.classify}".safe_constantize }
+        .compact_blank
+    end
+
+    def base_fields(resource)
+      {
+        slug: polymorphic_path(resource),
+        href: polymorphic_path(resource),
+        title: resource.try(:title) || resource.metadata.title,
+        headings: resource.extracted_headings.flatten.join(" "),
+        body: resource.sweeped_content
+      }
+    end
+
+    def additional_search_fields(resource)
+      return {} unless resource.class.search_fields_list.any?
+
+      resource.class.search_fields_list.to_h do |field|
+        [field, resource.public_send(field)]
+      end
+    end
+  end
+end

data/app/helpers/perron/feeds_helper.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module Perron
+  module FeedsHelper
+    def feeds(options = {}) = Perron::Feeds.new.render(options)
+  end
+end

data/app/helpers/perron/markdown_helper.rb

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

data/app/helpers/perron/meta_tags_helper.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Perron
+  module MetaTagsHelper
+    def meta_tags(options = {}) = Perron::Metatags.new(resource.metadata).render(options)
+
+    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)
+    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 "My first post"' %>
+
+              <% 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/bin/release

@@ -3,17 +3,32 @@
 VERSION=$1
 
 if [ -z "$VERSION" ]; then
-  echo "Error: The version number is required."
-  echo "Usage: $0 <version-number>"
+  echo "Error: Version number or bump type is required"
+  echo "  Usage: $0 <major|minor|patch|version-number>"
+
   exit 1
 fi
 
+if [[ "$VERSION" =~ ^(major|minor|patch)$ ]]; then
+  CURRENT=$(grep -o '"[^"]*"' ./lib/perron/version.rb | tr -d '"')
+  IFS='.' read -r MAJOR MINOR PATCH <<< "$CURRENT"
+
+  case $VERSION in
+    major) VERSION="$((MAJOR + 1)).0.0" ;;
+    minor) VERSION="$MAJOR.$((MINOR + 1)).0" ;;
+    patch) VERSION="$MAJOR.$MINOR.$((PATCH + 1))" ;;
+  esac
+fi
+
 printf "module Perron\n  VERSION = \"$VERSION\"\nend\n" > ./lib/perron/version.rb
+
 bundle
+
 git add Gemfile.lock lib/perron/version.rb
 git commit -m "Bump version for $VERSION"
 git push
 git tag v$VERSION
 git push --tags
-gem build perron.gemspec
-gem push "perron-$VERSION.gem"
+
+bundle exec rake build
+gem push "pkg/perron-$VERSION.gem"

data/lib/generators/rails/content/USAGE

@@ -2,63 +2,82 @@ Description:
     Generates content model scaffold (controller, views, routes) or creates
     new content files from templates.
 
+Arguments:
+    NAME                Name of the content model (singular or plural)
+    actions             Actions to generate (default: index show)
+
+Options:
+    --new [TITLE]                   Create new content file instead of scaffold
+    --data [SOURCE...]              Create data source files (default extension: .yml)
+    --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 content scaffold:
+    Generate basic content scaffold:
         rails generate content Post
         rails generate content Post index
         rails generate content Post index show
 
-    This will create:
+    Creates:
         app/content/posts/
         app/models/content/post.rb
         app/controllers/content/posts_controller.rb
         app/views/content/posts/index.html.erb
         app/views/content/posts/show.html.erb
 
-    And adds: resources :posts, module: :content, only: %w[index show]
+    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
 
-    This will additionally create:
+    Additionally creates:
         app/content/pages/root.erb
-        def root action in Content::PagesController
-        root route in config/routes.rb (if not already defined)
+        root action in app/controllers/content/pages_controller.rb
+        root route in config/routes.rb
 
-    Skip root generation for pages:
+    Control root generation:
         rails generate content Page --no-include-root
-
-    Include root for non-pages content:
         rails generate content Article --include-root
 
-    Generate content scaffold with data sources:
+    Generate scaffold with data sources:
         rails generate content Product --data countries products
         rails generate content Product --data countries.json products.yml
 
-    This will additionally create data source files in app/content/products/
-    and add sources/template_source class methods to the model.
+    Creates data source files in app/content/data/ and adds
+    .sources and .template_source class methods to the model.
 
     Create new content file from template:
         rails generate content Post --new
         rails generate content Post --new "My First Post"
 
-    This will create a new content file in app/content/posts/ using:
-        - YYYY-MM-DD-template.*.tt (if exists, with date prefix)
-        - template.*.tt (if exists, without date prefix)
-        - Empty file with frontmatter dashes (if no template)
+    Creates a new content file in app/content/posts/ using:
+        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 %>
         published_at: <%= Time.current %>
         ---
-
-Arguments:
-    NAME: Name of the content model (singular or plural)
-    actions: Actions to generate (default: index show)
-
-Options:
-    --new [TITLE]: Create new content file instead of scaffold
-    --data [source1(.ext) source2(.ext)]: Create data source files (default extension: .yml)
-    --force-plural: Use plural form for model name and class
-    --[no-]include-root: Include root action and route (default: true for pages, false otherwise)