robin_cms 0.1.2 → 0.1.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 398d0d377f476c68de1e02e504cbe7353347e1f93835d3cce55811d7a90e82a3
-  data.tar.gz: 5b253a4f07db5e5282bf879695ec96ed51d28a2b8e667f1110213b45e0c63e98
+  metadata.gz: 7496d517d8e733bc0e0876e806347a0c3670efc489d974b16718e3b015d0a8e1
+  data.tar.gz: cc6df56fde6950e75fddf3fef947e5363cdc67f506bd07c16f5bbe0f1940d629
 SHA512:
-  metadata.gz: b976e15a5ca7c7af3f44f8be1ee2df5f6ddfe766ddfedafeb6c17dd41c48dc449e13d819b0dcdac17c23263a04d9c3e7e99a1f3cc5b66d97b562c7fc8d77ecfb
-  data.tar.gz: 609ed3f32088e434615486ba25da6fdb199a074b0d628ee5e58f45b13f80151b7319437bad45538d636158e6b522701e3960663b2269db5f78ea3699e233ea07
+  metadata.gz: 6f4c01cfe9c26b0c7e864af98d405dfe55fbe986f78a3ee9295cb20e9c6bd808bbd9473685ddd17c158574540a63535c16a783a650a937f3e6419f215a81c51f
+  data.tar.gz: 36e240374f3bcf0c564d15347b4847a6b781d7b6192b3b3214fbf35f297748415d1729773039dca5f61b00ce088d681d7b3b02ac340fc3aa1f981c2fa4dd63dc

data/README.md

@@ -1,5 +1,9 @@
 # Robin CMS
 
+> [!IMPORTANT]
+> This software is currently in beta. There may be bugs and breaking changes.
+> If you find a bug, I'd love to hear about it.
+
 ![Robin CMS logo](./assets/robin-logo.png)
 
 Robin CMS is a minimalist flat-file CMS built with Ruby and Sinatra. It is

data/lib/robin_cms/cms.rb

@@ -2,9 +2,8 @@
 
 module RobinCMS
   class CMS < Sinatra::Base
-    set :logging, true
-    set :sessions, true
-    set :session_secret, ENV.fetch("SESSION_SECRET", SecureRandom.hex(64))
+    include Helpers
+    include Auth
 
     attr_accessor :config
 
@@ -14,10 +13,9 @@ module RobinCMS
       @config = Configuration.parse(**opts)
     end
 
-    helpers do
-      include Helpers
-      include Auth
-    end
+    set :logging, true
+    set :sessions, true
+    set :session_secret, ENV.fetch("SESSION_SECRET", SecureRandom.hex(64))
 
     before do
       if %w[/login /logout].include?(request.path_info)
@@ -27,13 +25,18 @@ module RobinCMS
       redirect to("/login") unless session[:auth_user]
     end
 
-    before(/\/libraries\/(.*).*/) do
+    before /\/libraries\/(.*).*/ do
       kind = params[:captures].first.split("/").first
+      library_schema = @config.find_library(kind)
 
-      @library = @config.find_library(kind)
-      @sorted_fields = @config.sorted_fields(kind)
+      halt 404 unless library_schema
 
-      halt 404 unless @library
+      @library = case library_schema[:type]
+                 when "collection"
+                   CollectionLibrary.new(library_schema)
+                 when "data"
+                   DataLibrary.new(library_schema)
+                 end
     end
 
     after do
@@ -92,20 +95,21 @@ module RobinCMS
     end
 
     get "/libraries/:kind" do
-      @items = Item.where(@library,
+      @items = @library.query(
         sort: params[:sort],
         published: params[:published],
-        q: params[:q])
+        q: params[:q]
+      )
 
       erb :library
     end
 
     get "/libraries/:kind/item" do
       if params[:id]
-        @item = Item.find_one(@library, params[:id])
+        @item = @library.find_one(params[:id])
         halt 404 unless @item
       else
-        @item = Item.blank(@library)
+        @item = @library.blank
       end
 
       erb :library_item
@@ -113,32 +117,30 @@ module RobinCMS
 
     post "/libraries/:kind/item" do
       if params[:id]
-        @item = Item.find_one(@library, params[:id])
+        @item = @library.find_one(params[:id])
         halt 404 unless @item
 
         if params[:image]
           filename = params[:image][:filename]
