perron 0.15.0 → 0.17.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f86f6e49cb1954ed51dc8aa0c2b6cfdaf3f1fcc3c78141b36c837f0eef26a9c8
-  data.tar.gz: efaff555c00579430812ca06e3ee6a87376db403321ab302762b393356d7607a
+  metadata.gz: fbf1b0d5483938df7b88423f3ecd72bffaf938eadcc49a3001a34fcb0156dfb9
+  data.tar.gz: cd8871c7ef91a102a45bcebbcdc8bbf385db3a83ffb34948cd0d3e49c14d8237
 SHA512:
-  metadata.gz: c7e7c64d77fac8aadb06e3fc3541db5f8593a571938c12020dcbcb03e3f968dd326eede32b06342843df4b0e84e8722b4beb95b5d202283539b763ba3db01ada
-  data.tar.gz: 1a3f470b3412fa9187bca282ee1ac051cd1674c34a19a761b6cdedf901f0e5e2e6bb2c1a025ffadf1e2f478fcf13b9f8a90ab29579d46ae0cf3594099b13fb5d
+  metadata.gz: 4d21cfbf61b54fb704990a23cbbf73285364e37ab722246c0202ecea37616398edcfe3fc9f841bc3cae9100108cb61e37200780c0e0ef667515f6e27319498e4
+  data.tar.gz: bed9e2b68bf2a5697a72a6b3bcb2dfcdb6898b93e31b6bc68b169583462d9e4a4f3e345dec8470077b2566dd31860e8ca97ce83cd82b8a01aff889ad0d5a7d14

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    perron (0.15.0)
+    perron (0.17.0)
       csv
       json
       psych
@@ -120,7 +120,8 @@ GEM
       net-smtp
     marcel (1.0.4)
     mini_mime (1.1.5)
-    minitest (5.25.5)
+    mini_portile2 (2.8.9)
+    minitest (5.27.0)
     net-imap (0.5.9)
       date
       net-protocol
@@ -131,6 +132,9 @@ GEM
     net-smtp (0.5.1)
       net-protocol
     nio4r (2.7.4)
+    nokogiri (1.18.8)
+      mini_portile2 (~> 2.8.2)
+      racc (~> 1.4)
     nokogiri (1.18.8-aarch64-linux-gnu)
       racc (~> 1.4)
     nokogiri (1.18.8-aarch64-linux-musl)
@@ -244,7 +248,7 @@ GEM
       concurrent-ruby (~> 1.0)
     unicode-display_width (3.1.4)
       unicode-emoji (~> 4.0, >= 4.0.4)
-    unicode-emoji (4.0.4)
+    unicode-emoji (4.2.0)
     useragent (0.16.11)
     websocket-driver (0.8.0)
       base64

data/lib/generators/perron/templates/initializer.rb.tt

@@ -1,25 +1,21 @@
 Perron.configure do |config|
-  # config.output = "output"
+  # View all options: https://perron.railsdesigner.com/docs/configuration/
 
   # config.site_name = "Chirp Form"
 
-  # The build mode for Perron. Can be :standalone or :integrated
+  # The build mode for Perron. Can be :standalone (SSG) or :integrated (alongside your Rails app)
   # config.mode = :standalone
 
-  # In `integrated` mode, the root is skipped by default. Set to `true` to enable
-  # config.include_root = false
-
-  # config.default_url_options = {host: "helptail.com", protocol: "https", trailing_slash: true}
+  # config.default_url_options = {host: "chirpform.com", protocol: "https", trailing_slash: true}
 
   # The options hash is passed directly to the chosen library
   # config.markdown_options = {}
 
-  # Set default meta values
-  # Examples:
-  # - `config.metadata.description = "Add forms to any static site. Display responses anywhere."`
-  # - `config.metadata.author = "Chirp Form Team"`
-
   # Set meta title suffix
   # config.metadata.title_suffix = nil
   # config.metadata.title_separator = " — "
+
+  # Set default meta values
+  # config.metadata.description = "Add forms to any static site. Display responses anywhere."
+  # config.metadata.author = "Chirp Form Team"
 end

data/lib/generators/rails/content/USAGE

