omniauth-rails 0.1.0

data/lib/omniauth/rails/engine.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+module Omniauth
+  module Rails
+    class Engine < ::Rails::Engine
+      require "omniauth"
+      require "omniauth-google-oauth2"
+      isolate_namespace Omniauth::Rails
+
+      initializer "omniauth_rails.action_controller" do |_app|
+        ActiveSupport.on_load :action_controller do
+          helper Omniauth::Rails::ApplicationHelper
+        end
+      end
+
+      config.generators do |g|
+        g.test_framework :rspec, fixture: false
+        g.assets false
+        g.helper false
+      end
+    end
+  end
+end

data/lib/omniauth/rails/test/controller_helpers.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+module Omniauth
+  module Rails
+    module Test
+      module ControllerHelpers
+        def sign_in(email)
+          session["OmniauthRailsAuthData"] = { "email" => email }
+        end
+
+        def authenticated?
+          session["OmniauthRailsAuthData"].present? &&
+            session["OmniauthRailsAuthData"]["email"].present?
+        end
+      end
+    end
+  end
+end

data/lib/omniauth/rails/test/request_helpers.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+module Omniauth
+  module Rails
+    module Test
+      module RequestHelpers
+        # Another option for mocking this, is to use something like this:
+        # before do
+        #   Rails.application.env_config["omniauth.auth"] = OmniAuth.config.mock_auth[:google_oauth2]
+        # end
+
+        def sign_in(email)
+          fake_session = {}
+          data_store = Omniauth::Rails::AuthenticationDataStore.new(fake_session)
+          data_store.set("email", email)
+          allow(AuthenticationDataStore).to receive(:new).and_return(data_store)
+        end
+
+        def authenticated?
+          get "/private"
+          response.status == 200
+        end
+      end
+    end
+  end
+end

data/lib/omniauth/rails/version.rb

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+module Omniauth
+  module Rails
+    VERSION = "0.1.0"
+  end
+end

data/lib/omniauth/rails.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+require "omniauth/rails/engine"
+
+require "omniauth/rails/configuration"
+
+module Omniauth
+  module Rails
+  end
+end

data/spec/controllers/application_controller_spec.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+require "rails_helper_for_engine"
+require_relative "../../app/controllers/omniauth/rails/application_controller"
+
+# This empty describe doesn't do anything. But for some reason it convinces
+# simplecov that the ApplicationController is covered.
+RSpec.describe Omniauth::Rails::ApplicationController do
+end

data/spec/examples.txt

@@ -0,0 +1,19 @@
+example_id                                                               | status | run_time        |
+------------------------------------------------------------------------ | ------ | --------------- |
+./spec/controllers/application_controller_spec.rb[1:1]                   | passed | 0.00035 seconds |
+./spec/models/omniauth/rails/authorization_types/emails_spec.rb[1:1:1:1] | passed | 0.00009 seconds |
+./spec/models/omniauth/rails/authorization_types/emails_spec.rb[1:1:2:1] | passed | 0.00051 seconds |
+./spec/models/omniauth/rails/authorization_types/regex_spec.rb[1:1:1:1]  | passed | 0.00019 seconds |
+./spec/models/omniauth/rails/authorization_types/regex_spec.rb[1:1:2:1]  | passed | 0.00012 seconds |
+./spec/omniauth_rails_spec.rb[1:1]                                       | passed | 0.00043 seconds |
+./spec/test_app/spec/controllers/private_controller_spec.rb[1:1:1:1]     | passed | 0.00652 seconds |
+./spec/test_app/spec/requests/private_controller_spec.rb[1:1:1:1]        | passed | 0.01215 seconds |
+./spec/test_app/spec/requests/private_controller_spec.rb[1:1:2:1]        | passed | 0.17193 seconds |
+./spec/test_app/spec/requests/public_controller_spec.rb[1:1:1]           | passed | 0.00821 seconds |
+./spec/test_app/spec/requests/sessions_controller_spec.rb[1:1:1]         | passed | 0.00263 seconds |
+./spec/test_app/spec/requests/sessions_controller_spec.rb[1:1:2:1]       | passed | 0.00228 seconds |
+./spec/test_app/spec/requests/sessions_controller_spec.rb[1:2:1:1]       | passed | 0.01283 seconds |
+./spec/test_app/spec/requests/sessions_controller_spec.rb[1:2:1:2:1]     | passed | 0.0042 seconds  |
+./spec/test_app/spec/requests/sessions_controller_spec.rb[1:3:1:1]       | passed | 0.00124 seconds |
+./spec/test_app/spec/requests/sessions_controller_spec.rb[1:3:2:1]       | passed | 0.0011 seconds  |
+./spec/test_app/spec/requests/sessions_controller_spec.rb[1:3:3:1]       | passed | 0.00288 seconds |

