terminus 0.1.0

data/README.rdoc

@@ -0,0 +1,61 @@
+= Terminus
+
+* http://github.com/jcoglan/terminus
+
+Terminus is a distributed JavaScript terminal. It lets you connect
+web browsers you have open to a command-line console and run code
+on all connected browsers at once. It's currently a toy, but it
+might turn into a useful debugging and testing tool. We'll see.
+
+
+== Installation
+
+  sudo gem install terminus
+
+
+== Usage
+
+In your terminal, run the +terminus+ command. You can optionally
+specify a port for it to open up like this:
+
+  terminus --port 7004
+
+You should see something like this:
+
+  Terminus running at http://0.0.0.0:7004
+  >>
+
+This is the Terminus prompt - it's where you type in JavaScript
+commands. Before you do that, though, visit http://localhost:7004
+in your browser. From there you can grab a bookmarklet that lets
+you connect any web page to the Terminus server. When you click
+the bookmarklet, the current page will open a connection with
+Terminus so that any commands you type into the shell are executed
+on that page.
+
+
+== License
+
+(The MIT License)
+
+Copyright (c) 2010 James Coglan
+
+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/bin/terminus

@@ -0,0 +1,33 @@
+#!/usr/bin/env ruby
+
+require 'rubygems'
+require 'readline'
+require 'oyster'
+require File.dirname(__FILE__) + '/../lib/terminus'
+
+spec = Oyster.spec do
+  name "terminus -- controll web browsers from the command line"
+  synopsis "terminus [--port PORT]"
+  
+  integer :port, :default => 7004
+end
+
+begin
+  options = spec.parse
+  app = Terminus.create(options)
+  
+  app.run!
+  puts "Terminus running at http://0.0.0.0:#{options[:port]}"
+  puts "Press CTRL-C to exit"
+  
+  trap("INT") { app.stop! ; exit }
+  
+  loop {
+    script, result = Readline.readline('>> '), nil
+    Readline::HISTORY.push(script)
+    app.execute(script) { |r| result = r }
+  }
+  
+rescue Oyster::HelpRendered
+end
+

data/lib/public/js.packages.js

