tuttle 0.0.2 → 0.0.3

data/app/views/tuttle/rails/models.html.erb

@@ -17,7 +17,7 @@ No models were found in this application
     <th>Scale</th>
   </tr>
 <% @models.each do |model| %>
-  <% next if model.abstract_class? %>
+  <% next if model.abstract_class? || ! model.table_exists? %>
 <tr>
   <th colspan="9"><%= model.name %> (<%= model.table_name %>)</th>
 </tr>

data/app/views/tuttle/ruby/miscellaneous.html.erb

@@ -0,0 +1,12 @@
+<h2>Miscellaneous</h2>
+
+<h3>Reslov-Replace</h3>
+<p>
+  By default, Ruby network libraries use the system DNS lookup.
+  But the Ruby standard library also ships with a pure-Ruby implementation that causes the VM to not
+  lock while waiting for DNS lookups to happen. To enable this lookup just add <code>require 'resolv-replace'</code>
+  somewhere in your application, such as in an initializer.
+</p>
+<p>
+Does <code>resolv-replace</code> appear to be patched in? <%= truth_label(IPSocket.method(:getaddress).source_location.present?) %>
+</p>

data/app/views/tuttle/ruby/tuning.html.erb

@@ -0,0 +1,117 @@
+<h2>Ruby Tuning</h2>
+
+<p>
+  Ruby can be tuned for different types of applications through the use of environment variables.
+</p>
+<p>
+  Different versions of Ruby support different variables so it is important to make sure that you are using
+  settings and environment variable names appropriate for your version of Ruby.
+</p>
+
+<h3>Global Method Cache</h3>
+<p>
+  Since Ruby 2.2, the method cache size is configurable using the <code>RUBY_GLOBAL_METHOD_CACHE_SIZE</code> environment variable.
+</p>
+<p>
+  The default value for this setting is 2048 entries which may be low for even a moderate-sized Rails application.
+</p>
+<%- # TODO: warn if value is not a power of 2 %>
+<pre>
+ENV['RUBY_GLOBAL_METHOD_CACHE_SIZE'] = <%= ENV.fetch('RUBY_GLOBAL_METHOD_CACHE_SIZE') { 'not configured'} %>
+</pre>
+<p>
+  For more information and a great story about how <a href="https://github.com/csfrancis">Scott Francis</a>
+  added this variable to Ruby
+  see <a href="http://www.shopify.com/technology/16777156-tuning-rubys-global-method-cache">his writeup</a>
+  on performance tuning the Shopify app.
+</p>
+
+<% if RUBY_VERSION.to_f >= 2.1 %>
+  <h3>Garbage Collection Internals</h3>
+  <p>
+    Some of Ruby's Garbage Collection parameters are determined during by the runtime platform or compile-time configuration.
+    These values can't be changed by environment variables but are helpful for understanding how memory is being allocated and used.
+  </p>
+  <ul>
+    <% GC::INTERNAL_CONSTANTS.each do |key, value| %>
+      <li><%= key %> = <%= value %></li>
+    <% end %>
+  </ul>
+<% end %>
+
+<h3>Garbage Collection</h3>
+<p>
+  Ruby's garbage collection is highly-tunable through environment variables.
+  Determining the right configuration requires understanding how the GC is working
+  and how much memory is being allocated by requests to the application.
+</p>
+<h4>Controls</h4>
+<p>
+  Normally, the Garbage Collector runs as needed to free memory. You can also programmatically control the GC as well to stop it from running or to trigger a GC on demand.</code>
+</p>
+<p>
+  Is GC enabled? <%= truth_label(@gc_enabled) %>
+  <br/>
+  Is GC::Profiler enabled? <%= truth_label(GC::Profiler.enabled?) %>
+</p>
+
+<h4>Garbage Collection Statistics</h4>
+<table class='table table-condensed' style='width:auto;'>
+  <%- gcstat = GC.stat %>
+  <%- [:count, :major_gc_count, :minor_gc_count,
+       :heap_available_slots, :heap_live_slots, :heap_free_slots, :heap_final_slots, :heap_marked_slots, :heap_swept_slots,
+       :heap_sorted_length,
+       :total_allocated_pages, :total_freed_pages, :heap_allocatable_pages, :heap_allocated_pages, :heap_eden_pages, :heap_tomb_pages,
+       :total_allocated_objects, :total_freed_objects,
+       :old_objects, :old_objects_limit,
+       :remembered_wb_unprotected_objects, :remembered_wb_unprotected_objects_limit,
+       :malloc_increase_bytes, :malloc_increase_bytes_limit,
+       :oldmalloc_increase_bytes, :oldmalloc_increase_bytes_limit].each do |key| %>
+    <tr>
+      <th class="text-right"><%= key %></th>
+      <td><%= gcstat[key] %></td>
+    </tr>
+  <%- end %>
+</table>
+
+<% if RUBY_VERSION.to_f >= 2.1 %>
+  <h4>Latest GC info</h4>
+  <%- dgtest = GC.latest_gc_info %>
+  <dl class="dl-horizontal">
+    <%- dgtest.each do |key,val| %>
+      <dt><%= key %></dt>
+      <dd><%= val %></dd>
+    <%- end %>
+  </dl>
+<% end %>
+
+<h4>Configuration settings</h4>
+<p>
+  The following environment variables are available to be configured to tune the Garbage Collector in Ruby 2.2.
+</p>
+<p>
+  Some useful resources for understanding how these variables affect performance can be found here:
+  <ul>
+    <li><a href="https://github.com/tmm1">Aman Gupta's</a> post: <a href="http://tmm1.net/ruby21-rgengc/">Ruby 2.1: RGenGC</a></li>
+    <li><a href="https://github.com/mrnugget">Thorsten Ball's</a> post: <a href="http://thorstenball.com/blog/2014/03/12/watching-understanding-ruby-2.1-garbage-collector/">Watching and Understanding the Ruby 2.1 Garbage Collector at Work</a></li>
+  </ul>
+</p>
+<%
+   #
+   #
+%>
+<table class="table table-condensed">
+  <tr>
+    <th>ENV</th>
+    <th>Value</th>
+    <th>Description</th>
+  </tr>
+  <%- @gc_params.each do |key, desc| %>
+    <tr>
+      <td><%= key %></td>
+      <td style="white-space: nowrap;"><%= ENV.fetch(key.to_s) { 'not configured'} %></td>
+      <td><%= desc %></td>
+    </tr>
+  <%- end %>
+</table>
+

