me_exceptional 0.0.1

data/.gitignore

@@ -0,0 +1,3 @@
+pkg/*
+*.gem
+.bundle

data/Gemfile

@@ -0,0 +1,4 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in me_exceptional.gemspec
+gemspec

data/README.rdoc

@@ -0,0 +1,37 @@
+
+
+= MeExceptional 
+
+The Gem notifies you of application exceptions by email and adds some
+useful information about the request and the client issuing the request. 
+It is heavily inspired by the exceptional gem and takes some of it design
+for the HTML email.
+
+
+== Installation
+
+Install the gem in your Rails 3 App as usual:
+
+    gem install me_exceptional
+
+Add installation run the generator 
+
+    rails generate me_exceptional:install
+
+The generator will create an initializer which you MUST take a look at
+and configure.
+
+
+Support for Rails 2.x is not provided so far.
+
+
+== Getting Started
+
+So far there's nothing much more to it. In your production environment you
+will get emails for controller exceptions.
+
+=== Configuring views
+
+Coming Soon. 
+
+

data/Rakefile

@@ -0,0 +1,2 @@
+require 'bundler'
+Bundler::GemHelper.install_tasks

data/app/mailers/me_exceptional/mailer.rb

@@ -0,0 +1,24 @@
+class MeExceptional::Mailer < ::ActionMailer::Base 
+
+  def exceptional(message, params)
+    @message, @params = message, params
+    @hostname = get_hostname(params[:client_ip])
+    @loc = geocode_ip(params[:client_ip])
+    mail(:from => MeExceptional.mailer_from, :to => MeExceptional.mailer_to, :subject => message)
+  end
+
+  private
+
+  def get_hostname(ip)
+    Socket.do_not_reverse_lookup = false
+    Socket.getaddrinfo(ip, nil)[0][2]
+  end 
+
+  def geocode_ip(ip)
+    GeoKit::Geocoders::MultiGeocoder.geocode(ip)
+  end
+
+
+end
+
+

data/app/views/me_exceptional/mailer/exceptional.html.erb

@@ -0,0 +1,53 @@
+
+<p style="font-size:12px"><b>Message</b></p>
+<p style="font-size:11px;font-family:Monaco,'Andale Mono',Consolas,'Courier New',monospace">
+<%= @message %>
+</p>
+
+<p style="font-size:12px"><b>Time</b></p>
+<p style="font-size:11px;font-family:Monaco,'Andale Mono',Consolas,'Courier New',monospace">
+<%= @params[:timestamp] %>
+</p>
+
+<p style="font-size:12px"><b>URL</b></p>
+<p style="font-size:11px;font-family:Monaco,'Andale Mono',Consolas,'Courier New',monospace">
+<%= @params[:method] %> <%= @params[:url] %>
+</p>
+
+<p style="font-size:12px"><b>Params</b></p>
+<p style="font-size:11px;font-family:Monaco,'Andale Mono',Consolas,'Courier New',monospace">
+<%= @params[:params] %>
+</p>
+
+<p style="font-size:12px"><b>User Agent</b></p>
+<p style="font-size:11px;font-family:Monaco,'Andale Mono',Consolas,'Courier New',monospace">
+<%= @params[:user_agent] %>
+</p>
+
+<p style="font-size:12px"><b>Client IP</b></p>
+<p style="font-size:11px;font-family:Monaco,'Andale Mono',Consolas,'Courier New',monospace">
+<%= @params[:client_ip] %> (<%= @hostname %>)
+</p>
+
+<p style="font-size:12px"><b>Address</b></p>
+<p style="font-size:11px;font-family:Monaco,'Andale Mono',Consolas,'Courier New',monospace">
+<%= @loc.full_address %>
+</p>
+
+<p style="font-size:12px"><b>Location</b></p>
+<p style="font-size:11px;font-family:Monaco,'Andale Mono',Consolas,'Courier New',monospace">
+<%- query = CGI::escape([@loc.lat, @loc.lng].join(','))%>
+http://maps.google.com/maps?q=<%= query %>
+</p>
+
+<p style="font-size:12px"><b>Complete Backtrace</b></p>
+<p style="font-size:11px;font-family:Monaco,'Andale Mono',Consolas,'Courier New',monospace">
+<%= @params[:backtrace] %>
+</p>
+
+<p style="font-size:12px"><b>Complete Request Object</b></p>
+<p style="font-size:11px;font-family:Monaco,'Andale Mono',Consolas,'Courier New',monospace">
+<%= @params[:request_env] %> 
+</p>
+
+

data/lib/generators/me_exceptional/install_generator.rb

@@ -0,0 +1,20 @@
+module MeExceptional
+  module Generators
+
+    class InstallGenerator < Rails::Generators::Base
+      source_root File.expand_path("../../templates", __FILE__)
+
+      desc "Creates a MeExceptional initializer."
+
+      def copy_initializer_file
+        copy_file "me_exceptional.rb", "config/initializers/me_exceptional.rb"
+      end
+
+      def show_readme
+        readme "README" if behavior == :invoke
+      end
+
+    end
+
+  end
+end

data/lib/generators/templates/README

@@ -0,0 +1,4 @@
+
+= README for MeExceptional
+
+

data/lib/generators/templates/me_exceptional.rb

@@ -0,0 +1,14 @@
+
+
+MeExceptional.setup do|config|
+
+  # Configure the e-mail address from which exceptions are to be sent
+  config.mailer_from = "please-change-me@example.com"
+    
+  # Configure the e-mail address which will receive the exception mails
+  config.mailer_to = "please-change-me@example.com"
+
+end
+
+
+

data/lib/me_exceptional/action_controller_extension.rb

@@ -0,0 +1,31 @@
+require 'action_controller'
+require 'action_dispatch'
+
+module ActionController
+  class Base
+
+    rescue_from Exception, :with => :exception_catcher
+
+    def exception_catcher(e)
+       if Rails.env == 'production' 
+        # blocking to be sure this gets send!
+        Emailer.exceptional(e.message,
+                            :backtrace => e.backtrace.join("\n"),
+                            :timestamp => Time.zone.now,
+                            :method => request.method,
+                            :url => request.url,
+                            :params => params.inspect.to_s,
+                            :user_agent => request.user_agent,
+                            :client_ip => request.remote_ip,
+                            :request_env => request.env.inspect.to_s).deliver
+
+      end
+      raise e
+    end
+
+  end
+
+end
+
+
+

data/lib/me_exceptional/engine.rb

@@ -0,0 +1,11 @@
+require 'me_exceptional'
+require 'rails'
+require 'action_controller'
+
+module MeExceptional
+  class Engine < ::Rails::Engine
+    engine_name :me_exceptional
+  end
+end
+
+

data/lib/me_exceptional/version.rb

@@ -0,0 +1,3 @@
+module MeExceptional
+  VERSION = "0.0.1"
+end

data/lib/me_exceptional.rb

@@ -0,0 +1,23 @@
+require 'rails'
+
+module MeExceptional
+
+  mattr_accessor :mailer_from
+  @@mailer_from = nil
+
+  mattr_accessor :mailer_to
+  @@mailer_to = nil
+
+
+  def self.setup
+    yield self
+  end
+
+end
+
+require 'me_exceptional/action_controller_extension'
+require 'me_exceptional/engine'
+
+
+
+

data/me_exceptional.gemspec

@@ -0,0 +1,27 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "me_exceptional/version"
+
+Gem::Specification.new do |s|
+  s.name        = "me_exceptional"
+  s.version     = MeExceptional::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ["Kai Rubarth"]
+  s.email       = ["kai@doxter.de"]
+  s.homepage    = ""
+  s.summary     = %q{notifies you of exceptions by email}
+  s.description = %q{The gem catches exceptions and creates and sends emails with backtrace and other informations.}
+
+  s.rubyforge_project = "me_exceptional"
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+
+  s.add_dependency('rails')
+  s.add_dependency('geokit')
+
+end
+
+

metadata

@@ -0,0 +1,108 @@
+--- !ruby/object:Gem::Specification 
+name: me_exceptional
+version: !ruby/object:Gem::Version 
+  hash: 29
+  prerelease: false
+  segments: 
+  - 0
+  - 0
+  - 1
+  version: 0.0.1
+platform: ruby
+authors: 
+- Kai Rubarth
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-06-16 00:00:00 +02:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rails
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: geokit
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  version_requirements: *id002
+description: The gem catches exceptions and creates and sends emails with backtrace and other informations.
+email: 
+- kai@doxter.de
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- Gemfile
+- README.rdoc
+- Rakefile
+- app/mailers/me_exceptional/mailer.rb
+- app/views/me_exceptional/mailer/exceptional.html.erb
+- lib/generators/me_exceptional/install_generator.rb
+- lib/generators/templates/README
+- lib/generators/templates/me_exceptional.rb
+- lib/me_exceptional.rb
+- lib/me_exceptional/action_controller_extension.rb
+- lib/me_exceptional/engine.rb
+- lib/me_exceptional/version.rb
+- me_exceptional.gemspec
+has_rdoc: true
+homepage: ""
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: me_exceptional
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: notifies you of exceptions by email
+test_files: []
+