goodguide-pinglish 1.1.0 → 1.2.0

checksums.yaml

@@ -1,15 +1,15 @@
 ---
 !binary "U0hBMQ==":
   metadata.gz: !binary |-
-    MzVmMGY0ODBmZTRmZGMwOTI3OTg2MDY5MGU5NDllMzNjZjkwZTk1OQ==
+    N2QyYmIwZjlmNjU0ODk0MDk4NDAzMWI5NDEyYzkyNzU4NWI5YzUyYg==
   data.tar.gz: !binary |-
-    NzI2YTdjODVlYTk4YmRiYjU1OGZhZjg2OWIwYWRkZGE5ZWU1YmRlNg==
+    NmVlMmFjNDhmY2JjZTdiN2U1M2Q5ZjBlMTY2OTU5MDJjYTg5ZDI4Ng==
 SHA512:
   metadata.gz: !binary |-
-    M2Q0M2RlYWUyOWI0NDVkMDQxZTQ0NWU4Nzg1M2NkZGMyMTkwZDdiZDE4MmQz
-    MjI4ZmZmZmQ3MmViNWVhNjk5MWYzZjdhYzRkNzJkYjk2YzQ2ODczMzhhYjg1
-    NzA5YTk3Yjc5YTVjM2E1MTI1ZjlhMWJiNzk5Y2U5ZWNhMmQ2NGY=
+    OTRmMmJiOTkyNzFlYmRkMjFmOTAyYTBhY2FmZGJjNDlhYmVkZDVmNWNkYjMx
+    NWE2YjUwOTFlZThlNjIwMDk4MTExOWUwZTExODkyODYzZWNkNGFmNDRkN2M0
+    ZDI1MjAyMDZjNGFjYzI2NjU4NGQ3NzA4MzgxNzM5ZmY0OTJiZGE=
   data.tar.gz: !binary |-
-    ZGI5MWVhYmE0ZDI0NGRhYThjNTIxMDJkMDQ2NWVkZWZhMGIzZDA2MGM1NGMy
-    MjRjZjRlNDI3M2ZiNmQ0MThmZGI3ZTlhMjVmZTZkNGFlYTc4YzA1MDcxY2My
-    Yjc5OTFhYzU1NWIxYjk1YjM0YWI5NGY3MzZlMmY2MWY0MDhhY2E=
+    NWNlYmY5NzcwZmNjNDc0YTE1YWE1NDI0Mzc0NTUwMWU1Mzk0YTgzYTNhODVh
+    OTIzZWVkY2EzZmY3MzEwZDVmNjRlZmE3NGExOGExYzMzYzU0Mzg0ODI5OTM3
+    M2VlYjNmNWIwYjliYmY0NGM2MWI4YTAzOTk3N2RiMTUwNzY0NWY=

data/.travis.yml

@@ -7,8 +7,11 @@ rvm:
   - rbx-2
   - ruby-head
   - jruby-head
-before_install: gem install bundler
 
+env:
+  - TRAVIS_CI=true
+
+before_install: gem install bundler
 bundler_args: --jobs=4 --retry=5
 
 deploy:

data/Gemfile

@@ -1,2 +1,2 @@
-source "https://rubygems.org"
+source 'https://rubygems.org'
 gemspec

data/README.md

@@ -11,9 +11,6 @@ A simple Rack app for checking application health. Pinglish responds to `GET` re
   agains my MySQL database," "Can I create/read keys in Redis," or "How
   many docs are in my ElasticSearch index?"
 
-0. The response __must__ return within 29 seconds. This is one second
-   less than the default timeout for many monitoring services.
-
 0. The response __must__ return an `HTTP 200 OK` status code if all
    health checks pass.
 

data/goodguide-pinglish.gemspec

@@ -1,20 +1,20 @@
 # -*- encoding: utf-8 -*-
 
 Gem::Specification.new do |gem|