@@ -0,0 +1 @@
+this.JS=this.JS||{};JS.Package=function(a){var b=JS.Package.OrderedSet;JS.Package._3(this);this._0=a;this._1=new b();this._4=new b();this._9=new b();this._2={};this._5={}};(function(f){var l=f.OrderedSet=function(a,b){this._a=this.list=[];this._3={};if(!a)return;for(var c=0,d=a.length;c<d;c++)this.push(b?b(a[c]):a[c])};l.prototype.push=function(a){var b=(a.id!==undefined)?a.id:a,c=this._3;if(c.hasOwnProperty(b))return;c[b]=this._a.length;this._a.push(a)};f._b=this;if((this.document||{}).getElementsByTagName){var m=document.getElementsByTagName('script')[0];f._i=(m.readyState!==undefined)}var h=f.prototype;h.addDependency=function(a){this._4.push(a)};h.addSoftDependency=function(a){this._9.push(a)};h.addName=function(a){this._1.push(a);f.getFromCache(a).pkg=this};h.onload=function(a){this._c=a};h.on=function(a,b,c){if(this._5[a])return b.call(c);var d=this._2[a]=this._2[a]||[];d.push([b,c])};h.fire=function(a){if(this._5[a])return false;this._5[a]=true;var b=this._2[a];if(!b)return true;delete this._2[a];for(var c=0,d=b.length;c<d;c++)b[c][0].call(b[c][1]);return true};h.isLoaded=function(a){if(!a&&this._6!==undefined)return this._6;var b=this._1.list,c=b.length,d,e;while(c--){d=b[c];e=f.getObject(d);if(e!==undefined)continue;if(a)throw new Error('Expected package at '+this._0+' to define '+d);else return this._6=false}return this._6=true};h.load=function(){if(!this.fire('request'))return;var c=this._4.list.concat(this._9.list),d='load',e={};e[d]=this._4.list;f.when(e,function(){f.when({complete:c,load:[this]},function(){this.fire('complete')},this);var a=this,b=function(){if(a._c)a._c();a.isLoaded(true);a.fire('load')};if(this.isLoaded()){this.fire('download');return this.fire('load')}if(this._0===undefined)throw new Error('No load path found for '+this._1.list[0]);typeof this._0==='function'?this._0(b):f.Loader.loadFile(this._0,b);this.fire('download')},this)};h.toString=function(){return'Package:'+this._1.list.join(',')};f.when=function(b,c,d){var e=[],g,j,i;for(g in b){if(!b.hasOwnProperty(g))continue;j=new f.OrderedSet(b[g],function(a){return f.getByName(a)});i=j.list.length;while(i--)e.push([g,j.list[i]])}var k=i=e.length;if(k===0)return c&&c.call(d);while(i--){e[i][1].on(e[i][0],function(){k-=1;if(k===0&&c)c.call(d)});e[i][1].load()}};f._d=1;f._e={};f._f={};f._3=function(a){a.id=this._d;this._d+=1};f.getByPath=function(a){var b=a.toString();return this._e[b]=this._e[b]||new this(a)};f.getByName=function(a){if(typeof a!=='string')return a;var b=this.getFromCache(a);if(b.pkg)return b.pkg;var c=new this();c.addName(a);return c};f.getFromCache=function(a){return this._f[a]=this._f[a]||{}};f.getObject=function(a){var b=this.getFromCache(a);if(b.obj!==undefined)return b.obj;var c=this._b,d=a.split('.'),e;while(e=d.shift())c=c&&c[e];return this.getFromCache(a).obj=c}})(JS.Package);JS.Package.DomLoader={usable:function(){return!!JS.Package.getObject('window.document.getElementsByTagName')},__FILE__:function(){var a=document.getElementsByTagName('script');return a[a.length-1].src},loadFile:function(c,d){var e=this,g=document.createElement('script');g.type='text/javascript';g.src=c;g.onload=g.onreadystatechange=function(){var a=g.readyState,b=g.status;if(!a||a==='loaded'||a==='complete'||(a===4&&b===200)){d();g.onload=g.onreadystatechange=e._g;g=null}};if(window.console&&console.info)console.info('Loading '+c);document.getElementsByTagName('head')[0].appendChild(g)},_g:function(){}};JS.Package.ServerLoader={usable:function(){return typeof JS.Package.getObject('load')==='function'&&typeof JS.Package.getObject('version')==='function'},setup:function(){var b=this;load=(function(a){return function(){b._h=arguments[0];return a.apply(JS.Package._b,arguments)}})(load)},__FILE__:function(){return this._h},loadFile:function(a,b){load(a);b()}};(function(){var a=[JS.Package.DomLoader,JS.Package.ServerLoader],b=a.length,c,d;for(c=0;c<b;c++){d=a[c];if(d.usable()){JS.Package.Loader=d;if(d.setup)d.setup();break}}})();JS.Package.DSL={__FILE__:function(){return JS.Package.Loader.__FILE__()},pkg:function(a,b){var c=b?JS.Package.getByPath(b):JS.Package.getByName(a);c.addName(a);return new JS.Package.Description(c)},file:function(a){var b=JS.Package.getByPath(a);return new JS.Package.Description(b)},load:function(a,b){JS.Package.Loader.loadFile(a,b)}};JS.Package.Description=function(a){this._7=a};(function(e){e._8=function(a,b){var c=b.length,a=this._7[a],d;for(d=0;d<c;d++)a.call(this._7,b[d]);return this};e.provides=function(){return this._8('addName',arguments)};e.requires=function(){return this._8('addDependency',arguments)};e.uses=function(){return this._8('addSoftDependency',arguments)};e.setup=function(a){this._7.onload(a);return this}})(JS.Package.Description.prototype);JS.Package.DSL.loader=JS.Package.DSL.file;JS.Packages=function(a){a.call(JS.Package.DSL)};JS.require=function(){var a=[],b=0;while(typeof arguments[b]==='string'){a.push(arguments[b]);b+=1}JS.Package.when({complete:a},arguments[b],arguments[b+1])};require=JS.require;