@@ -17,6 +17,27 @@ Examples:
 
     And adds: resources :posts, module: :content, only: %w[index show]
 
+    Generate pages scaffold with root:
+        rails generate content Page
+
+    This will additionally create:
+        app/content/pages/root.erb
+        def root action in Content::PagesController
+        root route in config/routes.rb (if not already defined)
+
+    Skip root generation for pages:
+        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:
+        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.
+
     Create new content file from template:
         rails generate content Post --new
         rails generate content Post --new "My First Post"
@@ -38,4 +59,6 @@ Arguments:
 
 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)

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

@@ -8,8 +8,11 @@ module Rails
       source_root File.expand_path("templates", __dir__)
 
       class_option :force_plural, type: :boolean, default: false, desc: "Forces the use of a plural model name and class"
+      class_option :include_root, type: :boolean, default: nil, desc: "Include root action and route (defaults to true for pages)"
       class_option :new, type: :string, default: nil, banner: "TITLE",
         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)"
 
       argument :actions, type: :array, default: %w[index show], banner: "actions", desc: "Specify which actions to generate (index/show)"
 
@@ -60,25 +63,52 @@ module Rails
         FileUtils.mkdir_p(content_directory)
       end
 
-      def create_pages_root
+      def add_content_route
         return if @content_mode
-        return unless pages_controller?
 
-        template "root.erb.tt", File.join(content_directory, "root.erb")
+        route "resources :#{plural_file_name}, module: :content, only: %w[#{actions.join(" ")}]"
       end
 
-      def add_content_route
+      def create_data_sources
         return if @content_mode
+        return if options[:data].empty?
 
-        route "resources :#{plural_file_name}, module: :content, only: %w[#{actions.join(" ")}]"
+        options[:data].each do |source|
+          name, extension = source.split(".", 2)
+
+          create_file File.join(content_directory, "#{name}.#{extension || "yml"}"), ""
+        end
+      end
+
+      def add_root_action
+        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
+
+          render :show
+        end
+          RUBY
+        end
+      end
+
+      def create_root_content_file
+        return if @content_mode
+        return unless should_include_root?
+
+        template "root.erb.tt", File.join(content_directory, "root.erb")
       end
 
       def add_root_route
         return if @content_mode
-        return unless pages_controller?
+        return unless should_include_root?
         return if root_route_exists?
 
-        inject_into_file "config/routes.rb", "  root to: \"content/pages#root\"\n", before: /^\s*end\s*$/
+        route "root to: \"content/#{plural_file_name}#root\""
       end
 
       private
@@ -99,14 +129,6 @@ module Rails
 
       def pages_controller? = plural_file_name == "pages"
 
-      def root_route_exists?
-        routes = File.join(destination_root, "config", "routes.rb")
-
-        return false unless File.exist?(routes)
-
-        File.read(routes).match?(/\broot\s+to:/)
-      end
-
       def template_file
         @template_file ||= Dir.glob(File.join(content_directory, "{YYYY-MM-DD-,}template.*.tt")).first
       end
@@ -121,6 +143,23 @@ module Rails
           end
         end
       end
+
+      def should_include_root?
+        options[:include_root].nil? ? pages_controller? : options[:include_root]
+      end
+
+      def root_route_exists?
+        routes = File.join(destination_root, "config", "routes.rb")
+        return false unless File.exist?(routes)
+
+        File.read(routes).match?(/\broot\s+to:/)
+      end
+
+      def data_sources
+        options[:data].map { it.split(".").first }
+      end
+
+      def data_sources? = !options[:data].empty?
     end
   end
 end

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

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

data/lib/generators/rails/content/templates/root.erb.tt

@@ -1,4 +1,4 @@
 ---
 ---
 
-Find me in `app/content/pages/root.erb`
+Find me in `app/content/<%= plural_file_name %>/root.erb`

data/lib/generators/rails/content/templates/show.html.erb.tt

@@ -3,5 +3,5 @@
     <%%= @resource.filename %>
   </h1>
 
-  <%%= markdownify @resource.content %>
+  <%%= @resource.content %>
 </article>

data/lib/perron/configuration.rb

