perron 1.0.0 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 72473e733aa6ec4313dc71e66b2a949dea6497b427e304cb4656be0d0a5fbc86
-  data.tar.gz: 37a57b14891cf3fef0dfb1a4c98b414852fdd1bd3f3e377c674e15673f6d2547
+  metadata.gz: bdd54bac7e739c0199d3381c1f20aaf15dd5c4dfddec9f57635c0dcf41b66505
+  data.tar.gz: c04dc9b074c2a53803086ee6f9a5a7780a26f930661a0884513185323197ba03
 SHA512:
-  metadata.gz: 478b181f494c2c0ac54e996c0d9f289c7694bedbcd203fd435c9222ecdd07ad6c5a3f5e8baeb497ee2f77499e3580f0f915439d2feba1edf8ab42385285a7e96
-  data.tar.gz: 19750396f542ac909322aa5cd3ed247dc10a03509ab521bdb75dd0ae705c502e80b3431737d5c34eb42bcacda17c0ef0c35889cb65561339646f6eb7a2ee1e58
+  metadata.gz: 0fdac048810289509dc253a93839fd2df30358a90e463dac6acc3e0cad1171640698e973522d5321b53ca807c56f9a806aeb4bdc972f56773ee0b2693871009b
+  data.tar.gz: 8864e0a699f0cf04cc67c696dee53df33e70cd7abe9d57a34b75312613d332c09d0e675fc46a02a52870f30c0a556bb00c98fd7150c8769af5bd1a1ddb79429c

data/Gemfile.lock

@@ -1,10 +1,10 @@
 PATH
   remote: .
   specs:
