parklife-rails 0.1.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ab76eceaed9401e81a67c48ee2ca9b55e7e90ce62b7bf31549e358d838c0106b
-  data.tar.gz: a230681dfc800e4700dc6218dde011dca3c93e6bebc2af500932d74814e3b249
+  metadata.gz: 57ab04a4d96ded8bcb081c1d3c6e7236e03d163052f409b4d281d4dffbcce966
+  data.tar.gz: 663b999db226fa73460e8c2ce526e987a2502e8d6f70d78782a75eadf367fc48
 SHA512:
-  metadata.gz: 1f9c7f1613d0888bc1e1114c0bb4a2d366e337982c990920c290adc09bd452855297cf2d24dcb8c00f702394d206a69078e152441a413934fe68579e9dcb8c70
-  data.tar.gz: bcf023342973cb13d307160bf106f9e2b1e66c55b0a1e3cb35f5d8946238da9677b4d1944cf44d0d693313771421ba86e101d5a32ecbd744cc87ba9fc957a4b3
+  metadata.gz: d8f33fe1826e01f722dafc0ef3a0513f6a72eb66e35bf1978c3529c3e33da6bbb474795efbe6bf3a59cc99f946f11761f5d1d264b995a21019bd401c464c1f07
+  data.tar.gz: f0f1a2181451e3e563033fffcd3ecf9393f7c6bfda165cce5bb20a26c8e20e038c522eba6f170b335395c8d1372209dce80d9e50db9a17db5891c5e0fb6ca230

data/Appraisals

@@ -3,6 +3,7 @@
 appraise 'rails_7.0' do
   gem 'concurrent-ruby', '< 1.3.5'
   gem 'rails', '~> 7.0.0'
+  gem 'sqlite3', '<2'
 end
 
 appraise 'rails_7.1' do

data/CHANGELOG.md

@@ -1,5 +1,19 @@
 ## Unreleased
 
+## 0.3.0 - 2025-09-05
+
+- Allow passing an ActiveStorage blob/attachment/preview/variant to the usual tag helpers:
+
+  ```
+  image_tag(blog_post.hero_image.variant(:medium))
+
+  video_tag(product.intro_video)
+  ```
+
+## 0.2.0 - 2025-08-21
+
+- ActiveStorage integration.
+
 ## 0.1.0 - 2025-08-10
 
 - Initial release extracted from Parklife 0.7.0.

data/README.md

