scatter 0.0.1

data/bin/scatter

@@ -0,0 +1,6 @@
+#!/usr/bin/env ruby
+require 'rubygems'
+require 'scatter'
+require 'optparse'
+
+Scatter::CLI.new(STDOUT).run(ARGV)

data/lib/scatter.rb

@@ -0,0 +1,27 @@
+require File.dirname(__FILE__) + '/scatter/cli'
+require File.dirname(__FILE__) + '/scatter/command'
+require File.dirname(__FILE__) + '/scatter/super_command'
+require File.dirname(__FILE__) + '/scatter/sub_command'
+require File.dirname(__FILE__) + '/scatter/commands/list'
+require File.dirname(__FILE__) + '/scatter/commands/push'
+require File.dirname(__FILE__) + '/scatter/commands/receive'
+require File.dirname(__FILE__) + '/scatter/commands/remote'
+require File.dirname(__FILE__) + '/scatter/commands/remote/add'
+require File.dirname(__FILE__) + '/scatter/commands/remote/list'
+require File.dirname(__FILE__) + '/scatter/commands/remote/rm'
+require File.dirname(__FILE__) + '/scatter/commands/node'
+require File.dirname(__FILE__) + '/scatter/commands/node/add'
+require File.dirname(__FILE__) + '/scatter/commands/node/list'
+require File.dirname(__FILE__) + '/scatter/commands/node/rm'
+require File.dirname(__FILE__) + '/scatter/commands/init'
+require File.dirname(__FILE__) + '/scatter/config'
+require File.dirname(__FILE__) + '/scatter/logger'
+require File.dirname(__FILE__) + '/scatter/node'
+require File.dirname(__FILE__) + '/scatter/remote'
+require File.dirname(__FILE__) + '/scatter/gemlist'
+require File.dirname(__FILE__) + '/scatter/shell'
+require File.dirname(__FILE__) + '/scatter/version'
+
+module Scatter
+  class CommandLineError< StandardError; end
+end

data/lib/scatter/cli.rb

@@ -0,0 +1,64 @@
+module Scatter
+  class CLI
+    def initialize(out)
+      @out = out
+    end
+    
+    def run!(args)
+      raise CommandLineError, 'No command given' if args.empty?
+    
+      case command_name = args.shift
+      when /^-?-?h(elp)?$/
+        if args.empty?
+          usage
+        else
+          if args.first == 'commands'
+            commands_help
+          else
+            @out.puts command_class(args.first).help
+          end
+        end
+      when /^-?-?v(ersion)?$/
+        @out.puts "scatter version #{Scatter.version}"
+      else
+        klass = command_class(command_name)
+        command = klass.new(@out, *args)
+        command.execute!
+      end
+    end
+    
+    def run(args)
+      run!(args)
+    rescue CommandLineError => e
+      @out.puts "Error: #{e.message}"
+      usage
+    end
+  
+  protected
+    def usage
+      @out.puts "Usage: scatter command [options ...]"
+      @out.puts "For information about the commands use: scatter help commands"
+    end
+    
+    def commands_help
+      @out.puts "To get help for a command, use: scatter help <command_name>"
+      @out.puts
+      hash = Scatter::Command.command_classes.inject({}) do |hash, cmd|
+        next hash if cmd.abstract
+        command_name = cmd.name.split('::').last.downcase
+        hash[command_name] = cmd.short_help
+        hash
+      end
+      
+      hash.sort.each do |command, help|
+        @out.puts "#{command} - #{help}"
+      end
+    end
+  
+    def command_class(command_name)
+      eval("Scatter::Commands::#{command_name.capitalize}")
+    rescue
+      raise CommandLineError, "Unknown command #{command_name}"
+    end
+  end
+end

data/lib/scatter/command.rb

