muto 0.0.1

data/Gemfile

@@ -0,0 +1,4 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in muto.gemspec
+gemspec

data/README.textile

@@ -0,0 +1,133 @@
+h1. Overview
+
+Muto is a lightweight little ruby/vbs/bat script that will allow you switch to another version of Ruby while also allowing you to alter Windows Environment
+variables at the same time. You can do this with Muto without having to reload your command prompt/shell and all gem paths associated with the chosen
+version of ruby are automatically updated as you switch versions.
+
+h2. Why I put this together..
+
+Firstly, I'm not trying to take anything from Pik, check it out first if you haven't already, there's a thousand things you can do with it and it might be
+better suited to what your needs are: https://github.com/vertiginous/pik
+
+I put Muto together because I needed to also frequently change a few environment variables every time I changed my version of ruby and I just got sick
+of having to do it all the time and then having to reload my command prompt as well just to pick up the changes. Also I needed to be able to switch
+ruby versions and persist the change to another version of Ruby across my entire Windows environment.
+
+h2. Example Usage
+
+<pre>
+#From the command line
+
+muto
+=>Expected format:  muto [ruby_version]
+=>
+=>Available Versions are:
+=>  186  ruby 1.8.6 (2007-09-24 patchlevel 111) [i386-mswin32]
+=>  192  ruby 1.9.2p180 (2011-02-18) [i386-mingw32]
+=>
+=>Currently using:
+=>ruby 1.8.6 (2007-09-24 patchlevel 111) [i386-mswin32]
+
+ruby -v
+=>ruby 1.8.6 (2007-09-24 patchlevel 111) [i386-mswin32]
+
+muto 192
+=>System updated. Now using:
+=>ruby 1.9.2p180 (2011-02-18) [i386-mingw32]
+
+ruby -v
+=>ruby 1.9.2p180 (2011-02-18) [i386-mingw32]
+</pre>
+
+h2. How Muto works..
+
+Muto works by using an executable .bat file to call a ruby script which will alter your systems environment variables and send an environment changed
+signal to your Windows environment. It'll then finish by calling a basic vb script to update the shell you're working in so that you won't need to
+restart your command prompt.
+
+The actual muto gem is not really a gem at all.. It's just basically a wrapper to help copy the muto scripts to your machine somewhere.
+
+
+h2. Setup/Config
+
+Use a normal Windows MRI version of Ruby to install Muto.
+<pre>gem install muto</pre>
+
+From the command line, change into a directory where you want to keep the scripts and run: extract_muto
+
+<pre>cd c:\
+extract_muto
+#=>Extracting to C:\Muto
+#=>Generating C:\Muto\muto.rb
+#=>Generating C:\Muto\reset_command_line.vbs
+#=>Generating C:\Muto\ruby_versions.yml
+#=>Writing C:\Muto\muto.bat file..
+#=>
+#=>Add Ruby versions to your C:\Muto\ruby_versions.yml"
+#=>Then add C:\Muto to your Windows PATH environment variable and you're good to go
+</pre>
+
+
+h3. ruby_versions.yml
+
+As well as being able to switch to other versions of Ruby in your Windows environment, you can also define other User Environment Variables to change at
+the same time. Muto switches versions of Ruby by just regex-ing out the ruby bin folder out of your Windows PATH variable and replacing it with the new
+version you choose. This way none of the other paths in your environments PATH variable are altered.
+
+The User Environment Variables are set completely differently! The values you give them are the full values used to define the variable so if there is an
+existing variable already defined in your User Environment variables then it will be overwritten with the new value.
+
+<pre>
+# ruby_versions.yml example
+
+ruby_versions:
+  ruby_186:
+    shortcut: 186
+    bin_folder: C:\ruby\bin
+  ruby_192:
+    shortcut: 192
+    bin_folder: C:\ruby192\bin
+
+  jruby_164_jre6:
+    shortcut: jr_j6
+    bin_folder: C:\jruby-1.6.4\bin
+    exe_name: jruby.exe
+    user_env_variables:
+      java_home: C:\Program Files\Java\jre6
+  jruby_164_jre7:
+    shortcut: jr_j7
+    bin_folder: C:\jruby-1.6.4\bin
+    exe_name: jruby.exe
+    user_env_variables:
+      java_home: C:\Program Files\Java\jre7
+
+</pre>
+
+
+h2. License
+
+MIT License
+
+Copyright (C) 2011 by Lucas Hills
+
+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/Rakefile

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

data/bin/extract_muto