-          tempfile = params[:image][:tempfile]
+          tempfile = params[:image][:tempfile].to_path
 
-          StaticItem.delete_if_exists!(@library, @item.attributes[:image_src])
-          StaticItem.create!(@library, filename, tempfile).then do |s|
-            params[:image_src] = "/" + s.filepath
-          end
+          @library.delete_static(@item.attributes[:image_src])
+          static_path = @library.create_static(filename, tempfile)
+          params[:image_src] = "/" + static_path
         end
 
         @item.attributes = params
-        @item.update!
+        @library.write(@item)
       else
         if params[:image]
           filename = params[:image][:filename]
-          tempfile = params[:image][:tempfile]
+          tempfile = params[:image][:tempfile].to_path
 
-          StaticItem.create!(@library, filename, tempfile).then do |s|
-            params[:image_src] = "/" + s.filepath
-          end
+          static_path = @library.create_static(filename, tempfile)
+          params[:image_src] = "/" + static_path
         end
 
-        Item.create!(@library, params)
+        @library.create(params)
       end
 
       redirect to("/libraries/#{params[:kind]}")
@@ -149,14 +151,14 @@ module RobinCMS
 
     post "/libraries/:kind/item/delete" do
       if params[:id]
-        @item = Item.find_one(@library, params[:id])
+        @item = @library.find_one(params[:id])
         halt 404 unless @item
 
         if @item.attributes[:image_src]
-          StaticItem.delete_if_exists!(@library, @item.attributes[:image_src])
+          @library.delete_static(@item.attributes[:image_src])
         end
 
-        @item.delete!
+        @library.delete(@item.id)
       else
         halt 404
       end

data/lib/robin_cms/collection_library.rb

@@ -0,0 +1,70 @@
+# frozen_string_literal: true
+
+module RobinCMS
+  class CollectionLibrary < Library
+    def create(attributes)
+      id = make_slug(attributes[:title], @schema[:pattern])
+      item = Item.new(id, attributes, **@schema)
+
+      if File.exist?(filepath(id))
+        raise ItemExistsError, "An item with the same name already exists"
+      end
+
+      write(item)
+    end
+
+    def find_one(id)
+      path = filepath(id)
+
+      return unless File.exist?(path)
+
+      deserialize(path)
+    end
+
+    def all
+      Dir.glob(filepath("*"))
+        .filter { |f| File.file?(f) }
+        .map { |path| deserialize(path) }
+    end
+
+    def write(item)
+      path = filepath(item.id)
+
+      FileUtils.mkdir_p(File.dirname(path))
+      FileUtils.touch(path)
+
+      item.update_timestamps!
+
+      serialized = YAML.dump(item.frontmatter, stringify_names: true)
+      if item.attributes[:content]
+        serialized << "---\n"
+        serialized << item.attributes[:content]
+      end
+      File.write(path, serialized)
+
+      path
+    end
+
+    def delete(id)
+      File.delete(filepath(id))
+    end
+
+    private
+
+    def filepath(id)
+      File.join(@schema[:location], "#{id}.#{@schema[:filetype]}")
+    end
+
+    def deserialize(path)
+      raw = File.read(path)
+      id = File.basename(path, File.extname(path))
+
+      _, frontmatter, content = raw.split("---")
+
+      attributes = YAML.load(frontmatter, symbolize_names: true)
+      attributes[:content] = content.strip
+
+      Item.new(id, attributes, **@schema)
+    end
+  end
+end

data/lib/robin_cms/configuration-schema.json

@@ -50,6 +50,7 @@
 				"can_create": { "type": "boolean" },
 				"can_delete": { "type": "boolean" },
 				"pattern": { "type": "string" },