-  gem.name          = "goodguide-pinglish"
-  gem.version       = "1.1.0"
-  gem.authors       = ["John Barnette", "Will Farrington"]
-  gem.email         = ["jbarnette@github.com", "wfarr@github.com"]
-  gem.description   = "A simple Rack middleware for checking app health."
-  gem.summary       = "/_ping your way to freedom."
-  gem.homepage      = "https://github.com/goodguide/pinglish"
+  gem.name          = 'goodguide-pinglish'
+  gem.version       = '1.2.0'
+  gem.authors       = ['John Barnette', 'Will Farrington', 'Ryan Long']
+  gem.email         = ['jbarnette@github.com', 'wfarr@github.com', 'ryan@rtlong.com']
+  gem.description   = 'A simple Rack middleware for checking app health.'
+  gem.summary       = '/_ping your way to freedom.'
+  gem.homepage      = 'https://github.com/goodguide/pinglish'
 
   gem.files         = `git ls-files`.split($/)
   gem.test_files    = gem.files.grep(/^test/)
-  gem.require_paths = ["lib"]
+  gem.require_paths = ['lib']
 
-  gem.add_dependency "rack"
+  gem.add_dependency 'rack'
   gem.add_development_dependency 'rake', '~> 10.4.0'
-  gem.add_development_dependency "minitest", "~> 4.5"
-  gem.add_development_dependency "rack-test", "~> 0.6"
+  gem.add_development_dependency 'minitest', '~> 4.5'
+  gem.add_development_dependency 'rack-test', '~> 0.6'
 end

data/lib/pinglish.rb

@@ -1,7 +1,6 @@
-require "json"
-require "pinglish/check"
-require "rack/request"
-require "timeout"
+require 'json'
+require 'pinglish/check'
+require 'rack/request'
 
 # This Rack app provides an endpoint for configurable
 # system health checks. It's intended to be consumed by machines.
@@ -10,96 +9,97 @@ class Pinglish
 
   # The HTTP headers sent for every response.
   HEADERS = {
-    "Content-Type" => "application/json; charset=UTF-8"
+    'Content-Type' => 'application/json; charset=UTF-8'
   }
 
-  # Raised when a check exceeds its timeout.
-  class TooLong < RuntimeError; end
-
-  # Create a new instance of the app, with optional parameter `:max` timeout in seconds (default: `29`); yields itself to an optional block for configuring checks.
+  # Create a new instance of the app; yields itself to an optional block for configuring checks.
   def initialize(options=nil, &block)
     options ||= {}
 
     @checks = {}
-    @max    = options[:max] || 29 # seconds
 
-    yield self if block_given?
+    yield(self) if block_given?
   end
 
   def call(env)
     request = Rack::Request.new(env)
+    results = {}
 
-    begin
-      timeout @max do
-        results = {}
-
-        selected_checks(request.params).each do |check|
-          begin
-            timeout(check.timeout) do
-              results[check.name] = check.call
-            end
-          rescue => e
-            results[check.name] = e
-          end
-        end
+    selected_checks(request.params).each do |check|
+      check_thread = Thread.new do
+        check.call
+      end
+      sleep_thread = Thread.new do
+        sleep check.timeout
+        check_thread.kill
+        :timeout
+      end
+      begin
+        val = check_thread.value
+      rescue => e
+        val = e
+      end
+      sleep_thread.kill
+      results[check.name] = sleep_thread.value || val
+    end
 
-        failed = results.values.any? { |v| failure? v }
-        http_status = failed ? 503 : 200
-        text_status = failed ? "failures" : "ok"
+    failed = results.values.any? { |v| failure?(v) }
+    http_status = failed ? 503 : 200
+    text_status = failed ? 'failures' : 'ok'
 
-        data = {
-          :now    => Time.now.to_i.to_s,
-          :status => text_status
-        }
+    data = {
+      now: Time.now.to_i,
+      status: text_status,
+    }
+
+    results.each do |name, value|
+      if timeout?(value)
+        # If the check failed because it timed out, its name is
+        # added to a `timeouts` array instead.
+        (data[:timeouts] ||= []) << name
+
+      elsif failure?(value)
+        # If a check fails its name is added to a `failures` array.
 
-        results.each do |name, value|
-          if failure?(value)
-            # If a check fails its name is added to a `failures` array.
-            # If the check failed because it timed out, its name is
-            # added to a `timeouts` array instead.
-
-            key = timeout?(value) ? :timeouts : :failures
-            (data[key] ||= []) << name
-
-            if key == :failures and value.is_a?(Exception)
-              data[name] = {
-                state: :error,
-                exception: value.class.name,
-                message: value.message,
-              }
-            end
-
-          elsif value
-            # If the check passed and returned a value, the stringified
-            # version of the value is returned under the `name` key.
-
-            data[name] = value
-          end
+        (data[:failures] ||= []) << name
+
+        if value.is_a?(Exception)
+          data[name] = {
+            state: :error,
+            exception: value.class.name,
+            message: value.message,
+          }
         end
 