@@ -0,0 +1,77 @@
+#!/usr/bin/env ruby
+
+require 'fileutils'
+require 'rbconfig'
+
+#
+# The following script will just extract the contents of the deploy_scripts directory somewhere onto the users
+# machine. The directory where the scripts are extracted to should be added to your Windows PATH environment variable
+# to add the muto command to the command line
+#
+# Usage: extract_muto
+#
+
+class Muto
+
+  def self.deploy
+    begin
+      muto_root_dir = File.expand_path(File.join(Dir.pwd, 'Muto'))
+      puts "Extracting to #{muto_root_dir.to_s.gsub(/\//, '\\')}"
+      FileUtils.mkdir_p(muto_root_dir) unless File.directory?(muto_root_dir)
+
+      template_dir = File.expand_path(File.join(File.dirname(__FILE__), "/../lib/deploy_scripts"))
+      templates = File.join(template_dir, "/**/*")
+
+      Dir[templates].each do |source|
+
+        next if source.match(/muto.bat\z/) #ignore muto.bat here, going to write it next
+
+        destination = File.join(muto_root_dir, source.gsub(/^.*\/deploy_scripts/, ''))
+        if File.exist?(destination) || (File.directory? destination)
+          puts "Skipping #{destination.to_s.gsub(/\//, '\\')} because it already exists"
+        else
+          puts "Generating #{destination.to_s.gsub(/\//, '\\')}"
+          File.directory?(source) ? FileUtils.mkdir(destination) : FileUtils.cp(source, destination)
+        end
+      end
+
+      ruby = File.join(Config::CONFIG['bindir'], Config::CONFIG['ruby_install_name'])
+      ruby << Config::CONFIG['EXEEXT']
+
+      # The muto.bat script needs to have a hardcoded fullpath to a Ruby.exe so that it can function
+      # independently from the version of ruby installed on your system. The following few lines just
+      # amend the muto.bat script to use the fullpath of the version of ruby that you've used to extract
+      # the muto scripts
+
+      orig = File.open(File.expand_path(File.join(File.dirname(__FILE__), "/../lib/deploy_scripts", "muto.bat")))
+      dest = File.new(File.expand_path(File.join(muto_root_dir, "muto.bat")), "w")
+
+      puts "Writing #{dest.path.to_s.gsub(/\//, '\\')} file.."
+      begin
+          while (line = orig.readline)
+              dest.puts line.gsub(/C:\\ruby\\bin\\ruby.exe/, ruby)
+          end
+      rescue EOFError
+          orig.close
+          dest.close
+      end
+
+      puts "\nAdd Ruby versions to your #{muto_root_dir.to_s.gsub(/\//, '\\')}\\ruby_versions.yml"
+      puts "Then add #{muto_root_dir.to_s.gsub(/\//, '\\')} to your Windows PATH environment variable and you're good to go"
+
+    rescue
+      puts $!, $!.backtrace
+      puts "Installation failed"
+    end
+  end
+
+end
+
+
+if RUBY_PLATFORM =~ /(:?mswin|mingw)/
+  Muto.deploy
+else
+  puts "Muto will only work properly if extracted using a Windows MRI version of Ruby"
+  puts "mswin or mingw versions should work fine"
+end
+

data/lib/deploy_scripts/muto.bat

@@ -0,0 +1,22 @@
+@ECHO OFF
+
+
+
+C:\ruby\bin\ruby.exe %~dp0\muto.rb %* 2> NUL
+
+
+:: The following 2 lines allow you to not have to reset your command line in order to pick up
+:: the new Environment Variables
+
+reset_command_line.vbs
+call "%TEMP%\reset_command_line.bat"
+
+
+
+:: The end of this script just outputs the now current version of Ruby being used by your system
+:: Using 2> NUL just means that if the ruby/jruby command doesn't exist, the error message won't be output
+:: to the command line.
+:: TODO - need to add support for all Ruby executables here
+
+@ruby -v 2> NUL
+@jruby -v 2> NUL

data/lib/deploy_scripts/muto.rb

