terminal_multiplexer 0.0.1

data/.gitignore

@@ -0,0 +1,6 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*
+*.s??
+.rvmrc

data/Gemfile

@@ -0,0 +1,15 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in terminal-multiplexer.gemspec
+gemspec
+
+group :development do
+  gem 'rspec'
+  gem 'guard' #, '0.8.8'
+  gem 'guard-rspec'
+  gem 'pry'
+  gem 'libnotify'
+  gem 'rb-inotify'
+  gem 'rb-readline'
+  gem 'fuubar'
+end

data/Guardfile

@@ -0,0 +1,11 @@
+# A sample Guardfile
+# More info at https://github.com/guard/guard#readme
+
+guard 'rspec', 
+  :version => 2 ,
+  :cli => '--color --format Fuubar' do
+  watch(%r{^spec/.+_spec\.rb$})
+  watch(%r{^lib/(.+)\.rb$})     { |m| "spec/lib/#{m[1]}_spec.rb" }
+  watch('spec/spec_helper.rb')  { "spec" }
+end
+

data/README.md

@@ -0,0 +1,56 @@
+terminal-multiplexer (3)  -- easy to use wrapper for tmux
+=========================================================
+
+## DESCRIPTION
+
+This is a wrapper for tmux to integrate easily in one's development workflow. 
+
+You should configure tmux via its config-file ".tmux.conf". You could use this
+library to create sessions and windows in that sessions.
+
+## SYNOPSIS
+
+```bash
+#require lib
+require 'terminal-multiplexer'
+#create new instance
+tmux = Terminal::Multiplexer.new
+#create new session to hold all windows
+tmux.new_session
+tmux.new_session('window_name','command')
+#create new window
+tmux.new_window
+tmux.new_window('window_name','command')
+#start tmux
+tmux.start
+``` 
+
+## INSTALL
+
+* `Packaged:`
+
+```bash
+gem install terminal_multiplexer
+```
+
+* `Source code:`
+
+```bash
+git clone https://github.com/maxmeyer/terminal_multiplexer.git
+cd terminal_multiplexer
+rake build
+gem install pkg/terminal_multiplexer-xxxx
+```
+
+## EXAMPLES
+
+Please see "doc/examples/" for example scripts.
+
+## FURTHER READING
+
+* http://tmux.sourceforge.net
+
+
+## LICENSE
+
+(c) 2012-, All rights reserved, Max Meyer

data/Rakefile

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

data/doc/examples/tmux_wrapper-thor.rb

@@ -0,0 +1,19 @@
+#!/usr/bin/env ruby
+
+require 'thor'
+require 'terminal-multiplexer'
+
+class Default < Thor
+  desc "work" , "Start working environment"
+  def work
+    tmux = Terminal::Multiplexer.new
+    tmux.new_session
+    tmux.new_window
+    tmux.new_window
+    tmux.new_window
+    tmux.new_window('tests', 'guard')
+    tmux.start
+  end
+end
+
+Default.start

data/doc/examples/tmux_wrapper.rb

@@ -0,0 +1,8 @@
+#!/usr/bin/env ruby
+
+require 'terminal-multiplexer'
+
+tmux = Terminal::Multiplexer.new
+tmux.new_session
+tmux.new_window
+tmux.start

data/env

@@ -0,0 +1,19 @@
+#!/usr/bin/env ruby
+
+require 'thor'
+require 'terminal-multiplexer'
+
+class Default < Thor
+  desc "work" , "Start working environment"
+  def work
+    tmux = Terminal::Multiplexer.new
+    tmux.new_session
+    tmux.new_window
+    tmux.new_window
+    tmux.new_window
+    tmux.new_window('tests', 'guard')
+    tmux.start
+  end
+end
+
+Default.start

data/lib/terminal-multiplexer/exceptions.rb

@@ -0,0 +1,11 @@
+module Terminal
+  module Exceptions
+
+    class SessionNotFound < Exception
+    end
+
+    class DuplicateSessionIdentifier < Exception
+    end
+
+  end
+end

data/lib/terminal-multiplexer/session.rb

@@ -0,0 +1,50 @@
+module Terminal
+  class Session
+    attr_reader :name, :command
+    attr_accessor :active_window
+
+    def initialize(name = 'default', command = 'zsh')
+
+      name = 'default' if name == nil  or name == ''
+      command = 'zsh' if command == nil  or command == ''
+
+      @name = name
+      @command = command
+      @windows = []
+      @active_window = 1
+    end
+
+    def plain
+      w_defs ||= build_window_string
+      w_opts ||= build_window_options
+
+      "new-session #{w_opts} #{command}\\;#{w_defs}"
+    end
+
+    private
+
+    def build_window_options
+      "-n #{name}"
+    end
+
+
+    def build_window_string
+      w_str = ''
+
+      if @windows.count > 0 
+        w_str += ' '
+        w_str += @windows.collect{|w| w.plain}.join(' ')
+      end
+
+      w_str += " select-window -t:+#{active_window}\\;"
+
+    end
+
+    public
+
+    def add_window(window)
+      @windows << window
+    end
+
+  end
+end