@@ -16,12 +16,9 @@ module Perron
       @config.site_name = nil
       @config.site_description = nil
 
-      @config.site_email = nil
-
       @config.output = "output"
 
       @config.mode = :standalone
-      @config.include_root = false
 
       @config.allowed_extensions = %w[erb md]
 
@@ -55,7 +52,11 @@ module Perron
 
     def mode = @config.mode.to_s.inquiry
 
-    def exclude_root? = !@config.include_root
+    def additional_routes
+      @additional_routes || (mode.integrated? ? [] : %w[root_path])
+    end
+
+    attr_writer :additional_routes
 
     def url
       options = Perron.configuration.default_url_options

data/lib/perron/content/data.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Content
+  module Data
+    def self.const_missing(name)
+      klass = Class.new(Perron::Data) do
+        def self.const_missing(nested_name) = const_set(nested_name, Class.new(Perron::Data))
+      end
+
+      const_set(name, klass)
+    end
+  end
+end

data/lib/perron/data.rb

@@ -4,6 +4,8 @@ require "csv"
 
 module Perron
   class Data < SimpleDelegator
+    include Enumerable
+
     def initialize(identifier)
       @identifier = identifier
       @file_path = self.class.path_for!(identifier)
@@ -12,7 +14,51 @@ module Perron
       super(records)
     end
 
+    def each(&block) = @records.each(&block)
+
+    def count = @records.count
+
+    def first(n = nil)
+      n ? @records.first(n) : @records.first
+    end
+
+    def last = @records.last
+
+    def [](index) = @records[index]
+
+    def size = @records.size
+    alias_method :length, :size
+
     class << self
+      def all
+        parts = name.to_s.split("::").drop(2)
+        identifier = parts.empty? ? name.demodulize.underscore : parts.map(&:underscore).join("/")
+
+        new(identifier)
+      end
+
+      def find(id)
+        all.find { it[:id] == id || it["id"] == id }
+      end
+
+      def count = all.size
+
+      def first = all.first
+
+      def second = all[1]
+
+      def third = all[2]
+
+      def fourth = all[3]
+
+      def fifth = all[4]
+
+      def forty_two = all[41]
+
+      def last = all.last
+
+      def take(n) = all.first(n)
+
       def path_for(identifier)
         path = Pathname.new(identifier)
 
@@ -107,6 +153,8 @@ module Perron
 
       def [](key) = @attributes[key.to_sym]
 
+      def association_value(key) = self[key]
+
       def to_partial_path
         @to_partial_path ||= begin
           identifier = @identifier.to_s

data/lib/perron/deprecator.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module Perron
+  def self.deprecator
+    @deprecator ||= ActiveSupport::Deprecation.new("1.0", "Perron")
+  end
+end

data/lib/perron/engine.rb

@@ -1,15 +1,22 @@
 # frozen_string_literal: true
 
+require "perron/output_server"
+
 module Perron
   class Engine < Rails::Engine
     initializer "perron.default_url_options" do |app|
       app.config.action_controller.default_url_options = Perron.configuration.default_url_options
     end
 
+    initializer "perron.output_server" do |app|
+      app.middleware.use Perron::OutputServer
+    end
+
     rake_tasks do
       load File.expand_path("../tasks/build.rake", __FILE__)
-      load File.expand_path("../tasks/validate.rake", __FILE__)
+      load File.expand_path("../tasks/clobber.rake", __FILE__)
       load File.expand_path("../tasks/sync_sources.rake", __FILE__)
+      load File.expand_path("../tasks/validate.rake", __FILE__)
     end
   end
 end

data/lib/perron/output_server.rb

@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+
+module Perron
+  class OutputServer
+    def initialize(app)
+      @app = app
+    end
+
+    def call(environment)
+      return @app.call(environment) if disabled?
+
+      static_file(environment).then do |file|
+        file ? serve(file) : @app.call(environment)
+      end
+    end
+
+    private
+
+    def disabled? = !enabled?
+
+    def static_file(environment)
+      request_path = Rack::Request.new(environment).path_info
+      file_path = File.join(output_path, request_path, "index.html")
+
+      File.file?(file_path) ? file_path : nil
+    end
+
+    def serve(file_path)
+      content = File.read(file_path)
+
+      [
+        200,
+
+        {
+          "Content-Type" => "text/html; charset=utf-8",
+          "Content-Length" => content.bytesize.to_s
+        },
+
+        [content]
+      ]
+    end
+
+    def enabled? = Dir.exist?(output_path)
+
+    def output_path
+      @output_path ||= Rails.root.join(Perron.configuration.output)
+    end
+  end
+end