@@ -0,0 +1,31 @@
+module Scatter
+  class Command
+    def initialize(out)
+      @out = out
+    end
+    
+    class << self
+      attr_reader :short_help
+      attr_reader :command_classes
+      attr_accessor :abstract
+      
+      def usage(short_help, long_help = nil)
+        @short_help, @help = short_help, long_help || short_help
+      end
+      
+      def help
+        lines = @help.split("\n")
+        indent = lines.collect { |l| l[/^(\s*)/, 1].size }.min
+        lines.collect { |l| l[indent..-1] }.join("\n")
+      end
+      
+      def inherited(sub)
+        (@command_classes ||= []) << sub
+      end
+      
+      def command_name
+        name.split('::').last.downcase
+      end
+    end
+  end
+end

data/lib/scatter/commands/init.rb

@@ -0,0 +1,17 @@
+require 'fileutils'
+
+module Scatter
+  module Commands
+    class Init < Scatter::Command
+      usage "Initialize scatter configuration", <<-end
+        Initializes your machine to use scatter. You need to run this command only once.
+        However, it should not break anything if you run it again.
+      end
+      
+      def execute!
+        FileUtils.mkdir_p File.dirname(Scatter::Config.file_name)
+        Scatter::Config.save!
+      end
+    end
+  end
+end

data/lib/scatter/commands/list.rb

@@ -0,0 +1,27 @@
+module Scatter
+  module Commands
+    class List < Scatter::Command
+      usage "List all gems installed on node", <<-end
+        List all gems on a node. The node can be specified by name or by fully qualified
+        node name. Examples:
+        
+          scatter list nodename
+          scatter list remote/nodename
+      end
+      
+      def initialize(out, node_name)
+        super(out)
+        @node_name = node_name
+      end
+      
+      def execute!
+        gemlist = node.list
+        @out.puts gemlist.gem_output
+      end
+      
+      def node
+        @node ||= Scatter::Config.find_node(@node_name)
+      end
+    end
+  end
+end

data/lib/scatter/commands/node.rb

@@ -0,0 +1,22 @@
+module Scatter
+  module Commands
+    class Node < Scatter::SuperCommand
+      usage "List, add or remove nodes", <<-end
+        List, add or remove nodes from remote.
+        To list nodes use the following syntax:
+        
+          scatter node list <remote_name>
+        
+        To add a node to a remote, use
+        
+          scatter node add <remote_name> <node_name> <username>@<hostname>
+        
+        To remove a node, use either of
+        
+          scatter node rm <node_name>
+          scatter node rm <remote_name>/<node_name>
+          scatter node rm <remote_name> <node_name>
+      end
+    end
+  end
+end

data/lib/scatter/commands/node/add.rb

@@ -0,0 +1,20 @@
+module Scatter
+  module Commands
+    class Node
+      class Add < Scatter::SubCommand
+        def initialize(out, remote_name, node, credentials)
+          super(out)
+          @remote_name, @node, @credentials = remote_name, node, credentials
+        end
+        
+        def execute!
+          remote = Scatter::Config.find_remote(@remote_name)
+          raise CommandLineError, "Unknown remote #{@remote_name}" unless remote
+          raise CommandLineError, "Remote #{@remote_name} already has node #{@node}" if remote.find_node(@node)
+          remote.nodes << Scatter::Node.new(remote, @node, *(@credentials.split('@')))
+          Scatter::Config.save!
+        end
+      end
+    end
+  end
+end

data/lib/scatter/commands/node/list.rb

@@ -0,0 +1,26 @@
+module Scatter
+  module Commands
+    class Node
+      class List < Scatter::SubCommand
+        def initialize(out, name = nil)
+          super(out)
+          @name = name
+        end
+        
+        def execute!
+          nodes = if @name
+            remote = Scatter::Config.find_remote(@name)
+            raise CommandLineError, "Unknown remote #{@name}" unless remote
+            remote.nodes
+          else
+            Scatter::Config.nodes
+          end
+
+          nodes.each do |node|
+            @out.puts "#{node.remote.name}/#{node.name}"
+          end
+        end
+      end
+    end
+  end
+end

data/lib/scatter/commands/node/rm.rb