@@ -0,0 +1,138 @@
+
+begin; require 'rubygems'; rescue; end
+require 'win32/registry'
+require 'Win32API'
+require 'yaml'
+
+HWND_BROADCAST = 0xffff
+WM_SETTINGCHANGE = 0x001A
+SMTO_ABORTIFHUNG = 2
+
+class Muto
+
+  def initialize
+    @commands = []
+    @ruby_versions = []
+    @all_bin_paths = []
+
+    @versions_yml = YAML.load(IO.read(File.join(File.dirname(__FILE__), 'ruby_versions.yml')))
+
+    if @versions_yml['ruby_versions'].nil?
+      puts "There aren't any version of Ruby defined in your ruby_versions.yml yet"
+      puts "Update #{File.expand_path(File.join(File.dirname(__FILE__), "ruby_versions.yml")).to_s.gsub(/\//, '\\')} first and try again"
+      puts "\nCurrently using:"
+      exit!
+    else
+
+      @versions_yml['ruby_versions'].each do |key, val|
+        @ruby_versions << @versions_yml['ruby_versions'][key]['shortcut'].to_s
+        @all_bin_paths << @versions_yml['ruby_versions'][key]['bin_folder']
+
+        begin
+          exe_name = (@versions_yml['ruby_versions'][key]['exe_name']) ? @versions_yml['ruby_versions'][key]['exe_name'] : 'ruby.exe'
+          ruby_exe = File.expand_path(File.join(@versions_yml['ruby_versions'][key]['bin_folder'], exe_name))
+          ruby_version = `"#{ruby_exe}" -v`
+
+          if File.exist?(ruby_exe)
+            add_version(:"#{@versions_yml['ruby_versions'][key]['shortcut'].to_s}", ruby_version)
+          else
+            puts "File does not exist: #{ruby_exe.to_s}"
+          end
+
+        rescue
+          puts "Error: File does not exist: #{ruby_exe.to_s}"
+        end
+
+      end
+
+
+    end
+
+  end
+
+  def add_version(name, description, hidden=false)
+    @commands << { :name => name, :desc => description, :hidden => hidden }
+  end
+
+  def run
+    if ARGV.empty?
+      help
+    else
+      begin
+        version = ARGV.shift.to_s
+      rescue
+        puts "Unknown Version"
+        help
+      end
+
+      if @ruby_versions.include?(version)
+        @versions_yml['ruby_versions'].each do |key, val|
+          update_user_path_variable(key.to_s) if @versions_yml['ruby_versions'][key]['shortcut'].to_s == version
+        end
+      else
+        puts "Unknown Version"
+        help
+      end
+    end
+  end
+
+  def help
+    puts "\nExpected format:  muto [ruby_version]"
+    puts "\nAvailable Versions are:"
+    @commands.each do |command|
+      puts "   #{command[:name]} \t - #{command[:desc]}" unless command[:hidden]
+    end
+
+    # The bat file muto.bat will always output the current version of Ruby being
+    # used by your system, so just adding this to make it read nice
+    puts "\nCurrently using:"
+  end
+
+
+  def broadcast_WM_SETTINGCHANGE_signal
+    # After setting a new environment variable, a 'WM_SETTINGCHANGE' signal needs to be broadcast to windows
+    # so that you won't need to log off and log back on again for the new settings to be propagated.
+    # The following uses the Win32API module to send the signal
+    #
+    # For more info read up here: http://msdn.microsoft.com/en-us/library/windows/desktop/ms725497%28v=vs.85%29.aspx
+    #
+
+    call_timeout_function = Win32API.new('user32', 'SendMessageTimeout', 'LLLPLLP', 'L')
+    result = 0
+    call_timeout_function.call(HWND_BROADCAST, WM_SETTINGCHANGE, 0, 'Environment', SMTO_ABORTIFHUNG, 5000, result)
+
+
+    # The muto.bat script will finish up by outputting the current version or Ruby being used on your system
+    # This next line is just sugar
+    puts "\nSystem updated. Now using:"
+  end
+
+  def update_user_path_variable(versions_yml_key)
+    reg_key, path_env_var = Win32::Registry::HKEY_CURRENT_USER.open('Environment').read('PATH')
+
+    #TODO - Fix regex to support all variants of path names
+    @all_bin_paths.each do |bin_path|
+      path_env_var.gsub!(bin_path, @versions_yml['ruby_versions'][versions_yml_key]['bin_folder'].to_s)
+    end
+
+    Win32::Registry::HKEY_CURRENT_USER.open('Environment', Win32::Registry::KEY_WRITE) do |reg|
+      reg['PATH'] = path_env_var
+    end
+
+    if @versions_yml['ruby_versions'][versions_yml_key]['user_env_variables']
+      @versions_yml['ruby_versions'][versions_yml_key]['user_env_variables'].each do |key, val|
+        Win32::Registry::HKEY_CURRENT_USER.open('Environment', Win32::Registry::KEY_WRITE) do |reg|
+          reg[key.upcase] = val
+        end
+      end
+    end
+
+    broadcast_WM_SETTINGCHANGE_signal
+
+  end
+end
+
+if __FILE__ == $0
+  s = Muto.new
+  s.run
+end

data/lib/deploy_scripts/reset_command_line.vbs