-        [http_status, HEADERS, [JSON.generate(data)]]
+      elsif value
+        # If the check passed and returned a value, the stringified
+        # version of the value is returned under the `name` key.
+
+        data[name] = value
       end
+    end
 
-    rescue Exception => ex
-      # Something catastrophic happened. We can't even run the checks
-      # and render a JSON response. Fall back on a pre-rendered string
-      # and interpolate the current epoch time.
+    [http_status, HEADERS, [JSON.generate(data)]]
 
-      now = Time.now.to_i.to_s
+  rescue Exception => ex
+    # Something catastrophic happened. We can't even run the checks
+    # and render a JSON response. Fall back on a pre-rendered string
+    # and interpolate the current epoch time.
 
-      body = <<-EOF.gsub(/^ {6}/, '')
+    now = Time.now.to_i
+
+    body = <<-EOF.gsub(/^ {6}/, '')
       {
         "status": "failures",
-        "now": "#{now}",
+        "now": #{now},
         "error": {
           "class": "#{ex.class.name}",
           "message": "#{ex.message.tr('"', '')}"
         }
       }
-      EOF
+    EOF
 
-      [500, HEADERS, [body]]
-    end
+    [500, HEADERS, [body]]
   end
 
   def selected_checks(params)
@@ -124,23 +124,10 @@ class Pinglish
   # Subclasses can override this method for different behavior.
 
   def failure?(value)
-    value.is_a?(Exception) || value == false
+    value.is_a?(Exception) || value == false || timeout?(value)
   end
 
-  # Raise Pinglish::TooLong after `seconds` has elapsed. This default
-  # implementation uses Ruby's built-in Timeout class. Subclasses can
-  # override this method for different behavior, but any new
-  # implementation must raise Pinglish::TooLong when the timeout is
-  # exceeded or override `timeout?` appropriately.
-
-  def timeout(seconds, &block)
-    Timeout.timeout seconds, Pinglish::TooLong, &block
-  end
-
-  # Does `value` represent a check timeout? Returns `true` for any
-  # value that is an instance of Pinglish::TooLong.
-
   def timeout?(value)
-    value.is_a? Pinglish::TooLong
+    value == :timeout
   end
 end

data/test/helper.rb

@@ -1,2 +1,4 @@
 require "minitest/autorun"
 require "pinglish"
+
+TIME_UNIT = ENV['TRAVIS_CI'] ? 1 : 0.001

data/test/pinglish_test.rb

@@ -1,8 +1,8 @@
-require "helper"
-require "rack/test"
+require 'helper'
+require 'rack/test'
 
 class PinglishTest < MiniTest::Unit::TestCase
-  FakeApp = lambda { |env| [200, {}, ["fake"]] }
+  FakeApp = lambda { |env| [200, {}, ['fake']] }
 
   def build_app(*args, &block)
     Rack::Builder.new do |builder|
@@ -18,7 +18,7 @@ class PinglishTest < MiniTest::Unit::TestCase
       builder.map '/_ping' do
         run Pinglish.new(*args, &block)
       end
-      builder.run lambda { |env| raise "boom" }
+      builder.run lambda { |env| raise 'boom' }
     end
   end
 
@@ -27,7 +27,7 @@ class PinglishTest < MiniTest::Unit::TestCase
     session = Rack::Test::Session.new(app)
 
     assert_raises RuntimeError do
-      session.get "/something"
+      session.get '/something'
     end
   end
 
@@ -35,14 +35,14 @@ class PinglishTest < MiniTest::Unit::TestCase
     app = build_app
 
     session = Rack::Test::Session.new(app)
-    session.get "/_ping"
+    session.get '/_ping'
     assert_equal 200, session.last_response.status
-    assert_equal "application/json; charset=UTF-8",
+    assert_equal 'application/json; charset=UTF-8',
       session.last_response.content_type
 
     json = JSON.load(session.last_response.body)
-    assert json.key?("now")
-    assert_equal "ok", json["status"]
+    assert json.key?('now')
+    assert_equal 'ok', json['status']
   end
 
   def test_with_good_check