data/spec/models/omniauth/rails/authorization_types/emails_spec.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+require "rails_helper_for_engine"
+require_relative "../../../../../app/models/omniauth/rails/authorization_types/base"
+require_relative "../../../../../app/models/omniauth/rails/authorization_types/emails"
+
+RSpec.describe Omniauth::Rails::AuthorizationTypes::Emails do
+  let(:email) { "foo@bar.com" }
+  let(:emails) { %w(foo@bar.com baz@bar.com) }
+
+  let(:subject) { Omniauth::Rails::AuthorizationTypes::Emails.new(email: email, value: emails) }
+
+  describe "#authorized?" do
+    context "a match" do
+      it "returns true" do
+        expect(subject.authorized?).to eq(true)
+      end
+    end
+
+    context "a miss" do
+      let(:email) { "foo99@bar.com" }
+
+      it "returns false" do
+        expect(subject.authorized?).to eq(false)
+      end
+    end
+  end
+end

data/spec/models/omniauth/rails/authorization_types/regex_spec.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+require "rails_helper_for_engine"
+require_relative "../../../../../app/models/omniauth/rails/authorization_types/base"
+require_relative "../../../../../app/models/omniauth/rails/authorization_types/regex"
+
+RSpec.describe Omniauth::Rails::AuthorizationTypes::Regex do
+  let(:email) { "foo@bar.com" }
+  let(:regex) { /\Afo\w@bar.com\z/i }
+
+  let(:subject) { Omniauth::Rails::AuthorizationTypes::Regex.new(email: email, value: regex) }
+
+  describe "#authorized?" do
+    context "a match" do
+      it "returns true" do
+        expect(subject.authorized?).to eq(true)
+      end
+    end
+
+    context "a miss" do
+      let(:email) { "baz@bar.com" }
+
+      it "returns false" do
+        expect(subject.authorized?).to eq(false)
+      end
+    end
+  end
+end

data/spec/omniauth_rails_spec.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+require_relative "../lib/omniauth/rails/version"
+
+RSpec.describe Omniauth::Rails do
+  # This silly spec ensures that the Omniauth::Rails::VERSION has code coverage
+  it "has a version" do
+    expect(Omniauth::Rails::VERSION).to be_a(String)
+  end
+end

data/spec/rails_helper_for_engine.rb

@@ -0,0 +1,62 @@
+# frozen_string_literal: true
+
+# This file is copied to spec/ when you run 'rails generate rspec:install'
+ENV["RAILS_ENV"] ||= "test"
+# require File.expand_path('../../config/environment', __FILE__)
+# Prevent database truncation if the environment is production
+# abort("The Rails environment is running in production mode!") if Rails.env.production?
+require "spec_helper"
+require "action_view/railtie"
+require "action_controller/railtie"
+require "rspec/rails"
+require "omniauth/rails"
+# Add additional requires below this line. Rails is not loaded until this point!
+
+# Requires supporting ruby files with custom matchers and macros, etc, in
+# spec/support/ and its subdirectories. Files matching `spec/**/*_spec.rb` are
+# run as spec files by default. This means that files in spec/support that end
+# in _spec.rb will both be required and run as specs, causing the specs to be
+# run twice. It is recommended that you do not name files matching this glob to
+# end with _spec.rb. You can configure this pattern with the --pattern
+# option on the command line or in ~/.rspec, .rspec or `.rspec-local`.
+#
+# The following line is provided for convenience purposes. It has the downside
+# of increasing the boot-up time by auto-requiring all files in the support
+# directory. Alternatively, in the individual `*_spec.rb` files, manually
+# require only the support files necessary.
+#
+# Dir[Rails.root.join('spec/support/**/*.rb')].each { |f| require f }
+
+# Checks for pending migration and applies them before tests are run.
+# If you are not using ActiveRecord, you can remove this line.
+# ActiveRecord::Migration.maintain_test_schema!
+
+RSpec.configure do |config|
+  # Remove this line if you're not using ActiveRecord or ActiveRecord fixtures
+  # config.fixture_path = "#{::Rails.root}/spec/fixtures"
+
+  # If you're not using ActiveRecord, or you'd prefer not to run each of your
+  # examples within a transaction, remove the following line or assign false
+  # instead of true.
+  # config.use_transactional_fixtures = true
+
+  # RSpec Rails can automatically mix in different behaviours to your tests
+  # based on their file location, for example enabling you to call `get` and
+  # `post` in specs under `spec/controllers`.
+  #
+  # You can disable this behaviour by removing the line below, and instead
+  # explicitly tag your specs with their type, e.g.:
+  #
+  #     RSpec.describe UsersController, :type => :controller do
+  #       # ...
+  #     end
+  #
+  # The different available types are documented in the features, such as in
+  # https://relishapp.com/rspec/rspec-rails/docs
+  config.infer_spec_type_from_file_location!
+
+  # Filter lines from Rails gems in backtraces.
+  config.filter_rails_from_backtrace!
+  # arbitrary gems may also be filtered via:
+  # config.filter_gems_from_backtrace("gem name")
+end

data/spec/spec_helper.rb