data/lib/perron/resource/associations.rb

@@ -22,11 +22,11 @@ module Perron
           define_method(association_name) do
             cache_has_many_association(association_name) do
               associated_class = association_class_for(association_name, singularize: true, **options)
-              foreign_key = foreign_key_for(inverse_association_name, **options)
-              primary_key_method = options.fetch(:primary_key, :slug)
-              lookup_value = public_send(primary_key_method)
+              ids_key = "#{association_name}_ids"
 
-              associated_class.all.select { |record| record.metadata[foreign_key] == lookup_value }
+              metadata[ids_key] ?
+                records_for_ids(associated_class, metadata[ids_key]) :
+                records_for_foreign_key(associated_class, association_name, **options)
             end
           end
         end
@@ -41,6 +41,10 @@ module Perron
         @belongs_to_cache[name] = yield
       end
 
+      def foreign_key_for(base_name, **options)
+        (options[:foreign_key] || "#{base_name}_id").to_s
+      end
+
       def cache_has_many_association(name)
         @has_many_cache ||= {}
         return @has_many_cache[name] if @has_many_cache.key?(name)
@@ -49,18 +53,28 @@ module Perron
       end
 
       def association_class_for(association_name, singularize: false, **options)
-        class_name = options[:class_name] || begin
+        if options[:class_name]
+          options[:class_name].to_s.constantize
+        else
           name = association_name.to_s
           name = name.singularize if singularize
 
-          "Content::#{name.classify}"
+          "Content::#{name.classify}".constantize
         end
+      end
 
-        class_name.constantize
+      def records_for_ids(associated_class, ids)
+        ids = Array(ids)
+
+        associated_class.all.select { ids.include?(it[:id]) || ids.include?(it["id"]) }
       end
 
-      def foreign_key_for(base_name, **options)
-        (options[:foreign_key] || "#{base_name}_id").to_s
+      def records_for_foreign_key(associated_class, association_name, **options)
+        foreign_key = foreign_key_for(inverse_association_name, **options)
+        primary_key_method = options.fetch(:primary_key, :slug)
+        lookup_value = public_send(primary_key_method)
+
+        associated_class.all.select { it.association_value(foreign_key) == lookup_value }
       end
 
       def inverse_association_name = self.class.name.demodulize.underscore

data/lib/perron/resource/class_methods.rb

@@ -12,7 +12,9 @@ module Perron
 
         def count = all.size
 
-        def first = all[0]
+        def first(n = nil)
+          n ? all.first(n) : all[0]
+        end
 
         def second = all[1]
 
@@ -30,9 +32,7 @@ module Perron
 
         def collection = Collection.new(collection_name)
 
-        def root
-          collection_name.pages? && collection.find_by_file_name("root", name.constantize)
-        end
+        def root = all.find(&:root?)
 
         def model_name
           @model_name ||= ActiveModel::Name.new(self, nil, name.demodulize.to_s)

data/lib/perron/resource/metadata.rb

@@ -47,7 +47,7 @@ module Perron
 
       def canonical_url
         return @frontmatter[:canonical_url] if @frontmatter[:canonical_url]
