union_station_hooks_rails 1.0.0

checksums.yaml

@@ -0,0 +1,15 @@
+---
+!binary "U0hBMQ==":
+  metadata.gz: !binary |-
+    ZDBmNjQ1YWNkZDdjZjAwOTMzZWQ1NjEyZDBiOGZjYWJhMWYzMmM5Zg==
+  data.tar.gz: !binary |-
+    NDEyNzgzMWJjMjdiMWFhNTkyMjUyZWQxNWY1Mzg4NGYwZDgzODE4OA==
+SHA512:
+  metadata.gz: !binary |-
+    NDYzNzBiZjk4MmZhY2JhYmJkNGJjM2JiNWZjNWU5NTRkYjRiNmE5ZGY2ZmQw
+    YmI3YzRhM2YxNzBjZWYzNWVhZmUwNjYzNDUxMTUzOGQ1MTQwMTY0OTI1ZjVj
+    YTVkMWM4N2IzMTdlOGMzN2UzNjI1NmRjOTBiYzZlZGM1NDlhNmY=
+  data.tar.gz: !binary |-
+    MWQ2YzQ2ZWJkNWRiNTRmZDQ1NzE5NjFhZDk5YzRjNTZhMzNkODMwZGM3MzZl
+    NDA0M2NiYzUyOGU2M2QxNGNkZGFhYmNkYzdmOTExNDY2MTBiZTJiMjFmNzgz
+    MjI3MTM3OTA4MjlkMzFlOGUzODExMGQ0MGQ4ZTMyYjNjMjYxMGE=

data/LICENSE.md

@@ -0,0 +1,19 @@
+Copyright (c) 2010-2015 Phusion Holding B.V.
+
+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