data/config/routes.rb

@@ -7,7 +7,14 @@ Tuttle::Engine.routes.draw do
     get :controllers, :models, :database, :helpers, :assets, :routes, :instrumentation, :inflectors, :cache
   end
 
-  get '/ruby' => 'ruby#index'
+  namespace :ruby do
+    get '', :action => :index
+    get :tuning, :miscellaneous
+  end
+
+  namespace :gems do
+    get :http_clients, :json, :other
+  end
 
   if defined?(Devise)
     get '/devise' => 'devise#index'

data/lib/tuttle.rb

@@ -3,7 +3,7 @@ require 'tuttle/engine'
 module Tuttle
 
   mattr_accessor :automount_engine
-  @@automount_engine = true
+  mattr_accessor :enabled
 
   def self.setup
     yield self

data/lib/tuttle/engine.rb

@@ -1,28 +1,50 @@
 module Tuttle
   class Engine < ::Rails::Engine
     isolate_namespace Tuttle
+    engine_name :tuttle
+
+    config.tuttle = ActiveSupport::OrderedOptions.new
 
     attr_accessor :reload_needed
-    attr_accessor :events, :event_counts
+    attr_accessor :events, :event_counts, :cache_events
     attr_accessor :session_start, :session_id
 
+    attr_reader :logger
+
+    initializer :tuttle_assets_precompile do |app|
+      app.config.assets.precompile += %w(tuttle/application.css tuttle/application.js tuttle/favicon.ico)
+    end
+
+    initializer :tuttle_set_configuration do |app|
+      app.config.tuttle.each do |k,v|
+        Tuttle.send("#{k}=", v)
+      end
+      # Tuttle will be automatically enabled in development if not configured explicitly
+      Tuttle.enabled= Rails.env.development? if Tuttle.enabled==nil
+      Tuttle.automount_engine= true if Tuttle.automount_engine==nil
+    end
+
     initializer :tuttle_startup do