@@ -52,16 +52,16 @@ class PinglishTest < MiniTest::Unit::TestCase
     end
 
     session = Rack::Test::Session.new(app)
-    session.get "/_ping"
+    session.get '/_ping'
 
-    assert_equal "application/json; charset=UTF-8",
+    assert_equal 'application/json; charset=UTF-8',
       session.last_response.content_type
 
     json = JSON.load(session.last_response.body)
-    assert json.key?("now")
-    assert_equal "ok", json["status"]
-    assert_equal "up_and_at_em", json["db"]
-    assert_equal "pushin_and_poppin", json["queue"]
+    assert json.key?('now')
+    assert_equal 'ok', json['status']
+    assert_equal 'up_and_at_em', json['db']
+    assert_equal 'pushin_and_poppin', json['queue']
   end
 
   def test_with_unnamed_check
@@ -70,62 +70,62 @@ class PinglishTest < MiniTest::Unit::TestCase
     end
 
     session = Rack::Test::Session.new(app)
-    session.get "/_ping"
+    session.get '/_ping'
 
-    assert_equal "application/json; charset=UTF-8",
+    assert_equal 'application/json; charset=UTF-8',
       session.last_response.content_type
 
     json = JSON.load(session.last_response.body)
-    assert json.key?("now")
-    assert_equal "ok", json["status"]
-    assert_equal "yohoho", json["default"]
+    assert json.key?('now')
+    assert_equal 'ok', json['status']
+    assert_equal 'yohoho', json['default']
   end
 
   def test_with_unnamed_check_that_raises
     app = build_app do |ping|
-      ping.check { raise "nooooope" }
+      ping.check { raise 'nooooope' }
     end
 
     session = Rack::Test::Session.new(app)
-    session.get "/_ping"
+    session.get '/_ping'
 
-    assert_equal "application/json; charset=UTF-8",
+    assert_equal 'application/json; charset=UTF-8',
       session.last_response.content_type
 
     json = JSON.load(session.last_response.body)
-    assert json.key?("now")
-    assert_equal 'failures', json["status"]
-    assert_equal ['default'], json["failures"]
+    assert json.key?('now')
+    assert_equal 'failures', json['status']
+    assert_equal ['default'], json['failures']
     assert_equal({
       'state' => 'error',
       'exception' => 'RuntimeError',
       'message' => 'nooooope'
-    }, json["default"])
+    }, json['default'])
   end
 
 
   def test_with_check_that_raises
     app = build_app do |ping|
       ping.check(:db) { :ok }
-      ping.check(:raise) { raise "nooooope" }
+      ping.check(:raise) { raise 'nooooope' }
     end
 
     session = Rack::Test::Session.new(app)
-    session.get "/_ping"
+    session.get '/_ping'
 
     assert_equal 503, session.last_response.status
-    assert_equal "application/json; charset=UTF-8",
+    assert_equal 'application/json; charset=UTF-8',
       session.last_response.content_type
 
     json = JSON.load(session.last_response.body)
-    assert json.key?("now")
-    assert_equal "failures", json["status"]
-    assert_equal ['raise'], json["failures"]
+    assert json.key?('now')
+    assert_equal 'failures', json['status']
+    assert_equal ['raise'], json['failures']
     assert_equal({
       'state' => 'error',
       'exception' => 'RuntimeError',
       'message' => 'nooooope'
-    }, json["raise"])
+    }, json['raise'])
   end
 
   def test_with_check_that_returns_false
@@ -135,68 +135,50 @@ class PinglishTest < MiniTest::Unit::TestCase
     end
 
     session = Rack::Test::Session.new(app)
-    session.get "/_ping"
+    session.get '/_ping'
 
     assert_equal 503, session.last_response.status
-    assert_equal "application/json; charset=UTF-8",
+    assert_equal 'application/json; charset=UTF-8',
       session.last_response.content_type
 
     json = JSON.load(session.last_response.body)
-    assert json.key?("now")
-    assert_equal "failures", json["status"]
-    assert_equal ["fail"], json["failures"]
-    assert_equal false, json.key?("fail")
+    assert json.key?('now')
+    assert_equal 'failures', json['status']
+    assert_equal ['fail'], json['failures']
+    assert_equal false, json.key?('fail')
   end
 
   def test_with_check_that_times_out
     app = build_app do |ping|
       ping.check(:db) { :ok }