@@ -0,0 +1,104 @@
+# Union Station Ruby hooks core
+
+[![Build Status](https://travis-ci.org/phusion/union_station_hooks_rails.svg?branch=master)](https://travis-ci.org/phusion/union_station_hooks_rails)
+
+[Union Station](https://www.unionstationapp.com) is a web application monitoring and performance analytics platform for Ruby. In order for Union Station to analyze your application, your application must send data to Union Station. This gem allows you to do that.
+
+`union_station_hooks_rails` is a gem that automatically hooks into various parts of Rails, so that the right information is sent to Union Station. Under the hood, it makes use of the APIs provided by [union_station_hooks_core](https://github.com/phusion/union_station_hooks_core).
+
+**Resources:** [About Union Station](https://www.unionstationapp.com) | [Github](https://github.com/phusion/union_station_hooks_rails)
+
+**Table of contents**
+
+ * [Installation](#installation)
+   - [Using with Passenger](#using-with-passenger)
+   - [Overriding Passenger's version](#overriding-passengers-version)
+   - [Using without Passenger](#using-without-passenger)
+ * [Legacy code](#legacy-code)
+ * [Contributing](contributing)
+
+---
+
+## Installation
+
+### Using with Passenger
+
+**Note: This documentation section only applies to Passenger X.X.X or later!**
+
+If you use [Passenger](https://www.phusionpassenger.com/), then you do not need to install the `union_station_hooks_rails` gem. `union_station_hooks_rails` is bundled with Passenger.
+
+The only thing you need to do is to create a file `config/initializers/union_station.rb` in which you call this code:
+
+    if defined?(UnionStationHooks)
+      UnionStationHooks.initialize!
+    end
+
+(Are you already calling `PhusionPassenger.install_framework_extensions!` from somewhere in your codebase? Please read [Legacy code](#legacy-code) for important information.)
+
+When you have this call in place, enable Union Station support in Passenger. Here are some examples:
+
+ * _Passenger with Nginx integration mode_<br>
+
+   Insert the following config in your virtual host configuration, then restart Nginx:
+
+        union_station_support on;
+        union_station_key <YOUR KEY HERE>;
+
+ * _Passenger with Apache integration mode_<br>
+
+   Insert the following config in your virtual host configuration, then restart Apache:
+
+        UnionStationSupport on
+        UnionStationKey <YOUR KEY HERE>
+
+ * _Passenger Standalone_<br>
+
+   Start Passenger with the `--union-station-key` parameter:
+
+        $ passenger start --union-station-key <YOUR KEY HERE>
+
+   Or set the `union_station_key` configuration option in Passengerfile.json:
+
+        {
+            "union_station_key": "<YOUR KEY HERE>"
+        }
+
+### Overriding Passenger's version
+
+Each version of Passenger bundles its own version of the `union_station_hooks_rails` gem (and the `union_station_hooks_core` gem, which is a dependency). The Passenger maintainers regularly update their bundled versions with the latest version. Sometimes, you may wish to use a specific version of `union_station_hooks_rails` and `union_station_hooks_core`, overriding the versions that came bundled with Passenger. For example, we have may published a new version of `union_station_hooks_rails` with some bug fixes, even though Passenger hasn't been updated yet.
+
+You can override Passenger's bundled versions as follows.
+
+ 1. Add the gems you want to override to your Gemfile, like this:
+
+        # Uncomment the following line if you want to override Passenger's
+        # bundled version
+        #gem 'union_station_hooks_core'
+
+        gem 'union_station_hooks_rails'
+
+ 2. Install your gem bundle:
+
+        bundle install
+
+### Using without Passenger
+
+It is currently not possible to use Union Station without Passenger. If you would like to have this feature, please let us know.
+
+## Legacy code
+
+Before Passenger X.X.X, the Union Station setup instructions used to tell you to create a `config/initializers/passenger.rb` in which you call the following code:
+
+    PhusionPassenger.install_framework_extensions! if defined?(PhusionPassenger)
+
+Since Passenger X.X.X, `PhusionPassenger.install_framework_extensions!` has become an alias for `UnionStationHooks.initialize!`, but the former is considered deprecated. Please replace the above code with:
+
+    if defined?(UnionStationHooks)
+      UnionStationHooks.initialize!
+    end
+
+And please also rename `config/initializers/passenger.rb` to `config/initializers/union_station.rb`.
+
+## Contributing
+
+Looking to contribute to this gem? Please read the documentation in the [hacking/](https://github.com/phusion/union_station_hooks_rails/blob/master/hacking) directory.

data/lib/union_station_hooks_rails/action_controller_extension.rb

@@ -0,0 +1,54 @@
+#  Union Station - https://www.unionstationapp.com/
+#  Copyright (c) 2010-2015 Phusion Holding B.V.
+#
+#  "Union Station" and "Passenger" are trademarks of Phusion Holding B.V.
+#
+#  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.
+
+
+module UnionStationHooksRails
+  module ActionControllerExtension
+    def process_action(action, *args)
+      reporter = request.env['union_station_hooks']
+      return super if !reporter
+
+      options = {
+        :controller_name => self.class.name,
+        :action_name => action_name,
+        :method => request.request_method
+      }
+      reporter.log_controller_action_block(options) do
+        super
+      end
+    end
+
+    def render(*args)
+      reporter = request.env['union_station_hooks']
+      return super if !reporter
+
+      reporter.log_view_rendering_block do
+        super
+      end
+    end
+  end
+end
+
+ActionController::Base.class_eval do
+  include UnionStationHooksRails::ActionControllerExtension
+end

data/lib/union_station_hooks_rails/active_record_subscriber.rb

@@ -0,0 +1,41 @@
+#  Union Station - https://www.unionstationapp.com/
+#  Copyright (c) 2010-2015 Phusion Holding B.V.
+#
+#  "Union Station" and "Passenger" are trademarks of Phusion Holding B.V.
+#
+#  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.
+
+
+module UnionStationHooksRails
+  class ActiveRecordSubscriber < ActiveSupport::LogSubscriber
+    def sql(event)
+      reporter = Thread.current[:union_station_hooks]
+      return if !reporter
+
+      UnionStationHooks.call_event_pre_hook(event)
+      reporter.log_database_query(
+        :begin_time => event.time,
+        :end_time => event.time,
+        :query => event.payload[:sql]
+      )
+    end
+  end
+end
+
+UnionStationHooksRails::ActiveRecordSubscriber.attach_to(:active_record)

data/lib/union_station_hooks_rails/active_support_benchmarkable_extension.rb

@@ -0,0 +1,47 @@
+#  Union Station - https://www.unionstationapp.com/
+#  Copyright (c) 2010-2015 Phusion Holding B.V.
+#
+#  "Union Station" and "Passenger" are trademarks of Phusion Holding B.V.
+#
+#  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.
+
+
+module UnionStationHooksRails
+  module ActiveSupportBenchmarkableExtension
+    def benchmark_with_union_station(message = 'Benchmarking', *args)
+      reporter = Thread.current[:union_station_hooks]
+      if reporter
+        reporter.log_benchmark_block(message) do
+          benchmark_without_union_station(message, *args) do
+            yield
+          end
+        end
+      else
+        benchmark_without_union_station(message, *args) do
+          yield
+        end
+      end
+    end
+  end
+end
+
+ActiveSupport::Benchmarkable.class_eval do
+  include UnionStationHooksRails::ActiveSupportBenchmarkableExtension
+  alias_method_chain :benchmark, :union_station
+end

data/lib/union_station_hooks_rails/active_support_cache_subscriber.rb

@@ -0,0 +1,70 @@
+#  Union Station - https://www.unionstationapp.com/
+#  Copyright (c) 2010-2015 Phusion Holding B.V.
+#
+#  "Union Station" and "Passenger" are trademarks of Phusion Holding B.V.
+#
+#  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.
+
+
+module UnionStationHooksRails
+  class ActiveSupportCacheSubscriber < ActiveSupport::LogSubscriber
+    def cache_read(event)
+      reporter = Thread.current[:union_station_hooks]
+      return if !reporter
+
+      UnionStationHooks.call_event_pre_hook(event)
+      if event.payload[:hit]
+        reporter.log_cache_hit(event.payload[:key])
+      else
+        reporter.log_cache_miss(event.payload[:key])
+      end
+    end
+
+    def cache_fetch_hit(event)
+      reporter = Thread.current[:union_station_hooks]
+      return if !reporter
+
+      UnionStationHooks.call_event_pre_hook(event)
+      reporter.log_cache_hit(event.payload[:key])
+    end
+
+    def cache_generate(event)
+      reporter = Thread.current[:union_station_hooks]
+      return if !reporter
+
+      UnionStationHooks.call_event_pre_hook(event)
+      reporter.log_cache_miss(event.payload[:key],
+        (event.duration * 1_000_000).to_i)
+    end
+  end
+end
+
+ActiveSupport::Cache::Store.instrument = true
+
+if defined?(PhusionPassenger)
+  PhusionPassenger.on_event(:starting_request_handler_thread) do
+    if defined?(ActiveSupport::Cache::Store)
+      # This flag is thread-local, so re-initialize it for every
+      # request handler thread.
+      ActiveSupport::Cache::Store.instrument = true
+    end
+  end
+end
+
+UnionStationHooksRails::ActiveSupportCacheSubscriber.attach_to(:active_support)

data/lib/union_station_hooks_rails/exception_logger.rb

@@ -0,0 +1,57 @@
+#  Union Station - https://www.unionstationapp.com/
+#  Copyright (c) 2010-2015 Phusion Holding B.V.
+#
+#  "Union Station" and "Passenger" are trademarks of Phusion Holding B.V.
+#
+#  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.
+
+
+module UnionStationHooksRails
+  class ExceptionLogger
+    def initialize(app)
+      @app = app
+    end
+
+    def call(env)
+      @app.call(env)
+    rescue Exception => e
+      report_exception(env, e)
+      raise e
+    end
+
+  private
+    def report_exception(env, exception)
+      reporter = env['union_station_hooks']
+      if reporter
+        reporter.log_exception(exception)
+      end
+    end
+  end
+end
+
+if defined?(ActionDispatch::DebugExceptions)
+  exceptions_middleware = ActionDispatch::DebugExceptions
+elsif defined?(ActionDispatch::ShowExceptions)
+  exceptions_middleware = ActionDispatch::ShowExceptions
+end
+if exceptions_middleware && defined?(Rails)
+  Rails.application.middleware.insert_after(
+    exceptions_middleware,
+    UnionStationHooksRails::ExceptionLogger)
+end

data/lib/union_station_hooks_rails/initialize.rb

@@ -0,0 +1,30 @@
+#  Union Station - https://www.unionstationapp.com/
+#  Copyright (c) 2010-2015 Phusion Holding B.V.
+#
+#  "Union Station" and "Passenger" are trademarks of Phusion Holding B.V.
+#
+#  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.
+
+# Initialize garbage collector statistics
+if GC.respond_to?(:enable_stats)
+  GC.enable_stats
+end
+if defined?(GC::Profiler) && GC::Profiler.respond_to?(:enable)
+  GC::Profiler.enable
+end

data/lib/union_station_hooks_rails/version.rb

@@ -0,0 +1,32 @@
+#  Union Station - https://www.unionstationapp.com/
+#  Copyright (c) 2010-2015 Phusion Holding B.V.
+#
+#  "Union Station" and "Passenger" are trademarks of Phusion Holding B.V.
+#
+#  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.
+
+
+module UnionStationHooksRails
+  version_file   = File.expand_path('version_data.rb', File.dirname(__FILE__))
+  version_data   = eval(File.read(version_file))
+  MAJOR_VERSION  = version_data[:major]
+  MINOR_VERSION  = version_data[:minor]
+  TINY_VERSION   = version_data[:tiny]
+  VERSION_STRING = version_data[:string]
+end

data/lib/union_station_hooks_rails/version_data.rb

@@ -0,0 +1,44 @@
+#  Union Station - https://www.unionstationapp.com/
+#  Copyright (c) 2010-2015 Phusion Holding B.V.
+#
+#  "Union Station" and "Passenger" are trademarks of Phusion Holding B.V.
+#
+#  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.
+
+# This file contains union_station_hook_rails's version number. It is meant
+# to be read and evaluated by the gemspec. We do not define any functions or
+# modules here because we need to support the following situation:
+#
+# 1. Passenger loads its vendored union_station_hooks_* gems. This defines
+#    various modules.
+# 2. The app specified union_station_hooks_* gems in its Gemfile, which
+#    indicates that it wants to override Passenger's vendored
+#    union_station_hooks_* gems with its own versions. This will cause Bundler
+#    to load union_station_hooks_*.gemspec.
+#
+# To make the gemspecs load properly and without affecting the already-loaded
+# union_station_hooks_* gems code, we must not define any functions or modules
+# here.
+
+{
+  :major  => 1,
+  :minor  => 0,
+  :tiny   => 0,
+  :string => '1.0.0'
+}

data/lib/union_station_hooks_rails.rb

@@ -0,0 +1,170 @@
+#  Union Station - https://www.unionstationapp.com/
+#  Copyright (c) 2010-2015 Phusion Holding B.V.
+#
+#  "Union Station" and "Passenger" are trademarks of Phusion Holding B.V.
+#
+#  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.
+
+# Important notes:
+#
+# - We can't define a Railtie in this gem because union_station_hooks_rails
+#   may be loaded from Passenger, before Rails is loaded.
+# - Make sure that you do not install any actual hooks until `initialize!`
+#   is called. Otherwise, union_station_hooks_core won't be able to properly
+#   upgrade the Union Station hook code vendored in Passenger.
+#   See https://github.com/phusion/union_station_hooks/hacking/Vendoring.md
+#   for more information.
+
+if defined?(UnionStationHooksRails::VERSION_STRING)
+  if UnionStationHooksRails.initialized?
+    raise 'Attempted to load union_station_hooks_core even though an ' \
+      'alternative version was already loaded and initialized'
+  end
+  if UnionStationHooksRails.vendored?
+    # Passenger loaded its vendored Union Station hooks code, but the
+    # application has also included 'union_station_hooks_*' in its Gemfile. We
+    # want the version in the Gemfile to take precedence, so we unload the old
+    # version. At this point, the Union Station hooks aren't installed yet, so
+    # removing the module is enough to unload the old version.
+    #
+    # See also:
+    # https://github.com/phusion/union_station_hooks/blob/master/hacking/Vendoring.md
+    if defined?(UnionStationHooks)
+      UnionStationHooks.initializers.delete(UnionStationHooksRails)
+    end
+    Object.send(:remove_const, :UnionStationHooksRails)
+  end
+end
+
+module UnionStationHooksRails
+  # The path to the `union_station_hooks_rails` Ruby library directory.
+  #
+  # @private
+  LIBROOT = File.expand_path(File.dirname(__FILE__))
+
+  # The path to the `union_station_hooks_rails` gem root directory.
+  #
+  # @private
+  ROOT = File.dirname(LIBROOT)
+
+  class << self
+    # @private
+    @@initialized = false
+    # @private
+    @@vendored = false
+
+    # Initializes `union_station_hooks_rails`. This method is automatically
+    # called by `UnionStationHooks.initialized!` because we registered
+    # ourselves in `UnionStationHooks.initializers`. The application does
+    # not need to call this.
+    #
+    # If this method successfully initializes, then it returns true.
+    #
+    # Calling this method may or may not actually initialize
+    # `union_station_hooks_rails`. If this gem determines that initialization
+    # is not desired, then this method won't do anything and will return
+    # `false`. See {UnionStationHooksRails#should_initialize?}.
+    #
+    # Initializing twice is a no-op. It only causes this method to return true.
+    #
+    # @private
+    # @return [Boolean] Whether initialization was successful.
+    def initialize!
+      return false if !should_initialize?
+      return true if initialized?
+
+      require_lib('initialize')
+      require_lib('active_record_subscriber')
+      require_lib('exception_logger')
+      if defined?(ActiveSupport::Cache::Store)
+        require_lib('active_support_cache_subscriber')
+      end
+      if defined?(ActionController::Base)
+        require_lib('action_controller_extension')
+      end
+      if defined?(ActiveSupport::Benchmarkable)
+        require_lib('active_support_benchmarkable_extension')
+      end
+
+      @@initialized = true
+
+      true
+    end
+
+    # Returns whether the Union Station hooks are initialized.
+    def initialized?
+      @@initialized
+    end
+
+    # Returns whether the Union Station hooks should be initialized. If this
+    # method returns false, then {UnionStationHooksRails.initialize!} doesn't
+    # do anything.
+    #
+    # This method only returns true if ActiveSupport >= 3 is currently loaded.
+    def should_initialize?
+      if defined?(::ActiveSupport) && !defined?(::ActiveSupport::VERSION)
+        require 'active_support/version'
+      end
+      defined?(::ActiveSupport) && ::ActiveSupport::VERSION::MAJOR >= 3
+    end
+
+    # Returns whether this `union_station_hooks_rails` gem is bundled with
+    # Passenger (as opposed to a standalone gem added to the Gemfile).
+    # See the README and the file `hacking/Vendoring.md` in the
+    # `union_station_hooks_core` gem for information about how Passenger
+    # bundles `union_station_hooks_*` gems.
+    #
+    # @private
+    def vendored?
+      @@vendored
+    end
+
+    # @private
+    def vendored=(val)
+      @@vendored = val
+    end
+
+    # @private
+    def require_lib(name)
+      require("#{LIBROOT}/union_station_hooks_rails/#{name}")
+    end
+
+    # @private
+    def require_and_check_union_station_hooks_core
+      if !defined?(UnionStationHooks::VERSION_STRING)
+        require 'union_station_hooks_core'
+      end
+
+      # If you update the dependency version here, also update
+      # the version in the gemspec and in the Gemfile.
+      compatible = UnionStationHooks::MAJOR_VERSION == 1 &&
+        UnionStationHooks::MINOR_VERSION >= 0
+      if !compatible
+        raise "This version of the union_station_hooks_rails gem " \
+          "(#{VERSION_STRING}) is only compatible with the " \
+          "union_station_hooks_core gem 1.x.x. However, you have loaded " \
+          "union_station_hooks_core #{UnionStationHooks::VERSION_STRING}"
+      end
+    end
+  end
+end
+
+UnionStationHooksRails.require_lib('version')
+UnionStationHooksRails.require_and_check_union_station_hooks_core
+UnionStationHooks.initializers << UnionStationHooksRails

data/union_station_hooks_rails.gemspec

@@ -0,0 +1,34 @@
+version_file = File.expand_path('lib/union_station_hooks_rails/version_data.rb', File.dirname(__FILE__))
+version_data = eval(File.read(version_file))
+
+Gem::Specification.new do |s|
+  s.name = "union_station_hooks_rails"
+  s.version = version_data[:string]
+  s.authors = ["Hongli Lai"]
+  s.description = "Union Station Rails hooks."
+  s.summary = "Union Station Rails hooks"
+  s.email = "info@phusion.nl"
+  s.license = "MIT"
+  s.files = Dir[
+    "README.md",
+    "LICENSE.md",
+    "*.gemspec",
+    "lib/**/*"
+  ]
+  s.homepage = "https://github.com/phusion/union_station_hooks_rails"
+  s.require_paths = ["lib"]
+
+  # If you update the dependency version here, also update
+  # the version in Gemfile and union_station_hooks_rails.rb method
+  # `require_and_check_union_station_hooks_core`
+  s.add_dependency("union_station_hooks_core", "~> 1.0")
+
+  s.add_dependency("activesupport", ">= 3.0")
+  s.add_dependency("activemodel", ">= 3.0")
+  s.add_dependency("actionpack", ">= 3.0")
+  s.add_dependency("railties", ">= 3.0")
+
+  # DO NOT ADD ANY FURTHER DEPENDENCIES! See
+  # https://github.com/phusion/union_station_hooks_core/blob/master/hacking/Vendoring.md,
+  # section "No dependencies", for more information.
+end

metadata

@@ -0,0 +1,126 @@
+--- !ruby/object:Gem::Specification
+name: union_station_hooks_rails
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Hongli Lai
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-09-10 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: union_station_hooks_core
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: activemodel
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: actionpack
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: railties
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '3.0'
+description: Union Station Rails hooks.
+email: info@phusion.nl
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE.md
+- README.md
+- lib/union_station_hooks_rails.rb
+- lib/union_station_hooks_rails/action_controller_extension.rb
+- lib/union_station_hooks_rails/active_record_subscriber.rb
+- lib/union_station_hooks_rails/active_support_benchmarkable_extension.rb
+- lib/union_station_hooks_rails/active_support_cache_subscriber.rb
+- lib/union_station_hooks_rails/exception_logger.rb
+- lib/union_station_hooks_rails/initialize.rb
+- lib/union_station_hooks_rails/version.rb
+- lib/union_station_hooks_rails/version_data.rb
+- union_station_hooks_rails.gemspec
+homepage: https://github.com/phusion/union_station_hooks_rails
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.2.2
+signing_key: 
+specification_version: 4
+summary: Union Station Rails hooks
+test_files: []
+has_rdoc: