lab419_tmux 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 1c863a86d859f3edec55d75620495a4981eea931
+  data.tar.gz: f31777265cc87f3050e33c643aed8d039ef65e82
+SHA512:
+  metadata.gz: f81f7ff65a0454d10e0e8ebec2f425d69c3b093c53fae6eb6e564927acae4d45c4636eafe1852c9e5692fa3c1591b6333785a29b0b3387e91a450bc5e46235f4
+  data.tar.gz: 3ab804f54412823cace789616122bd2837537d5befbe3f550b7afc5644d2d019266e80c976f0ff66e157113e9afee1f1f1c9d883d915152f0717e1e72e1ef5bc

data/LICENSE

@@ -0,0 +1,10 @@
+The MIT License (MIT)
+
+Copyright (c) 2012 Robert Dober
+
+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/README.md

@@ -0,0 +1,32 @@
+# Lab419, Programmers' Best Friend
+
+## Tmux
+
+Tmux needs Ruby 2.
+
+### Common Observations
+
+Unless otherwise stated all `lab419_*` commands implemented by this gem are determining a `session\_name` as the basename of 
+the first argument, which shall be an existing directory.
+
+In case a tmux session with the thusly determined `session_name` already exists the aforementioned script just attaches to the session with
+the `tmux attach` command. Otherwise a session with name `session_name` is created and windows and panes are created and configured as specified
+by the script in question and its parameters.
+
+
+### Predefined Scripts
+
+#### lab419\_tmux
+
+```
+  lab419_tmux some_path [windows: n]
+```
+
+Will open a session with n *additional* windows, each window will be cwed into `some_path`
+
+
+### Tmux::Command API
+
+This is inherited from my private, non TDD :@, driven project, only the script present in this release is protected by
+cucumber specs. The `Lab419::Tmux::Command` API will be speced and documented in later versions of this gem. This version serves
+as a useable tool but do not consider the API stable.

data/bin/lab419_tmux

@@ -0,0 +1,12 @@
+#!/usr/bin/env ruby
+
+require 'lab419/tmux/options'
+tmux_need_existing_dir
+
+require 'lab419/tmux/command'
+include Lab419::Tmux::Command
+
+tmux_new_session
+@options.windows.to_i.times do
+  tmux_new_window
+end

data/lib/lab419/tmux/command.rb

@@ -0,0 +1,123 @@
+require 'lab419/tmux/options/api'
+class Array
+  def mk_string *args, &blk
+    args = [' '] if args.empty?
+    compact.join( *args, &blk )
+  end
+end # class Array
+
+module Lab419
+  module Tmux
+    module Command
+      include Lab419::Tmux::Options::Api
+
+      def tmux cmd
+        if @options.dry_run
+          puts "tmux #{cmd}"
+        else
+          system "tmux #{cmd}"
+        end
+      end
+
+      def tmux_current_window
+        window = [@options.session_name, tmux_current_window_number].join(":")
+        "-t #{window}"
+      end
+
+      def tmux_current_window_command cmd, *args
+        args = args.compact
+        arguments = args.empty? ? "" : " #{args.join(" ")}"
+        tmux "#{cmd} #{tmux_current_window}#{arguments}"
+      end
+
+      def tmux_current_window_number
+        @__tmux_current_window_number__ ||= 0
+      end
+
+      def tmux_current_window_number= new_val
+        @__tmux_current_window_number__ = new_val
+      end
+
+      def tmux_execute_window_commands
+        ( @tmux_window_precommands || [] ).each do | blk |
+          blk.()
+        end
+      end
+
+      def tmux_increase_current_window_number by=1
+        self.tmux_current_window_number += by
+      end
+
+      # tmux new-session -s $session_name -n console -d
+      def tmux_new_session params=nil
+        if has_tmux_session?
+          tmux "attach -t #{@options.session_name}"
+          exit 0
+        end
+        suffix = params ? " #{params}" : ""
+        session_name = @options.session_name
+        tmux "new-session -s #{session_name} -d#{suffix}"
+        return if @options.no_source_file || @options.tmux_source_file.nil?
+        tmux "source-file #{@options.tmux_source_file}"
+        tmux "set-window-option -g automatic-rename off"
+        tmux_project_home
+        at_exit do
+          tmux "attach -t #{session_name}"
+        end
+      end
+
+      def tmux_new_window name=nil, dir=nil
+        tmux_increase_current_window_number
+        suffix = name ? %{ -n "#{name}"} : nil
+        tmux "new-window -t #{@options.session_name}#{suffix}"
+        tmux_set_window_options "automatic-rename off", "allow-rename off"
+        tmux_project_home dir
+        tmux_execute_window_commands
+      end
+
+      def tmux_open_vim options={}
+        dir = options.delete( :dir ){ "." }
+        tmux_send_keys "vi #{dir}"
+        options.each do | cmd, params |
+          command = ":#{[cmd,params].compact.join(" ")}"
+        tmux_send_keys command
+        end
+      end
+
+      def tmux_open_irb options={}
+        lib = options.delete( :lib ){ "./lib" }
+        tmux_send_keys "irb -I#{lib}"
+      end
+
+      def tmux_prefixed_command cmd, eol=true
+        tmux_send_keys [@options.cmd_prefix, cmd].mk_string, eol
+      end
+
+      def tmux_project_home dir=nil
+        dir = File.join @options.dir, dir if dir && %r{\A[^/]} === dir
+        tmux_send_keys "cd #{dir || @options.dir}" 
+      end
+
+      def tmux_register_window_command noexec=false, &blk
+        blk.() unless noexec
+        @tmux_window_precommands ||= []
+        @tmux_window_precommands << blk
+      end
+
+      def tmux_send_keys keys, eol=true
+        suffix = eol ? " C-m" : nil 
+        tmux_current_window_command "send-keys", %{"#{keys}"}, suffix
+      end
+
+      def tmux_set_window_option option
+        tmux_current_window_command "set-window-option", option
+      end
+
+      def tmux_set_window_options *options
+        options.each do | option |
+          tmux_set_window_option option
+        end
+      end
+    end
+  end
+end

