mysql_replication_monitor 0.1.5 → 0.1.6

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009 Umamibud, Inc.
+ 
+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 → README.rdoc}

@@ -1,5 +1,5 @@
 mysql_replication_monitor
-========
+---
 
 Utility to check the replication status between MySQL master and slave
 dbs set up to replicate to each other
@@ -9,7 +9,7 @@ config (environment) names (e.g. 'staging_master', 'staging_slave' or
 whatever).
 
 Examples
-=========
+---
  
   # specify both master and slave db configs
   monitor = MysqlReplicationMonitor.new(:master => 'master', :slave => 'slave)

data/lib/mysql_replication_monitor.rb

@@ -7,17 +7,16 @@
 #
 # examples:
 # 
-# # specify both master and slave db configs
-# monitor = MysqlReplicationMonitor.new(:master => 'master', :slave => 'slave)
-# # default slave to the current environment
-# monitor = MysqlReplicationMonitor.new(:master => 'master')
-# # override the default time to cache the statuses (in seconds)
-# monitor = MysqlReplicationMonitor.new(:master => 'master', :slave => 'slave,
-#                                     :refresh_time => 10)
-# # override the default database config file (not recommended)
-# monitor = MysqlReplicationMonitor.new(:master => 'master', :slave => 'slave,
-#                                     :db_config_file => 'foofile.txt')
-#
+#   # specify both master and slave db configs
+#   monitor = MysqlReplicationMonitor.new(:master => 'master', :slave => 'slave)
+#   # default slave to the current environment
+#   monitor = MysqlReplicationMonitor.new(:master => 'master')
+#   # override the default time to cache the statuses (in seconds)
+#   monitor = MysqlReplicationMonitor.new(:master => 'master', :slave => 'slave,
+#                                         :refresh_time => 10)
+#   # override the default database config file (not recommended)
+#   monitor = MysqlReplicationMonitor.new(:master => 'master', :slave => 'slave,
+#                                         :db_config_file => 'foofile.txt')
 #-------------------------------------------------------------------------------
 class MysqlReplicationMonitor
 
@@ -133,6 +132,16 @@ class MysqlReplicationMonitor
   end
 
 
+  # returns slave's report of seconds behind master. note: this isn't super-
+  # reliable, especially if the I/O thread is not running.
+  #-----------------------------------------------------------------------------
+  def seconds_behind
+    cache_check_or_refresh
+
+    @slave_status['Seconds_Behind_Master'].to_i
+  end
+
+
   # return a hashed version of the result of running SHOW SLAVE STATUS
   # options: 
   #   :refresh_if_stale: indicate whether to refresh the status if it's stale

data/mysql_replication_monitor.gemspec

@@ -0,0 +1,46 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run the gemspec command
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{mysql_replication_monitor}
+  s.version = "0.1.6"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Brian Percival"]
+  s.date = %q{2010-04-09}
+  s.description = %q{Connects to both master and slave and compares their status, allowing you to check whether
+the slave is running and whether slave is caught up to master
+}
+  s.email = %q{percivalatumamibuddotcom}
+  s.extra_rdoc_files = [
+    "LICENSE",
+     "README.rdoc",
+     "TODO"
+  ]
+  s.files = [
+    "README.rdoc",
+     "lib/mysql_replication_monitor.rb",
+     "mysql_replication_monitor.gemspec"
+  ]
+  s.homepage = %q{http://github.com/bmpercy/mysql_replication_monitor}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.5}
+  s.summary = %q{a helper class for monitoring replication between two mysql dbs. Rails environment only and depends on multiple_connection_handler.}
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<multiple_connection_handler>, [">= 0"])
+    else
+      s.add_dependency(%q<multiple_connection_handler>, [">= 0"])
+    end
+  else
+    s.add_dependency(%q<multiple_connection_handler>, [">= 0"])
+  end
+end
+

metadata

@@ -1,15 +1,15 @@
 --- !ruby/object:Gem::Specification 
 name: mysql_replication_monitor
 version: !ruby/object:Gem::Version 
-  version: 0.1.5
+  version: 0.1.6
 platform: ruby
 authors: 
-- bmpercy
+- Brian Percival
 autorequire: 
 bindir: bin
 cert_chain: []
 
-date: 2009-12-02 00:00:00 -08:00
+date: 2010-04-09 00:00:00 -07:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -20,34 +20,41 @@ dependencies:
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
-        version: 0.1.2
+        version: "0"
     version: 
-description: Simple utility to check replication status between two dbs listed in Rails' database.yml. See README for more info.
-email: 
+description: |
+  Connects to both master and slave and compares their status, allowing you to check whether
+  the slave is running and whether slave is caught up to master
+
+email: percivalatumamibuddotcom
 executables: []
 
 extensions: []
 
-extra_rdoc_files: []
-
+extra_rdoc_files: 
+- LICENSE
+- README.rdoc
+- TODO
 files: 
+- README.rdoc
 - lib/mysql_replication_monitor.rb
-- README
-- CHANGELOG
+- mysql_replication_monitor.gemspec
+- LICENSE
+- TODO
 has_rdoc: true
-homepage: 
+homepage: http://github.com/bmpercy/mysql_replication_monitor
 licenses: []
 
 post_install_message: 
-rdoc_options: []
-
+rdoc_options: 
+- --charset=UTF-8
 require_paths: 
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement 
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
-      version: 1.8.1
+      version: "0"
   version: 
 required_rubygems_version: !ruby/object:Gem::Requirement 
   requirements: 
@@ -61,6 +68,6 @@ rubyforge_project:
 rubygems_version: 1.3.5
 signing_key: 
 specification_version: 3
-summary: Utility for checking replication status between two dbs in Rails' database.yml
+summary: a helper class for monitoring replication between two mysql dbs. Rails environment only and depends on multiple_connection_handler.
 test_files: []
 

data/CHANGELOG

@@ -1,4 +0,0 @@
-0.1.5
------
-* added option to raw_slave_status to prevent status refreshing since last status call if desired
-