@@ -0,0 +1,30 @@
+module Scatter
+  module Commands
+    class Node
+      class Rm < Scatter::SubCommand
+        def initialize(out, remote, node = nil)
+          super(out)
+          @remote, @node = remote, node
+        end
+        
+        def execute!
+          node = if @node
+            remote = Scatter::Config.find_remote(@remote)
+            raise CommandLineError, "Unknown remote #{@remote}" unless remote
+            remote.find_node(@node)
+          else
+            Scatter::Config.find_destination(@remote)
+          end
+          
+          unless node
+            dest = [@remote, @node].compact.join('/')
+            raise CommandLineError, "Unknown node #{dest}"
+          end
+
+          node.remote.nodes.delete(node)
+          Scatter::Config.save!
+        end
+      end
+    end
+  end
+end

data/lib/scatter/commands/push.rb

@@ -0,0 +1,30 @@
+module Scatter
+  module Commands
+    class Push < Scatter::Command
+      usage "Push gem to remote or node", <<-end
+        Pushes a gem to a remote or node. Use the remote name, node name or fully
+        qualified node name to specify the target. Examples:
+        
+          # to push to node my_node
+          scatter push my_gem.gem my_node
+          scatter push my_gem.gem my_remote/my_node
+          
+          # to push to remote my_remote
+          scatter push my_gem.gem my_remote
+      end
+      
+      def initialize(out, gemfile, destination)
+        super(out)
+        @gemfile, @destination = gemfile, destination
+      end
+      
+      def execute!
+        dest.push(@gemfile)
+      end
+      
+      def dest
+        @dest ||= Scatter::Config.find_destination(@destination)
+      end
+    end
+  end
+end

data/lib/scatter/commands/receive.rb

@@ -0,0 +1,19 @@
+module Scatter
+  module Commands
+    class Receive < Scatter::Command
+      usage "Inform scatter that gem was received; calls post receive hook"
+      
+      def initialize(out, gemfile)
+        super(out)
+        @gemfile = gemfile
+      end
+      
+      def execute!
+        if File.executable?("#{ENV['HOME']}/.scatter/post-receive")
+          Scatter::Logger.log("Executing post receive hook")
+          Scatter::Shell.execute "#{ENV['HOME']}/.scatter/post-receive #{@gemfile}"
+        end
+      end
+    end
+  end
+end

data/lib/scatter/commands/remote.rb

@@ -0,0 +1,20 @@
+module Scatter
+  module Commands
+    class Remote < Scatter::SuperCommand
+      usage "List, add or remove remotes", <<-end
+        List, add or remove remotes.
+        To list remotes use the following syntax:
+        
+          scatter remote list
+        
+        To add a remote, use
+        
+          scatter remote add <remote_name>
+        
+        To remove a remote, use
+        
+          scatter remote rm <remote_name>
+      end
+    end
+  end
+end

data/lib/scatter/commands/remote/add.rb

@@ -0,0 +1,18 @@
+module Scatter
+  module Commands
+    class Remote
+      class Add < Scatter::SubCommand
+        def initialize(out, name)
+          super(out)
+          @name = name
+        end
+        
+        def execute!
+          raise CommandLineError, "Remote #{@name} already exists" if Scatter::Config.find_remote(@name)
+          Scatter::Config.remotes << Scatter::Remote.new(@name)
+          Scatter::Config.save!
+        end
+      end
+    end
+  end
+end

data/lib/scatter/commands/remote/list.rb

@@ -0,0 +1,13 @@
+module Scatter
+  module Commands
+    class Remote
+      class List < Scatter::SubCommand
+        def execute!
+          Scatter::Config.remotes.each do |remote|
+            @out.puts remote.name
+          end
+        end
+      end
+    end
+  end
+end

data/lib/scatter/commands/remote/rm.rb

@@ -0,0 +1,19 @@
+module Scatter
+  module Commands
+    class Remote
+      class Rm < Scatter::SubCommand
+        def initialize(out, name)
+          super(out)
+          @name = name
+        end
+        
+        def execute!
+          remote = Scatter::Config.find_remote(@name)
+          raise CommandLineError, "Remote #{@name} does not exist" unless remote
+          Scatter::Config.remotes.delete(remote)
+          Scatter::Config.save!
+        end
+      end
+    end
+  end
+end

