shapewear 0.0.1

data/.gitignore

@@ -0,0 +1 @@
+Gemfile.lock

data/.rspec

@@ -0,0 +1 @@
+--colour

data/.rvmrc

@@ -0,0 +1 @@
+rvm use ree@shapewear

data/.travis.yml

@@ -0,0 +1,10 @@
+# https://github.com/travis-ci/travis-ci/wiki/.travis.yml-options
+script: "bundle exec rake"
+rvm:
+  - 1.8.7
+  - 1.9.2
+  - 1.9.3
+  - ree
+  - rbx
+  - rbx-2.0
+  - jruby

data/Gemfile

@@ -0,0 +1,2 @@
+source :rubygems
+gemspec

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2011 Elementar Sistemas Ltda
+
+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,67 @@
+shapewear [![Build Status](https://secure.travis-ci.org/elementar/shapewear.png)](http://travis-ci.org/elementar/shapewear)
+=========
+
+Make your fat service look skinny.
+
+Installation
+------------
+
+Shapewear is available through [Rubygems](http://rubygems.org/gems/shapewear) and can be installed via:
+
+```
+$ gem install shapewear
+```
+
+Introduction
+------------
+
+First, describe your SOAP service:
+
+``` ruby
+require "shapewear"
+
+class MyFirstService
+  include Shapewear::DSL
+
+  def hello(name)
+    "hello, #{name}"
+  end
+
+  def sum(x, y)
+    x + y
+  end
+end
+```
+
+Then bind to your web application in a non-intrusive way.
+
+Rails example:
+
+``` ruby
+# don't forget to write the appropriate routes
+class MyFirstServiceController < ApplicationController
+  def wsdl
+    render :xml => MyHelloService.to_wsdl
+  end
+
+  def serve
+    render :xml => MyHelloService.serve(params)
+  end
+end
+```
+
+Sinatra example:
+
+``` ruby
+class MySinatraApp < Sinatra::App
+  get "my_first_service/wsdl" do
+    content_type "application/xml"
+    MyHelloService.to_wsdl
+  end
+
+  post "my_first_service" do
+    content_type "application/xml"
+    MyHelloService.serve(params)
+  end
+end
+```

data/Rakefile

@@ -0,0 +1,7 @@
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new
+
+task :default => :spec
+task :test => :spec

data/lib/shapewear.rb

@@ -0,0 +1,13 @@
+require 'nokogiri'
+
+require 'shapewear/version'
+require 'shapewear/dsl'
+
+# defines String.camelize if it is not defined by, e.g. Rails
+unless String.respond_to? :camelize
+  class String
+    def camelize
+      self.split('_').map(&:capitalize).join
+    end
+  end
+end

data/lib/shapewear/dsl.rb

@@ -0,0 +1,107 @@
+require 'builder'
+
+module Shapewear
+  module DSL
+    def self.included(receiver)
+      receiver.extend(ClassMethods)
+    end
+
+    #noinspection RubyArgCount,RubyResolve
+    module ClassMethods
+
+      # reference: http://www.w3.org/TR/wsdl
+      def to_wsdl
+        tns = "http://shapewear.elementarsistemas.com.br/auto/#{self.name}.wsdl"
+        xsd = "http://shapewear.elementarsistemas.com.br/auto/#{self.name}.xsd"
+
+        xm = Builder::XmlMarkup.new
+
+        xm.instruct!
+        xm.definitions :name => self.name, 'targetNamespace' => tns,
+                       'xmlns' => 'http://schemas.xmlsoap.org/wsdl/',
+                       'xmlns:soap' => 'http://schemas.xmlsoap.org/wsdl/soap/',
+                       'xmlns:xsd1' => xsd, 'tns' => tns do |xdef|
+
+          xdef.types do |xtypes|
+            xtypes.schema 'xmlns' => 'http://www.w3.org/2000/10/XMLSchema', 'targetNamespace' => xsd do |xschema|
+
+              # define elements for each defined method
+              instance_methods(false).each do |m|
+                build_type_elements_for_method(m, xschema)
+              end
+            end
+          end
+
+          instance_methods(false).each do |m|
+            xdef.message :name => "#{m.camelize}Input" do |xmsg|
+              xmsg.part :name => :body, :element => "xsd1:#{m.camelize}Request"
+            end unless instance_method(m).arity == 0
+            xdef.message :name => "#{m.camelize}Output" do |xmsg|
+              xmsg.part :name => :body, :element => "xsd1:#{m.camelize}"
+            end
+          end
+
+          xdef.portType :name => "#{self.name}PortType" do |xpt|
+            instance_methods(false).each do |m|
+              xpt.operation :name => m.camelize do |xop|
+                xop.input :message => "tns:#{m.camelize}Input" unless instance_method(m).arity == 0
+                xop.output :message => "tns:#{m.camelize}Output"
+              end
+            end
+          end
+
+          xdef.binding :name => "#{self.name}Binding", :type => "tns:#{self.name}PortType" do |xbind|
+            xbind.tag! 'soap:binding', :style => 'document', :transport => 'http://schemas.xmlsoap.org/soap/http'
+            instance_methods(false).each do |m|
+              xbind.operation :name => m.camelize do |xop|
+                xbind.tag! 'soap:operation', :soapAction => "http://shapewear.elementarsistemas.com.br/auto/op/#{m.camelize}"
+                xbind.input { |xin| xin.tag! 'soap:body', :use => 'literal' } unless instance_method(m).arity == 0
+                xbind.output { |xin| xin.tag! 'soap:body', :use => 'literal' }
+              end
+            end
+          end
+
+          xdef.service :name => self.name do |xsrv|
+            xsrv.documentation "WSDL auto-generated by shapewear."
+            xsrv.port :name => "#{self.name}Port", :binding => "#{self.name}Binding" do |xport|
+              xport.tag! 'soap:address', :location => "..." # TODO: let the developer configure
+            end
+          end
+        end
+      end
+
+      def build_type_elements_for_method(m, xschema)
+        # element for method arguments
+        um = instance_method(m)
+
+        if um.arity > 0
+          xschema.element :name => "#{m.camelize}Request" do |xreq|
+            xreq.complexType do |xct|
+              xct.all do |xall|
+                if um.respond_to?(:parameters)
+                  # with Ruby 1.9, we can create the parameters with the correct names
+                  params = um.parameters.select { |p| p.first == :in }.map &:first
+                else
+                  params = (0..um.arity).map { |i| "arg#{i}" }
+                end
+
+                params.each do |p|
+                  xall.element :name => p, :type => 'xsd:string' # TODO: there must be a better way
+                end
+              end
+            end
+          end
+        end
+
+        # element for method result
+        xschema.element :name => "#{m.camelize}" do |xreq|
+          xreq.complexType do |xct|
+            xct.all do |xall|
+              xall.element :name => 'result', :type => 'xsd:string'
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/shapewear/version.rb

@@ -0,0 +1,5 @@
+module Shapewear
+
+  Version = "0.0.1"
+
+end

data/shapewear.gemspec

@@ -0,0 +1,25 @@
+lib = File.expand_path("../lib", __FILE__)
+$:.unshift lib unless $:.include? lib
+
+require 'shapewear/version'
+
+Gem::Specification.new do |s|
+  s.name        = "shapewear"
+  s.version     = Shapewear::Version
+  s.authors     = "Fábio Batista"
+  s.email       = "fabio@elementarsistemas.com.br"
+  s.homepage    = "https://github.com/elementar/shapewear"
+  s.summary     = "Make your fat service look skinny"
+  s.description = "Shapewear is a Ruby library for handling SOAP requests from within your Rails or Sinatra application. It makes your fat services look skinny."
+
+  s.rubyforge_project = s.name
+
+  s.add_dependency "builder",  ">= 2.1.2"
+  s.add_dependency "nokogiri", ">= 1.5.0"
+
+  s.add_development_dependency "rake",  "~> 0.9.2"
+  s.add_development_dependency "rspec", "~> 2.7.0"
+
+  s.files = `git ls-files`.split("\n")
+  s.require_path = "lib"
+end

data/spec/shapewear/dsl_spec.rb

@@ -0,0 +1,55 @@
+require "spec_helper"
+
+describe Shapewear::DSL do
+
+  let(:xmlns) { {'wsdl' => 'http://schemas.xmlsoap.org/wsdl/', 'soap' => 'http://schemas.xmlsoap.org/wsdl/soap/'} }
+
+  describe "basic DSL" do
+    it "should describe parameterless, 'hello world' services" do
+      class ParameterlessHelloWorldService
+        include Shapewear::DSL
+
+        def hello_world
+          "hello"
+        end
+      end
+
+      wsdl = ParameterlessHelloWorldService.to_wsdl
+      puts wsdl
+      wsdl_doc = nil
+      expect { wsdl_doc = Nokogiri::XML(wsdl) { |c| c.strict } }.not_to raise_error
+
+      # there should be a definition with the class' name
+      wsdl_def = wsdl_doc.xpath("/wsdl:definitions[@name='ParameterlessHelloWorldService']", xmlns)
+      wsdl_def.should have(1).node
+      wsdl_def.xpath("wsdl:service[@name='ParameterlessHelloWorldService']/wsdl:port[@name='ParameterlessHelloWorldServicePort']/soap:address", xmlns).should have(1).node
+
+      # the message element for the input should not be there, as the method does not accept parameters
+      wsdl_def.xpath("wsdl:message[@name='HelloWorldInput']", xmlns).should have(0).node
+
+      # the message element for the output must be there, as a simple string
+      wsdl_def.xpath("wsdl:message[@name='HelloWorldOutput']/wsdl:part[@name='body']", xmlns).should have(1).node
+
+      # there must be an operation named 'HelloWorld'
+      wsdl_def.xpath("wsdl:portType/wsdl:operation[@name='HelloWorld']", xmlns).should have(1).node
+      wsdl_def.xpath("wsdl:binding/wsdl:operation[@name='HelloWorld']", xmlns).should have(1).node
+    end
+    it "should describe services with basic parameters and return values"
+    it "should describe services with array parameters"
+  end
+
+  describe "complex types DSL" do
+    it "should allow definition of complex types using class introspection"
+    it "should allow definition of complex types using a builder-like DSL"
+    it "should accept complex types as input"
+    it "should accept complex types as output"
+  end
+
+  describe "WSDL customization" do
+    it "should allow customization of namespace"
+  end
+
+  describe "existing WSDL" do
+    it "should accept an existing WSDL"
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,5 @@
+require "bundler"
+Bundler.require :default, :development
+
+RSpec.configure do |config|
+end

metadata

@@ -0,0 +1,142 @@
+--- !ruby/object:Gem::Specification 
+name: shapewear
+version: !ruby/object:Gem::Version 
+  hash: 29
+  prerelease: 
+  segments: 
+  - 0
+  - 0
+  - 1
+  version: 0.0.1
+platform: ruby
+authors: 
+- "F\xC3\xA1bio Batista"
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2012-01-02 00:00:00 Z
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: builder
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 15
+        segments: 
+        - 2
+        - 1
+        - 2
+        version: 2.1.2
+  type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: nokogiri
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 1
+        - 5
+        - 0
+        version: 1.5.0
+  type: :runtime
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: rake
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 63
+        segments: 
+        - 0
+        - 9
+        - 2
+        version: 0.9.2
+  type: :development
+  version_requirements: *id003
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id004 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 19
+        segments: 
+        - 2
+        - 7
+        - 0
+        version: 2.7.0
+  type: :development
+  version_requirements: *id004
+description: Shapewear is a Ruby library for handling SOAP requests from within your Rails or Sinatra application. It makes your fat services look skinny.
+email: fabio@elementarsistemas.com.br
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- .rspec
+- .rvmrc
+- .travis.yml
+- Gemfile
+- Gemfile.lock
+- LICENSE
+- README.md
+- Rakefile
+- lib/shapewear.rb
+- lib/shapewear/dsl.rb
+- lib/shapewear/version.rb
+- shapewear.gemspec
+- spec/shapewear/dsl_spec.rb
+- spec/spec_helper.rb
+homepage: https://github.com/elementar/shapewear
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: shapewear
+rubygems_version: 1.8.11
+signing_key: 
+specification_version: 3
+summary: Make your fat service look skinny
+test_files: []
+