data/lib/terminal-multiplexer/version.rb

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

data/lib/terminal-multiplexer/window.rb

@@ -0,0 +1,20 @@
+module Terminal
+  class Window
+    attr_accessor :name, :command
+
+    def initialize(name = 'tab', command = 'zsh')
+
+      name = 'tab' if name == nil  or name == ''
+      command = 'zsh' if command == nil  or command == ''
+
+      @name = name
+      @command = command
+      @options = []
+    end
+
+    def plain
+      @options.push "-n #{name}"
+      "new-window #{@options.join(' ')} #{command}\\;"
+    end
+  end
+end

data/lib/terminal-multiplexer.rb

@@ -0,0 +1,61 @@
+require 'terminal-multiplexer/version'
+require 'terminal-multiplexer/window'
+require 'terminal-multiplexer/session'
+require 'terminal-multiplexer/exceptions'
+
+require 'highline/import'
+
+module Terminal
+  class Multiplexer 
+    include Exceptions
+
+
+    def initialize(*options)
+#      @options = {
+#        :default_cmd => 'zsh'
+#      }.update options
+#
+      @sessions = []
+    end
+
+    def new_session(name='default', command='zsh')
+      if @sessions.find { |s| s.name == name }
+        raise DuplicateSessionIdentifier , "Please do not reuse the session identifier. You used \"#{name}\" at least twice."
+      end
+
+      session = Session.new(name, command)
+      @sessions <<  session
+      session
+    end
+
+    def new_window(name='tab', command='zsh', session_name='default')
+      session = @sessions.find { |s| s.name == session_name }
+
+
+      if session == nil
+        say "Warning: No valid session found. Create a default one"
+        session = new_session
+      end
+      
+      session.add_window Window.new( name , command )
+
+    end
+    
+    private
+
+    def build_multiplexer_command_string
+      m_str = @sessions.collect{ |s| s.plain}.join(' ')
+      m_str
+    end
+
+    public
+
+    def start(process_info={})
+
+      process_info[:cmd] = 'tmux'
+      process_info[:status] = system("#{process_info[:cmd]} #{build_multiplexer_command_string}") 
+
+    end
+
+  end
+end

data/spec/session/session_spec.rb

@@ -0,0 +1,66 @@
+require 'spec_helper'
+
+module Terminal
+  describe Session do
+    let(:sess) { Session.new }
+
+    describe "run with rubbish options" do
+      let(:sess) { Session.new(nil,nil) }
+
+      it "has a name" do
+        sess.name.should == 'default'
+      end
+
+      it " has a command associated with it" do
+        sess.command.should == 'zsh'
+      end
+    end
+
+    describe "run with no option" do
+
+      it "has a name" do
+        sess.name.should == 'default'
+      end
+
+      it " has a command associated with it" do
+        sess.command.should == 'zsh'
+      end
+    end
+
+    describe "run with option" do
+      let(:sess) { Session.new('session','ksh') }
+
+      it "has a name" do
+        sess.name.should == 'session'
+      end
+
+      it "has a command associated with it" do
+        sess.command.should == 'ksh'
+      end
+    end
+
+    describe "#plain" do
+      it "returns the correct tmux string" do
+        sess.plain.should == "new-session -n default zsh\\; select-window -t:+1\\;" 
+      end
+    end
+
+    describe "#add_window" do
+      before :each do
+        @win = double('window')
+        @win.should_receive(:plain).and_return('new-window -n tab zsh\\;')
+      end
+
+      it "returns the correct tmux string" do
+        sess.add_window(@win)
+        sess.plain.should == "new-session -n default zsh\\; new-window -n tab zsh\\; select-window -t:+1\\;" 
+      end
+    end
+
+    describe "#active_window" do
+      it "sets the active window after creation of session and windows" do
+        sess.active_window(2)
+      end
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,4 @@
+$LOAD_PATH << File.expand_path('../lib/terminal-multiplexer' , File.dirname(__FILE__))
+
+require 'terminal-multiplexer'
+require 'pry'

data/spec/terminal-multiplexer/terminal-multiplexer_spec.rb