+      next unless Tuttle.enabled
+
       Tuttle::Engine.session_start = Time.now
       Tuttle::Engine.session_id = SecureRandom.uuid
-    end
-
-    initializer :tuttle_assets_precompile do |app|
-      app.config.assets.precompile += %w(tuttle/application.css tuttle/application.js )
+      @logger = ::Logger.new("#{Rails.root}/log/tuttle.log")
+      @logger.info('Tuttle engine started')
     end
 
     initializer :tuttle_track_reloads, group: :all do
+      next unless Tuttle.enabled
+
       ActionDispatch::Reloader.to_prepare do
-        Rails.logger.warn('Tuttle: ActionDispatch::Reloader called to_prepare')
+        Tuttle::Engine.logger.warn('ActionDispatch::Reloader called to_prepare') unless Tuttle::Engine.reload_needed.nil?
         Tuttle::Engine.reload_needed = true
       end
     end
 
     initializer :tuttle_global_instrumenter, group: :all do
+      next unless Tuttle.enabled
+
       Tuttle::Engine.events = []
       Tuttle::Engine.event_counts = Hash.new(0)
 
@@ -35,11 +57,30 @@ module Tuttle
         end
       end
 
+      Tuttle::Engine.cache_events = []
+      # Note: For Rails < 4.2 instrumentation is not enabled by default. Hitting the cache inspector page will enable it for that session.
+      Tuttle::Engine.logger.info('Initializing cache_read subscriber')
+      ActiveSupport::Notifications.subscribe('cache_read.active_support') do |*args|
+        cache_call_location = caller_locations.detect { |cl| cl.path.start_with?("#{Rails.root}/app".freeze) }
+        event = ActiveSupport::Notifications::Event.new(*args)
+
+        Tuttle::Engine.logger.info("Cache Read called: #{cache_call_location.path} on line #{cache_call_location.lineno} :: #{event.payload.inspect}")
+
+        event.payload.merge!({:call_location_path => cache_call_location.path, :call_location_lineno => cache_call_location.lineno })
+        Tuttle::Engine.cache_events << event
+      end
+      ActiveSupport::Notifications.subscribe('cache_generate.active_support') do |*args|
+        Tuttle::Engine.logger.info('Cache Generate called')
+      end
+
     end
 
     initializer :tuttle_automounter do
+      next unless Tuttle.enabled
+
       if Tuttle.automount_engine
-        Rails.application.routes.append do
+        Rails.application.routes.prepend do
+          Tuttle::Engine.logger.info('Auto-mounting /tuttle routes')
           mount Tuttle::Engine, at: "tuttle"
         end
       end

data/lib/tuttle/version.rb

@@ -1,3 +1,3 @@
 module Tuttle
-  VERSION = '0.0.2'
+  VERSION = '0.0.3'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tuttle
 version: !ruby/object:Gem::Version
-  version: 0.0.2
+  version: 0.0.3
 platform: ruby
 authors:
 - Dave Gynn
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-01-14 00:00:00.000000000 Z
+date: 2015-03-31 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -69,12 +69,13 @@ files:
 - MIT-LICENSE
 - README.md
 - Rakefile
+- app/assets/images/tuttle/favicon.ico
 - app/assets/javascripts/tuttle/application.js
-- app/assets/stylesheets/scaffold.css
 - app/assets/stylesheets/tuttle/application.css
 - app/controllers/tuttle/application_controller.rb
 - app/controllers/tuttle/cancancan_controller.rb
 - app/controllers/tuttle/devise_controller.rb
+- app/controllers/tuttle/gems_controller.rb
 - app/controllers/tuttle/home_controller.rb
 - app/controllers/tuttle/rails_controller.rb
 - app/controllers/tuttle/ruby_controller.rb
@@ -84,6 +85,9 @@ files:
 - app/views/tuttle/cancancan/index.html.erb
 - app/views/tuttle/cancancan/rule_tester.html.erb
 - app/views/tuttle/devise/index.html.erb
