winrm 1.1.1 → 1.1.2

data/.gitignore

@@ -3,4 +3,5 @@
 pkg/*
 .rvmrc
 test/spec/creds*.json
-traces/
+test/config.yml
+traces/

data/README.md

@@ -0,0 +1,90 @@
+# Windows Remote Management (WinRM) for Ruby
+
+This is a SOAP library that uses the functionality in Windows Remote
+Management(WinRM) to call native object in Windows.  This includes, but is
+not limitted to, running batch scripts, powershell scripts and fetching WMI
+variables.  For more information on WinRM, please visit Microsoft's WinRM
+site: http://msdn.microsoft.com/en-us/library/aa384426(v=VS.85).aspx
+
+## My Info
+* Twitter: [@zentourist](https://twitter.com/zentourist)
+* BLOG:  [http://distributed-frostbite.blogspot.com/](http://distributed-frostbite.blogspot.com/)
+* Add me in LinkedIn:  [http://www.linkedin.com/in/danwanek](http://www.linkedin.com/in/danwanek)
+* Find me on irc.freenode.net in #ruby-lang (zenChild)
+
+## Current features
+
+1. GSSAPI support:  This is the default way that Windows authenticates and
+   secures WinRM messages. In order for this to work the computer you are
+   connecting to must be a part of an Active Directory domain and you must
+   have local credentials via kinit. GSSAPI support is dependent on the
+   gssapi gem which only supports the MIT Kerberos libraries at this time.
+
+   If you are using this method there is no longer a need to change the
+   WinRM service authentication settings. You can simply do a
+   'winrm quickconfig' on your server or enable WinRM via group policy and
+   everything should be working.
+
+2. Multi-Instance support:  The SOAP back-end has been completely gutted
+   and is now using some of the Savon core libraries for parsing and
+   building packets. Moving away from Handsoap allows multiple instances
+   to be created because the SOAP backend is no longer a Singleton type
+   class.
+
+
+## !!!SHOUTS OUT!!!
+Many thanks to the following for their many patches....
+* Seth Chisamore (https://github.com/schisamo)
+* Paul Morton (https://github.com/pmorton)
+
+
+
+## INSTALL:
+`gem install -r winrm` then on the server `winrm quickconfig` as admin
+
+## USE:
+`require 'winrm'`
+
+## EXAMPLE:
+```ruby
+require 'winrm'
+endpoint = http://mywinrmhost:5985/wsman
+krb5_realm = 'EXAMPLE.COM'
+winrm = WinRM::WinRMWebService.new(endpoint, :kerberos, :realm => krb5_realm)
+winrm.cmd('ipconfig /all') do |stdout, stderr|
+  STDOUT.print stdout
+  STDERR.print stderr
+end
+```
+
+There are various connection types you can specify upon initialization:
+
+#### PLAINTEXT
+```ruby
+WinRM::WinRMWebService.new(endpoint, :plaintext, :user => myuser, :pass => mypass)
+
+# Same but force basic authentication:
+WinRM::WinRMWebService.new(endpoint, :plaintext, :user => myuser, :pass => mypass, :basic_auth_only => true)
+```
+
+#### SSL
+```ruby
+WinRM::WinRMWebService.new(endpoint, :ssl, :user => myuser, :pass => mypass)
+
+# Same but force basic authentication:
+WinRM::WinRMWebService.new(endpoint, :ssl, :user => myuser, :pass => mypass, :basic_auth_only => true)
+```
+
+#### KERBEROS
+```ruby
+WinRM::WinRMWebService.new(endpoint, :kerberos, :realm => 'MYREALM.COM')
+```
+
+## DISCLAIMER
+If you see something that could be done better or would like to help out in the development of this code please feel free to clone the repository and send me patches.
+
+`git clone git://github.com/zenchild/WinRM.git` or add an [issue](https://github.com/zenchild/WinRM/issues) on GitHub:
+
+- - -
+
+Cheers!

data/VERSION

@@ -1 +1 @@
-1.1.1
+1.1.2

data/lib/winrm/winrm_service.rb

@@ -289,7 +289,9 @@ module WinRM
       }
 
       resp = send_message(s.to_xml)
+      toggle_nori_type_casting :off
       hresp = Nori.parse(resp.to_xml)[:envelope][:body]
+      toggle_nori_type_casting :original
       # Normalize items so the type always has an array even if it's just a single item.
       items = {}
       hresp[:enumerate_response][:items].each_pair do |k,v|
@@ -303,6 +305,20 @@ module WinRM
     end
     alias :wql :run_wql
 
+    def toggle_nori_type_casting(to)
+      @nori_type_casting ||= Nori.advanced_typecasting?
+      case to.to_sym
+      when :original
+        Nori.advanced_typecasting = @nori_type_casting
+      when :on
+        Nori.advanced_typecasting = true
+      when :off
+        Nori.advanced_typecasting = false
+      else
+        raise ArgumentError, "Cannot toggle type casting to '#{to}', it is not a valid argument"
+      end
+
+    end
 
     private
 

data/test/config-example.yml

@@ -0,0 +1,12 @@
+## Kerberos
+#auth_type: plaintest
+#endpoint: "http://<yourserver>:5985/wsman"
+#options:
+#  realm: "your.realm"
+
+## Plain Text
+#auth_type: plaintext
+#endpoint: "http://localhost:5985/wsman"
+#options:
+#  user: vagrant
+#  pass: vagrant

data/test/spec/nori_type_casting_spec.rb

@@ -0,0 +1,30 @@
+$: << File.dirname(__FILE__)
+require 'spec_helper'
+require 'Nori'
+
+describe "Test Nori Type Cast Toggler" do
+  before(:all) do
+    @winrm = winrm_connection
+  end
+
+  it 'should have nori advanced type casting on' do
+    Nori.advanced_typecasting?.should == true
+  end
+
+  it 'should turn off nori advanced type casting' do
+    @winrm.toggle_nori_type_casting :off
+    Nori.advanced_typecasting?.should == false
+  end
+
+  it 'should return nori advanced type casting to the original state' do
+    @winrm.toggle_nori_type_casting :original
+    Nori.advanced_typecasting?.should == true
+  end
+
+  it 'should turn on nori advanced type casting' do
+    @winrm.toggle_nori_type_casting :off
+    @winrm.toggle_nori_type_casting :on
+    Nori.advanced_typecasting?.should == true
+  end
+
+end

data/test/spec/spec_helper.rb

@@ -5,15 +5,30 @@ require 'json'
 module ConnectionHelper
   # To run this test put a file called 'creds.json' in this directory with the following format:
   #   {"user":"myuser","pass":"mypass","endpoint":"http://mysys.com/wsman","realm":"MY.REALM"}
-  CREDS_FILE=File.dirname(__FILE__) + '/creds.json'
+  WINRM_CONFIG = File.expand_path("#{File.dirname(__FILE__)}/../config.yml")
 
   def winrm_connection
-    creds = JSON.load(File.open(CREDS_FILE,'r'))
-    winrm = WinRM::WinRMWebService.new(creds['endpoint'], :kerberos, :realm => creds['realm'])
-    #winrm = WinRM::WinRMWebService.new(creds['endpoint'], :plaintext, :user => creds['user'], :pass => creds['pass'])
-    #winrm = WinRM::WinRMWebService.new(creds['endpoint'], :plaintext, :user => creds['user'], :pass => creds['pass'], :basic_auth_only => true)
+    config = symbolize_keys(YAML.load(File.read(WINRM_CONFIG)))
+    config[:options].merge!( :basic_auth_only => true ) unless config[:auth_type].eql? :kerberos
+    winrm = WinRM::WinRMWebService.new(config[:endpoint], config[:auth_type].to_sym, config[:options])
     winrm
   end
+
+  def symbolize_keys(hash)
+    hash.inject({}){|result, (key, value)|
+      new_key = case key
+                when String then key.to_sym
+                else key
+                end
+      new_value = case value
+                  when Hash then symbolize_keys(value)
+                  else value
+                  end
+      result[new_key] = new_value
+      result
+    }
+  end
+
 end
 
 RSpec.configure do |config|

data/winrm.gemspec

@@ -21,7 +21,7 @@ Gem::Specification.new do |s|
   s.files = `git ls-files`.split(/\n/)
   s.require_path = "lib"
   s.rdoc_options	= %w(-x test/ -x examples/)
-  s.extra_rdoc_files = %w(README LICENSE)
+  s.extra_rdoc_files = %w(README.md LICENSE)
 
   s.required_ruby_version	= '>= 1.9.0'
   s.add_runtime_dependency  'gssapi', '~> 1.0.0'

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: winrm
 version: !ruby/object:Gem::Version
-  version: 1.1.1
+  version: 1.1.2
   prerelease: 
 platform: ruby
 authors:
@@ -9,11 +9,11 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-05-31 00:00:00.000000000 Z
+date: 2012-06-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: gssapi
-  requirement: &17923760 !ruby/object:Gem::Requirement
+  requirement: &9359240 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -21,10 +21,10 @@ dependencies:
         version: 1.0.0
   type: :runtime
   prerelease: false
-  version_requirements: *17923760
+  version_requirements: *9359240
 - !ruby/object:Gem::Dependency
   name: nokogiri
-  requirement: &17922480 !ruby/object:Gem::Requirement
+  requirement: &9358240 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -32,10 +32,10 @@ dependencies:
         version: 1.5.0
   type: :runtime
   prerelease: false
-  version_requirements: *17922480
+  version_requirements: *9358240
 - !ruby/object:Gem::Dependency
   name: httpclient
-  requirement: &17921240 !ruby/object:Gem::Requirement
+  requirement: &9356700 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -43,10 +43,10 @@ dependencies:
         version: 2.2.0.2
   type: :runtime
   prerelease: false
-  version_requirements: *17921240
+  version_requirements: *9356700
 - !ruby/object:Gem::Dependency
   name: rubyntlm
-  requirement: &17920200 !ruby/object:Gem::Requirement
+  requirement: &9355960 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -54,10 +54,10 @@ dependencies:
         version: 0.1.1
   type: :runtime
   prerelease: false
-  version_requirements: *17920200
+  version_requirements: *9355960
 - !ruby/object:Gem::Dependency
   name: uuidtools
-  requirement: &17919160 !ruby/object:Gem::Requirement
+  requirement: &9354860 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -65,10 +65,10 @@ dependencies:
         version: 2.1.2
   type: :runtime
   prerelease: false
-  version_requirements: *17919160
+  version_requirements: *9354860
 - !ruby/object:Gem::Dependency
   name: savon
-  requirement: &17918380 !ruby/object:Gem::Requirement
+  requirement: &9354080 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - =
@@ -76,10 +76,10 @@ dependencies:
         version: 0.9.5
   type: :runtime
   prerelease: false
-  version_requirements: *17918380
+  version_requirements: *9354080
 - !ruby/object:Gem::Dependency
   name: logging
-  requirement: &17917680 !ruby/object:Gem::Requirement
+  requirement: &9353360 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -87,7 +87,7 @@ dependencies:
         version: 1.6.1
   type: :runtime
   prerelease: false
-  version_requirements: *17917680
+  version_requirements: *9353360
 description: ! '    Ruby library for Windows Remote Management
 
 '
@@ -95,12 +95,12 @@ email: dan.wanek@gmail.com
 executables: []
 extensions: []
 extra_rdoc_files:
-- README
+- README.md
 - LICENSE
 files:
 - .gitignore
 - LICENSE
-- README
+- README.md
 - Rakefile
 - VERSION
 - lib/winrm.rb
@@ -111,7 +111,9 @@ files:
 - lib/winrm/winrm_service.rb
 - preamble
 - test/.rspec
+- test/config-example.yml
 - test/spec/cmd_spec.rb
+- test/spec/nori_type_casting_spec.rb
 - test/spec/powershell_spec.rb
 - test/spec/spec_helper.rb
 - test/spec/test.ps1

data/README

@@ -1,90 +0,0 @@
---------------------------------------------------------------------------
-              Windows Remote Management (WinRM) for Ruby
---------------------------------------------------------------------------
-This is a SOAP library that uses the functionality in Windows Remote
-Management(WinRM) to call native object in Windows.  This includes, but is
-not limitted to, running batch scripts, powershell scripts and fetching WMI
-variables.  For more information on WinRM, please visit Microsoft's WinRM
-site: http://msdn.microsoft.com/en-us/library/aa384426(v=VS.85).aspx
-
-My Info: 
-BLOG:  http://distributed-frostbite.blogspot.com/
-Add me in LinkedIn:  http://www.linkedin.com/in/danwanek
-Find me on irc.freenode.net in #ruby-lang (zenChild)
-
---------------------------------------------------------------------------
-Version 1.0.0rc1
-
-This is a release candidate of the new version 1 code for Ruby WinRM. It
-is almost a complete re-write from the previous version to support some
-of the following major feature additions:
-
-1. GSSAPI support:  This is the default way that Windows authenticates and
-   secures WinRM messages. In order for this to work the computer you are
-   connecting to must be a part of an Active Directory domain and you must
-   have local credentials via kinit. GSSAPI support is dependent on the
-   gssapi gem which only supports the MIT Kerberos libraries at this time.
-
-   If you are using this method there is no longer a need to change the
-   WinRM service authentication settings. You can simply do a
-   'winrm quickconfig' on your server or enable WinRM via group policy and
-   everything should be working.
-
-2. Multi-Instance support:  The SOAP back-end has been completely gutted
-   and is now using some of the Savon core libraries for parsing and
-   building packets. Moving away from Handsoap allows multiple instances
-   to be created because the SOAP backend is no longer a Singleton type
-   class.
-
---------------------------------------------------------------------------
-!!!SHOUTS OUT!!!
---------------------------------------------------------------------------
-Thanks to Seth Chisamore (https://github.com/schisamo) of Opscode for his input and patches.
---------------------------------------------------------------------------
-
-
-INSTALL:
-gem install -r winrm
-.. on the server 'winrm quickconfig' as admin
-
-USE:
-require 'winrm'
-
-EXAMPLE:
-require 'winrm'
-endpoint = http://mywinrmhost:5985/wsman
-krb5_realm = 'EXAMPLE.COM'
-winrm = WinRM::WinRMWebService.new(endpoint, :kerberos, :realm => krb5_realm)
-winrm.cmd('ipconfig /all') do |stdout, stderr|
-  STDOUT.print stdout
-  STDERR.print stderr
-end
-
-
-CONNECTION TYPES:
-
-PLAINTEXT:
-  WinRM::WinRMWebService.new(endpoint, :plaintext, :user => myuser, :pass => mypass)
-  # Same but force basic authentication
-  WinRM::WinRMWebService.new(endpoint, :plaintext, :user => myuser, :pass => mypass, :basic_auth_only => true)
-SSL:
-  WinRM::WinRMWebService.new(endpoint, :ssl, :user => myuser, :pass => mypass)
-  # Same but force basic authentication
-  WinRM::WinRMWebService.new(endpoint, :ssl, :user => myuser, :pass => mypass, :basic_auth_only => true)
-KERBEROS:
-  WinRM::WinRMWebService.new(endpoint, :kerberos, :realm => 'MYREALM.COM')
-
---------------------------------------------------------------------------
-DISCLAIMER:  If you see something that could be done better or would like
-to help out in the development of this code please feel free to clone the
-'git' repository and send me patches:
-git clone git://github.com/zenchild/WinRM.git
-or add an issue on GitHub:
-http://github.com/zenchild/WinRM/issues
-
-Cheers!
---------------------------------------------------------------------------
-
-
-Thurs : #9 5:30-6:30
-