@@ -0,0 +1,59 @@
+require 'spec_helper'
+
+module Terminal 
+  include Exceptions
+
+  describe Multiplexer do
+
+    describe "#new_session" do
+      let(:multi) { Multiplexer.new }
+
+      it "creates a new session with default name" do
+        multi.new_session
+        multi.send(:build_multiplexer_command_string).should == "new-session -n default zsh\\; select-window -t:+1\\;"
+      end
+
+      it "creates a new session with given name" do
+        multi.new_session('session1','ksh')
+        multi.send(:build_multiplexer_command_string).should == "new-session -n session1 ksh\\; select-window -t:+1\\;"
+      end
+
+      it "creates a string for all sessions created" do
+        multi.new_session
+        multi.new_session('session1','ksh')
+        multi.send(:build_multiplexer_command_string).should == "new-session -n default zsh\\; select-window -t:+1\\; new-session -n session1 ksh\\; select-window -t:+1\\;"
+      end
+
+      it "raises an exception if a session identifier is reused" do
+        lambda{ 
+          multi.new_session
+          multi.new_session
+        }.should raise_error DuplicateSessionIdentifier
+      end
+    end
+    
+    describe "#new_window" do
+      let(:multi) { Multiplexer.new }
+
+      it "creates a new window for the default session" do
+        multi.new_window
+        multi.send(:build_multiplexer_command_string).should == "new-session -n default zsh\\; new-window -n tab zsh\\;"
+      end
+      it "creates two session one with and one without a window if the session name doesn't match " do
+        multi.new_session('session1','ksh')
+        multi.new_window
+        multi.send(:build_multiplexer_command_string).should == "new-session -n session1 ksh\\; new-session -n default zsh\\; new-window -n tab zsh\\; select-window -t:+1\\;"
+      end
+
+      it "creates two session one with and one without a window if the session name doesn't match " do
+        multi.new_session
+        multi.new_window
+        multi.send(:build_multiplexer_command_string).should == "new-session -n default zsh\\; new-window -n tab zsh\\; select-window -t:+1\\;"
+      end
+
+      #it "creates a new window for a given session" do
+      #  multi.new_session
+      #end
+    end
+  end
+end

data/spec/window/window_spec.rb

@@ -0,0 +1,36 @@
+require 'spec_helper'
+
+module Terminal
+  describe Window do
+    let(:win) { Window.new }
+
+    describe "run with no option" do
+      it "has a name" do
+        win.name.should == 'tab'
+      end
+
+      it "has a command associated with it" do
+        win.command.should == 'zsh'
+      end
+    end
+
+    describe "run with option" do
+      let(:win) { Window.new('win','ksh') }
+
+      it "has a name" do
+        win.name.should == 'win'
+      end
+
+      it "has a command associated with it" do
+        win.command.should == 'ksh'
+      end
+    end
+
+    describe "#plain" do
+      it "returns the correct tmux string" do
+        win.plain.should == "new-window -n tab zsh\\;" 
+      end
+    end
+  end
+end
+

data/terminal_multiplexer.gemspec

@@ -0,0 +1,21 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "terminal-multiplexer/version"
+
+Gem::Specification.new do |s|
+  s.name        = "terminal_multiplexer"
+  s.version     = Terminal::VERSION
+  s.authors     = ["Max Meyer"]
+  s.email       = ["dev@fedux.org"]
+  s.homepage    = ""
+  s.summary     = %q{Building tmux sessions with ease}
+
+  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_runtime_dependency "highline"
+end

metadata

@@ -0,0 +1,78 @@
+--- !ruby/object:Gem::Specification
+name: terminal_multiplexer
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Max Meyer
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-01-04 00:00:00.000000000Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: highline
+  requirement: &13629420 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *13629420
+description: 
+email:
+- dev@fedux.org
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- Guardfile
+- README.md
+- Rakefile
+- doc/examples/tmux_wrapper-thor.rb
+- doc/examples/tmux_wrapper.rb
+- env
+- lib/terminal-multiplexer.rb
+- lib/terminal-multiplexer/exceptions.rb
+- lib/terminal-multiplexer/session.rb
+- lib/terminal-multiplexer/version.rb
+- lib/terminal-multiplexer/window.rb
+- spec/session/session_spec.rb
+- spec/spec_helper.rb
+- spec/terminal-multiplexer/terminal-multiplexer_spec.rb
+- spec/window/window_spec.rb
+- terminal_multiplexer.gemspec
+homepage: ''
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.6
+signing_key: 
+specification_version: 3
+summary: Building tmux sessions with ease
+test_files:
+- spec/session/session_spec.rb
+- spec/spec_helper.rb
+- spec/terminal-multiplexer/terminal-multiplexer_spec.rb
+- spec/window/window_spec.rb