filepress 0.1.0 → 0.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1e18ee52d65d384ba64e31f69826907c5768e90530880e519b2e60b08c7b3792
-  data.tar.gz: d0120941b4b5808438c7003c8a8fa9652587dd26eee6ee6c4f5d78efe2fd8336
+  metadata.gz: 7d19a795578233e2969fa1438a21c7614afab2650666a2a229338c2f322cccc0
+  data.tar.gz: cfcfbff322ea8909a384f580b6de6082f4a015808acb6d5e3f03a5bc02d17d54
 SHA512:
-  metadata.gz: b375a0c1a6335d95df185db9c47d9b69d4366f7dd3176fb66ae0ff21fdd6ad8542019880bf68faf7f935249008991b0794570522eec79dc3c14da878f1f61770
-  data.tar.gz: dd4b78d2e56ead2fc7b4c3c9233652c90840c1f1682b6eaf1b51e651e5e2b6ab4d505dfeadd8ba68a43555731c7fecdeb13ceb06b50873490f55b0cad1430b3a
+  metadata.gz: a69c6dbb2a9491da1698d9d97ba37ebb4e3e6caceffa1b0d4e7c21d782c0d5d4111869c075fcddb339dd0df471db291a9f43f197cd11dbb9871042b013b5f14c
+  data.tar.gz: 9590840f2f26567dca12b04fc929c2273a5f21074b179abdf7fb0f96dc22de5720a9d2bb37c8eede06c516ebb7bfcf7b1c8e0ae7eacc6192b782a5a3c9406a4e

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright Carl Dawson
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -1,17 +1,122 @@
 # Filepress
 
-**Write content as flat files. Use it anywhere in your Rails app.**
+Filepress is a minimal Rails plugin that offers the best of both worlds for content management:
+- Write and version control your content in Markdown (or a similar format)
+- Sync it seamlessly to ActiveRecord models so you can harness the full power of a Rails backend.
 
-Filepress lets you manage content in plain text files with frontmatter — like Markdown, HTML, or anything else — and sync them directly into your ActiveRecord models. It's the simplicity of static files, with the full power of a Rails backend.
+Ideal for blogs, documentation, or any content-driven Rails app where you want the flexibility of flat files and the structure of a database.
 
----
+## Getting Started
+
+1. Install the gem
+
+Add it to your Gemfile:
+
+```ruby
+gem "filepress"
+```
+Then run:
+
+```bash
+bundle install
+```
+
+2. Create a model to represent your content
+
+Be sure to include a field that can serve as a unique identifier (e.g. `slug`):
+
+```bash
+rails g model Post title:string slug:string body:text
+```
+
+3. Enable Filepress for your model
 
-## ✨ Why use Filepress?
+Use the `filepress` method in your model class:
 
-- 📝 Write content in any editor — no CMS required
-- 🔁 Keep content version-controlled with Git
-- ⚡ Instantly available in your Rails app via ActiveRecord
-- 🧠 Works with any file type (Markdown, HTML, plain text, etc.)
-- 🧹 Automatically adds, updates, and deletes records
+```ruby
+class Post < ApplicationRecord
+    filepress
+end
+```
 
+4. Add some content
+
+Create Markdown files in `app/content/posts`. Each file should include frontmatter:
+
+```markdown
+---
+title: My First Post
+slug: first
 ---
+
+# 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! 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.
+
+## 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).
+
+## Configuration
+
+You can customize how Filepress behaves by passing options to `filepress`:
+
+### `from:` - Set a custom content directory
+
+```ruby
+class Post
+    filepress from: "app/my_custom_content_folder"
+end
+```
+
+### `glob:` - Use filetypes besides Markdown
+
+```ruby
+class Post
+    filepress glob: "*.html"
+end
+```
+
+### `key:` - Use a unique identifier other than `slug`
+
+```ruby
+class Post
+    filepress key: :name
+end
+```
+
+### `body:` - Set which attribute stores the main content
+
+```ruby
+class Post
+    filepress body: :content
+end
+```
+
+### `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:
+
+```ruby
+class Post
+    filepress destroy_stale: false
+end
+```
+
+## Why Filepress?
+
+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/Rakefile

@@ -1,12 +1,2 @@
-# frozen_string_literal: true
-
+require "bundler/setup"
 require "bundler/gem_tasks"
-require "minitest/test_task"
-
-Minitest::TestTask.create
-
-require "rubocop/rake_task"
-
-RuboCop::RakeTask.new
-
-task default: %i[test rubocop]

data/lib/filepress/model.rb

@@ -0,0 +1,15 @@
+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: {}
+
+      self.filepress_options = {
+        from: from || "app/content/#{name.underscore.pluralize}",
+        glob: glob,
+        key: key,
+        body: body,
+        destroy_stale: destroy_stale
+      }
+    end
+  end
+end

data/lib/filepress/railtie.rb

