parklife 0.5.1 → 0.6.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0a0e894c4cba14f5f3d7dc614df86e5430dded896ddf5466048bd2b7eb224791
-  data.tar.gz: 684afeeb534d59bb1139e5df34c3a5ff93a4c9e2c491b69b2a2a66feeba54c3c
+  metadata.gz: 8c94649aadc5cc8fe79a9215950b461adfdf658ec56c396c42d3e69e9e6082d3
+  data.tar.gz: 54c2b0b8c4f8a8a5149d10b5f649d0009e9c9f32201d85acc8960bb595ea1e9c
 SHA512:
-  metadata.gz: 8e0edd657e0b2d82e17b2eb143748cd22612b72b99851ef1ad331f9641f310e09859f537dc95798e255a5868cabed63599089fe19003991d8cce86c36dba8978
-  data.tar.gz: d82d26729d3206e07ed39b84215d9243c789066f3be32a64a9173356d70a8e588ffc60672832bb77038821249621dd2de7745cf6448f118916fbbffe3d6ee64e
+  metadata.gz: 3e77cf82affdd32b75f747c2a9a4bc7aaf8df14d0b847470b241b1fb34e3f98b8aea13fdb55430caff5a420e28a5ba0dc6e80d32505e315428317fb42a5fd9d6
+  data.tar.gz: d80856454fb213de0ef217f18518d42bed3f0a4e57b870f22d2e8eaa72b1cec45123e0c84b38f875b6cd85a62f543381437c8e8200cff87a31f3b2683671f94e

data/.github/workflows/examples.yml

@@ -0,0 +1,64 @@
+name: Examples
+
+on: push
+
+jobs:
+  rack:
+    runs-on: ubuntu-latest
+    name: Rack example
+    steps:
+    - uses: actions/checkout@v3
+    - uses: ruby/setup-ruby@v1
+      with:
+        bundler-cache: true
+        ruby-version: '2.7'
+        working-directory: examples/rack
+    - run: bundle exec parklife build
+      working-directory: examples/rack
+    - run: test -f build/index.html
+      working-directory: examples/rack
+
+  rails:
+    runs-on: ubuntu-latest
+    name: Rails example
+    steps:
+    - uses: actions/checkout@v3
+    - uses: ruby/setup-ruby@v1
+      with:
+        bundler-cache: true
+        ruby-version: '3.2'
+        working-directory: examples/rails
+    - run: bin/static-build
+      working-directory: examples/rails
+    - run: test -f build/index.html
+      working-directory: examples/rails
+
+  roda:
+    runs-on: ubuntu-latest
+    name: Roda example
+    steps:
+    - uses: actions/checkout@v3
+    - uses: ruby/setup-ruby@v1
+      with:
+        bundler-cache: true
+        ruby-version: '3.2'
+        working-directory: examples/roda
+    - run: bundle exec parklife build
+      working-directory: examples/roda
+    - run: test -f build/index.html
+      working-directory: examples/roda
+
+  sinatra:
+    runs-on: ubuntu-latest
+    name: Sinatra example
+    steps:
+    - uses: actions/checkout@v3
+    - uses: ruby/setup-ruby@v1
+      with:
+        bundler-cache: true
+        ruby-version: '2.7'
+        working-directory: examples/sinatra
+    - run: bundle exec parklife build
+      working-directory: examples/sinatra
+    - run: test -f build/index.html
+      working-directory: examples/sinatra

data/.github/workflows/tests.yml

@@ -3,51 +3,6 @@ name: Tests
 on: push
 
 jobs:
-  example_rack:
-    runs-on: ubuntu-latest
-    name: Rack example
-    steps:
-    - uses: actions/checkout@v3
-    - uses: ruby/setup-ruby@v1
-      with:
-        bundler-cache: true
-        ruby-version: '2.7'
-        working-directory: examples/rack
-    - run: bundle exec parklife build
-      working-directory: examples/rack
-    - run: test -f build/index.html
-      working-directory: examples/rack
-
-  example_rails:
-    runs-on: ubuntu-latest
-    name: Rails example
-    steps:
-    - uses: actions/checkout@v3
-    - uses: ruby/setup-ruby@v1
-      with:
-        bundler-cache: true
-        ruby-version: '3.2'
-        working-directory: examples/rails
-    - run: bin/static-build
-      working-directory: examples/rails
-    - run: test -f build/index.html
-      working-directory: examples/rails
-
-  example_sinatra:
-    runs-on: ubuntu-latest
-    name: Sinatra example
-    steps:
-    - uses: actions/checkout@v3
-    - uses: ruby/setup-ruby@v1
-      with:
-        bundler-cache: true
-        ruby-version: '2.7'
-        working-directory: examples/sinatra
-    - run: bundle exec parklife build
-      working-directory: examples/sinatra
-    - run: test -f build/index.html
-      working-directory: examples/sinatra
-
   rspec:
     runs-on: ubuntu-latest
     strategy:
@@ -57,6 +12,7 @@ jobs:
           - '3.0'
           - '3.1'
           - '3.2'
+          - '3.3'
     name: Ruby ${{ matrix.ruby }} RSpec
     steps:
     - uses: actions/checkout@v3

data/CHANGELOG.md

@@ -1,3 +1,21 @@
+## Version 0.6.1 - 2024-08-23
+
+- Don't error when the public directory doesn't exist <https://github.com/benpickles/parklife/pull/105>
+
+## Version 0.6.0 - 2023-03-26
+
+- Allow assigning a URI object to config.base <https://github.com/benpickles/parklife/pull/98>
+
+- Add a `parklife config` command to output the full Parklife config <https://github.com/benpickles/parklife/pull/97>
+
+- Improved Rails integration <https://github.com/benpickles/parklife/pull/96>
+
+  Parklife now integrates with Rails via Railties and can therefore hook into the app's configuration before it's initialised. This allows Parklife to remove the host authorisation middleware that's present in development and otherwise causes Parklife requests to receive a 403 response.
+
+  **Upgrading**: For an existing Parklife+Rails integration move requiring `parklife/rails` above requiring `config/environment` in the Parkfile.
+
+- Prevent `Encoding::UndefinedConversionError` error when writing a binary response <https://github.com/benpickles/parklife/pull/94>
+
 ## Version 0.5.1 - 2023-03-22
 
 - Ensure the generated static-build script is executable. <https://github.com/benpickles/parklife/pull/89>

data/Gemfile

@@ -8,6 +8,7 @@ git_source(:github) {|repo_name| "https://github.com/#{repo_name}" }
 gemspec
 
 gem 'bundler'
+gem 'rails'
 gem 'rake'
 gem 'rspec'
 gem 'rubocop'

data/README.md

@@ -23,14 +23,14 @@ $ bundle exec parklife init
 Parklife is configured with a file called `Parkfile` in the root of your project, here's an example `Parkfile` for an imaginary Rails app:
 
 ```ruby
+# Load Parklife's Rails-specific integration which, among other things, allows
+# you to use URL helpers within the `routes` block below.
+require 'parklife/rails'
+
 # Load the Rails application, this gives you full access to the application's
 # environment from this file - using models for example.
 require_relative 'config/environment'
 
-# Load Parklife and some Rails-specific settings allowing you to use URL
-# helpers within the `routes` block below.
-require 'parklife/rails'
-
 Parkfile.application.routes do
   # Start from the homepage and crawl all links.
   root crawl: true
@@ -76,7 +76,7 @@ build/feed.atom
 build/sitemap.xml
 ```
 
-Parklife doesn't know about assets (images, CSS, etc) so you likely also need to generate those and copy them to the build directory, see the [Rails example's full build script](examples/rails/parklife-build) for how you might do this.
+Parklife doesn't know about assets (images, CSS, etc) so you likely also need to generate those and copy them to the build directory, see the [Rails example's full build script](examples/rails/bin/static-build) for how you might do this.
 
 ## More examples
 

data/lib/parklife/cli.rb

@@ -15,6 +15,21 @@ module Parklife
       application.build
     end
 
+    desc 'config', 'Output the full Parklife config'
+    def config
+      reporter = application.config.reporter
+
+      shell.print_table([
+        ['app', application.config.app.inspect],
+        ['base', application.config.base.to_s],
+        ['build_dir', application.config.build_dir],
+        ['nested_index', application.config.nested_index],
+        ['on_404', application.config.on_404.inspect],
+        ['parklife/rails', defined?(::Parklife::Railtie) ? 'enabled' : '-'],
+        ['reporter', reporter == $stdout ? '$stdout' : reporter],
+      ])
+    end
+
     desc 'get PATH', 'Fetch PATH from the app and output its contents'
     def get(path)
       puts application.crawler.get(path).body

data/lib/parklife/config.rb

@@ -20,7 +20,7 @@ module Parklife
     end
 
     def base=(value)
-      uri = URI.parse(value || '')
+      uri = URI === value ? value : URI.parse(value || '')
       uri.host ||= DEFAULT_HOST
       uri.scheme ||= DEFAULT_SCHEME
       @base = uri

data/lib/parklife/errors.rb

@@ -16,10 +16,4 @@ module Parklife
       super %Q(Cannot load Parkfile "#{path}")
     end
   end
-
-  class RailsNotDefinedError < Error
-    def initialize(msg = 'Expected Rails to be defined, require config/environment before parklife')
-      super
-    end
-  end
 end

