rmate 1.5.1

data/README.mdown

@@ -0,0 +1,20 @@
+# rmate
+
+If you wish to activate TextMate from an ssh session you can do so by copying the `rmate` (ruby) script to the server you are logged into. The script will connect back to TextMate running on your Mac so you should setup an ssh tunnel (as your Mac is likely behind NAT):
+
+	ssh -R 52698:127.0.0.1:52698 «server»
+
+# Usage
+
+Call `rmate --help` for options. Default options can be set in `/etc/rmate.rc` or `~/.rmate.rc`, e.g.:
+
+	host: auto
+	port: 52698
+
+You can also set the `RMATE_HOST` and `RMATE_PORT` environment variables.
+
+For more info see this [blog post about rmate](http://blog.macromates.com/2011/mate-and-rmate/ "TextMate Blog » mate and rmate").
+
+# Ports
+
+- [Bash](https://github.com/aurora/rmate) by Harald Lapp

data/bin/rmate

@@ -0,0 +1,195 @@
+#!/usr/bin/env ruby
+# encoding: UTF-8
+
+$VERBOSE = true                         # -w
+$KCODE   = "U" if RUBY_VERSION < "1.9"  # -KU
+
+require 'optparse'
+require 'socket'
+require 'tempfile'
+require 'yaml'
+
+VERSION_STRING = 'rmate version 1.5 (2012-09-19)'
+
+class Settings
+  attr_accessor :host, :port, :wait, :force, :verbose, :lines, :names, :types
+
+  def initialize
+    @host, @port = 'localhost', 52698
+
+    @wait    = false
+    @force   = false
+    @verbose = false
+    @lines   = []
+    @names   = []
+    @types   = []
+
+    read_disk_settings
+
+    @host = ENV['RMATE_HOST'].to_s if ENV.has_key? 'RMATE_HOST'
+    @port = ENV['RMATE_PORT'].to_i if ENV.has_key? 'RMATE_PORT'
+
+    parse_cli_options
+
+    @host = parse_ssh_connection if @host == 'auto'
+  end
+
+  def read_disk_settings
+    [ "/etc/rmate.rc", "~/.rmate.rc"].each do |current_file|
+      file = File.expand_path current_file
+      if File.exist? file
+        params = YAML::load(File.open(file))
+        @host = params["host"] unless params["host"].nil?
+        @port = params["port"] unless params["port"].nil?
+      end
+    end
+  end
+
+  def parse_cli_options
+    OptionParser.new do |o|
+      o.on(           '--host=name',       "Connect to host.", "Use 'auto' to detect the host from SSH.", "Defaults to #{@host}.") { |v| @host    = v          }
+      o.on('-p',      '--port=#', Integer, "Port number to use for connection.", "Defaults to #{@port}.")                          { |v| @port    = v          }
+      o.on('-w',      '--[no-]wait',       'Wait for file to be closed by TextMate.')                                              { |v| @wait    = v          }
+      o.on('-l',      '--line [NUMBER]',   'Place caret on line [NUMBER] after loading file.')                                     { |v| @lines <<= v          }
+      o.on('-m',      '--name [NAME]',     'The display name shown in TextMate.')                                                  { |v| @names <<= v          }
+      o.on('-t',      '--type [TYPE]',     'Treat file as having [TYPE].')                                                         { |v| @types <<= v          }
+      o.on('-f',      '--force',           'Open even if the file is not writable.')                                               { |v| @force   = v          }
+      o.on('-v',      '--verbose',         'Verbose logging messages.')                                                            { |v| @verbose = v          }
+      o.on_tail('-h', '--help',            'Show this message.')                                                                   { puts o; exit              }
+      o.on_tail(      '--version',         'Show version.')                                                                        { puts VERSION_STRING; exit }
+      o.parse!
+    end
+  end
+
+  def parse_ssh_connection
+    ENV['SSH_CONNECTION'].nil? ? 'localhost' : ENV['SSH_CONNECTION'].split(' ').first
+  end
+end
+
+class Command
+   def initialize(name)
+     @command   = name
+     @variables = {}
+     @data      = nil
+     @size      = nil
+   end
+
+   def []=(name, value)
+     @variables[name] = value
+   end
+
+   def read_file(path)
+     @size = File.size(path)
+     @data = File.open(path, "rb") { |io| io.read(@size) }
+   end
+
+   def send(socket)
+     socket.puts @command
+     @variables.each_pair do |name, value|
+       value = 'yes' if value === true
+       socket.puts "#{name}: #{value}"
+     end
+     if @data
+       socket.puts "data: #{@size}"
+       socket.puts @data
+     end
+     socket.puts
+   end
+end
+
+def handle_save(socket, variables, data)
+  path = variables["token"]
+  $stderr.puts "Saving #{path}" if $settings.verbose
+  begin
+    backup_path = "#{path}~"
+    backup_path = "#{backup_path}~" while File.exists? backup_path
+    File.link(path, backup_path) if File.exist? path
+    Tempfile.open("rmate", File.dirname(path)) do |temp|
+      temp.close(false)
+      if File.exists?(path)
+        if stat = File.stat(path)
+          File.chown(stat.uid, stat.gid, temp.path)
+          File.chmod(stat.mode, temp.path)
+        end
+      end
+      open(temp.path, 'wb') {|file| file << data }
+      File.rename(temp.path, path)
+    end
+    File.unlink(backup_path) if File.exist? backup_path
+  rescue
+    # TODO We probably want some way to notify the server app that the save failed
+    $stderr.puts "Save failed! #{$!}" if $settings.verbose
+  end
+end
+
+def handle_close(socket, variables, data)
+  path = variables["token"]
+  $stderr.puts "Closed #{path}" if $settings.verbose
+end
+
+def handle_cmd(socket)
+  cmd = socket.readline.chomp
+
+  variables = {}
+  data = ""
+
+  while line = socket.readline.chomp
+    break if line.empty?
+    name, value     = line.split(': ', 2)
+    variables[name] = value
+    data << socket.read(value.to_i) if name == "data"
+  end
+  variables.delete("data")
+
+  case cmd
+  when "save"   then handle_save(socket, variables, data)
+  when "close"  then handle_close(socket, variables, data)
+  else          abort "Received unknown command “#{cmd}”, exiting."
+  end
+end
+
+def connect_and_handle_cmds(host, port, cmds)
+  socket = TCPSocket.new(host, port)
+  server_info = socket.readline.chomp
+  $stderr.puts "Connect: ‘#{server_info}’" if $settings.verbose
+
+  cmds.each { |cmd| cmd.send(socket) }
+
+  socket.puts "."
+  handle_cmd(socket) while !socket.eof?
+  socket.close
+  $stderr.puts "Done" if $settings.verbose
+end
+
+## MAIN
+
+$settings = Settings.new
+
+## Parse arguments.
+cmds = []
+ARGV.each_index do |idx|
+  path = ARGV[idx]
+  abort "File #{path} is not writable! Use -f/--force to open anyway." unless $settings.force or File.writable? path or not File.exists? path
+  $stderr.puts "File #{path} is not writable. Opening anyway." if not File.writable? path and File.exists? path and $settings.verbose
+  cmd                 = Command.new("open")
+  cmd['display-name'] = "#{Socket.gethostname}:#{path}"
+  cmd['display-name'] = $settings.names[idx] if $settings.names.length > idx
+  cmd['real-path']    = File.expand_path(path)
+  cmd['data-on-save'] = true
+  cmd['re-activate']  = true
+  cmd['token']        = path
+  cmd['selection']    = $settings.lines[idx] if $settings.lines.length > idx
+  cmd['file-type']    = $settings.types[idx] if $settings.types.length > idx
+  cmd.read_file(path)               if File.exist? path
+  cmd['data']         = "0"     unless File.exist? path
+  cmds << cmd
+end
+
+unless $settings.wait
+  pid = fork do
+    connect_and_handle_cmds($settings.host, $settings.port, cmds)
+  end
+  Process.detach(pid)
+else
+  connect_and_handle_cmds($settings.host, $settings.port, cmds)
+end

metadata

@@ -0,0 +1,71 @@
+--- !ruby/object:Gem::Specification 
+name: rmate
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 1
+  - 5
+  - 1
+  version: 1.5.1
+platform: ruby
+authors: 
+- Alex Ross
+- Allan Odgaard
+- "Ciar\xC3\xA1n Walsh"
+- James Edward Gray II
+- John St. John
+- Nicolas Ledez
+- OZAWA Sakuro
+- Timothy Andrew
+- Toby Butzon
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2013-03-16 00:00:00 +01:00
+default_executable: 
+dependencies: []
+
+description: This program can be used to edit text files in TextMate 2 running on your local Mac.
+email: rmate@textmate.org
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- bin/rmate
+- README.mdown
+has_rdoc: true
+homepage: https://github.com/textmate/rmate
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.6
+signing_key: 
+specification_version: 3
+summary: Proxy edits to a Mac running TextMate 2
+test_files: []
+