-        return Rails.application.routes.url_helpers.root_url(**Perron.configuration.default_url_options) if @resource.slug == "/"
+        return Rails.application.routes.url_helpers.root_url(**Perron.configuration.default_url_options) if @resource.root?
 
         begin
           Rails.application.routes.url_helpers.polymorphic_url(

data/lib/perron/resource/previewable.rb

@@ -9,6 +9,7 @@ module Perron
         def previewable?
           frontmatter.preview.present? && (draft? || scheduled?)
         end
+        alias_method :preview?, :previewable?
 
         def preview_token
           return nil unless previewable?

data/lib/perron/resource/sourceable.rb

@@ -40,7 +40,7 @@ module Perron
         end
 
         def combinations
-          datasets = source_names.map { Perron::Site.data.public_send(it) }
+          datasets = source_names.map { Perron::Data.new(it.to_s) }
 
           datasets.first.product(*datasets[1..])
         end
@@ -71,7 +71,8 @@ module Perron
             primary_key = options[:primary_key]
             singular_name = name.to_s.singularize
             identifier = frontmatter["#{singular_name}_#{primary_key}"]
-            hash[name] = Perron::Site.data.public_send(name).find { it.public_send(primary_key).to_s == identifier.to_s }
+
+            hash[name] = Perron::Data.new(name.to_s).find { it.public_send(primary_key).to_s == identifier.to_s }
           end
 
           Source.new(data)

data/lib/perron/resource.rb

@@ -66,6 +66,8 @@ module Perron
       render_inline_erb using: page_content
     end
 
+    def association_value(key) = metadata[key]
+
     def to_partial_path
       @to_partial_path ||= begin
         element = ActiveSupport::Inflector.underscore(ActiveSupport::Inflector.demodulize(self.class.model_name))
@@ -80,6 +82,10 @@ module Perron
     def related_resources(limit: 5) = Perron::Site::Resource::Related.new(self).find(limit:)
     alias_method :related, :related_resources
 
+    def root?
+      slug == "/"
+    end
+
     private
 
     def frontmatter
@@ -101,9 +107,5 @@ module Perron
     def erb_processing?
       @file_path.ends_with?(".erb") || metadata.erb == true
     end
-
-    def root?
-      collection.name.inquiry.pages? && File.basename(filename) == "root"
-    end
   end
 end

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

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module Perron
+  module Site
+    class Builder
+      class AdditionalRoutes
+        def initialize(paths)
+          @paths = paths
+        end
+
+        def get
+          Perron.configuration.additional_routes.each do |route_name|
+            @paths << routes.public_send(route_name) if routes.respond_to?(route_name)
+          end
+        end
+
+        private
+
+        def routes = Rails.application.routes.url_helpers
+      end
+    end
+  end
+end

data/lib/perron/site/builder/feeds/author.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+module Perron
+  module Site
+    class Builder
+      class Feeds
+        module Author
+          private
+
+          def author(resource)
+            author = (resource&.respond_to?(:author) && resource.author) ||
+              feed_configuration.author
+
+            Author.new(author) if author
+          end
+
+          class Author
+            def initialize(author)
+              @author = author
+            end
+
+            def name
+              @author.respond_to?(:metadata) ? @author.metadata.name : @author[:name]
+            end
+
+            def email
+              @author.respond_to?(:metadata) ? @author.metadata.email : @author[:email]
+            end
+
+            def url
+              @author.respond_to?(:metadata) ? @author.metadata.url : @author[:url]
+            end
+
+            def avatar
+              @author.respond_to?(:metadata) ? @author.metadata.avatar : @author[:avatar]
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/perron/site/builder/feeds/json.rb

@@ -1,12 +1,15 @@
 # frozen_string_literal: true
 
 require "json"
+require "perron/site/builder/feeds/author"
 
 module Perron
   module Site
     class Builder
       class Feeds
         class Json
+          include Feeds::Author
+
           def initialize(collection:)
             @collection = collection
             @configuration = Perron.configuration
@@ -27,6 +30,7 @@ module Perron
                     id: resource.id,
                     url: url.polymorphic_url(resource, ref: feed_configuration.ref).delete_suffix("?ref="),
                     date_published: resource.published_at&.iso8601,
+                    authors: authors(resource),
                     title: resource.metadata.title,
                     content_html: Perron::Markdown.render(resource.content)
                   }
@@ -48,6 +52,14 @@ module Perron
           end
 
           def feed_configuration = @collection.configuration.feeds.json
+
+          def authors(resource)
+            author = author(resource)
+
+            return nil unless author&.name
+
+            [{name: author.name, email: author.email, url: author.url, avatar: author.avatar}.compact].presence
+          end
         end
       end
     end