@@ -8,6 +8,57 @@ Add the gem to your application's `Gemfile`:
 gem 'parklife-rails'
 ```
 
+## ActiveStorage integration
+
+Parklife's ActiveStorage integration allows you to use ActiveStorage as normal in development, then during a Parklife build any encountered attachments are collected and copied to the build directory so they can be served alongside the rest of your static files. This is achieved via a Rails Engine and custom ActiveStorage DiskService which work together to tweak ActiveStorage URLs so they're suitable for a static web server.
+
+Enable the engine in `config/application.rb`:
+
+> [!NOTE]
+> This must be done before the app boots so can't be in an initializer.
+
+```ruby
+require 'parklife-rails/activestorage'
+```
+
+Then switch to Parklife's ActiveStorage service in `config/storage.yml`:
+
+```yml
+local:
+  service: Parklife
+  root: <%= Rails.root.join("storage") %>
+```
+
+Finally, use ActiveStorage (almost entirely) as usual:
+
+```ruby
+# Pass a blob/attachment/preview/variant directly to helpers as usual:
+image_tag(blog_post.hero_image.variant(:medium))
+# => <img src="/parklife/blobs/6adews39uehd44spynetigykwssh/cute-cat.jpg" />
+video_tag(product.intro_video)
+# => <video src="/parklife/blobs/x74tu8izjv141l8503gwkkruokca/cat-mug.mp4"></video>
+
+# Ask a variant for its path:
+blog_post.hero_image.variant(:medium).processed.url
+# => "/parklife/blobs/6adews39uehd44spynetigykwssh/cute-cat.jpg"
+
+# Use the route helper:
+Rails.application.routes.url_helpers.parklife_blob_path(
+  blog_post.hero_image.variant(:medium)
+)
+# => "/parklife/blobs/6adews39uehd44spynetigykwssh/cute-cat.jpg"
+```
+
+The only quirk is if you want to generate the full URL (including hostname etc), in that case `parklife_blob_url` doesn't behave as you'd expect and you must also pass `only_path: false`:
+
+```ruby
+Rails.application.routes.url_helpers.parklife_blob_url(
+  blog_post.hero_image.variant(:medium),
+  only_path: false,
+)
+# => "http://example.com/parklife/blobs/6adews39uehd44spynetigykwssh/cute-cat.jpg"
+```
+
 ## Contributing
 
 Bug reports and pull requests are welcome on GitHub at <https://github.com/benpickles/parklife-rails>. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [code of conduct](https://github.com/benpickles/parklife-rails/blob/main/CODE_OF_CONDUCT.md).

data/Rakefile

@@ -2,6 +2,10 @@
 require 'bundler/gem_tasks'
 require 'rspec/core/rake_task'
 
+# Enable `db:setup` and friends.
+require_relative 'example-app/config/application'
+Rails.application.load_tasks
+
 RSpec::Core::RakeTask.new(:spec)
 
 require 'rubocop/rake_task'

data/app/controllers/parklife/rails/active_storage/blobs_controller.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+module Parklife
+  module Rails
+    module ActiveStorage
+      class BlobsController < ActionController::Base
+        include ::ActiveStorage::FileServer
+
+        def show
+          blob = ::ActiveStorage::Blob.find_by!(key: params[:key])
+
+          serve_file(
+            named_disk_service(blob.service_name).path_for(blob.key),
+            content_type: blob.content_type,
+            disposition: :inline,
+          )
+        rescue Errno::ENOENT
+          head :not_found
+        end
+
+        private
+          def named_disk_service(name)
+            ::ActiveStorage::Blob.services.fetch(name)
+          end
+      end
+    end
+  end
+end

data/config/routes.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+Rails.application.routes.draw do
+  scope Parklife::Rails::ActiveStorage.routes_prefix do
+    get 'blobs/:key/*filename',
+      to: 'parklife/rails/active_storage/blobs#show',
+      as: :parklife_blob_service
+  end
+
+  direct :parklife_blob do |obj, options|
+    blob = case obj
+    when ActiveStorage::Attachment
+      obj.blob
+    when ActiveStorage::Preview, ActiveStorage::VariantWithRecord
+      obj.processed.image.blob
+    else
+      obj
+    end
+
+    options = { only_path: true }.merge(options)
+    url = route_for(:parklife_blob_service, blob.key, blob.filename, options)
+
+    if Parklife::Rails::ActiveStorage.collect_assets
+      service = ActiveStorage::Blob.services.fetch(blob.service_name)
+
+      # When collecting ActiveStorage Blobs we only ever want the path and never
+      # its full URL.
+      path = if options[:only_path]
+        url
+      else
+        route_for(
+          :parklife_blob_service,
+          blob.key,
+          blob.filename,
+          options.merge(only_path: true),
+        )
+      end
+
+      Parklife::Rails::ActiveStorage.collect_asset(service, blob.key, path)
+    end
+
+    url
+  end
+
+  resolve('ActiveStorage::Attachment')        { |attachment, options| route_for(:parklife_blob, attachment, options) }
+  resolve('ActiveStorage::Blob')              { |blob, options| route_for(:parklife_blob, blob, options) }
+  resolve('ActiveStorage::Preview')           { |preview, options| route_for(:parklife_blob, preview, options) }
+  resolve('ActiveStorage::VariantWithRecord') { |variant, options| route_for(:parklife_blob, variant, options) }
+end

data/gemfiles/rails_7.0.gemfile

@@ -4,9 +4,20 @@ source "https://rubygems.org"
 
 gem "appraisal"
 gem "rake"
-gem "rspec"
 gem "rubocop"
+gem "image_processing"
+gem "sprockets-rails"
+gem "sqlite3", "<2"
 gem "concurrent-ruby", "< 1.3.5"
 gem "rails", "~> 7.0.0"
 
+group :development, :test do
+  gem "rspec-rails"
+end
+
+group :test do
+  gem "capybara"
+  gem "factory_bot_rails"
+end
+
 gemspec path: "../"

data/gemfiles/rails_7.1.gemfile

@@ -4,8 +4,19 @@ source "https://rubygems.org"
 
 gem "appraisal"
 gem "rake"
-gem "rspec"
 gem "rubocop"
+gem "image_processing"
+gem "sprockets-rails"
+gem "sqlite3"
 gem "rails", "~> 7.1.0"
 
+group :development, :test do
+  gem "rspec-rails"
+end
+
+group :test do
+  gem "capybara"
+  gem "factory_bot_rails"
+end
+
 gemspec path: "../"

data/gemfiles/rails_7.2.gemfile

@@ -4,8 +4,19 @@ source "https://rubygems.org"
 
 gem "appraisal"
 gem "rake"
-gem "rspec"
 gem "rubocop"
+gem "image_processing"
+gem "sprockets-rails"
+gem "sqlite3"
 gem "rails", "~> 7.2.0"
 
+group :development, :test do
+  gem "rspec-rails"
+end
+
+group :test do
+  gem "capybara"
+  gem "factory_bot_rails"
+end
+
 gemspec path: "../"

data/gemfiles/rails_8.0.gemfile

@@ -4,8 +4,19 @@ source "https://rubygems.org"
 
 gem "appraisal"
 gem "rake"
-gem "rspec"
 gem "rubocop"
+gem "image_processing"
+gem "sprockets-rails"
+gem "sqlite3"
 gem "rails", "~> 8.0.0"
 
+group :development, :test do
+  gem "rspec-rails"
+end
+
+group :test do
+  gem "capybara"
+  gem "factory_bot_rails"
+end
+
 gemspec path: "../"

data/lib/active_storage/service/parklife_service.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+require 'active_storage/service/disk_service'
+
+module ActiveStorage
+  class Service::ParklifeService < Service::DiskService
+    def url(key, **options)
+      super.tap do |path|
+        if Parklife::Rails::ActiveStorage.collect_assets
+          Parklife::Rails::ActiveStorage.collect_asset(self, key, path)
+        end
+      end
+    end
+
+    private
+      def generate_url(key, expires_in:, filename:, content_type:, disposition:) # rubocop:disable Lint/UnusedMethodArgument
+        url_helpers.parklife_blob_service_path(key: key, filename: filename)
+      end
+  end
+end

data/lib/parklife/rails/activestorage.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+module Parklife
+  module Rails
+    module ActiveStorage
+      Asset = Struct.new(:service, :key, :path) do
+        def blob_path
+          service.path_for(key)
+        end
+      end
+
+      class Engine < ::Rails::Engine
+        isolate_namespace Parklife::Rails::ActiveStorage
+
+        initializer 'parklife.app_integration' do |app|
+          # Disable the standard ActiveStorage routes that will otherwise
+          # prevent a blob being served by Parklife's controller.
+          app.config.active_storage.draw_routes = false
+        end
+      end
+
+      mattr_accessor :collect_assets, default: false
+      mattr_accessor :collected_assets, default: {}
+      mattr_accessor :routes_prefix, default: 'parklife'
+
+      def self.collect_asset(service, key, path)
+        collected_assets[key] ||= Asset.new(service, key, path)
+      end
+    end
+  end
+end

data/lib/parklife/rails/build_integration.rb

@@ -0,0 +1,73 @@
+# frozen_string_literal: true
+require 'fileutils'
+require 'parklife'
+require 'rails'
+require_relative 'config_refinements'
+require_relative 'route_set_refinements'
+
+module Parklife
+  module Rails
+    class BuildIntegration < ::Rails::Railtie
+      initializer 'parklife.build_integration' do |app|
+        # The offending middleware is included in Rails (6+) development mode and
+        # rejects a request with a 403 response if its host isn't present in the
+        # allowlist (a security feature). This prevents Parklife from working in
+        # a Rails app out of the box unless you manually add the expected
+        # Parklife base to the hosts allowlist or set it to nil to disable it -
+        # both of which aren't great because they disable the security feature
+        # whenever the development server is booted.
+        #
+        # https://guides.rubyonrails.org/configuring.html#actiondispatch-hostauthorization
+        #
+        # However it's safe to remove the middleware at this point because it
+        # won't be executed in the normal Rails development flow, only via a
+        # Parkfile when parklife/rails is required.
+        if defined?(ActionDispatch::HostAuthorization)
+          app.middleware.delete(ActionDispatch::HostAuthorization)
+        end
+
+        Parklife.application.config.app = app
+
+        # This ensures next tweak is compatibile with Rails 8+ lazy routes.
+        Parklife.application.routes.extend(RouteSetRefinements)
+
+        # Allow use of the Rails application's route helpers when defining
+        # Parklife routes in the block form.
+        Parklife.application.routes.singleton_class.include(app.routes.url_helpers)
+
+        Parklife.application.config.extend(ConfigRefinements)
+      end
+
+      config.after_initialize do |app|
+        # Read the Rails app's URL config and apply it to Parklife's so that the
+        # Rails config can be used as the single source of truth.
+        host, port, protocol = app.default_url_options.values_at(:host, :port, :protocol)
+        protocol = 'https' if app.config.force_ssl
+        path = ActionController::Base.relative_url_root
+
+        Parklife.application.config.base.scheme = protocol if protocol
+        Parklife.application.config.base.host = host if host
+        Parklife.application.config.base.port = port if port
+        Parklife.application.config.base.path = path if path
+
+        # If the host Rails app includes Parklife's ActiveStorage integration
+        # then automatically collect attachments encountered during a build and
+        # copy them to the build directory.
+        if defined?(Parklife::Rails::ActiveStorage)
+          Parklife.application.before_build do
+            ActiveStorage.collected_assets.clear
+            ActiveStorage.collect_assets = true
+          end
+
+          Parklife.application.after_build do
+            ActiveStorage.collected_assets.each_value do |asset|
+              build_path = File.join(Parklife.application.config.build_dir, asset.path)
+              FileUtils.mkdir_p(File.dirname(build_path))
+              FileUtils.cp(asset.blob_path, build_path)
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/parklife/rails/config_refinements.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+module Parklife
+  module Rails
+    module ConfigRefinements
+      # When setting Parklife's base also configure the Rails app's
+      # default_url_options and relative_url_root to match.
+      def base=(value)
+        super.tap { |uri|
+          app.default_url_options = {
+            host: Utils.host_with_port(uri),
+            protocol: uri.scheme,
+          }
+
+          base_path = !uri.path.empty? && uri.path != '/' ? uri.path : nil
+          ActionController::Base.relative_url_root = base_path
+        }
+      end
+    end
+  end
+end

data/lib/parklife/rails/route_set_refinements.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+module Parklife
+  module Rails
+    module RouteSetRefinements
+      def default_url_options
+        ::Rails.application.default_url_options
+      end
+    end
+  end
+end

data/lib/parklife/rails/version.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 module Parklife
   module Rails
-    VERSION = '0.1.0'
+    VERSION = '0.3.0'
   end
 end

data/lib/parklife/rails.rb

@@ -1,70 +1,9 @@
 # frozen_string_literal: true
-require 'parklife'
-require 'rails'
 
-module Parklife
-  module RailsConfigRefinements
-    # When setting Parklife's base also configure the Rails app's
-    # default_url_options and relative_url_root to match.
-    def base=(value)
-      super.tap { |uri|
-        app.default_url_options = {
-          host: Utils.host_with_port(uri),
-          protocol: uri.scheme,
-        }
-
-        base_path = !uri.path.empty? && uri.path != '/' ? uri.path : nil
-        ActionController::Base.relative_url_root = base_path
-      }
-    end
-  end
-
-  module RailsRouteSetRefinements
-    def default_url_options
-      ::Rails.application.default_url_options
-    end
-  end
-
-  class Railtie < ::Rails::Railtie
-    initializer 'parklife.disable_host_authorization' do |app|
-      # The offending middleware is included in Rails (6+) development mode and
-      # rejects a request with a 403 response if its host isn't present in the
-      # allowlist (a security feature). This prevents Parklife from working in
-      # a Rails app out of the box unless you manually add the expected
-      # Parklife base to the hosts allowlist or set it to nil to disable it -
-      # both of which aren't great because they disable the security feature
-      # whenever the development server is booted.
-      #
-      # https://guides.rubyonrails.org/configuring.html#actiondispatch-hostauthorization
-      #
-      # However it's safe to remove the middleware at this point because it
-      # won't be executed in the normal Rails development flow, only via a
-      # Parkfile when parklife/rails is required.
-      if defined?(ActionDispatch::HostAuthorization)
-        app.middleware.delete(ActionDispatch::HostAuthorization)
-      end
-
-      Parklife.application.config.app = app
-
-      # Allow use of the Rails application's route helpers when defining
-      # Parklife routes in the block form.
-      Parklife.application.routes.singleton_class.include(RailsRouteSetRefinements)
-      Parklife.application.routes.singleton_class.include(app.routes.url_helpers)
-
-      Parklife.application.config.extend(RailsConfigRefinements)
-    end
-
-    config.after_initialize do |app|
-      # Read the Rails app's URL config and apply it to Parklife's so that the
-      # Rails config can be used as the single source of truth.
-      host, port, protocol = app.default_url_options.values_at(:host, :port, :protocol)
-      protocol = 'https' if app.config.force_ssl
-      path = ActionController::Base.relative_url_root
-
-      Parklife.application.config.base.scheme = protocol if protocol
-      Parklife.application.config.base.host = host if host
-      Parklife.application.config.base.port = port if port
-      Parklife.application.config.base.path = path if path
-    end
-  end
+# Only require the build integration when running from a Parklife CLI command.
+#
+# This means that the gem can safely be included in the app's Gemfile without
+# applying any of its build-time tweaks.
+if defined?(Parklife::CLI)
+  require_relative 'rails/build_integration'
 end

data/lib/parklife-rails/activestorage.rb

@@ -0,0 +1,2 @@
+# frozen_string_literal: true
+require_relative '../parklife/rails/activestorage'

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: parklife-rails
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Ben Pickles
-autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-08-10 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: parklife
@@ -38,7 +37,6 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-description:
 email:
 - spideryoung@gmail.com
 executables: []
@@ -51,12 +49,20 @@ files:
 - LICENSE.txt
 - README.md
 - Rakefile
+- app/controllers/parklife/rails/active_storage/blobs_controller.rb
+- config/routes.rb
 - gemfiles/rails_7.0.gemfile
 - gemfiles/rails_7.1.gemfile
 - gemfiles/rails_7.2.gemfile
 - gemfiles/rails_8.0.gemfile
+- lib/active_storage/service/parklife_service.rb
 - lib/parklife-rails.rb
+- lib/parklife-rails/activestorage.rb
 - lib/parklife/rails.rb
+- lib/parklife/rails/activestorage.rb
+- lib/parklife/rails/build_integration.rb
+- lib/parklife/rails/config_refinements.rb
+- lib/parklife/rails/route_set_refinements.rb
 - lib/parklife/rails/version.rb
 homepage: https://parklife.dev/rails
 licenses:
@@ -66,7 +72,6 @@ metadata:
   homepage_uri: https://parklife.dev/rails
   rubygems_mfa_required: 'true'
   source_code_uri: https://github.com/benpickles/parklife-rails
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -81,8 +86,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.6
-signing_key:
+rubygems_version: 3.7.1
 specification_version: 4
 summary: Rails integration for Parklife
 test_files: []