nogara-wash_out 0.5.2

data/.gitignore

@@ -0,0 +1,9 @@
+.bundle/
+.idea/
+log/*.log
+pkg/
+spec/dummy/db/*.sqlite3
+spec/dummy/log/*.log
+spec/dummy/tmp/
+gemfiles/rails-3.1.0.gemfile.lock b/gemfiles/rails-3.1.0.gemfile.lock
+gemfiles/rails-3.1.0.gemfile.lock b/gemfiles/rails-3.0.10.gemfile.lock

data/.travis.yml

@@ -0,0 +1,3 @@
+rvm:
+  - 1.9.3
+  - jruby-19mode

data/Appraisals

@@ -0,0 +1,7 @@
+appraise "rails-3.1.3" do
+  gem "rails", "3.1.3"
+end
+
+appraise "rails-3.0.11" do
+  gem "rails", "3.0.11"
+end

data/CHANGELOG.md

@@ -0,0 +1,79 @@
+# Changelog
+
+## 0.5.2
+
+* .NET-compliant response tags [@ebeigarts][]
+* Tiny fixes [@ebeigarts][]
+
+## 0.5.1
+
+* Better routing points [@inossidabile][]
+
+## 0.5.0
+
+* WSSE password authentication [@dhinus][]
+* Ruby 1.8 compatibility restores [@dhinus][]
+
+## 0.4.2
+
+* SOAP hrefs are now supported [@inossidabile][]
+* Better camelization: reusable types and methods are now supported [@inossidabile][]
+
+## 0.4.1
+
+* .NET-compliant :integer type WSDL [@inossidabile][]
+
+## 0.4.0
+
+* Better content-type for the response (#33) [@inossidabile][]
+* Date type support (#18) [@inossidabile][]
+* Avoid duplication of inner types [@inossidabile][]
+* Output camelization support [@inossidabile][]
+* External types declaration support (#21, #41) [@inossidabile][]
+
+## 0.3.7
+
+* Better empty parameters handling (#26, #30) [@rngtng][]
+
+## 0.3.6
+
+* Unicorn stream reading bug (#20)
+* .NET minOccurs/maxOccurs basic WSDL compatibility (#22, #23)
+
+## 0.3.5
+
+* Very evil thread-safety bug fixed. You are encouraged to never use anything below this version.
+
+## 0.3.4
+
+* WSDL generation fixed to support complex structures for return values
+* Configuration moved to OrderedOptions with proper Engine binding
+* `snakecase` configuration directive added: if set to false, wash_out won't modify params keys
+
+## 0.3.3
+
+* Tiny fixes in wash_out behavior with inline arrays (#11, #12)
+* Ability to change namespace
+
+## 0.3.2
+
+* WashOut doesn't check existance of parameters anymore you should do it yourself from now
+* Proper handling of blank parameters (#10)
+* Proper handling of complex structures inside arrays (#9)
+* Response performance improved
+
+## 0.3.1
+
+* Support of complex structures inside array
+* Better Nori handling (no more dependency on Savon hijacking)
+
+## 0.3.0
+
+* The syntax for empty set (no input params or output params) changed from [] to nil.
+* SOAP response format improved. All results are now wrapped into tns:messages instead of soap:Body.
+* Arrays (minOccurs/maxOccurs) are now supported with `:foo => [:integer]` syntax.
+
+[@inossidabile]: https://twitter.com/#!/_inossidabile
+[@rngtng]: https://github.com/rngtng
+[@dhinus]: https://github.com/dhinus
+[@ebeigarts]: https://github.com/ebeigarts

data/Gemfile

@@ -0,0 +1,5 @@
+source "http://rubygems.org"
+
+gem 'pry'
+
+gemspec

data/Gemfile.lock

@@ -0,0 +1,118 @@
+PATH
+  remote: .
+  specs:
+    wash_out (0.5.2)
+      nori
+
+GEM
+  remote: http://rubygems.org/
+  specs:
+    actionpack (3.2.1)
+      activemodel (= 3.2.1)
+      activesupport (= 3.2.1)
+      builder (~> 3.0.0)
+      erubis (~> 2.7.0)
+      journey (~> 1.0.1)
+      rack (~> 1.4.0)
+      rack-cache (~> 1.1)
+      rack-test (~> 0.6.1)
+      sprockets (~> 2.1.2)
+    activemodel (3.2.1)
+      activesupport (= 3.2.1)
+      builder (~> 3.0.0)
+    activesupport (3.2.1)
+      i18n (~> 0.6)
+      multi_json (~> 1.0)
+    akami (1.0.0)
+      gyoku (>= 0.4.0)
+    appraisal (0.4.1)
+      bundler
+      rake
+    builder (3.0.0)
+    coderay (1.0.5)
+    diff-lcs (1.1.3)
+    erubis (2.7.0)
+    gyoku (0.4.4)
+      builder (>= 2.1.2)
+    hike (1.2.1)
+    httpi (0.9.6)
+      rack
+    i18n (0.6.0)
+    journey (1.0.3)
+    json (1.6.5)
+    json (1.6.5-java)
+    method_source (0.7.1)
+    multi_json (1.1.0)
+    nokogiri (1.5.0)
+    nokogiri (1.5.0-java)
+    nori (1.1.0)
+    pry (0.9.8.4)
+      coderay (~> 1.0.5)
+      method_source (~> 0.7.1)
+      slop (>= 2.4.4, < 3)
+    pry (0.9.8.4-java)
+      coderay (~> 1.0.5)
+      method_source (~> 0.7.1)
+      slop (>= 2.4.4, < 3)
+      spoon (~> 0.0)
+    rack (1.4.1)
+    rack-cache (1.1)
+      rack (>= 0.4)
+    rack-ssl (1.3.2)
+      rack
+    rack-test (0.6.1)
+      rack (>= 1.0)
+    railties (3.2.1)
+      actionpack (= 3.2.1)
+      activesupport (= 3.2.1)
+      rack-ssl (~> 1.3.2)
+      rake (>= 0.8.7)
+      rdoc (~> 3.4)
+      thor (~> 0.14.6)
+    rake (0.9.2.2)
+    rdoc (3.12)
+      json (~> 1.4)
+    rspec (2.8.0)
+      rspec-core (~> 2.8.0)
+      rspec-expectations (~> 2.8.0)
+      rspec-mocks (~> 2.8.0)
+    rspec-core (2.8.0)
+    rspec-expectations (2.8.0)
+      diff-lcs (~> 1.1.2)
+    rspec-mocks (2.8.0)
+    rspec-rails (2.8.1)
+      actionpack (>= 3.0)
+      activesupport (>= 3.0)
+      railties (>= 3.0)
+      rspec (~> 2.8.0)
+    savon (0.9.9)
+      akami (~> 1.0)
+      builder (>= 2.1.2)
+      gyoku (>= 0.4.0)
+      httpi (~> 0.9)
+      nokogiri (>= 1.4.0)
+      nori (~> 1.1)
+      wasabi (~> 2.1)
+    slop (2.4.4)
+    spoon (0.0.1)
+    sprockets (2.1.2)
+      hike (~> 1.2)
+      rack (~> 1.0)
+      tilt (~> 1.1, != 1.3.0)
+    thor (0.14.6)
+    tilt (1.3.3)
+    tzinfo (0.3.31)
+    wasabi (2.1.0)
+      nokogiri (>= 1.4.0)
+
+PLATFORMS
+  java
+  ruby
+
+DEPENDENCIES
+  appraisal
+  pry
+  rspec-rails
+  savon
+  tzinfo
+  wash_out!

data/LICENSE

@@ -0,0 +1,22 @@
+The MIT License
+
+Copyright (c) 2012 Round Lake, inc.,
+                   Peter Zotov <whitequark@whitequark.org>.
+
+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,181 @@
+# WashOut
+
+WashOut is a gem that greatly simplifies creation of SOAP service providers.
+
+But if you have a chance, please [http://stopsoap.com/](http://stopsoap.com/).
+
+## Compatibility
+
+Rails >3.0 only.
+
+WashOut should work like a charm on CRuby 1.9.x.
+
+![Travis CI](https://secure.travis-ci.org/roundlake/wash_out.png)
+
+We do support CRuby 1.8.7. However it is not a goal and it is not well supported by our specs. According to
+this fact it maybe sometimes broken from the start on major releases. You are welcome to hold on an old
+version and give us enough issues and pull-requests to make it work.
+
+All dependencies are JRuby-compatible so again it will work well in --1.9 mode but it can fail with
+fresh releases if you go --1.8.
+
+## Installation
+
+In your Gemfile, add this line:
+
+    gem 'wash_out'
+
+## Usage
+
+A SOAP endpoint in WashOut is simply a Rails controller which includes the module WashOut::SOAP. Each SOAP
+action corresponds to a certain controller method; this mapping, as well as the argument definition, is defined
+by [soap_action][] method. Check the method documentation for complete info; here, only a few examples will be
+demonstrated.
+
+  [soap_action]: http://rubydoc.info/gems/wash_out/WashOut/SOAP/ClassMethods#soap_action-instance_method
+
+```ruby
+# app/controllers/rumbas_controller.rb
+class RumbasController < ApplicationController
+  include WashOut::SOAP
+
+  # Simple case
+  soap_action "integer_to_string",
+              :args   => :integer,
+              :return => :string
+  def integer_to_string
+    render :soap => params[:value].to_s
+  end
+
+  soap_action "concat",
+              :args   => { :a => :string, :b => :string },
+              :return => :string
+  def concat
+    render :soap => (params[:a] + params[:b])
+  end
+
+  # Complex structures
+  soap_action "AddCircle",
+              :args   => { :circle => { :center => { :x => :integer,
+                                                     :y => :integer },
+                                        :radius => :double } },
+              :return => nil, # [] for wash_out below 0.3.0
+              :to     => :add_circle
+  def add_circle
+    circle = params[:circle]
+
+    raise SOAPError, "radius is too small" if circle[:radius] < 3.0
+
+    Circle.new(circle[:center][:x], circle[:center][:y], circle[:radius])
+
+    render :soap => nil
+  end
+
+  # Arrays
+  soap_action "integers_to_boolean",
+              :args => { :data => [:integer] },
+              :return => [:boolean]
+  def integers_to_boolean
+    render :soap => params[:data].map{|x| x ? 1 : 0}
+  end
+
+  # You can use all Rails features like filtering, too. A SOAP controller
+  # is just like a normal controller with a special routing.
+  before_filter :dump_parameters
+  def dump_parameters
+    Rails.logger.debug params.inspect
+  end
+end
+```
+
+```ruby
+# config/routes.rb
+WashOutSample::Application.routes.draw do
+  wash_out :rumbas
+end
+```
+
+In such a setup, the generated WSDL may be queried at path `/api/wsdl`. So, with a
+gem like Savon, a request can be done using this path:
+
+```ruby
+require 'savon'
+
+client = Savon::Client.new("http://localhost:3000/rumbas/wsdl")
+
+client.wsdl.soap_actions # => [:integer_to_string, :concat, :add_circle]
+
+result = client.request(:concat) do
+  soap.body = { :a => "123", :b => "abc" }
+end
+
+# actual wash_out
+result.to_hash # => {:concat_reponse => {:value=>"123abc"}}
+
+# wash_out below 0.3.0 (and this is malformed response so please update)
+result.to_hash # => {:value=>"123abc"}
+```
+
+Take a look at [WashOut sample application](https://github.com/roundlake/wash_out-sample).
+
+## Reusable types
+
+Basic inline types definition is fast and furious for the simple cases. You have an option to describe SOAP types
+inside separate classes for the complex ones. Here's the way to do that:
+
+```ruby
+class Fluffy < WashOut::Type
+  map :universe => {
+        :name => :string,
+        :age  => :int
+      }
+end
+
+class FluffyContainer < WashOut::Type
+  type_name 'fluffy_con'
+  map :fluffy => Fluffy
+end
+```
+
+To use defined type inside your inline declaration, pass the class instead of type symbol (`:fluffy => Fluffy`).
+
+Note that WashOut extends the `ActiveRecord` so every model you use is already a WashOut::Type and can be used
+inside your interface declarations.
+
+## Configuration
+
+Use `config.wash_out...` inside your environment configuration to setup WashOut.
+
+Available properties are:
+
+* **namespace**: SOAP namespace to use. Default is `urn:WashOut`.
+* **snakecase**: *(DEPRECATED SINCE 0.4.0)* Determines if WashOut should modify parameters keys to snakecase. Default is `false`.
+* **snakecase_input**: Determines if WashOut should modify parameters keys to snakecase. Default is `false`.
+* **camelize_wsdl**: Determinse if WashOut should camelize types within WSDL and responses. Default is `false`.
+
+### Camelization
+
+Note that WSDL camelization will affect method names but only if they were given as a symbol:
+
+```ruby
+soap_action :foo  # this will be affected
+soap_action "foo" # this will be passed as is
+```
+
+## Credits
+
+<img src="http://roundlake.ru/assets/logo.png" align="right" />
+
+* Boris Staal ([@_inossidabile](http://twitter.com/#!/_inossidabile))
+* Peter Zotov ([@whitequark](http://twitter.com/#!/whitequark))
+
+## Contributors
+
+* Björn Nilsson ([@Bjorn-Nilsson](https://github.com/Bjorn-Nilsson))
+* Tobias Bielohlawek ([@rngtng](https://github.com/rngtng))
+* Francesco Negri ([@dhinus](https://github.com/dhinus))
+* Edgars Beigarts ([@ebeigarts](https://github.com/ebeigarts))
+
+## LICENSE
+
+It is free software, and may be redistributed under the terms of MIT license.

data/Rakefile

@@ -0,0 +1,14 @@
+require 'bundler/setup'
+require 'bundler/gem_tasks'
+require 'appraisal'
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec)
+
+desc "Default: run the unit tests."
+task :default => [:all]
+
+desc 'Test the plugin under all supported Rails versions.'
+task :all => ["appraisal:install"] do |t|
+  exec('rake appraisal spec')
+end