+- app/views/tuttle/gems/http_clients.html.erb
+- app/views/tuttle/gems/json.html.erb
+- app/views/tuttle/gems/other.html.erb
 - app/views/tuttle/home/index.html.erb
 - app/views/tuttle/rails/assets.html.erb
 - app/views/tuttle/rails/cache.html.erb
@@ -96,62 +100,13 @@ files:
 - app/views/tuttle/rails/models.html.erb
 - app/views/tuttle/rails/routes.html.erb
 - app/views/tuttle/ruby/index.html.erb
+- app/views/tuttle/ruby/miscellaneous.html.erb
+- app/views/tuttle/ruby/tuning.html.erb
 - config/routes.rb
 - lib/tasks/tuttle_tasks.rake
 - lib/tuttle.rb
 - lib/tuttle/engine.rb
 - lib/tuttle/version.rb
-- test/controllers/tuttle/cancancan_controller_test.rb
-- test/controllers/tuttle/devise_controller_test.rb
-- test/controllers/tuttle/home_controller_test.rb
-- test/controllers/tuttle/rails_controller_test.rb
-- test/controllers/tuttle/ruby_controller_test.rb
-- test/dummy/Gemfile.lock
-- test/dummy/README.rdoc
-- test/dummy/Rakefile
-- test/dummy/app/assets/javascripts/application.js
-- test/dummy/app/assets/stylesheets/application.css
-- test/dummy/app/controllers/application_controller.rb
-- test/dummy/app/helpers/application_helper.rb
-- test/dummy/app/models/ability.rb
-- test/dummy/app/models/user.rb
-- test/dummy/app/views/layouts/application.html.erb
-- test/dummy/config.ru
-- test/dummy/config/application.rb
-- test/dummy/config/boot.rb
-- test/dummy/config/database.yml
-- test/dummy/config/environment.rb
-- test/dummy/config/environments/development.rb
-- test/dummy/config/environments/test.rb
-- test/dummy/config/initializers/backtrace_silencers.rb
-- test/dummy/config/initializers/devise.rb
-- test/dummy/config/initializers/inflections.rb
-- test/dummy/config/initializers/mime_types.rb
-- test/dummy/config/initializers/secret_token.rb
-- test/dummy/config/initializers/session_store.rb
-- test/dummy/config/initializers/tuttle.rb
-- test/dummy/config/initializers/wrap_parameters.rb
-- test/dummy/config/locales/en.yml
-- test/dummy/config/routes.rb
-- test/dummy/db/migrate/20141229204528_devise_create_users.rb
-- test/dummy/db/schema.rb
-- test/dummy/public/404.html
-- test/dummy/public/422.html
-- test/dummy/public/500.html
-- test/dummy/public/favicon.ico
-- test/dummy/script/rails
-- test/dummy/test/fixtures/users.yml
-- test/dummy/test/models/user_test.rb
-- test/dummy/tmp/cache/assets/test/sprockets/00091e0cb6df543a8e704290f4dec8db
-- test/dummy/tmp/cache/assets/test/sprockets/11599cd5b5d6a0a58a5e98c0902e1997
-- test/dummy/tmp/cache/assets/test/sprockets/9b2e26c1e54d4ff5ae04270e8f03907f
-- test/dummy/tmp/cache/assets/test/sprockets/a65793481a75afa9f660d1032ee66ef5
-- test/dummy/tmp/cache/assets/test/sprockets/d9450766086a9f3f994e8c4a2273bfaa
-- test/dummy/tmp/cache/assets/test/sprockets/e117b0425a7b9daef8a213c1a2203f00
-- test/integration/navigation_test.rb
-- test/test_helper.rb
-- test/tuttle_test.rb
-- test/unit/tuttle/note_test.rb
 homepage: https://github.com/dgynn/tuttle
 licenses:
 - MIT
@@ -164,7 +119,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 1.9.3
+      version: 2.0.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
@@ -172,59 +127,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.4.5
+rubygems_version: 2.4.6
 signing_key: 
 specification_version: 4
 summary: Tuttle for Rails