data/lib/public/style.css

@@ -0,0 +1,44 @@
+body {
+  background:   #222;
+  margin:       0;
+  padding:      40px;
+}
+
+.container {
+  background:   #fff;
+  color:        #444;
+  margin:       0 auto;
+  padding:      40px;
+  width:        400px;
+  font:         16px/1.5 Georgia, Times New Roman, serif;
+}
+
+.footer {
+  margin:       0 auto;
+  padding:      40px;
+  width:        400px;
+  color:        #fff;
+  font:         13px Helvetica, Arial, sans-serif;
+}
+
+h1 {
+  font:         bold 64px Helvetica, Arial, sans-serif;
+  letter-spacing: -0.03em;
+  margin:       0 0 32px;
+  color:        #f00846;
+}
+
+a {
+  color:        #f00846;
+  text-decoration: none;
+}
+
+a:hover {
+  background:   #f00846;
+  color:        #fff;
+}
+
+p {
+  margin:       0;
+}
+

data/lib/public/terminus.js

@@ -0,0 +1,15 @@
+Terminus = {
+  connect: function(endpoint) {
+    if (this._client) return;
+    
+    this._client = new Faye.Client(endpoint);
+    this._client.subscribe('/terminus/commands', function(message) {
+      this.execute(message.command);
+    }, this);
+  },
+  
+  execute: function(command) {
+    eval(command);
+  }
+};
+

data/lib/terminus.rb

@@ -0,0 +1,23 @@
+require 'rubygems'
+require 'rack'
+require 'thin'
+require 'eventmachine'
+require 'faye'
+require 'sinatra'
+require 'packr'
+
+%w[application server].each do |file|
+  require File.join(File.dirname(__FILE__), 'terminus', file)
+end
+
+Thin::Logging.silent = true
+
+module Terminus
+  VERSION    = '0.1.0'
+  FAYE_MOUNT = '/messaging'
+  
+  def self.create(options = {})
+    Server.new(options)
+  end
+end
+

data/lib/terminus/application.rb

@@ -0,0 +1,24 @@
+module Terminus
+  class Application < Sinatra::Base
+    
+    ROOT = File.expand_path(File.dirname(__FILE__) + '/../')
+    
+    set :static, true
+    set :public, ROOT + '/public'
+    set :views,  ROOT + '/views'
+    
+    helpers do
+      def host
+        "http://#{ env['HTTP_HOST'] }"
+      end
+      
+      def bookmarklet
+        Packr.pack(erb(:bookmarklet), :shrink_vars => true)
+      end
+    end
+    
+    get('/') { erb :index }
+    
+  end
+end
+

data/lib/terminus/server.rb

@@ -0,0 +1,48 @@
+module Terminus
+  class Server
+    
+    def initialize(options = {})
+      @options = options
+    end
+    
+    def execute(script, &callback)
+      messenger.publish('/terminus/commands', :command => script)
+    end
+    
+    def running?
+      not @server.nil?
+    end
+    
+    def run!
+      return if running?
+      handler = Rack::Handler.get('thin')
+      ensure_reactor_running!
+      handler.run(app, :Port => @options[:port]) { |s| @server = s }
+    end
+    
+    def stop!
+      return unless running?
+      @server.stop!
+      @server = nil
+    end
+    
+  private
+    
+    def app
+      return @app if defined?(@app)
+      frontend = Application.new
+      @app = Faye::RackAdapter.new(frontend, :mount => FAYE_MOUNT, :timeout => 15)
+    end
+    
+    def messenger
+      app.get_client
+    end
+    
+    def ensure_reactor_running!
+      Thread.new { EM.run unless EM.reactor_running? }
+      while not EM.reactor_running?; end
+    end
+    
+  end
+end
+