data/lib/scatter/config.rb

@@ -0,0 +1,72 @@
+module Scatter
+  class Config
+    class << self
+      def instance
+        @instance ||= new
+      end
+      
+      def clear
+        @instance = nil
+      end
+      
+      def reload
+        @instance = new(@instance.file_name)
+      end
+      
+      def method_missing(method, *args)
+        if instance.respond_to?(method)
+          instance.send(method, *args)
+        else
+          super
+        end
+      end
+    end
+    
+    attr_accessor :file_name
+    
+    def initialize(file_name = nil)
+      self.file_name = file_name || "#{ENV['HOME']}/.scatter/config"
+    end
+
+    def remotes
+      load!
+      @remotes ||= (@config['remotes'] || {}).collect { |name, config| Scatter::Remote.decode_from_config(name, config) }
+    end
+    
+    def nodes
+      @nodes ||= remotes.collect { |remote| remote.nodes }.flatten
+    end
+    
+    def load!
+      @loaded ||= begin
+        @config = YAML.load(File.read(file_name)) rescue {}
+        true
+      end
+    end
+    
+    def save!
+      config = {
+        'remotes' => self.remotes.inject({}) { |hash, remote| hash[remote.name] = remote.encode_for_config; hash }
+      }
+      File.open(file_name, 'w') { |file| file.puts config.to_yaml }
+    end
+    
+    def find_remote(name)
+      remotes.find { |remote| remote.name == name }
+    end
+    
+    def find_node(name)
+      nodes.find { |node| node.name == name || node.full_name == name }
+    end
+    
+    def find_destination(name)
+      if name =~ /\//
+        remote, node = *(name.split('/'))
+        remote_object = find_remote(remote)
+        remote_object.find_node(node) if remote_object
+      else
+        (remotes + nodes).find { |dest| dest.name == name }
+      end
+    end
+  end
+end

data/lib/scatter/gemlist.rb

@@ -0,0 +1,13 @@
+module Scatter
+  class Gemlist
+    attr_accessor :gem_output
+    
+    def initialize(gem_output)
+      @gem_output = gem_output
+    end
+    
+    def self.parse(gem_output)
+      new(gem_output)
+    end
+  end
+end

data/lib/scatter/logger.rb

@@ -0,0 +1,7 @@
+module Scatter
+  class Logger
+    def self.log(message)
+      puts message
+    end
+  end
+end

data/lib/scatter/node.rb

@@ -0,0 +1,34 @@
+module Scatter
+  class Node
+    attr_reader :remote, :name, :username, :hostname
+    
+    def initialize(remote, name, username, hostname)
+      @remote, @name, @username, @hostname = remote, name, username, hostname
+    end
+    
+    def full_name
+      [remote.name, name].join('/')
+    end
+    
+    def list
+      Scatter::Gemlist.parse(Scatter::Shell.capture("ssh #{@username}@#{@hostname} gem list"))
+    end
+    
+    def push(gemfile)
+      Scatter::Shell.execute "scp #{gemfile} #{@username}@#{@hostname}:/tmp"
+      Scatter::Shell.execute "ssh #{@username}@#{@hostname} sudo gem install /tmp/#{File.basename(gemfile)}"
+      Scatter::Shell.execute "ssh #{@username}@#{@hostname} scatter receive /tmp/#{File.basename(gemfile)}"
+    end
+    
+    def self.decode_from_config(remote, name, config)
+      new(remote, name, config['username'], config['hostname'])
+    end
+    
+    def encode_for_config
+      {
+        'username' => @username,
+        'hostname' => @hostname
+      }
+    end
+  end
+end

data/lib/scatter/remote.rb

