filepress 0.2.1 → 0.3.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7d19a795578233e2969fa1438a21c7614afab2650666a2a229338c2f322cccc0
-  data.tar.gz: cfcfbff322ea8909a384f580b6de6082f4a015808acb6d5e3f03a5bc02d17d54
+  metadata.gz: e04385f62b93b0ae73ed1a5406e9ffabfa0e3b9347a320362426e07daf9f2a1f
+  data.tar.gz: c2ab7c42b0a8d13ad530a406a734aeea8806abf4ac4fb601e0fd376ebd8c611a
 SHA512:
-  metadata.gz: a69c6dbb2a9491da1698d9d97ba37ebb4e3e6caceffa1b0d4e7c21d782c0d5d4111869c075fcddb339dd0df471db291a9f43f197cd11dbb9871042b013b5f14c
-  data.tar.gz: 9590840f2f26567dca12b04fc929c2273a5f21074b179abdf7fb0f96dc22de5720a9d2bb37c8eede06c516ebb7bfcf7b1c8e0ae7eacc6192b782a5a3c9406a4e
+  metadata.gz: 18c23fdf881720757082d8f16d8789a2c973ffb20350057265c3a59007a4f94d627a20e0116e211984b2456b901c985de8ab12ea4268c17079bd7816101dcf68
+  data.tar.gz: 64d52cc8d248fef1d014f8040891613e39eb823a1998c4156c23d982900fcdd60ef96b6249296b67dffce32b849120c7e7a8b82af04bbb2c67e81896ea3ef4fd

data/README.md

@@ -15,11 +15,6 @@ Add it to your Gemfile:
 ```ruby
 gem "filepress"
 ```
-Then run:
-
-```bash
-bundle install
-```
 
 2. Create a model to represent your content
 
@@ -35,80 +30,78 @@ Use the `filepress` method in your model class:
 
 ```ruby
 class Post < ApplicationRecord
-    filepress
+  filepress
 end
 ```
 
 4. Add some content
 
-Create Markdown files in `app/content/posts`. Each file should include frontmatter:
+Create Markdown files in `app/content/posts`. The filename becomes the slug, and YAML frontmatter maps to your model's attributes:
 
 ```markdown
 ---
 title: My First Post
-slug: first
+published: true
 ---
 
-# Hello, this is my first post
+Hello, this is my first post!
 ```
 
-5. Sync your content
-
-Run the sync task to import your files into the database:
-
-```bash
-bin/rails filepress:sync
-```
+That's it! Filepress syncs your content to the database automatically — on boot, on deploy, and whenever files change in development. No rake tasks, no deploy hooks.
 
-That’s it! You’re now free to query your content via ActiveRecord like any other model. Filepress doesn't dictate how you render the body—use a Markdown parser like Kramdown, Redcarpet, or similar.
+You're free to query your content via ActiveRecord like any other model. Filepress doesn't dictate how you render the body — use a Markdown parser like Kramdown, Redcarpet, or similar.
 
 ## How it works
 
 Filepress reads your content files, extracts YAML frontmatter, and uses the values to populate or update model attributes. The rest of the file becomes the value of the body attribute (or another field, if configured).
 