data/lib/perron/site/builder/feeds/rss.rb

@@ -1,12 +1,15 @@
 # frozen_string_literal: true
 
 require "nokogiri"
+require "perron/site/builder/feeds/author"
 
 module Perron
   module Site
     class Builder
       class Feeds
         class Rss
+          include Feeds::Author
+
           def initialize(collection:)
             @collection = collection
             @configuration = Perron.configuration
@@ -29,6 +32,9 @@ module Perron
                         xml.guid resource.id
                         xml.link url.polymorphic_url(resource, ref: feed_configuration.ref).delete_suffix("?ref="), isPermaLink: true
                         xml.pubDate(resource.published_at&.rfc822)
+                        if (author = author(resource)) && author.email
+                          xml.author author.name ? "#{author.email} (#{author.name})" : author.email
+                        end
                         xml.title resource.metadata.title
                         xml.description { xml.cdata(Perron::Markdown.render(resource.content)) }
                       end

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

@@ -13,11 +13,9 @@ module Perron
 
           if routes.respond_to?(show_path)
             @collection.send(:load_resources).select(&:buildable?).each do |resource|
-              root = resource.slug == "/"
+              next if resource.root?
 
-              next if skip? root
-
-              @paths << (root ? routes.root_path : routes.public_send(show_path, resource))
+              @paths << routes.public_send(show_path, resource)
 
               (resource.class.try(:nested_routes) || []).each do |nested|
                 @paths << routes.polymorphic_path([resource, nested])
@@ -28,11 +26,6 @@ module Perron
 
         private
 
-        def skip?(root)
-          root &&
-            Perron.configuration.mode.integrated? && Perron.configuration.exclude_root?
-        end
-
         def routes = Rails.application.routes.url_helpers
 
         def index_path = "#{@collection.name}_path"

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

@@ -13,6 +13,8 @@ module Perron
 
           xml = Nokogiri::XML::Builder.new(encoding: "UTF-8") do |builder|
             builder.urlset(xmlns: "http://www.sitemaps.org/schemas/sitemap/0.9") do
+              add_additional_routes(with: builder)
+
               Perron::Site.collections.each do |collection|
                 add_urls_for(collection, with: builder)
               end
@@ -24,6 +26,21 @@ module Perron
 
         private
 
+        def add_additional_routes(with:)
+          (Perron.configuration.additional_routes || []).each do |route_name|
+            next unless routes.respond_to?(route_name)
+
+            routes.with_options(Perron.configuration.default_url_options) do |url|
+              with.url do
+                with.loc url.public_send(route_name.to_s.gsub("_path", "_url"))
+                with.priority Perron.configuration.sitemap.priority
+                with.changefreq Perron.configuration.sitemap.change_frequency
+                with.lastmod Time.current.iso8601
+              end
+            end
+          end
+        end
+
         def add_urls_for(collection, with:)
           return if collection.configuration.blank?
           return if collection.configuration.sitemap.exclude == true
@@ -31,13 +48,12 @@ module Perron
           collection.resources.each do |resource|
             next if resource.metadata.sitemap == false
 
-            root = resource.slug == "/"
             priority = resource.metadata.sitemap_priority || collection.configuration.sitemap.priority || Perron.configuration.sitemap.priority
             change_frequency = resource.metadata.sitemap_change_frequency || collection.configuration.sitemap.change_frequency || Perron.configuration.sitemap.change_frequency
 
             Rails.application.routes.url_helpers.with_options(Perron.configuration.default_url_options) do |url|
               with.url do
-                with.loc root ? url.root_url : url.polymorphic_url(resource)
+                with.loc resource.root? ? url.root_url : url.polymorphic_url(resource)
                 with.priority priority
                 with.changefreq change_frequency
                 begin
@@ -49,6 +65,8 @@ module Perron
             end
           end
         end
+
+        def routes = Rails.application.routes.url_helpers
       end
     end
   end

data/lib/perron/site/builder.rb

@@ -5,6 +5,7 @@ require "perron/site/builder/sitemap"
 require "perron/site/builder/feeds"
 require "perron/site/builder/public_files"
 require "perron/site/builder/paths"