@@ -0,0 +1,33 @@
+module Scatter
+  class Remote
+    attr_reader :name, :nodes
+    
+    def initialize(name)
+      @name = name
+      @nodes = []
+    end
+    
+    def push(gemfile)
+      @nodes.each do |node|
+        node.push(gemfile)
+      end
+    end
+    
+    def find_node(name)
+      nodes.find { |node| node.name == name }
+    end
+    
+    def self.decode_from_config(name, config)
+      remote = new(name)
+      nodes = config['nodes'].collect { |nodename, config| Node.decode_from_config(remote, nodename, config) } rescue []
+      remote.nodes.concat(nodes)
+      remote
+    end
+    
+    def encode_for_config
+      {
+        'nodes' => @nodes.inject({}) { |hash, node| hash[node.name] = node.encode_for_config; hash }
+      }
+    end
+  end
+end

data/lib/scatter/shell.rb

@@ -0,0 +1,28 @@
+module Scatter
+  module Shell
+    extend self
+    
+    attr_accessor :dry_run
+    attr_accessor :command_log
+    
+    def execute(command)
+      log_command command
+      system command unless dry_run
+    end
+    
+    def capture(command)
+      log_command command
+      %x{#{command}} unless dry_run
+    end
+    
+    def clear_log
+      self.command_log = []
+    end
+    
+  protected
+    def log_command(command)
+      self.command_log ||= []
+      self.command_log << command
+    end
+  end
+end

data/lib/scatter/sub_command.rb

@@ -0,0 +1,7 @@
+module Scatter
+  class SubCommand
+    def initialize(out)
+      @out = out
+    end
+  end
+end

data/lib/scatter/super_command.rb

@@ -0,0 +1,28 @@
+module Scatter
+  class SuperCommand < Command
+    self.abstract = true
+    
+    # needed?
+    class << self
+      def inherited(sub)
+        Command.inherited(sub)
+      end
+    end
+    
+    def initialize(out, *args)
+      super(out)
+      @subcmd = args.shift
+      @arguments = args
+    end
+    
+    def execute!
+      subcmd_class = eval("#{self.class.name}::#{@subcmd.capitalize}")
+      cmd = subcmd_class.new(@out, *@arguments)
+      cmd.execute!
+    rescue ArgumentError
+      raise CommandLineError, "Wrong number of mandatory arguments for command #{self.class.command_name} #{@subcmd}"
+    rescue NameError
+      raise CommandLineError, "Unknown subcommand #{@subcmd} for command #{self.class.command_name}"
+    end
+  end
+end

data/lib/scatter/version.rb

@@ -0,0 +1,5 @@
+module Scatter
+  def self.version
+    "0.0.1"
+  end
+end

metadata

@@ -0,0 +1,81 @@
+--- !ruby/object:Gem::Specification 
+name: scatter
+version: !ruby/object:Gem::Version 
+  version: 0.0.1
+platform: ruby
+authors: 
+- imedo GmbH
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-04-17 00:00:00 +02:00
+default_executable: 
+dependencies: []
+
+description: 
+email: entwicker@imedo.de
+executables: 
+- scatter
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- bin/scatter
+- lib/scatter
+- lib/scatter/cli.rb
+- lib/scatter/command.rb
+- lib/scatter/commands
+- lib/scatter/commands/init.rb
+- lib/scatter/commands/list.rb
+- lib/scatter/commands/node
+- lib/scatter/commands/node/add.rb
+- lib/scatter/commands/node/list.rb
+- lib/scatter/commands/node/rm.rb
+- lib/scatter/commands/node.rb
+- lib/scatter/commands/push.rb
+- lib/scatter/commands/receive.rb
+- lib/scatter/commands/remote
+- lib/scatter/commands/remote/add.rb
+- lib/scatter/commands/remote/list.rb
+- lib/scatter/commands/remote/rm.rb
+- lib/scatter/commands/remote.rb
+- lib/scatter/config.rb
+- lib/scatter/gemlist.rb
+- lib/scatter/logger.rb
+- lib/scatter/node.rb
+- lib/scatter/remote.rb
+- lib/scatter/shell.rb
+- lib/scatter/sub_command.rb
+- lib/scatter/super_command.rb
+- lib/scatter/version.rb
+- lib/scatter.rb
+has_rdoc: false
+homepage: http://www.imedo.de/
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.1
+signing_key: 
+specification_version: 2
+summary: Gem deployment tool
+test_files: []
+