@@ -0,0 +1,23 @@
+
+Set oShell = WScript.CreateObject("WScript.Shell")
+filename = oShell.ExpandEnvironmentStrings("%TEMP%\reset_command_line.bat")
+Set objFileSystem = CreateObject("Scripting.fileSystemObject")
+Set oFile = objFileSystem.CreateTextFile(filename, TRUE)
+
+'Grab System Environment variables'
+    set oEnv=oShell.Environment("System")
+    for each sitem in oEnv
+        oFile.WriteLine("SET " & sitem)
+    next
+    path = oEnv("PATH")
+
+'Grab User Environment variables'
+    set oEnv=oShell.Environment("User")
+    for each sitem in oEnv
+        oFile.WriteLine("SET " & sitem)
+    next
+
+'Output to Global PATH variable'
+    path = path & ";" & oEnv("PATH")
+    oFile.WriteLine("SET PATH=" & path)
+    oFile.Close

data/lib/deploy_scripts/ruby_versions.yml

@@ -0,0 +1,19 @@
+ruby_versions:
+#  ruby_186:
+#    shortcut: 186
+#    bin_folder: C:\ruby\bin
+#  ruby_192:
+#    shortcut: 192
+#    bin_folder: C:\ruby192\bin
+#  jruby_164_jre6:
+#    shortcut: jr_j6
+#    bin_folder: C:\jruby-1.6.4\bin
+#    exe_name: jruby.exe
+#    user_env_variables:
+#      java_home: C:\Program Files\Java\jre6
+#  jruby_164_jre7:
+#    shortcut: jr_j7
+#    bin_folder: C:\jruby-1.6.4\bin
+#    exe_name: jruby.exe
+#    user_env_variables:
+#      java_home: C:\Program Files\Java\jre7

data/lib/muto/version.rb

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

data/lib/muto.rb

@@ -0,0 +1,4 @@
+require "muto/version"
+
+module Muto
+end

data/muto.gemspec

@@ -0,0 +1,34 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "muto/version"
+
+Gem::Specification.new do |s|
+  s.name        = "muto"
+  s.version     = Muto::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ["Lucas Hills"]
+  s.email       = ["lucas@lucashills.com"]
+  s.homepage    = 'https://github.com/2potatocakes/muto'
+  s.summary     = 'I got sick of manually having to change windows environment variables and versions of ruby in the control panel'
+  s.description = 'Set up different Windows Ruby environments and switch between them on the command line'
+
+  s.files       = %w(Rakefile Gemfile README.textile muto.gemspec) + Dir.glob("{bin,lib}/**/*")
+  s.bindir      = 'bin'
+  s.executables = %w(extract_muto)
+  s.post_install_message = %q{
+========================================================================
+Muto installed!
+------------------------------------------------------------------------
+This gem is basically just a wrapper to make deployment easier. Delete
+the gem after you've deployed the scripts if you want. To extract the
+scripts, cd into a directory where you'd like to keep them and from the
+command line run:
+
+extract_muto
+
+========================================================================
+}
+
+  s.require_paths = ['lib']
+  s.extra_rdoc_files = ['README.textile']
+end

metadata

@@ -0,0 +1,82 @@
+--- !ruby/object:Gem::Specification
+name: muto
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Lucas Hills
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2011-09-24 00:00:00.000000000Z
+dependencies: []
+description: Set up different Windows Ruby environments and switch between them on
+  the command line
+email:
+- lucas@lucashills.com
+executables:
+- extract_muto
+extensions: []
+extra_rdoc_files:
+- README.textile
+files:
+- Rakefile
+- Gemfile
+- README.textile
+- muto.gemspec
+- bin/extract_muto
+- lib/deploy_scripts/muto.bat
+- lib/deploy_scripts/muto.rb
+- lib/deploy_scripts/reset_command_line.vbs
+- lib/deploy_scripts/ruby_versions.yml
+- lib/muto/version.rb
+- lib/muto.rb
+homepage: https://github.com/2potatocakes/muto
+licenses: []
+post_install_message: ! '
+
+  ========================================================================
+
+  Muto installed!
+
+  ------------------------------------------------------------------------
+
+  This gem is basically just a wrapper to make deployment easier. Delete
+
+  the gem after you''ve deployed the scripts if you want. To extract the
+
+  scripts, cd into a directory where you''d like to keep them and from the
+
+  command line run:
+
+
+  extract_muto
+
+
+  ========================================================================
+
+'
+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.5
+signing_key: 
+specification_version: 3
+summary: I got sick of manually having to change windows environment variables and
+  versions of ruby in the control panel
+test_files: []