+- Syncs are wrapped in a transaction — if any file fails, nothing changes
+- Unknown frontmatter keys (that don't match a column) are silently ignored
+- In development, Rails' built-in file watcher picks up live edits without a server restart
+
 ## Configuration
 
 You can customize how Filepress behaves by passing options to `filepress`:
 
-### `from:` - Set a custom content directory
+### `from:` — Set a custom content directory
 
 ```ruby
-class Post
-    filepress from: "app/my_custom_content_folder"
+class Post < ApplicationRecord
+  filepress from: "app/my_custom_content_folder"
 end
 ```
 
-### `glob:` - Use filetypes besides Markdown
+### `extensions:` — Use filetypes besides Markdown
 
 ```ruby
-class Post
-    filepress glob: "*.html"
+class Post < ApplicationRecord
+  filepress extensions: ["html", "txt"]
 end
 ```
 
-### `key:` - Use a unique identifier other than `slug`
+### `key:` — Use a unique identifier other than `slug`
 
 ```ruby
-class Post
-    filepress key: :name
+class Post < ApplicationRecord
+  filepress key: :name
 end
 ```
 
-### `body:` - Set which attribute stores the main content
+### `body:` — Set which attribute stores the main content
 
 ```ruby
-class Post
-    filepress body: :content
+class Post < ApplicationRecord
+  filepress body: :content
 end
 ```
 
-### `destroy_stale:` - Prevent deletion of records when files are removed
+### `destroy_stale:` — Prevent deletion of records when files are removed
 
-By default, Filepress deletes records when the corresponding file is removed. Disable this behavior with:
+By default, Filepress deletes records when the corresponding file is removed. Disable this behaviour with:
 
 ```ruby
-class Post
-    filepress destroy_stale: false
+class Post < ApplicationRecord
+  filepress destroy_stale: false
 end
 ```
 
@@ -119,4 +112,3 @@ Filepress is for you if:
 - You prefer writing content in files
 - You want the convenience of version control for content
 - And you still want powerful querying, associations, validations and all the other Rails goodness
-

data/lib/filepress/engine.rb

@@ -0,0 +1,22 @@
+module Filepress
+  class Engine < ::Rails::Engine
+    initializer "filepress.model" do
+      ActiveSupport.on_load(:active_record) do
+        extend Filepress::Model
+      end
+    end
+
+    initializer "filepress.file_watcher" do |app|
+      content_path = app.root.join("app", "content")
+
+      app.config.after_initialize do
+        if content_path.exist?
+          extensions = Filepress.watched_extensions
+          app.reloaders << app.config.file_watcher.new([], { content_path.to_s => extensions }) do
+            Filepress.sync
+          end
+        end
+      end
+    end
+  end
+end

data/lib/filepress/file_parser.rb

@@ -0,0 +1,27 @@
+require "yaml"
+
+module Filepress
+  class FileParser
+    FRONTMATTER_PATTERN = /\A---\s*\n(.*?\n?)---\s*\n?(.*)\z/m
+
+    attr_reader :attributes, :body
+
+    def initialize(raw_content)
+      @attributes, @body = parse(raw_content)
+    end
+
+    private
+
+    def parse(raw_content)
+      if (match = raw_content.match(FRONTMATTER_PATTERN))
+        attributes = YAML.safe_load(match[1], permitted_classes: [Date, Time, Symbol]) || {}
+        body = match[2].strip
+      else
+        attributes = {}
+        body = raw_content.strip
+      end
+
+      [attributes.symbolize_keys, body]
+    end
+  end
+end

data/lib/filepress/model.rb

@@ -1,15 +1,17 @@
 module Filepress
   module Model
-    def filepress(from: nil, glob: "*.md", key: :slug, body: :body, destroy_stale: true)
-      class_attribute :filepress_options, instance_accessor: false, default: {}
+    def filepress(from: nil, extensions: ["md"], key: :slug, body: :body, destroy_stale: true)
+      class_attribute :filepress_options, instance_accessor: false
 
       self.filepress_options = {
-        from: from || "app/content/#{name.underscore.pluralize}",
-        glob: glob,
+        from: from || Rails.root.join("app", "content", model_name.plural).to_s,
+        extensions: extensions,
         key: key,
         body: body,
         destroy_stale: destroy_stale
       }
+
+      Filepress.register(self, filepress_options)
     end
   end
 end

data/lib/filepress/sync.rb

@@ -0,0 +1,58 @@
+module Filepress
+  class Sync
+    def initialize(config)
+      @model_class = config[:model_class]
+      @from = config[:from]
+      @extensions = config[:extensions]
+      @key = config[:key]
+      @body = config[:body]
+      @destroy_stale = config[:destroy_stale]
+    end
+
+    def perform
+      return unless table_exists?
+      return unless File.directory?(@from)
+
+      synced_identifiers = []
+
+      @model_class.transaction do
+        content_files.each do |file_path|
+          identifier_value = File.basename(file_path, ".*")
+          parsed = FileParser.new(File.read(file_path))
+
+          record = @model_class.find_or_initialize_by(@key => identifier_value)
+          record.assign_attributes(permitted_attributes(record, parsed.attributes))
+          record.public_send(:"#{@body}=", parsed.body)
+          record.save!
+
+          synced_identifiers << identifier_value
+        end
+
+        if @destroy_stale
+          @model_class.where.not(@key => synced_identifiers).destroy_all
+        end
+      end
+    end
+
+    private
+
+    def table_exists?
+      @model_class.connection_pool.with_connection do
+        @model_class.table_exists?
+      end
+    rescue ActiveRecord::NoDatabaseError, ActiveRecord::StatementInvalid
+      false
+    end
+
+    def permitted_attributes(record, attributes)
+      known_columns = record.class.column_names.map(&:to_sym)
+      attributes.select { |key, _| known_columns.include?(key) }
+    end
+
+    def content_files
+      @extensions.flat_map do |ext|
+        Dir[File.join(@from, "*.#{ext}")]
+      end.sort
+    end
+  end
+end

data/lib/filepress/version.rb

@@ -1,3 +1,3 @@
 module Filepress
-  VERSION = "0.2.1"
+  VERSION = "0.3.1"
 end

data/lib/filepress.rb

@@ -1,39 +1,36 @@
 require "filepress/version"
-require "filepress/railtie"
+require "filepress/engine"
+require "filepress/file_parser"
 require "filepress/model"
+require "filepress/sync"
 
 module Filepress
   class << self
-    def sync
-      Rails.application.eager_load!
-      models = ActiveRecord::Base.descendants.select { |model| model.respond_to? :filepress_options }
-
-      models.each do |model|
-        options = model.filepress_options
-        raise "Filepress options missing for #{model.name}" unless options
-
-        path = Rails.root.join(options[:from])
-        key = options[:key]
-        body_attribute = options[:body]
-
-        keys = Dir.glob("#{path}/#{options[:glob]}").map do |file|
-          raw = File.read(file)
-          frontmatter, body = raw.split(/^---\s*$/, 3).reject(&:empty?)
-          data = YAML.safe_load(frontmatter, symbolize_names: true)
-          content = body.strip
-
-          identifier = data[key]
-          raise "Missing key `#{key}` in frontmatter for #{file}" unless identifier
+    def registry
+      @registry ||= {}
+    end
 
-          record = model.find_or_initialize_by(key => identifier)
-          record.assign_attributes(data)
-          record.send("#{body_attribute}=", content)
-          record.save!
+    def register(model_class, options)
+      config = options.merge(model_class: model_class)
+      registry[model_class.name] = config
 
-          identifier
+      trace = TracePoint.new(:end) do |tp|
+        if tp.self == model_class
+          trace.disable
+          Sync.new(config).perform
         end
+      end
+      trace.enable
+    end
 
-        model.where.not(key => keys).destroy_all if options[:destroy_stale]
+    def watched_extensions
+      exts = registry.values.flat_map { |config| config[:extensions] }.uniq
+      exts.empty? ? ["md"] : exts
+    end
+
+    def sync
+      registry.each_value do |config|
+        Sync.new(config).perform
       end
     end
   end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: filepress
 version: !ruby/object:Gem::Version
-  version: 0.2.1
+  version: 0.3.1
 platform: ruby
 authors:
 - Carl Dawson
@@ -15,14 +15,14 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '5.2'
+        version: '7.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '5.2'
+        version: '7.0'
 description: Filepress lets you manage content as simple flat files, with all the
   power of ActiveRecord.
 email:
@@ -35,10 +35,11 @@ files:
 - README.md
 - Rakefile
 - lib/filepress.rb
+- lib/filepress/engine.rb
+- lib/filepress/file_parser.rb
 - lib/filepress/model.rb
-- lib/filepress/railtie.rb
+- lib/filepress/sync.rb
 - lib/filepress/version.rb
-- lib/tasks/filepress_tasks.rake
 homepage: https://github.com/carldaws/filepress
 licenses:
 - MIT
@@ -53,14 +54,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '0'
+      version: '3.1'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.7
+rubygems_version: 4.0.3
 specification_version: 4
 summary: Write content as flat files, use it anywhere in your Rails app.
 test_files: []

data/lib/filepress/railtie.rb

@@ -1,11 +0,0 @@
-module Filepress
-  class Railtie < ::Rails::Railtie
-    ActiveSupport.on_load(:active_record) do
-      extend Filepress::Model
-    end
-
-    rake_tasks do
-      Dir[File.expand_path("../tasks/**/*.rake", __dir__)].each { |f| load f }
-    end
-  end
-end

data/lib/tasks/filepress_tasks.rake

@@ -1,6 +0,0 @@
-namespace :filepress do
-  desc "Synchronise Filepress models"
-  task sync: :environment do
-    Filepress.sync
-  end
-end