ciclope 0.0.1

data/.gitignore

@@ -0,0 +1,4 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*

data/Gemfile

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

data/README.markdown

@@ -0,0 +1,60 @@
+Ciclope
+=======
+
+Simple utility to show the replication status for MySQL hots. Usefull to inspect seconds behind master status.
+ 
+_NOTE: This gem depends on Rails and ActiveRecord as ORM._
+
+Configuration
+-------------
+
+Only has to specify a array of two or more Rails database config names:
+
+> Ciclope.connections = [:production, :production\_in\_aws, :production\_in\_other_location]
+
+The ring will be auto-sorted guessing the master host for each connection, you could bypass this feature setting:
+
+> Ciclope.auto\_sort\_connections = false
+
+Use
+---
+
+Actually there is one class methods to inspect replication data and one to show seconds behind master:
+
+> Ciclope.replication\_status \# => returns a array of hashes with replication data
+
+> Ciclope.replication\_seconds\_behind\_master # => returns a simple string with the host status like:
+
+>> host1 ––– 0 seconds –––> host2 ––– 0 seconds –––> host3 ––– 0 seconds –––> host1
+
+TODO
+----
+
+Extend and refact in order to let work with others frameworks ruby based (Sinatra, Merb), and others ORMs (DataMapper).
+
+Licence
+-------
+
+Copyright (c) 2011 Hugo Gerónimo Díaz
+
+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/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/ciclope.gemspec

@@ -0,0 +1,26 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "ciclope/version"
+
+Gem::Specification.new do |s|
+  s.name        = "ciclope"
+  s.version     = Ciclope::VERSION
+  s.authors     = ["Hugo Geronimo Diaz"]
+  s.email       = ["geronimod@gmail.com"]
+  s.homepage    = "http://github.com/geronimod/ciclope"
+  s.summary     = %q{Simple MySQL Replication Utility.}
+  s.description = %q{Simple utility to show the replication status for MySQL hots. Usefull to inspect sencond behind master status. This gem depends on Rails and ActiveRecord as ORM.}
+
+  s.rubyforge_project = "ciclope"
+
+  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"]
+
+  # specify any dependencies here; for example:
+  s.add_development_dependency "rspec"
+  s.add_dependency "rails"
+  s.add_dependency "activerecord"
+  # s.add_runtime_dependency "rest-client"
+end

data/lib/ciclope.rb

@@ -0,0 +1,32 @@
+require "ciclope/ring"
+require "ciclope/host"
+require "ciclope/version"
+
+module Ciclope
+
+  class << self
+    attr_accessor :connections, :auto_sort_connections
+  end
+  self.auto_sort_connections = true
+
+  def self.auto_sort?
+    auto_sort_connections
+  end
+
+  def self.ring
+    @ring ||= Ring.new(connections, :sort_hosts => auto_sort?)
+  end
+
+  def self.replication_status
+    ring.hosts.map &:status
+  end
+  
+  def self.replication_seconds_behind_master
+    out = ring.hosts.map do |host|
+      host.name + " ––– #{host.seconds_behind_master} seconds –––> "
+    end
+    out << ring.hosts.first.name
+    out.join
+  end
+  
+end

data/lib/ciclope/host.rb

@@ -0,0 +1,54 @@
+module Ciclope
+  class Host
+    include Comparable
+  
+    attr_reader :connection, :config
+
+    def initialize(connection)
+      @connection = connection
+      @config     = @connection.instance_variable_get '@config'
+    
+      # define every key as a method
+      status.keys.each do |m|
+        self.class.send :define_method, m.downcase do
+          status[m]
+        end
+      end
+    end
+
+    def name
+      @config[:host]
+    end
+
+    def status
+      @connection.select_one 'SHOW SLAVE STATUS'
+    end
+  
+    def log_file
+      cleanfy_log_name relay_log_file.split('.').first
+    end
+  
+    def master_log_file
+      cleanfy_log_name relay_master_log_file.split('.').first
+    end
+  
+    # sort by log file names, there is no way to do this by host names, may be there is another way to do this more clean
+    # TODO: find the right sort
+    def <=>(other)
+      if log_file == other.master_log_file
+        1
+      elsif other.log_file == master_log_file
+        -1
+      else
+        0
+      end
+    end
+  
+    private
+      def cleanfy_log_name(name)
+        name.gsub(/(binary|relay)log/i, '').
+             gsub(/[_\-\d]/, '')
+      end
+  
+  end
+end

data/lib/ciclope/ring.rb

@@ -0,0 +1,29 @@
+module Ciclope
+  class Ring
+    class NotEnoughConnections < Exception
+      def message
+        "Connections must be more than once !"
+      end
+    end
+    
+    attr_reader :hosts
+    
+    def initialize(*args)
+      options = args.pop if args.last.is_a? Hash
+      options ||= {}
+      connections = Array(args).flatten.compact.uniq
+      
+      raise NotEnoughConnections if connections.size < 2
+      
+      @hosts = []
+
+      connections.each do |c|
+        config = Rails.configuration.database_configuration[c.to_s]
+        @hosts << Host.new(ActiveRecord::Base.mysql_connection(config)) if config
+      end
+
+      @hosts = @hosts.sort if options[:sort_hosts] && @hosts.count > 2
+    end
+    
+  end
+end

data/lib/ciclope/version.rb

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

metadata

@@ -0,0 +1,115 @@
+--- !ruby/object:Gem::Specification 
+name: ciclope
+version: !ruby/object:Gem::Version 
+  hash: 29
+  prerelease: 
+  segments: 
+  - 0
+  - 0
+  - 1
+  version: 0.0.1
+platform: ruby
+authors: 
+- Hugo Geronimo Diaz
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-12-26 00:00:00 Z
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: rails
+  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
+- !ruby/object:Gem::Dependency 
+  name: activerecord
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  version_requirements: *id003
+description: Simple utility to show the replication status for MySQL hots. Usefull to inspect sencond behind master status. This gem depends on Rails and ActiveRecord as ORM.
+email: 
+- geronimod@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- Gemfile
+- README.markdown
+- Rakefile
+- ciclope.gemspec
+- lib/ciclope.rb
+- lib/ciclope/host.rb
+- lib/ciclope/ring.rb
+- lib/ciclope/version.rb
+homepage: http://github.com/geronimod/ciclope
+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: ciclope
+rubygems_version: 1.8.12
+signing_key: 
+specification_version: 3
+summary: Simple MySQL Replication Utility.
+test_files: []
+