@@ -0,0 +1,11 @@
+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/filepress/version.rb

@@ -1,5 +1,3 @@
-# frozen_string_literal: true
-
 module Filepress
-  VERSION = "0.1.0"
+  VERSION = "0.2.1"
 end

data/lib/filepress.rb

@@ -1,77 +1,40 @@
-# frozen_string_literal: true
-
-require "active_support"
-require "active_support/core_ext"
-require "active_support/concern"
-
-require_relative "filepress/version"
+require "filepress/version"
+require "filepress/railtie"
+require "filepress/model"
 
 module Filepress
-  class Syncer
-    def self.sync!(model_class)
-      opts = model_class.filepress_options
-      raise "Missing Filepress Options" unless opts
+  class << self
+    def sync
+      Rails.application.eager_load!
+      models = ActiveRecord::Base.descendants.select { |model| model.respond_to? :filepress_options }
 
-      path = Rails.root.join(opts[:path])
-      key = opts[:key]
-      content_attr = opts[:content_attribute]
+      models.each do |model|
+        options = model.filepress_options
+        raise "Filepress options missing for #{model.name}" unless options
 
-      seen_keys = []
+        path = Rails.root.join(options[:from])
+        key = options[:key]
+        body_attribute = options[:body]
 
-      Dir.glob("#{path}/#{opts[:glob]}").each 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
+        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
+          identifier = data[key]
+          raise "Missing key `#{key}` in frontmatter for #{file}" unless identifier
 
-        seen_keys << identifier
+          record = model.find_or_initialize_by(key => identifier)
+          record.assign_attributes(data)
+          record.send("#{body_attribute}=", content)
+          record.save!
 
-        record = model_class.find_or_initialize_by(key => identifier)
-        record.assign_attributes(data)
-        record.send("#{content_attr}=", content)
-        record.save!
-      end
+          identifier
+        end
 
-      # Clean up records whose source file no longer exists
-      model_class.where.not(key => seen_keys).destroy_all
-    end
-
-    def self.sync_all!
-      models = ActiveRecord::Base.descendants.select do |klass|
-        klass.respond_to?(:filepress_options)
+        model.where.not(key => keys).destroy_all if options[:destroy_stale]
       end
-
-      models.each { |model| sync!(model) }
-    end
-  end
-
-  module ModelExt
-    def filepress_model(path: nil, glob: "*.md", key: :slug, content_attribute: :content)
-      class_attribute :filepress_options, instance_accessor: false, default: {}
-
-      self.filepress_options = {
-        path: path || "app/content/#{name.underscore.pluralize}",
-        glob: glob,
-        key: key,
-        content_attribute: content_attribute
-      }
-    end
-  end
-end
-
-ActiveSupport.on_load(:active_record) do
-  extend Filepress::ModelExt
-end
-
-if defined?(Rake::Task)
-  namespace :filepress do
-    desc "Sync all filepress-backed models"
-    task sync: :environment do
-      Rails.application.eager_load!
-      Filepress::Syncer.sync_all!
     end
   end
 end

data/lib/tasks/filepress_tasks.rake

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

metadata

@@ -1,11 +1,11 @@
 --- !ruby/object:Gem::Specification
 name: filepress
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.1
 platform: ruby
 authors:
 - Carl Dawson
-bindir: exe
+bindir: bin
 cert_chain: []
 date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
@@ -31,20 +31,21 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- ".rubocop.yml"
-- LICENSE.txt
+- MIT-LICENSE
 - README.md
 - Rakefile
 - lib/filepress.rb
+- lib/filepress/model.rb
+- lib/filepress/railtie.rb
 - lib/filepress/version.rb
-- sig/filepress.rbs
+- lib/tasks/filepress_tasks.rake
 homepage: https://github.com/carldaws/filepress
 licenses:
 - MIT
 metadata:
   allowed_push_host: https://rubygems.org
   homepage_uri: https://github.com/carldaws/filepress
-  source_code_uri: https://github.com/carldawson/filepress
+  source_code_uri: https://github.com/carldaws/filepress
 rdoc_options: []
 require_paths:
 - lib
@@ -52,7 +53,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 3.1.0
+      version: '0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="

data/.rubocop.yml

@@ -1,8 +0,0 @@
-AllCops:
-  TargetRubyVersion: 3.1
-
-Style/StringLiterals:
-  EnforcedStyle: double_quotes
-
-Style/StringLiteralsInInterpolation:
-  EnforcedStyle: double_quotes

data/LICENSE.txt

@@ -1,21 +0,0 @@
-The MIT License (MIT)
-
-Copyright (c) 2025 Carl Dawson
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in
-all copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-THE SOFTWARE.

data/sig/filepress.rbs

@@ -1,4 +0,0 @@
-module Filepress
-  VERSION: String
-  # See the writing guide of rbs: https://github.com/ruby/rbs#guides
-end