data/lib/lab419/tmux/options.rb

@@ -0,0 +1,22 @@
+require 'ostruct'
+require 'lab419/tmux/options/api'
+include Lab419::Tmux::Options::Api
+
+@options = {}
+@options["dir"] = ARGV.first
+e = ARGV[1..-1]
+e = (e || []).enum_for(:each)
+loop do
+  case current = e.next
+  when /\A:(\w+)/
+    @options[$1] = true
+  when /(\w+):/
+    @options[$1] = e.next
+  else
+    raise ArgumentError, ele
+  end
+end
+
+@options = OpenStruct.new @options
+@options.session_name ||= @options.dir && File.basename( @options.dir )
+@options.tmux_source_file ||= "~/.tmux.conf"

data/lib/lab419/tmux/options/api.rb

@@ -0,0 +1,20 @@
+module Lab419
+  module Tmux
+    module Options
+      module Api
+        def has_tmux_session?
+          system "tmux has-session -t #{@options.session_name}"
+        end
+        def tmux_need_existing_dir
+          if !@options.dir
+            $stderr.puts "unable to determine session name"
+            exit -1
+          elsif !File.directory? @options.dir
+            $stderr.puts "no such directory #{@options.dir}"
+            exit -2
+          end
+        end
+      end
+    end
+  end
+end

data/lib/lab419/tmux/version.rb

@@ -0,0 +1,5 @@
+module Lab419
+  module Tmux
+    VERSION = "0.1.0"
+  end 
+end

metadata

@@ -0,0 +1,110 @@
+--- !ruby/object:Gem::Specification
+name: lab419_tmux
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Robert Dober
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-07-01 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.9.12
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.9.12
+- !ruby/object:Gem::Dependency
+  name: cucumber
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.3.2
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.3.2
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.13.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.13.0
+- !ruby/object:Gem::Dependency
+  name: aruba
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.5.3
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.5.3
+description: A Gem that will give us helpers to dry up the creation of TMUX windows
+  and panes, adding some predefind layouts which are a good starting point for the
+  usage of this gem
+email: robert.dober@gmail.com
+executables:
+- lab419_tmux
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/lab419/tmux.rb
+- lib/lab419/tmux/options/api.rb
+- lib/lab419/tmux/options.rb
+- lib/lab419/tmux/command.rb
+- lib/lab419/tmux/version.rb
+- LICENSE
+- README.md
+- bin/lab419_tmux
+homepage: https://github.com/RobertDober/lab419/tree/tmux-0.1.0/tmux
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: 2.0.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.0.3
+signing_key: 
+specification_version: 4
+summary: Creating Tmux Windows And Panes Without Pains
+test_files: []