+require "perron/site/builder/additional_routes"
 require "perron/site/builder/page"
 
 module Perron
@@ -40,6 +41,7 @@ module Perron
 
       def paths
         Set.new.tap do |paths|
+          Perron::Site::Builder::AdditionalRoutes.new(paths).get
           Perron::Site.collections.each { Perron::Site::Builder::Paths.new(it, paths).get }
         end
       end

data/lib/perron/site.rb

@@ -24,6 +24,8 @@ module Perron
     def collection(name) = Collection.new(name)
 
     def data(name = nil)
+      Perron.deprecator.deprecation_warning(:data, "Use Content::Data::ClassName instead, e.g. `Content::Data::Users.all`")
+
       (name && Perron::Data.new(name)) || Perron::Data::Proxy.new
     end
   end

data/lib/perron/tasks/clobber.rake

@@ -0,0 +1,12 @@
+namespace :perron do
+  desc "Remove compiled static output"
+  task clobber: :environment do
+    output_path = Rails.root.join(Perron.configuration.output)
+
+    if Dir.exist?(output_path)
+      FileUtils.rm_rf(output_path)
+
+      puts "Removed #{output_path}"
+    end
+  end
+end

data/lib/perron/version.rb

@@ -1,3 +1,3 @@
 module Perron
-  VERSION = "0.15.0"
+  VERSION = "0.17.0"
 end

data/lib/perron.rb

@@ -2,9 +2,10 @@
 
 require "perron/version"
 require "perron/configuration"
+require "perron/deprecator"
 require "perron/errors"
-require "perron/root"
 require "perron/site"
+require "perron/content/data"
 require "perron/resource"
 require "perron/markdown"
 require "perron/feeds"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: perron
 version: !ruby/object:Gem::Version
-  version: 0.15.0
+  version: 0.17.0
 platform: ruby
 authors:
 - Rails Designer Developers
@@ -99,8 +99,10 @@ files:
 - lib/perron.rb
 - lib/perron/collection.rb
 - lib/perron/configuration.rb
+- lib/perron/content/data.rb
 - lib/perron/data.rb
 - lib/perron/data/proxy.rb
+- lib/perron/deprecator.rb
 - lib/perron/engine.rb
 - lib/perron/errors.rb
 - lib/perron/feeds.rb
@@ -111,6 +113,7 @@ files:
 - lib/perron/html_processor/target_blank.rb
 - lib/perron/markdown.rb
 - lib/perron/metatags.rb
+- lib/perron/output_server.rb
 - lib/perron/refinements/delete_suffixes.rb
 - lib/perron/resource.rb
 - lib/perron/resource/associations.rb
@@ -128,11 +131,12 @@ files:
 - lib/perron/resource/slug.rb
 - lib/perron/resource/sourceable.rb
 - lib/perron/resource/table_of_content.rb
-- lib/perron/root.rb
 - lib/perron/site.rb
 - lib/perron/site/builder.rb
+- lib/perron/site/builder/additional_routes.rb
 - lib/perron/site/builder/assets.rb
 - lib/perron/site/builder/feeds.rb
+- lib/perron/site/builder/feeds/author.rb
 - lib/perron/site/builder/feeds/json.rb
 - lib/perron/site/builder/feeds/rss.rb
 - lib/perron/site/builder/page.rb
@@ -141,6 +145,7 @@ files:
 - lib/perron/site/builder/sitemap.rb
 - lib/perron/site/validate.rb
 - lib/perron/tasks/build.rake
+- lib/perron/tasks/clobber.rake
 - lib/perron/tasks/sync_sources.rake
 - lib/perron/tasks/validate.rake
 - lib/perron/version.rb
@@ -165,7 +170,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.1
+rubygems_version: 4.0.4
 specification_version: 4
 summary: Rails-based static site generator
 test_files: []

data/lib/perron/root.rb

@@ -1,13 +0,0 @@
-# frozen_string_literal: true
-
-module Perron
-  module Root
-    include ActiveSupport::Concern
-
-    def root
-      @resource = Content::Page.root
-
-      render :show
-    end
-  end
-end