data/lib/parklife/rails.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-raise Parklife::RailsNotDefinedError unless defined?(Rails)
+require 'rails'
 
 module Parklife
   module RailsConfigRefinements
@@ -18,12 +18,35 @@ module Parklife
       }
     end
   end
-end
 
-Parklife.application.config.app = Rails.application
+  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
+    end
+
+    config.after_initialize do
+      Parklife.application.config.app = Rails.application
 
-# Allow use of the Rails application's route helpers when defining Parklife
-# routes in the block form.
-Parklife.application.routes.singleton_class.include(Rails.application.routes.url_helpers)
+      # Allow use of the Rails application's route helpers when defining
+      # Parklife routes in the block form.
+      Parklife.application.routes.singleton_class.include(Rails.application.routes.url_helpers)
 
-Parklife.application.config.extend(Parklife::RailsConfigRefinements)
+      Parklife.application.config.extend(RailsConfigRefinements)
+    end
+  end
+end

data/lib/parklife/templates/Parkfile.erb

@@ -1,6 +1,6 @@
 <% if options[:rails] -%>
-require_relative 'config/environment'
 require 'parklife/rails'
+require_relative 'config/environment'
 <% else -%>
 # Assuming your Rack app lives in ./app.rb:
 require_relative 'app'

data/lib/parklife/templates/static_build.erb

@@ -22,7 +22,9 @@ bundle exec rails assets:precompile
 bundle exec parklife build "$@"
 
 # Copy all public resources to ./build.
-cp -R public/* build
+if [ -d public ]; then
+  cp -R public/* build
+fi
 
 # List all files in the build (useful for debugging).
 find build -type f | sort

data/lib/parklife/utils.rb

@@ -34,7 +34,7 @@ module Parklife
         build_path_for(path, index: config.nested_index)
       )
       FileUtils.mkdir_p(File.dirname(build_path))
-      File.write(build_path, content)
+      File.write(build_path, content, mode: 'wb')
     end
 
     def scan_for_links(html)

data/lib/parklife/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Parklife
-  VERSION = '0.5.1'
+  VERSION = '0.6.1'
 end

data/parklife.gemspec

@@ -11,19 +11,15 @@ Gem::Specification.new do |spec|
   spec.email         = ['spideryoung@gmail.com']
 
   spec.summary       = 'Convert a Rack app into a static HTML site.'
-  spec.homepage      = 'https://github.com/benpickles/parklife'
+  spec.homepage      = 'https://parklife.dev'
   spec.license       = 'MIT'
-
-  # Prevent pushing this gem to RubyGems.org. To allow pushes either set the 'allowed_push_host'
-  # to allow pushing to a single host or delete this section to allow pushing to any host.
-  spec.metadata = {
-    'changelog_uri' => 'https://github.com/benpickles/parklife/blob/main/CHANGELOG.md',
-    'rubygems_mfa_required' => 'true',
-    'source_code_uri' => 'https://github.com/benpickles/parklife',
-  }
-
   spec.required_ruby_version = '>= 2.5.0'
 
+  spec.metadata['changelog_uri'] = 'https://github.com/benpickles/parklife/blob/main/CHANGELOG.md'
+  spec.metadata['homepage_uri'] = spec.homepage
+  spec.metadata['rubygems_mfa_required'] = 'true'
+  spec.metadata['source_code_uri'] = 'https://github.com/benpickles/parklife'
+
   # Specify which files should be added to the gem when it is released.
   # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
   spec.files         = Dir.chdir(File.expand_path('..', __FILE__)) do

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: parklife
 version: !ruby/object:Gem::Version
-  version: 0.5.1
+  version: 0.6.1
 platform: ruby
 authors:
 - Ben Pickles
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2023-03-22 00:00:00.000000000 Z
+date: 2024-08-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: nokogiri
@@ -60,6 +60,7 @@ executables:
 extensions: []
 extra_rdoc_files: []
 files:
+- ".github/workflows/examples.yml"
 - ".github/workflows/tests.yml"
 - ".gitignore"
 - ".rspec"
@@ -89,11 +90,12 @@ files:
 - lib/parklife/utils.rb
 - lib/parklife/version.rb
 - parklife.gemspec
-homepage: https://github.com/benpickles/parklife
+homepage: https://parklife.dev
 licenses:
 - MIT
 metadata:
   changelog_uri: https://github.com/benpickles/parklife/blob/main/CHANGELOG.md
+  homepage_uri: https://parklife.dev
   rubygems_mfa_required: 'true'
   source_code_uri: https://github.com/benpickles/parklife
 post_install_message:
@@ -111,7 +113,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.6
+rubygems_version: 3.5.17
 signing_key:
 specification_version: 4
 summary: Convert a Rack app into a static HTML site.