frontier 0.0.1

data/LICENSE

@@ -0,0 +1,2 @@
+
+You may not use this software. At all.

data/README.md

@@ -0,0 +1,74 @@
+
+Ruby sans frontiers
+-------------------
+
+A cross-host ruby bridge. Allows you to create and operate on objects
+created in ruby runtimes on remote hosts. Frontier uses an ssh connection
+and tunnels serializes method calls and replies through it. It's inspired
+by Rush, but without the limitation of needing a server process running on
+the remote host.
+
+In its pure form, the shell simply forwards all missing methods to the unix
+shell (bash or whatever you use). But you can extend the shell through
+a system of mixins. There's a few builtin mixins, and you can write your own.
+
+
+Mixins
+------
+
+ * Filesystem: the 'filesystem' mixin provides the method `#[](glob)` which
+   returns an array of Pathname objects.
+
+ * Process: the 'process' mixin provides the method 'process' which uses 
+   PQL internally to enumerate or find processes.
+
+
+Limitations
+-----------
+
+Frontier uses Marshal internally to serialize objects and Marshal has certain
+limitations which objects it can serialize. For example it can't serialize
+Proc objects, bindings or IO objects. So you need to pay attention where the
+object you created lives, whether on the local or remote host.
+
+For example this won't work:
+
+    server.process.where(:command => /ruby/).each {|p| puts p }
+
+But this will
+
+    server.process.where(:command => /ruby/).all.each {|p| puts p }
+
+This is because where() returns a Plucky::Query object which lives on the
+server, so passing a proc to it doesn't work. but where().all() returns an
+Array which is lives in the process space on the local host and you can treat
+it just like any other array.
+
+
+Example
+-------
+
+    require 'frontier'
+
+    server = Frontier::Shell.new('user@server.tld')
+
+    puts server.uname
+    puts server.ls '*.rb'
+    
+    server.load('filesystem')
+    puts server['*.rb'].last
+    
+    server.load('process')
+    puts local.process.where(:command => /ruby/).fields(:pid, :rss).all
+
+
+References
+----------
+
+  * [Rush](http://rush.heroku.com/)
+  * [PQL](http://github.com/wereHamster/process-query-language)
+
+License
+-------
+
+Copyright (c) 2010 by Tomas "wereHamster" Carnecky (tomas.carnecky@gmail.com)

data/bin/frontier

@@ -0,0 +1,6 @@
+#!/usr/bin/env ruby
+
+require 'rubygems'
+require 'frontier'
+
+Frontier::Adapter.new

data/lib/frontier/adapter.rb

@@ -0,0 +1,55 @@
+
+module Frontier
+
+  class Adapter
+
+    def self.wrap(object)
+      case object
+      when Numeric, String, Exception
+        return object
+      when Array
+        return object.map { |o| wrap(o) }
+      when Hash
+        return object.merge(object) { |k, v| wrap(v) }
+      else
+        return Proxy.new(object)
+      end
+    end
+
+
+    def initialize
+      @cache = {}
+
+      while true do
+        begin
+          request = Marshal.load($stdin)
+
+          if request[:object]
+            object = ObjectSpace._id2ref(request[:object])
+          else
+            object = self
+          end
+
+          reply = object.send(request[:name], *request[:args])
+          @cache[reply.object_id] = reply
+          Marshal.dump(Adapter.wrap(reply), $stdout)
+        rescue Exception => e
+          Marshal.dump(e, $stdout)
+        end
+        $stdout.flush
+      end
+    end
+
+    def load(*mixins)
+      [*mixins].each do |mixin|
+        self.class.class_eval("include Frontier::Mixin::#{mixin.capitalize}")
+      end
+    end
+
+    def method_missing(name, *args)
+      %x[#{name} #{args.join(' ')}]
+    end
+
+  end
+
+end

data/lib/frontier/channel.rb

@@ -0,0 +1,29 @@
+
+module Frontier
+
+  class Channel
+
+    def self.hydrate(channel, object)
+      case object
+      when Array, Hash
+        object.each { |o| Channel.hydrate(channel, o) }
+      when Proxy
+        object.channel = channel
+      end
+
+      return object
+    end
+
+
+    def initialize(host, port)
+      @channel = IO.popen("ssh #{host} frontier", "r+")
+    end
+
+    def submit(request)
+      Marshal.dump(request, @channel)
+      return Channel.hydrate(self, Marshal.load(@channel))
+    end
+
+  end
+
+end

data/lib/frontier/mixin/filesystem.rb

@@ -0,0 +1,10 @@
+
+require 'pathname'
+
+module Frontier::Mixin::Filesystem
+
+  def [](glob)
+    Pathname.glob(glob)
+  end
+
+end

data/lib/frontier/mixin/process.rb

@@ -0,0 +1,10 @@
+
+require 'process-query-language'
+
+module Frontier::Mixin::Process
+
+  def process
+    return Process
+  end
+
+end

data/lib/frontier/mixin.rb

@@ -0,0 +1,11 @@
+
+module Frontier
+
+  module Mixin
+
+    autoload :Filesystem,     'frontier/mixin/filesystem'
+    autoload :Process,        'frontier/mixin/process'
+
+  end
+
+end

data/lib/frontier/proxy.rb

@@ -0,0 +1,19 @@
+
+module Frontier
+
+  class Proxy
+    attr_accessor :channel
+
+    def initialize(object)
+      @typename = object.class.to_s
+      @object = object.object_id
+    end
+
+    def method_missing(name, *args)
+      request = { :object => @object, :name => name, :args => args }
+      return @channel.submit(request)
+    end
+
+  end
+
+end

data/lib/frontier/shell.rb

@@ -0,0 +1,18 @@
+
+module Frontier
+
+  class Shell
+
+    def initialize(host = 'localhost', port = 22)
+      @host = host
+      @port = port
+    end
+
+    def method_missing(name, *args)
+      @channel ||= Channel.new(@host, @port)
+      return @channel.submit({ :name => name, :args => args })
+    end
+
+  end
+
+end

data/lib/frontier/version.rb

@@ -0,0 +1,6 @@
+
+module Frontier
+
+  Version = '0.0.1'
+
+end

data/lib/frontier.rb

@@ -0,0 +1,11 @@
+
+module Frontier
+
+  autoload :Adapter,          'frontier/adapter'
+  autoload :Channel,          'frontier/channel'
+  autoload :Mixin,            'frontier/mixin'
+  autoload :Proxy,            'frontier/proxy'
+  autoload :Shell,            'frontier/shell'
+  autoload :Version,          'frontier/version'
+
+end

metadata

@@ -0,0 +1,79 @@
+--- !ruby/object:Gem::Specification 
+name: frontier
+version: !ruby/object:Gem::Version 
+  hash: 29
+  prerelease: false
+  segments: 
+  - 0
+  - 0
+  - 1
+  version: 0.0.1
+platform: ruby
+authors: 
+- Tomas Carnecky
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-10-31 01:00:00 +02:00
+default_executable: 
+dependencies: []
+
+description: 
+email: 
+- tomas.carnecky@gmail.com
+executables: 
+- frontier
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- lib/frontier/adapter.rb
+- lib/frontier/channel.rb
+- lib/frontier/mixin/filesystem.rb
+- lib/frontier/mixin/process.rb
+- lib/frontier/mixin.rb
+- lib/frontier/proxy.rb
+- lib/frontier/shell.rb
+- lib/frontier/version.rb
+- lib/frontier.rb
+- LICENSE
+- README.md
+- bin/frontier
+has_rdoc: true
+homepage: http://github.com/wereHamster/frontier
+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: 
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: Ruby without borders
+test_files: []
+