-      ping.check(:long, :timeout => 0.001) { sleep 0.003 }
+      ping.check(:long, :timeout => TIME_UNIT) { sleep TIME_UNIT * 5 }
     end
 
     session = Rack::Test::Session.new(app)
-    session.get "/_ping"
+    session.get '/_ping'
 
-    assert_equal 503, session.last_response.status
-    assert_equal "application/json; charset=UTF-8",
+    assert_equal 503, session.last_response.status, session.last_response.body
+    assert_equal 'application/json; charset=UTF-8',
       session.last_response.content_type
 
     json = JSON.load(session.last_response.body)
-    assert json.key?("now")
-    assert_equal "failures", json["status"]
-    assert_equal ["long"], json["timeouts"]
-  end
-
-  def test_with_checks_taking_more_than_max
-    app = build_app(:max => 0.001) do |ping|
-      ping.check(:long) { sleep 0.003 }
-    end
-
-    session = Rack::Test::Session.new(app)
-    session.get "/_ping"
-
-    assert_equal 503, session.last_response.status
-    assert_equal "application/json; charset=UTF-8",
-      session.last_response.content_type
-
-    json = JSON.load(session.last_response.body)
-    assert json.key?("now")
-    assert_equal "failures", json["status"]
-    assert_equal ['long'], json["timeouts"]
+    assert json.key?('now')
+    assert_equal 'failures', json['status']
+    assert_equal ['long'], json['timeouts']
   end
 
   def test_with_script_name
     app = build_app
 
     session = Rack::Test::Session.new(app)
-    session.get "/_ping", {}, "SCRIPT_NAME" => "/myapp"
+    session.get '/_ping', {}, 'SCRIPT_NAME' => '/myapp'
     assert_equal 200, session.last_response.status
-    assert_equal "application/json; charset=UTF-8",
+    assert_equal 'application/json; charset=UTF-8',
       session.last_response.content_type
 
     json = JSON.load(session.last_response.body)
-    assert json.key?("now")
-    assert_equal "ok", json["status"]
+    assert json.key?('now')
+    assert_equal 'ok', json['status']
   end
 
   def test_with_selective_checks
@@ -207,17 +189,17 @@ class PinglishTest < MiniTest::Unit::TestCase
     end
 
     session = Rack::Test::Session.new(app)
-    session.get "/_ping?checks=db,foo"
+    session.get '/_ping?checks=db,foo'
 
     assert_equal 200, session.last_response.status
-    assert_equal "application/json; charset=UTF-8",
+    assert_equal 'application/json; charset=UTF-8',
       session.last_response.content_type
 
     json = JSON.load(session.last_response.body)
-    assert json.key?("now")
-    assert_equal "ok", json["status"]
-    assert_equal false, json.key?("timeouts")
-    assert_equal false, json.key?("failures")
+    assert json.key?('now')
+    assert_equal 'ok', json['status']
+    assert_equal false, json.key?('timeouts')
+    assert_equal false, json.key?('failures')
     assert_equal 'ok', json['db']
     assert_equal 'bar', json['foo']
   end
@@ -245,19 +227,13 @@ class PinglishTest < MiniTest::Unit::TestCase
     refute pinglish.failure?(:ok)
   end
 
-  def test_timeout
-    pinglish = Pinglish.new(FakeApp)
-
-    assert_raises Pinglish::TooLong do
-      pinglish.timeout(0.001) { sleep 0.003 }
-    end
-  end
-
   def test_timeout_boolean
     pinglish = Pinglish.new(FakeApp)
 
-    assert pinglish.timeout?(Pinglish::TooLong.new)
-    refute pinglish.timeout?(Exception.new)
+    assert pinglish.timeout?(:timeout)
+    refute pinglish.timeout?(:foo)
+    refute pinglish.timeout?(false)
+    refute pinglish.timeout?(StandardError.new)
   end
 
   def test_enabled_by_default_false
@@ -267,19 +243,19 @@ class PinglishTest < MiniTest::Unit::TestCase
     end
 
     session = Rack::Test::Session.new(app)
-    session.get "/_ping"
+    session.get '/_ping'
 
     assert_equal 200, session.last_response.status