-test_files:
-- test/controllers/tuttle/cancancan_controller_test.rb
-- test/controllers/tuttle/devise_controller_test.rb
-- test/controllers/tuttle/home_controller_test.rb
-- test/controllers/tuttle/rails_controller_test.rb
-- test/controllers/tuttle/ruby_controller_test.rb
-- test/dummy/app/assets/javascripts/application.js
-- test/dummy/app/assets/stylesheets/application.css
-- test/dummy/app/controllers/application_controller.rb
-- test/dummy/app/helpers/application_helper.rb
-- test/dummy/app/models/ability.rb
-- test/dummy/app/models/user.rb
-- test/dummy/app/views/layouts/application.html.erb
-- test/dummy/config/application.rb
-- test/dummy/config/boot.rb
-- test/dummy/config/database.yml
-- test/dummy/config/environment.rb
-- test/dummy/config/environments/development.rb
-- test/dummy/config/environments/test.rb
-- test/dummy/config/initializers/backtrace_silencers.rb
-- test/dummy/config/initializers/devise.rb
-- test/dummy/config/initializers/inflections.rb
-- test/dummy/config/initializers/mime_types.rb
-- test/dummy/config/initializers/secret_token.rb
-- test/dummy/config/initializers/session_store.rb
-- test/dummy/config/initializers/tuttle.rb
-- test/dummy/config/initializers/wrap_parameters.rb
-- test/dummy/config/locales/en.yml
-- test/dummy/config/routes.rb
-- test/dummy/config.ru
-- test/dummy/db/migrate/20141229204528_devise_create_users.rb
-- test/dummy/db/schema.rb
-- test/dummy/Gemfile.lock
-- test/dummy/public/404.html
-- test/dummy/public/422.html
-- test/dummy/public/500.html
-- test/dummy/public/favicon.ico
-- test/dummy/Rakefile
-- test/dummy/README.rdoc
-- test/dummy/script/rails
-- test/dummy/test/fixtures/users.yml
-- test/dummy/test/models/user_test.rb
-- test/dummy/tmp/cache/assets/test/sprockets/00091e0cb6df543a8e704290f4dec8db
-- test/dummy/tmp/cache/assets/test/sprockets/11599cd5b5d6a0a58a5e98c0902e1997
-- test/dummy/tmp/cache/assets/test/sprockets/9b2e26c1e54d4ff5ae04270e8f03907f
-- test/dummy/tmp/cache/assets/test/sprockets/a65793481a75afa9f660d1032ee66ef5
-- test/dummy/tmp/cache/assets/test/sprockets/d9450766086a9f3f994e8c4a2273bfaa
-- test/dummy/tmp/cache/assets/test/sprockets/e117b0425a7b9daef8a213c1a2203f00
-- test/integration/navigation_test.rb
-- test/test_helper.rb
-- test/tuttle_test.rb
-- test/unit/tuttle/note_test.rb
+test_files: []

data/app/assets/stylesheets/scaffold.css

@@ -1,56 +0,0 @@
-body { background-color: #fff; color: #333; }
-
-body, p, ol, ul, td {
-  font-family: verdana, arial, helvetica, sans-serif;
-  font-size:   13px;
-  line-height: 18px;
-}
-
-pre {
-  background-color: #eee;
-  padding: 10px;
-  font-size: 11px;
-}
-
-a { color: #000; }
-a:visited { color: #666; }
-a:hover { color: #fff; background-color:#000; }
-
-div.field, div.actions {
-  margin-bottom: 10px;
-}
-
-#notice {
-  color: green;
-}
-
-.field_with_errors {
-  padding: 2px;
-  background-color: red;
-  display: table;
-}
-
-#error_explanation {
-  width: 450px;
-  border: 2px solid red;
-  padding: 7px;
-  padding-bottom: 0;
-  margin-bottom: 20px;
-  background-color: #f0f0f0;
-}
-
-#error_explanation h2 {
-  text-align: left;
-  font-weight: bold;
-  padding: 5px 5px 5px 15px;
-  font-size: 12px;
-  margin: -7px;
-  margin-bottom: 0px;
-  background-color: #c00;
-  color: #fff;
-}
-
-#error_explanation ul li {
-  font-size: 12px;
-  list-style: square;
-}