@@ -0,0 +1,93 @@
+# frozen_string_literal: true
+
+# Hack to remove VERSION (which is loaded/required via Gemfile -> mogl.gemspec) before simplecov
+# Without this, simplecov reports the VERSION is not covered by specs.
+::Omniauth::Rails.send(:remove_const, "VERSION")
+$LOADED_FEATURES.delete_if { |s| s.include?("omniauth/rails/version") }
+
+require "simplecov"
+require "byebug"
+require "awesome_print" # Useful for debugging
+require "dotenv"
+Dotenv.load
+
+RSpec.configure do |config|
+  # rspec-expectations config goes here. You can use an alternate
+  # assertion/expectation library such as wrong or the stdlib/minitest
+  # assertions if you prefer.
+  config.expect_with :rspec do |expectations|
+    # This option will default to `true` in RSpec 4. It makes the `description`
+    # and `failure_message` of custom matchers include text for helper methods
+    # defined using `chain`, e.g.:
+    #     be_bigger_than(2).and_smaller_than(4).description
+    #     # => "be bigger than 2 and smaller than 4"
+    # ...rather than:
+    #     # => "be bigger than 2"
+    expectations.include_chain_clauses_in_custom_matcher_descriptions = true
+  end
+
+  # rspec-mocks config goes here. You can use an alternate test double
+  # library (such as bogus or mocha) by changing the `mock_with` option here.
+  config.mock_with :rspec do |mocks|
+    # Prevents you from mocking or stubbing a method that does not exist on
+    # a real object. This is generally recommended, and will default to
+    # `true` in RSpec 4.
+    mocks.verify_partial_doubles = true
+  end
+
+  # This option will default to `:apply_to_host_groups` in RSpec 4 (and will
+  # have no way to turn it off -- the option exists only for backwards
+  # compatibility in RSpec 3). It causes shared context metadata to be
+  # inherited by the metadata hash of host groups and examples, rather than
+  # triggering implicit auto-inclusion in groups with matching metadata.
+  config.shared_context_metadata_behavior = :apply_to_host_groups
+
+  # The settings below are suggested to provide a good initial experience
+  # with RSpec, but feel free to customize to your heart's content.
+
+  # This allows you to limit a spec run to individual examples or groups
+  # you care about by tagging them with `:focus` metadata. When nothing
+  # is tagged with `:focus`, all examples get run. RSpec also provides
+  # aliases for `it`, `describe`, and `context` that include `:focus`
+  # metadata: `fit`, `fdescribe` and `fcontext`, respectively.
+  config.filter_run_when_matching :focus
+
+  # Allows RSpec to persist some state between runs in order to support
+  # the `--only-failures` and `--next-failure` CLI options. We recommend
+  # you configure your source control system to ignore this file.
+  config.example_status_persistence_file_path = "spec/examples.txt"
+
+  # Limits the available syntax to the non-monkey patched syntax that is
+  # recommended. For more details, see:
+  #   - http://rspec.info/blog/2012/06/rspecs-new-expectation-syntax/
+  #   - http://www.teaisaweso.me/blog/2013/05/27/rspecs-new-message-expectation-syntax/
+  #   - http://rspec.info/blog/2014/05/notable-changes-in-rspec-3/#zero-monkey-patching-mode
+  config.disable_monkey_patching!
+
+  # Many RSpec users commonly either run the entire suite or an individual
+  # file, and it's useful to allow more verbose output when running an
+  # individual spec file.
+  if config.files_to_run.one?
+    # Use the documentation formatter for detailed output,
+    # unless a formatter has already been configured
+    # (e.g. via a command-line flag).
+    config.default_formatter = "doc"
+  end
+
+  # Print the 10 slowest examples and example groups at the
+  # end of the spec run, to help surface which specs are running
+  # particularly slow.
+  # config.profile_examples = 10
+
+  # Run specs in random order to surface order dependencies. If you find an
+  # order dependency and want to debug it, you can fix the order by providing
+  # the seed, which is printed after each run.
+  #     --seed 1234
+  config.order = :random
+
+  # Seed global randomization in this process using the `--seed` CLI option.
+  # Setting this allows you to use `--seed` to deterministically reproduce
+  # test failures related to randomization by passing the same `--seed` value
+  # as the one that triggered the failure.
+  Kernel.srand config.seed
+end

data/spec/test_app/Rakefile

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+# Add your own tasks in files placed in lib/tasks ending in .rake,
+# for example lib/tasks/capistrano.rake, and they will automatically be available to Rake.
+
+require_relative "config/application"
+
+Rails.application.load_tasks
+
+task("spec").clear
+RSpec::Core::RakeTask.new do |t|
+  t.verbose = false
+end

data/spec/test_app/app/assets/config/manifest.js

@@ -0,0 +1,4 @@
+
+//= link_tree ../images
+//= link_directory ../stylesheets .css
+//= link omniauth_rails_manifest.js

data/spec/test_app/app/assets/javascripts/application.js

@@ -0,0 +1,13 @@
+// This is a manifest file that'll be compiled into application.js, which will include all the files
+// listed below.
+//
+// Any JavaScript/Coffee file within this directory, lib/assets/javascripts, vendor/assets/javascripts,
+// or any plugin's vendor/assets/javascripts directory can be referenced here using a relative path.
+//
+// It's not advisable to add code directly here, but if you do, it'll appear at the bottom of the
+// compiled file. JavaScript code in this file should be added after the last require_* statement.
+//
+// Read Sprockets README (https://github.com/rails/sprockets#sprockets-directives) for details
+// about supported directives.
+//
+//= require_tree .

data/spec/test_app/app/assets/stylesheets/application.css

@@ -0,0 +1,15 @@
+/*
+ * This is a manifest file that'll be compiled into application.css, which will include all the files
+ * listed below.
+ *
+ * Any CSS and SCSS file within this directory, lib/assets/stylesheets, vendor/assets/stylesheets,
+ * or any plugin's vendor/assets/stylesheets directory can be referenced here using a relative path.
+ *
+ * You're free to add application-wide styles to this file and they'll appear at the bottom of the
+ * compiled file so the styles you add here take precedence over styles defined in any other CSS/SCSS
+ * files in this directory. Styles in this file should be added after the last require_* statement.
+ * It is generally better to create a new file per style scope.
+ *
+ *= require_tree .
+ *= require_self
+ */