-    assert_equal "application/json; charset=UTF-8",
+    assert_equal 'application/json; charset=UTF-8',
       session.last_response.content_type
 
     json = JSON.load(session.last_response.body)
-    assert json.key?("now")
-    assert_equal "ok", json["status"]
-    assert_equal false, json.key?("timeouts")
-    assert_equal false, json.key?("failures")
+    assert json.key?('now')
+    assert_equal 'ok', json['status']
+    assert_equal false, json.key?('timeouts')
+    assert_equal false, json.key?('failures')
     assert_equal 'ok', json['db']
-    assert_equal false, json.key?("intense")
+    assert_equal false, json.key?('intense')
   end
 
   def test_enabled_by_default_selected
@@ -289,18 +265,18 @@ class PinglishTest < MiniTest::Unit::TestCase
     end
 
     session = Rack::Test::Session.new(app)
-    session.get "/_ping?checks=db,intense"
+    session.get '/_ping?checks=db,intense'
 
     assert_equal 200, session.last_response.status
-    assert_equal "application/json; charset=UTF-8",
+    assert_equal 'application/json; charset=UTF-8',
       session.last_response.content_type
 
     json = JSON.load(session.last_response.body)
-    assert json.key?("now")
-    assert_equal "ok", json["status"]
-    assert_equal false, json.key?("timeouts")
-    assert_equal false, json.key?("failures")
+    assert json.key?('now')
+    assert_equal 'ok', json['status']
+    assert_equal false, json.key?('timeouts')
+    assert_equal false, json.key?('failures')
     assert_equal 'ok', json['db']
-    assert_equal 'ok', json["intense"]
+    assert_equal 'ok', json['intense']
   end
 end

metadata

@@ -1,11 +1,12 @@
 --- !ruby/object:Gem::Specification
 name: goodguide-pinglish
 version: !ruby/object:Gem::Version
-  version: 1.1.0
+  version: 1.2.0
 platform: ruby
 authors:
 - John Barnette
 - Will Farrington
+- Ryan Long
 autorequire: 
 bindir: bin
 cert_chain: []
@@ -71,6 +72,7 @@ description: A simple Rack middleware for checking app health.
 email:
 - jbarnette@github.com
 - wfarr@github.com
+- ryan@rtlong.com
 executables: []
 extensions: []
 extra_rdoc_files: []
@@ -84,9 +86,6 @@ files:
 - goodguide-pinglish.gemspec
 - lib/pinglish.rb
 - lib/pinglish/check.rb
-- script/bootstrap
-- script/release
-- script/test
 - test/check_test.rb
 - test/helper.rb
 - test/pinglish_test.rb

data/script/bootstrap

@@ -1,9 +0,0 @@
-#!/bin/sh
-# Make sure local development dependencies are satisfied.
-
-set -e
-
-cd $(dirname "$0")/..
-rm -rf .bundle/config
-
-bundle install --path .bundle --binstubs .bundle/binstubs --quiet "$@"

data/script/release

@@ -1,38 +0,0 @@
-#!/bin/sh
-# Tag and push a release.
-
-set -e
-
-# Make sure we're in the project root.
-
-cd $(dirname "$0")/..
-
-# Build a new gem archive.
-
-rm -rf pinglish-*.gem
-gem build -q pinglish.gemspec
-
-# Make sure we're on the master branch.
-
-(git branch | grep -q '* master') || {
-  echo "Only release from the master branch."
-  exit 1
-}
-
-# Figure out what version we're releasing.
-
-tag=v`ls pinglish-*.gem | sed 's/^pinglish-\(.*\)\.gem$/\1/'`
-
-# Make sure we haven't released this version before.
-
-git fetch -t origin
-
-(git tag -l | grep -q "$tag") && {
-  echo "Whoops, there's already a '${tag}' tag."
-  exit 1
-}
-
-# Tag it and bag it.
-
-gem push pinglish-*.gem && git tag "$tag" &&
-  git push origin master && git push origin "$tag"

data/script/test

@@ -1,9 +0,0 @@
-#!/bin/sh
-# Run the tests.
-
-set -e
-
-cd $(dirname "$0")/..
-
-script/bootstrap && ruby -I lib -I test -rubygems \
-  -e 'require "bundler/setup"; Dir["test/**/*_test.rb"].each { |f| load f }' "$@"