-    perron (1.0.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

@@ -5,8 +5,11 @@ module Perron
     end
 
     def run_command
-      system(params[: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

data/app/helpers/perron/markdown_helper.rb

@@ -4,10 +4,11 @@ require "perron/markdown"
 
 module Perron
   module MarkdownHelper
-    def markdownify(content = nil, process: [], resource: nil, &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, resource: resource || @resource)
+      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

@@ -211,7 +211,7 @@
             <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"' %>
+              <%= 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>

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

@@ -37,6 +37,8 @@ module Perron
 
       @config.markdown_options = {}
 
+      @config.default_processors = []
+
       @config.search_scope = []
 
       @config.cache_data_sources = false
@@ -51,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")
@@ -65,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
@@ -82,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.rb

@@ -66,11 +66,13 @@ module Perron
       end
 
       data.map.with_index do |item, index|
-        unless item.is_a?(Hash)
-          raise Errors::DataParseError, "Item at index #{index} in `#{@file_path}` must be a hash/object, got #{item.class}"
+        if item.is_a?(Hash)
+          Item.new(item, identifier: @identifier)
+        elsif item.is_a?(String)
+          item
+        else
+          raise Errors::DataParseError, "Item at index #{index} in `#{@file_path}` must be a hash/object or string, got #{item.class}"
         end
-
-        Item.new(item, identifier: @identifier)
       end
     end
 

data/lib/perron/engine.rb

@@ -30,17 +30,19 @@ module Perron
     end
 
     initializer "perron.concierge", before: :add_builtin_route do |app|
-      app.config.after_initialize do
-        app.routes.append do
-          namespace :perron do
-            post :run_command, to: "concierge#run_command"
-          end
+      if Rails.env.development?
+        app.config.after_initialize do
+          app.routes.append do
+            namespace :perron do
+              post :run_command, to: "concierge#run_command"
+            end
 
-          root to: "perron/concierge#show" unless app.routes.named_routes.key?(:root)
+            root to: "perron/concierge#show" unless app.routes.named_routes.key?(:root)
+          end
         end
-      end
 
-      app.routes.finalize!
+        app.routes.finalize!
+      end
     end
 
     initializer "perron.inflections" do
@@ -57,6 +59,7 @@ module Perron
       load File.expand_path("../tasks/install.rake", __FILE__)
       load File.expand_path("../tasks/sync_sources.rake", __FILE__)
       load File.expand_path("../tasks/validate.rake", __FILE__)
+      load File.expand_path("../tasks/deploy.rake", __FILE__)
     end
   end
 end

data/lib/perron/install/deploy.yml

@@ -0,0 +1,15 @@
+# Deploy configuration for Perron
+# Requires Beam Up (`bundle add beam_up`)
+# See also: https://perron.railsdesigner.com/docs/deploy/
+
+# Uncomment and configure your provider:
+# provider: netlify
+
+# netlify:
+#   api_token: your_token_here
+#   site_id: your_site_id
+
+before_actions:
+  - RAILS_ENV=production bundle exec rails perron:build
+after_actions:
+  - bundle exec rails perron:clobber

data/lib/perron/install.rb

@@ -6,6 +6,9 @@ copy_file "#{__dir__}/install/initializer.rb", "config/initializers/perron.rb"
 say "Create content data directory"
 copy_file "#{__dir__}/install/README.md", "app/content/data/README.md"
 
+say "Create deploy configuration"
+copy_file "#{__dir__}/install/deploy.yml", "config/deploy.yml"
+
 say "Add Markdown gem options to Gemfile"
 append_to_file "Gemfile", <<~RUBY
 

data/lib/perron/paginate.rb

@@ -0,0 +1,58 @@
+# frozen_string_literal: true
+
+module Perron
+  class Paginate
+    def initialize(collection, page:, per_page:, base_path: nil, page_path_template: nil, use_query_params: false)
+      @collection = collection
+      @per_page = per_page
+      @base_path = base_path
+      @page_path_template = page_path_template || "/page/:page/"
+      @use_query_params = use_query_params
+
+      @total_items = collection.size
+      @total_pages = total_items.zero? ? 0 : (total_items.to_f / per_page).ceil
+      @current_page = page.clamp(1, total_pages.zero? ? 1 : total_pages)
+    end
+
+    attr_reader :current_page, :total_pages, :total_items, :per_page
+
+    def items
+      offset = (@current_page - 1) * @per_page
+
+      @collection[offset, @per_page] || []
+    end
+
+    def next? = @current_page < @total_pages
+
+    def previous? = @current_page > 1
+
+    def next
+      return unless next?
+
+      page_path(@current_page + 1)
+    end
+
+    def previous
+      return unless previous?
+
+      target = (@current_page == 2) ? 1 : @current_page - 1
+
+      page_path(target)
+    end
+
+    private
+
+    attr_reader :use_query_params
+
+    def page_path(number)
+      return if number < 1
+      return if number > @total_pages && @total_pages > 0
+
+      return @base_path if number <= 1
+
+      return "#{@base_path}?page=#{number}" if @use_query_params
+
+      @base_path.sub(/\/$/, "") + @page_path_template.sub(":page", number.to_s)
+    end
+  end
+end

data/lib/perron/relation.rb

@@ -2,9 +2,12 @@
 
 module Perron
   class Relation < Array
-    def initialize(resources = [])
-      super
+    def initialize(resources = [], model_class = nil)
+      super(resources)
+
+      @model_class = model_class
     end
+    attr_reader :model_class
 
     def where(**conditions)
       filtered = select do |resource|
@@ -19,12 +22,12 @@ module Perron
         end
       end
 
-      Relation.new(filtered)
+      Relation.new(filtered, @model_class)
     end
 
-    def limit(count) = Relation.new(first(count))
+    def limit(count) = Relation.new(first(count), @model_class)
 
-    def offset(count) = Relation.new(drop(count))
+    def offset(count) = Relation.new(drop(count), @model_class)
 
     def order(attribute, direction = :asc)
       if attribute.is_a?(Hash)
@@ -33,7 +36,7 @@ module Perron
 
       sorted = sort_by { it.public_send(attribute) }
 
-      Relation.new((direction == :desc) ? sorted.reverse : sorted)
+      Relation.new((direction == :desc) ? sorted.reverse : sorted, @model_class)
     end
 
     def pluck(*attributes)
@@ -47,5 +50,20 @@ module Perron
         end
       end
     end
+
+    def in_order_of(attribute, values, filter: true)
+      return Relation.new([]) if values.empty?
+
+      indexed = values.each_with_index.to_h
+
+      resources = if filter
+        select { indexed.key?(it.public_send(attribute)) }
+          .sort_by { indexed[it.public_send(attribute)] }
+      else
+        sort_by { indexed[it.public_send(attribute)] || Float::INFINITY }
+      end
+
+      Relation.new(resources)
+    end
   end
 end

data/lib/perron/resource/class_methods.rb

@@ -22,6 +22,8 @@ module Perron
 
         def order(attribute, direction = :asc) = all.order(attribute, direction)
 
+        def in_order_of(attribute, values, filter: true) = all.in_order_of(attribute, values, filter:)
+
         def first(n = nil)
           n ? all.first(n) : all[0]
         end
@@ -44,6 +46,10 @@ module Perron
 
         def root = all.find(&:root?)
 
+        def destroy_all
+          all.each(&:destroy)
+        end
+
         def model_name
           @model_name ||= ActiveModel::Name.new(self, nil, name.demodulize.to_s)
         end

data/lib/perron/resource/configuration.rb

@@ -31,6 +31,9 @@ module Perron
             config.related_posts.enabled = false
             config.related_posts.max = 5
 
+            config.pagination = ActiveSupport::OrderedOptions.new
+            config.pagination.path_template = "/page/:page/"
+
             config.sitemap = ActiveSupport::OrderedOptions.new
             config.sitemap.exclude = false
           end

data/lib/perron/resource/metadata.rb

@@ -3,22 +3,28 @@
 module Perron
   class Resource
     class Metadata
-      def initialize(resource:, frontmatter:, collection:)
+      def initialize(resource:, frontmatter:, collection:, controller_metadata: {})
         @resource = resource
         @frontmatter = frontmatter&.deep_symbolize_keys || {}
         @collection = collection
+        @controller_metadata = controller_metadata
         @config = Perron.configuration
       end
 
       def data
         @data ||= ActiveSupport::OrderedOptions
           .new
-          .merge(apply_fallbacks_and_defaults(to: merged_site_collection_resource_frontmatter))
+          .merge(apply_fallbacks_and_defaults(to: merged_metadata))
       end
 
       private
 
-      def merged_site_collection_resource_frontmatter = site_data.merge(collection_data).merge(@frontmatter)
+      def merged_metadata
+        site_data
+          .merge(collection_data)
+          .merge(@controller_metadata)
+          .merge(@frontmatter)
+      end
 
       def apply_fallbacks_and_defaults(to:)
         to[:title] ||= @config.site_name || Rails.application.name.underscore.camelize

data/lib/perron/resource/sourceable.rb

@@ -5,6 +5,11 @@ module Perron
     module Sourceable
       extend ActiveSupport::Concern
 
+      MODES = {
+        single: ->(dataset) { dataset.zip },
+        combinations: ->(dataset) { dataset.to_a.combination(2).to_a }
+      }
+
       class_methods do
         def sources(*arguments)
           @source_definitions = parsed(*arguments)
@@ -32,7 +37,7 @@ module Perron
         def generate_from_sources!
           return unless source_backed?
 
-          combinations.each do |combo|
+          derive.each do |combo|
             content = content_with combo
             filename = filename_with combo
 
@@ -48,7 +53,7 @@ module Perron
         def parsed(*arguments)
           return {} if arguments.empty?
 
-          arguments.flat_map do |argument|
+          definitions = arguments.flat_map do |argument|
             case argument
             when Hash
               argument.to_a
@@ -58,11 +63,39 @@ module Perron
               [[argument, {primary_key: :id}]]
             end
           end.to_h
+
+          if definitions.values.any? { it[:mode] }
+            raise ArgumentError, "mode is only supported for single-source definitions" if definitions.size > 1
+          end
+
+          definitions
         end
 
-        def combinations
+        def derive
           datasets = source_names.map { resolve it }
 
+          if single_source_with_mode?
+            derive_from_single_source(datasets.first)
+          else
+            derive_from_multiple_sources(datasets)
+          end
+        end
+
+        def derive_from_single_source(dataset)
+          source_name = source_names.first
+          mode = source_definitions[source_name][:mode] || :single
+          method = MODES[mode.to_sym] || raise(ArgumentError, "Unknown mode: #{mode}")
+
+          method.call(dataset).each do |combo|
+            primary_key = source_definitions[source_name][:primary_key] || :id
+
+            combo.each do |item|
+              raise Errors::DataParseError, "Primary key `#{primary_key}` is nil for row" if item.public_send(primary_key).nil?
+            end
+          end
+        end
+
+        def derive_from_multiple_sources(datasets)
           datasets.first.product(*datasets[1..]).each do |combo|
             combo.each_with_index do |item, index|
               name = source_names[index]
@@ -74,18 +107,37 @@ module Perron
         end
 
         def content_with(combo)
-          data = source_names.each.with_index.to_h { |name, index| [name, combo[index]] }
+          data = if single_source_with_mode?
+            source_name = source_names.first
+            names = source_definitions[source_name][:as]&.map(&:to_sym) || (1..combo.size).map { :"#{source_name}_#{it}" }
+
+            combo.each_with_index.to_h { |item, index| [names[index], item] }
+          else
+            source_names.each_with_index.to_h { |name, index| [name, combo[index]] }
+          end
+
           source = Source.new(data)
 
           source_template(source)
         end
 
         def filename_with(combo)
-          source_names.each_with_index.map do |name, index|
-            primary_key = source_definitions[name][:primary_key]
+          if single_source_with_mode?
+            source_name = source_names.first
+            primary_key = source_definitions[source_name][:primary_key] || :id
+
+            combo.map { it.public_send(primary_key) }.join("-")
+          else
+            source_names.each_with_index.map do |name, index|
+              primary_key = source_definitions[name][:primary_key]
+
+              combo[index].public_send(primary_key)
+            end.join("-")
+          end
+        end
 
-            combo[index].public_send(primary_key)
-          end.join("-")
+        def single_source_with_mode?
+          source_names.one? && source_definitions[source_names.first][:mode]
         end
 
         def output_dir = Perron.configuration.input.join(model_name.collection)

data/lib/perron/resource.rb

@@ -96,6 +96,10 @@ module Perron
       slug == "/"
     end
 
+    def destroy
+      File.delete(@file_path) and self
+    end
+
     private
 
     ID_LENGTH = 8
@@ -117,6 +121,8 @@ module Perron
     end
 
     def erb_processing?
+      return false if metadata.erb == false
+
       @file_path.ends_with?(".erb") || metadata.erb == true
     end
   end

data/lib/perron/site/builder/feeds/atom.erb

@@ -16,7 +16,7 @@
 
   <% resources.each do |resource| %>
   <entry>
-    <id><%= url_for_resource.call(resource) || "#{@configuration.url}/posts/#{resource.id}" %></id>
+    <id><%= url_for_resource.call(resource) %></id>
     <title><%= resource.metadata.title %></title>
     <link href="<%= url_for_resource.call(resource) %>" rel="alternate" type="text/html"/>
     <published><%= resource.published_at&.iso8601 %></published>

data/lib/perron/site/builder/page.rb

@@ -11,13 +11,15 @@ module Perron
         end
 
         def render
-          action = route_info[:action]
+          info = route_info
+          return puts "  ❌ ERROR: No route matches '#{@path}'" unless info
+
           request = ActionDispatch::Request.new(env)
           response = ActionDispatch::Response.new
 
-          request.path_parameters = route_info
+          request.path_parameters = info
 
-          controller.dispatch(action, request, response)
+          controller.dispatch(info[:action], request, response)
 
           return puts "  ❌ ERROR: Request failed for '#{@path}' (Status: #{response.status})" unless response.successful?
 
@@ -41,7 +43,20 @@ module Perron
         end
 
         def route_info
-          @route_info ||= Rails.application.routes.recognize_path(@path)
+          @route_info ||= recognize_path_with_pagination_fallback(@path)
+        end
+
+        def recognize_path_with_pagination_fallback(path)
+          Rails.application.routes.recognize_path(path)
+        rescue ActionController::RoutingError
+          return nil unless (match = path.match(/\/(.+)\/page\/(\d+)\//))
+
+          base_path = "/#{match[1]}"
+          page_number = match[2].to_i
+
+          Rails.application.routes.recognize_path(base_path).tap do |route_info|
+            route_info[:page] = page_number
+          end
         end
 
         def env = Rack::MockRequest.env_for(@path, "HTTP_HOST" => Perron.configuration.default_url_options[:host])

data/lib/perron/site/builder/paths.rb

@@ -28,12 +28,30 @@ module Perron
               raise "Route `#{route.name}` (#{route.path.spec}) is an index route but requires parameters #{required_params}. Perron doesn't know how to generate these parameters."
             end
 
-            [routes.public_send("#{route.name}_path")]
+            base_path = routes.public_send("#{route.name}_path")
+            collection = collection_for(route)
+            return [base_path] unless collection
+
+            pagination = collection.configuration.pagination
+            return [base_path] unless pagination.per_page
+
+            total = collection.all.count
+            total_pages = (total.to_f / pagination.per_page).ceil
+            return [base_path] if total_pages <= 1
+
+            [base_path] + (2..total_pages).map do |page_number|
+              build_paginated_path(route, page_number, pagination.path_template)
+            end
           when "show" then show_paths_for(route)
           else []
           end
         end
 
+        def build_paginated_path(route, page_number, path_template)
+          routes.public_send("#{route.name}_path")
+            .sub(/\/$/, "") + path_template.sub(":page", page_number.to_s)
+        end
+
         def show_paths_for(route)
           resources_for(route).reject(&:root?).map do |resource|
             routes.public_send("#{route.name}_path", resource)

data/lib/perron/site/builder.rb

@@ -16,6 +16,8 @@ module Perron
       end
 
       def build
+        run_hook(:before_build)
+
         if Perron.configuration.mode.standalone?
           puts "🧹 Cleaning previous build…"
 
@@ -35,6 +37,8 @@ module Perron
         output_preview_urls
 
         puts "\n✅ Build complete"
+      ensure
+        run_hook(:after_build)
       end
 
       private
@@ -58,6 +62,26 @@ module Perron
           end
         end
       end
+
+      def run_hook(name)
+        return unless (hook = Perron.configuration.public_send(name))
+
+        context = Context.new(
+          output_path: @output_path.to_s,
+          mode: Perron.configuration.mode
+        )
+
+        hook.call(context)
+      end
+
+      class Context
+        attr_reader :output_path, :mode
+
+        def initialize(output_path:, mode:)
+          @output_path = output_path
+          @mode = mode
+        end
+      end
     end
   end
 end

data/lib/perron/site/validate.rb

@@ -36,7 +36,11 @@ module Perron
       def validate_collection(collection)
         collection.resources.each do |resource|
           resource.validate ? success : failed(resource)
+        rescue Psych::SyntaxError => error
+          render_yaml error, resource.file_path
         end
+      rescue Psych::SyntaxError => error
+        render_yaml error, "unknown"
       end
 
       def success = print "#{GREEN}.#{RESET}"
@@ -44,13 +48,22 @@ module Perron
       def failed(resource)
         print "#{RED}F#{RESET}"
 
-        errors = []
+        @failures << Failure.new(
+          identifier: resource.file_path,
+          errors: resource.errors.respond_to?(:full_messages) ? resource.errors.full_messages : []
+        )
+      end
 
-        if resource.respond_to?(:errors) && resource.errors.respond_to?(:full_messages) && resource.errors.any?
-          errors = resource.errors.full_messages
-        end
+      def render_yaml(error, identifier)
+        print "#{RED}F#{RESET}"
+
+        line_info = error.line ? " at line #{error.line}" : ""
+        column_info = error.column ? ", column #{error.column}" : ""
 
-        @failures << Failure.new(identifier: resource.file_path, errors: errors)
+        @failures << Failure.new(
+          identifier: identifier,
+          errors: ["Invalid YAML#{line_info}#{column_info}: #{error.problem}"]
+        )
       end
 
       def failures_report

data/lib/perron/tasks/deploy.rake

@@ -0,0 +1,58 @@
+namespace :perron do
+  desc "Deploy static site using Beam Up"
+  task deploy: :environment do
+    begin
+      require "beam_up"
+    rescue LoadError
+      raise LoadError, <<~MSG
+        Beam Up is required for the deploy task to run.
+
+        Add it to your Gemfile:
+          gem "beam_up"
+
+        Read more: https://perron.railsdesigner.com/docs/deploy/
+      MSG
+    end
+
+    config = Rails.root.join("config/deploy.yml")
+
+    unless config.exist?
+      template = File.expand_path("../install/deploy.yml", __dir__)
+      FileUtils.cp(template, config)
+
+      puts "Created config/deploy.yml"
+    end
+
+    beamed = BeamUp.with_progress do
+      BeamUp.deploy!(
+        Perron.configuration.output,
+        config_file: "config/deploy.yml"
+      )
+    end
+
+    puts beamed.message
+    puts "Deploy ID: #{beamed.deploy_id}" if beamed.deploy_id
+  end
+
+  namespace :deploy do
+    desc "Initialize deploy configuration with Beam Up"
+    task :init, [:provider] do |task, arguments|
+      begin
+        require "beam_up"
+      rescue LoadError
+        raise LoadError, <<~MSG
+          Beam Up is required for the deploy task to run.
+
+          Add it to your Gemfile:
+            gem "beam_up"
+
+          See for more: https://perron.railsdesigner.com/docs/deploy/
+        MSG
+      end
+
+      path = BeamUp.init!(arguments[:provider], config_file: "config/deploy.yml")
+
+      puts "Configured Beam Up in #{path}"
+    end
+  end
+end

data/lib/perron/version.rb

@@ -1,3 +1,3 @@
 module Perron
-  VERSION = "1.0.0"
+  VERSION = "1.1.0"
 end

data/lib/perron.rb

@@ -6,6 +6,7 @@ require "perron/deprecator"
 require "perron/errors"
 require "perron/site"
 require "perron/relation"
+require "perron/paginate"
 require "perron/content/data"
 require "perron/resource"
 require "perron/markdown"

data/perron.gemspec

@@ -19,7 +19,7 @@ Gem::Specification.new do |spec|
   spec.required_ruby_version = ">= 3.4.0"
 
   spec.add_dependency "rails", ">= 7.2.0"
-  spec.add_dependency "mata", "~> 0.8.0"
+  spec.add_dependency "mata", "~> 0.10.0"
 
   spec.add_runtime_dependency "csv"
   spec.add_runtime_dependency "json"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: perron
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.1.0
 platform: ruby
 authors:
 - Rails Designer Developers
@@ -29,14 +29,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.8.0
+        version: 0.10.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.8.0
+        version: 0.10.0
 - !ruby/object:Gem::Dependency
   name: csv
   requirement: !ruby/object:Gem::Requirement
@@ -98,6 +98,7 @@ files:
 - app/helpers/perron/feeds_helper.rb
 - app/helpers/perron/markdown_helper.rb
 - app/helpers/perron/meta_tags_helper.rb
+- app/helpers/perron/paginate_helper.rb
 - app/views/perron/concierge/show.html.erb
 - bin/console
 - bin/rails
@@ -133,10 +134,12 @@ files:
 - lib/perron/html_processor/target_blank.rb
 - lib/perron/install.rb
 - lib/perron/install/README.md.tt
+- lib/perron/install/deploy.yml
 - lib/perron/install/initializer.rb.tt
 - lib/perron/markdown.rb
 - lib/perron/metatags.rb
 - lib/perron/output_server.rb
+- lib/perron/paginate.rb
 - lib/perron/refinements/delete_suffixes.rb
 - lib/perron/relation.rb
 - lib/perron/resource.rb
@@ -180,6 +183,7 @@ files:
 - lib/perron/site/validate.rb
 - lib/perron/tasks/build.rake
 - lib/perron/tasks/clobber.rake
+- lib/perron/tasks/deploy.rake
 - lib/perron/tasks/install.rake
 - lib/perron/tasks/sync_sources.rake
 - lib/perron/tasks/validate.rake
@@ -205,7 +209,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.6
+rubygems_version: 4.0.14
 specification_version: 4
 summary: Rails-based static site generator
 test_files: []