+				"display_name_pattern": { "type": "string" },
 				"fields": {
 					"type": "array",
 					"items": {
@@ -89,6 +90,7 @@
 				"can_create": { "type": "boolean" },
 				"can_delete": { "type": "boolean" },
 				"pattern": { "type": "string" },
+				"display_name_pattern": { "type": "string" },
 				"fields": {
 					"type": "array",
 					"items": {

data/lib/robin_cms/configuration.rb

@@ -102,27 +102,13 @@ module RobinCMS
     end
 
     def find_library(kind)
-      self[:libraries].find { |c| c[:id] == kind }
-    end
-
-    def sorted_fields(kind)
-      find_library(kind)
-        &.dig(:fields)
-        &.sort_by { |field| field[:order] || Float::INFINITY }
-    end
-
-    def drafts_enabled?(library)
-      collection?(library)
+      self[:libraries].find { |library| library[:id] == kind }
     end
 
     def collection?(library)
       library[:type].nil? || library[:type] == "collection"
     end
 
-    def data?(library)
-      !collection?(library)
-    end
-
     def has_image?(library)
       library[:fields].find { |f| f[:type] == "image" }
     end
@@ -148,7 +134,7 @@ module RobinCMS
       config[:libraries].each do |library|
         library[:fields].append(*AUTOMATIC_FIELDS)
 
-        if drafts_enabled?(library)
+        if collection?(library)
           library[:fields].append(*AUTOMATIC_DRAFT_FIELDS)
         end
 

data/lib/robin_cms/data_library.rb

@@ -0,0 +1,58 @@
+# frozen_string_literal: true
+
+module RobinCMS
+  class DataLibrary < Library
+    def create(attributes)
+      item = Item.new(nil, attributes, **@schema)
+      write(item)
+    end
+
+    def find_one(id)
+      all[id.to_i]
+    end
+
+    def all
+      return [] unless File.exist?(filepath)
+
+      items = YAML.load_file(filepath, symbolize_names: true)
+
+      return [] unless items
+
+      items.each_with_index.map do |attrs, i|
+        Item.new(i, attrs, **@schema)
+      end
+    end
+
+    def write(item)
+      FileUtils.mkdir_p(File.dirname(filepath))
+      FileUtils.touch(filepath)
+
+      item.update_timestamps!
+
+      all_items = YAML.load_file(filepath) || []
+      if item.id.nil?
+        all_items.append(item.frontmatter)
+      else
+        all_items[item.id.to_i] = item.frontmatter
+      end
+
+      serialized = YAML.dump(all_items, stringify_names: true)
+      File.write(filepath, serialized)
+
+      filepath
+    end
+
+    def delete(id)
+      all_items = YAML.load_file(filepath)
+      all_items[id.to_i] = nil
+      serialized = YAML.dump(all_items.compact, stringify_names: true)
+      File.write(filepath, serialized)
+    end
+
+    private
+
+    def filepath
+      File.join(@schema[:location], "#{@schema[:id]}.#{@schema[:filetype]}")
+    end
+  end
+end

data/lib/robin_cms/editable.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+module RobinCMS
+  # This module provides methods for editing image files.
+  # No methods are required in the base class in order to use this mixin.
+  module Editable
+    def resize_image(filepath, dimensions)
+      # The mogrify command edits images in place. For more info, see
+      # mogrify(1).
+
+      system("mogrify -resize #{dimensions} #{filepath}")
+      if $?.exitstatus != 0
+        raise ConversionError, "Could not resize image #{filepath}"
+      end
+    end
+
+    def format_image(filepath, filetype)
+      system("mogrify -format #{filetype} #{filepath}")
+      if $?.exitstatus != 0
+        raise ConversionError, "Could not format image #{filepath}"
+      end
+
+      # The name of the converted file will be the same as the original but
+      # with a new file extension.
+      converted = filepath.sub(/#{File.extname(filepath)}$/, ".#{filetype}")
+
+      # Mogrify's format command creates a new file with the new extension.
+      # Copy the contents of this file to the original, then delete the newly
+      # created file.
+      IO.copy_stream(converted, filepath)
+      File.delete(converted)
+    end
+  end
+end

data/lib/robin_cms/item.rb

@@ -1,34 +1,104 @@
 # frozen_string_literal: true
 
 module RobinCMS
-  # This is a wrapper class for providing a uniform interface to both the
-  # DataItem class and the CollectionItem class. It's sole job is to dispatch
-  # methods to the appropriate class based on the settings of the library.
   class Item
-    METHOD_NAMES = %i[all where create! find_one blank]
+    attr_reader :id, :attributes
 
-    def self.method_missing(method_name, *args, **kwargs)
-      unless METHOD_NAMES.include?(method_name)
-        super
-        return
+    DATETIME_FORMAT = "%Y-%m-%d"
+
+    # The keys which we don't want to serialize.
+    FRONTMATTER_IGNORE_KEYS = [:id, :content, :image, :captures].freeze
+
+    def initialize(id, attrs = {}, **opts)
+      if !attrs.empty? && !attrs.has_key?(:title)
+        raise TypeError, "Missing required field `title'"
+      end
+
+      @id = id
+      @opts = opts
+
+      # Be sure to use the setter here so the keys get converted to symbols.
+      self.attributes = attrs
+    end
+
+    def attributes=(attributes)
+      @attributes = attributes.to_h.transform_keys(&:to_sym)
+
+      if attributes.has_key?(:published)
+        @attributes[:published] = attributes[:published].to_s == "true"
+      end
+    end
+
+    def inspect
+      "<#{self.class} id=\"#{id}\">"
+    end
+
+    def published?
+      if @attributes.has_key?(:published)
+        @attributes[:published]
+      else
+        true
+      end
+    end
+
+    def published_label
+      if published?
+        "Published"
+      else
+        "Draft"
       end
+    end
+
+    def created_at
+      return unless @attributes[:created_at]
+
+      Time.parse(@attributes[:created_at])
+    end
 
-      # All the class methods for DataItem and CollectionItem should have
-      # the library as the first argument.
-      library = args.first
+    def updated_at
+      return unless @attributes[:updated_at]
 
-      case library[:type]
-      when "data"
-        DataItem.send(method_name, *args, **kwargs)
-      when "collection"
-        CollectionItem.send(method_name, *args, **kwargs)
+      Time.parse(@attributes[:updated_at])
+    end
+
+    def update_timestamps!
+      timestamp = Time.now.strftime(DATETIME_FORMAT)
+
+      if !@attributes.has_key?(:created_at) || @attributes[:created_at].empty?
+        @attributes[:created_at] = timestamp
+      end
+      @attributes[:updated_at] = timestamp
+    end
+
+    def display_name
+      return @attributes[:title] unless @opts[:display_name_pattern]
+
+      @opts[:display_name_pattern].clone.tap do |name|
+        @attributes.each { |key, value| name.gsub!(":#{key}", value) }
+      end
+    end
+
+    # Get the frontmatter as a hash with stringified keys.
+    def frontmatter
+      frontmatter = @attributes.clone
+      FRONTMATTER_IGNORE_KEYS.each { |key| frontmatter.delete(key) }
+
+      if published?
+        frontmatter.delete(:published)
       else
-        super
+        frontmatter[:published] = false
       end
+
+      # The Psych module (for which YAML is an alias) has a
+      # stringify_names option which does exactly this. However it was
+      # only introduced in Ruby 3.4. Using transform_keys is a workaround
+      # to support earlier versions of Ruby.
+      frontmatter.to_h.transform_keys(&:to_s)
     end
 
-    def self.respond_to_missing?(method_name)
-      METHOD_NAMES.include?(method_name)
+    def field_value_or_default(field)
+      value = @attributes[field[:id].to_sym] || field[:default]
+      value.to_s
     end
   end
 end

data/lib/robin_cms/library.rb

@@ -0,0 +1,83 @@
+# frozen_string_literal: true
+
+module RobinCMS
+  class Library
+    include Editable
+    include Sluggable
+    include Queryable
+
+    attr_reader :schema
+
+    def initialize(schema)
+      @schema = schema.freeze
+    end
+
+    def blank
+      Item.new(nil, **@schema)
+    end
+
+    def create(attributes)
+      raise NotImplementedError
+    end
+
+    def find_one(id)
+      raise NotImplementedError
+    end
+
+    def all
+      raise NotImplementedError
+    end
+
+    # Writes the specified item to disk.
+    #
+    # Returns the path where the item was written.
+    def write(item)
+      raise NotImplementedError
+    end
+
+    # Delete the item specified by +id+.
+    def delete(id)
+      raise NotImplementedError
+    end
+
+    def create_static(filename, tempfile)
+      path = File.join(@schema[:static_location], File.basename(make_slug(filename)))
+
+      if File.exist?(path)
+        raise ItemExistsError, "An item with the same name already exists"
+      end
+
+      image_field = @schema[:fields].find { |f| f[:type] == "image" }
+      dimensions = image_field&.dig(:dimensions)
+      filetype = image_field&.dig(:filetype)
+
+      resize_image(tempfile, dimensions) if dimensions
+      format_image(tempfile, filetype) if filetype
+
+      FileUtils.mkdir_p(File.dirname(path))
+      FileUtils.cp(tempfile, path)
+
+      path
+    end
+
+    def delete_static(filename)
+      path = File.join(@schema[:static_location], File.basename(filename))
+
+      return unless File.exist?(path)
+
+      File.delete(path)
+    end
+
+    def drafts_enabled?
+      @schema[:type].nil? || @schema[:type] == "collection"
+    end
+
+    def sorted_fields
+      @schema[:fields].sort_by { |field| field[:order] || Float::INFINITY }
+    end
+
+    def [](key)
+      @schema[key]
+    end
+  end
+end

data/lib/robin_cms/queryable.rb

@@ -1,8 +1,13 @@
 # frozen_string_literal: true
 
 module RobinCMS
+  # This module provides methods for querying items.
+  #
+  # In order to use this as a mixin, you only need to implement an +all+
+  # method in the base class. This method should take no parameters, and
+  # return all items.
   module Queryable
-    def where(library, **kwargs)
+    def query(**kwargs)
       by_published = lambda do |i|
         case kwargs[:published]
         when nil, ""
@@ -34,14 +39,11 @@ module RobinCMS
         end * sort_direction
       end
 
-      all(library)
-        .filter(&by_search)
-        .filter(&by_published)
-        .sort(&by_field)
+      all.filter(&by_search).filter(&by_published).sort(&by_field)
     end
 
-    def count(library)
-      all(library).size
+    def count
+      all.size
     end
   end
 end

data/lib/robin_cms/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module RobinCMS
-  VERSION = "0.1.2"
+  VERSION = "0.1.3"
 end

data/lib/robin_cms/views/filter_form.erb

@@ -11,7 +11,7 @@
       </option>
     <% end %>
   </select>
-  <% if @config.drafts_enabled?(@library) %>
+  <% if @library.drafts_enabled? %>
     <select id="published" name="published">
       <% for option in PUBLISHED_OPTIONS%>
         <option

data/lib/robin_cms/views/hidden_field.erb

@@ -2,5 +2,5 @@
   id="<%= safe_id(field[:id], 'field') %>"
   type="hidden"
   name="<%= field[:id] %>"
-  value="<%= @item.attributes[field[:id].to_sym] || field[:default] %>"
+  value="<%= @item.field_value_or_default(field) %>"
 />

data/lib/robin_cms/views/input_field.erb

@@ -3,7 +3,7 @@
   id="<%= safe_id(field[:id], 'field') %>"
   type="<%= field[:type] %>"
   name="<%= field[:id] %>"
-  value="<%= @item.attributes[field[:id].to_sym] || field[:default] %>"
+  value="<%= @item.field_value_or_default(field) %>"
   <% if field[:required] %>required<% end %>
   <% if field[:readonly] %>readonly<% end %>
 />

data/lib/robin_cms/views/layout.erb

@@ -3,8 +3,11 @@
   <head>
     <meta charset="utf-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no">
+    <meta name="robots" content="noindex,nofollow" />
     <title><%= @config[:title] %> | admin</title>
-    <%= erb :style %>
+    <style>
+      <%= erb :"stylesheet.css" %>
+    </style>
   </head>
   <body <% if flash[:success_dialog] %>onload="successdialog.showModal()"<% end %>>
     <% if session[:auth_user] %>
@@ -14,7 +17,7 @@
         </span>
         <span class="controls --gap-md">
           <a href="<%= @config[:url] %>" target="_blank">
-            <%= @config[:url] %><%= erb :new_tab %>
+            <%= @config[:url] %><%= erb :"new_tab.svg" %>
           </a>
           <% if @config[:build_command] %>
             <form id="publish-form" action="/admin/publish" method="post">
@@ -29,7 +32,7 @@
     <main id="site-content">
       <%= yield %>
       <footer id="site-footer" class="card --clear">
-        <%= erb :logo %>
+        <%= erb :"logo.svg" %>
         <p>
           Made with 🧡
           <br />