data/lib/views/bookmarklet.erb

@@ -0,0 +1,40 @@
+(function() {
+  var faye = '<%= ::Terminus::FAYE_MOUNT %>',
+      host = '<%= host %>';
+  
+  var withPackageManager = function(callback) {
+    if (window.JS && JS.Packages) return callback();
+    
+    var script = document.createElement('script'),
+        head   = document.getElementsByTagName('head')[0];
+    
+    script.type = 'text/javascript';
+    script.src  = host + '/js.packages.js';
+    
+    script.onload = script.onreadystatechange = function() {
+      var state = script.readyState;
+      if (!state || state === 'loaded' || state === 'complete') {
+        script.onload = script.onreadystatechange = null;
+        head.removeChild(script);
+        callback();
+      }
+    };
+    head.appendChild(script);
+  };
+  
+  withPackageManager(function() {
+    JS.Packages(function() {
+      this.file(host + faye + '/client.js')
+        .provides('Faye', 'Faye.Client');
+      
+      this.file(host + '/terminus.js')
+        .requires('Faye.Client')
+        .provides('Terminus');
+    });
+    
+    require('Terminus', function() {
+      Terminus.connect(host + faye);
+    });
+  });
+})();
+

data/lib/views/index.erb

@@ -0,0 +1,29 @@
+<!doctype html>
+
+<html>
+  <head>
+    <meta http-equiv="content-type" content="text/html; charset=utf-8">
+    <link rel="stylesheet" type="text/css" href="/style.css">
+    <title>Terminus</title>
+  </head>
+  <body>
+    
+    <div class="container">
+      <h1><a href="javascript:<%= bookmarklet %>">Terminus</a>.</h1>
+      
+      <p>Terminus is a distributed JavaScript console. You can find out
+        more at <a href="http://github.com/jcoglan/terminus">its GitHub page</a>.
+        To connect the console to your browser, you&rsquo;ll need this
+        bookmarklet. Just drag the word &lsquo;Terminus&rsquo; up to your
+        bookmark toolbar and click it to connect any page to your console.</p>
+    </div>
+    
+    <div class="footer">
+      <p>Copyright &copy; 2010
+      <a href="http://jcoglan.com">James Coglan</a>.
+      Released under the MIT license.</p>
+    </div>
+    
+  </body>
+</html>
+

metadata

@@ -0,0 +1,133 @@
+--- !ruby/object:Gem::Specification 
+name: terminus
+version: !ruby/object:Gem::Version 
+  version: 0.1.0
+platform: ruby
+authors: 
+- James Coglan
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-04-05 00:00:00 +01:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rack
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "1.0"
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: thin
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "1.2"
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: eventmachine
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0.12"
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: faye
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        version: 0.3.2
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: sinatra
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "1.0"
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: packr
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "3.1"
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: oyster
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0.9"
+    version: 
+description: 
+email: jcoglan@googlemail.com
+executables: 
+- terminus
+extensions: []
+
+extra_rdoc_files: 
+- README.rdoc
+files: 
+- README.rdoc
+- lib/terminus.rb
+- lib/public/style.css
+- lib/public/terminus.js
+- lib/public/js.packages.js
+- lib/views/bookmarklet.erb
+- lib/views/index.erb
+- lib/terminus/server.rb
+- lib/terminus/application.rb
+has_rdoc: true
+homepage: http://github.com/jcoglan/terminus
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --main
+- README.rdoc
+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.5
+signing_key: 
+specification_version: 3
+summary: Control multiple web browsers from the command line
+test_files: []
+