data/spec/test_app/app/controllers/application_controller.rb

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+class ApplicationController < ActionController::Base
+  protect_from_forgery with: :exception
+end

data/spec/test_app/app/controllers/private_controller.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+class PrivateController < ApplicationController
+  include Omniauth::Rails::RequireAuthorization
+  require_authorization domains: %w(bar.com)
+
+  def show
+  end
+end

data/spec/test_app/app/controllers/public_controller.rb

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+class PublicController < ApplicationController
+  def show
+  end
+end

data/spec/test_app/app/helpers/application_helper.rb

@@ -0,0 +1,3 @@
+# frozen_string_literal: true
+module ApplicationHelper
+end

data/spec/test_app/app/mailers/application_mailer.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+class ApplicationMailer < ActionMailer::Base
+  default from: "from@example.com"
+  layout "mailer"
+end

data/spec/test_app/app/models/application_record.rb

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+class ApplicationRecord < ActiveRecord::Base
+  self.abstract_class = true
+end

data/spec/test_app/app/views/layouts/application.html.erb

@@ -0,0 +1,24 @@
+<!DOCTYPE html>
+<html>
+  <head>
+    <title>TestApp</title>
+    <%= stylesheet_link_tag "omniauth/rails/application.css", media: "all" %>
+    <%= csrf_meta_tags %>
+  </head>
+
+  <body>
+    Navigation:
+    <ul>
+      <li><%= link_to "Public page", public_path %></li>
+      <li><%= link_to "Private page", private_path %></li>
+    </ul>
+
+    <% if authenticated? %>
+        Logged in as <%= authenticated_email %>
+        |
+        <%= button_to "Logout", omniauth_rails.sign_out_url, method: :delete %>
+    <% end %>
+
+    <%= yield %>
+  </body>
+</html>

data/spec/test_app/app/views/private/show.html.erb

@@ -0,0 +1 @@
+<h1>This is a private page</h1>

data/spec/test_app/app/views/public/show.html.erb

@@ -0,0 +1 @@
+<h1>This is a public page</h1>

data/spec/test_app/bin/bundle

@@ -0,0 +1,4 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+ENV["BUNDLE_GEMFILE"] ||= File.expand_path("../../Gemfile", __FILE__)
+load Gem.bin_path("bundler", "bundle")

data/spec/test_app/bin/rails

@@ -0,0 +1,5 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+APP_PATH = File.expand_path("../config/application", __dir__)
+require_relative "../config/boot"
+require "rails/commands"

data/spec/test_app/bin/rake

@@ -0,0 +1,5 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+require_relative "../config/boot"
+require "rake"
+Rake.application.run

data/spec/test_app/bin/setup

@@ -0,0 +1,35 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+require "pathname"
+require "fileutils"
+include FileUtils
+
+# path to your application root.
+APP_ROOT = Pathname.new File.expand_path("../../", __FILE__)
+
+def system!(*args)
+  system(*args) || abort("\n== Command #{args} failed ==")
+end
+
+chdir APP_ROOT do
+  # This script is a starting point to setup your application.
+  # Add necessary setup steps to this file.
+
+  puts "== Installing dependencies =="
+  system! "gem install bundler --conservative"
+  system("bundle check") || system!("bundle install")
+
+  # puts "\n== Copying sample files =="
+  # unless File.exist?('config/database.yml')
+  #   cp 'config/database.yml.sample', 'config/database.yml'
+  # end
+
+  puts "\n== Preparing database =="
+  system! "bin/rails db:setup"
+
+  puts "\n== Removing old logs and tempfiles =="
+  system! "bin/rails log:clear tmp:clear"
+
+  puts "\n== Restarting application server =="
+  system! "bin/rails restart"
+end

data/spec/test_app/bin/update

@@ -0,0 +1,30 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+require "pathname"
+require "fileutils"
+include FileUtils
+
+# path to your application root.
+APP_ROOT = Pathname.new File.expand_path("../../", __FILE__)
+
+def system!(*args)
+  system(*args) || abort("\n== Command #{args} failed ==")
+end
+
+chdir APP_ROOT do
+  # This script is a way to update your development environment automatically.
+  # Add necessary update steps to this file.
+
+  puts "== Installing dependencies =="
+  system! "gem install bundler --conservative"
+  system("bundle check") || system!("bundle install")
+
+  puts "\n== Updating database =="
+  system! "bin/rails db:migrate"
+
+  puts "\n== Removing old logs and tempfiles =="
+  system! "bin/rails log:clear tmp:clear"
+
+  puts "\n== Restarting application server =="
+  system! "bin/rails restart"
+end

data/spec/test_app/config/application.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+require_relative "boot"
+
+# Pick the frameworks you want:
+# require "active_record/railtie"
+require "action_controller/railtie"
+require "action_view/railtie"
+# require "action_mailer/railtie"
+# require "active_job/railtie"
+# require "action_cable/engine"
+# require "rails/test_unit/railtie"
+require "sprockets/railtie"
+
+Bundler.require(*Rails.groups)
+require "omniauth/rails"
+
+module TestApp
+  class Application < Rails::Application
+    # Settings in config/environments/* take precedence over those specified here.
+    # Application configuration should go into files in config/initializers
+    # -- all .rb files in that directory are automatically loaded.
+  end
+end

data/spec/test_app/config/boot.rb

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+# Set up gems listed in the Gemfile.
+ENV["BUNDLE_GEMFILE"] ||= File.expand_path("../../../Gemfile", __dir__)
+
+require "bundler/setup" if File.exist?(ENV["BUNDLE_GEMFILE"])
+$LOAD_PATH.unshift File.expand_path("../../../lib", __dir__)

data/spec/test_app/config/environment.rb

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+# Load the Rails application.
+require_relative "application"
+
+# Initialize the Rails application.
+Rails.application.initialize!

data/spec/test_app/config/environments/development.rb

@@ -0,0 +1,55 @@
+# frozen_string_literal: true
+Rails.application.configure do
+  # Settings specified here will take precedence over those in config/application.rb.
+
+  # In the development environment your application's code is reloaded on
+  # every request. This slows down response time but is perfect for development
+  # since you don't have to restart the web server when you make code changes.
+  config.cache_classes = false
+
+  # Do not eager load code on boot.
+  config.eager_load = false
+
+  # Show full error reports.
+  config.consider_all_requests_local = true
+
+  # Enable/disable caching. By default caching is disabled.
+  if Rails.root.join("tmp/caching-dev.txt").exist?
+    config.action_controller.perform_caching = true
+
+    config.cache_store = :memory_store
+    config.public_file_server.headers = {
+      "Cache-Control" => "public, max-age=172800",
+    }
+  else
+    config.action_controller.perform_caching = false
+
+    config.cache_store = :null_store
+  end
+
+  # Don't care if the mailer can't send.
+  # config.action_mailer.raise_delivery_errors = false
+
+  # config.action_mailer.perform_caching = false
+
+  # Print deprecation notices to the Rails logger.
+  config.active_support.deprecation = :log
+
+  # Raise an error on page load if there are pending migrations.
+  # config.active_record.migration_error = :page_load
+
+  # Debug mode disables concatenation and preprocessing of assets.
+  # This option may cause significant delays in view rendering with a large
+  # number of complex assets.
+  # config.assets.debug = true
+
+  # Suppress logger output for asset requests.
+  # config.assets.quiet = true
+
+  # Raises error for missing translations
+  # config.action_view.raise_on_missing_translations = true
+
+  # Use an evented file watcher to asynchronously detect changes in source code,
+  # routes, locales, etc. This feature depends on the listen gem.
+  # config.file_watcher = ActiveSupport::EventedFileUpdateChecker
+end