wsdl-mapper 0.0.7

data/lib/wsdl_mapper/naming/default_service_namer.rb

@@ -0,0 +1,147 @@
+require 'wsdl_mapper/dom/name'
+
+require 'wsdl_mapper/naming/type_name'
+require 'wsdl_mapper/naming/property_name'
+require 'wsdl_mapper/naming/inflector'
+
+require 'wsdl_mapper/naming/namer_base'
+
+module WsdlMapper
+  module Naming
+    class DefaultServiceNamer < NamerBase
+
+      def initialize(module_path: [], api_name: 'Api')
+        super module_path: module_path
+        @api_name = api_name
+      end
+
+      def get_api_name
+        type_name = TypeName.new camelize(@api_name), @module_path, get_file_name(@api_name), get_file_path(@module_path)
+        type_name.parent = make_parents @module_path
+        type_name
+      end
+
+      def get_service_name(service)
+        type_name = TypeName.new camelize(service.name.name), @module_path, get_file_name(service.name.name), get_file_path(@module_path)
+        type_name.parent = make_parents @module_path
+        type_name
+      end
+
+      def get_property_name(type)
+        PropertyName.new get_accessor_name(type.name.name), get_var_name(type.name.name)
+      end
+
+      def get_port_name(service, port)
+        service_name = get_service_name service
+        module_path = @module_path + [service_name.class_name]
+        type_name = TypeName.new camelize(port.name.name), module_path, get_file_name(port.name.name), get_file_path(module_path)
+        type_name.parent = make_parents module_path
+        type_name
+      end
+
+      def get_proxy_name(service, port)
+        service_name = get_service_name service
+        module_path = @module_path + [service_name.class_name]
+        name = port.name.name + 'Proxy'
+        type_name = TypeName.new camelize(name), module_path, get_file_name(name), get_file_path(module_path)
+        type_name.parent = make_parents module_path
+        type_name
+      end
+
+      def get_operation_name(service, port, operation)
+        service_name = get_service_name service
+        port_name = get_port_name service, port
+        module_path = @module_path + [service_name.class_name, port_name.class_name]
+        name = operation.name.name
+        type_name = TypeName.new camelize(name), module_path, get_file_name(name), get_file_path(module_path)
+        type_name.parent = make_parents module_path
+        type_name
+      end
+
+      def get_input_body_name(service, port, op)
+        get_body_name service, port, op, 'InputBody'
+      end
+
+      def get_input_s8r_name(service, port, op)
+        get_operation_part_name service, port, op, 'InputS8r'
+      end
+
+      def get_output_s8r_name(service, port, op)
+        get_operation_part_name service, port, op, 'OutputS8r'
+      end
+
+      def get_input_d10r_name(service, port, op)
+        get_operation_part_name service, port, op, 'InputD10r'
+      end
+
+      def get_output_d10r_name(service, port, op)
+        get_operation_part_name service, port, op, 'OutputD10r'
+      end
+
+      def get_output_type_directory_name
+        'OutputTypeDirectory'
+      end
+
+      def get_output_header_d10r_name
+        'OutputHeaderDeserializer'
+      end
+
+      def get_output_body_d10r_name
+        'OutputBodyDeserializer'
+      end
+
+      def get_output_element_directory_name
+        'OutputElementDirectory'
+      end
+
+      def get_input_type_directory_name
+        'InputTypeDirectory'
+      end
+
+      def get_input_header_d10r_name
+        'InputHeaderDeserializer'
+      end
+
+      def get_input_body_d10r_name
+        'InputBodyDeserializer'
+      end
+
+      def get_input_element_directory_name
+        'InputElementDirectory'
+      end
+
+      def get_operation_part_name(service, port, op, name)
+        service_name = get_service_name service
+        port_name = get_port_name service, port
+        op_name = get_operation_name service, port, op
+        module_path = @module_path + [service_name.class_name, port_name.class_name, op_name.class_name]
+        type_name = TypeName.new camelize(name), module_path, get_file_name(name), get_file_path(module_path)
+        type_name.parent = make_parents module_path
+        type_name
+      end
+      alias_method :get_header_name, :get_operation_part_name
+      alias_method :get_body_name, :get_operation_part_name
+
+      def get_output_body_name(service, port, op)
+        get_body_name service, port, op, 'OutputBody'
+      end
+
+      def get_input_header_name(service, port, op)
+        get_header_name service, port, op, 'InputHeader'
+      end
+
+      def get_output_header_name(service, port, op)
+        get_header_name service, port, op, 'OutputHeader'
+      end
+
+      def get_header_property_name(message_name, part_name)
+        name = message_name.name + part_name.name
+        PropertyName.new get_accessor_name(name), get_var_name(name)
+      end
+
+      def get_body_property_name(part_name)
+        PropertyName.new get_accessor_name(part_name.name), get_var_name(part_name.name)
+      end
+    end
+  end
+end

data/lib/wsdl_mapper/naming/enumeration_value_name.rb

@@ -0,0 +1,16 @@
+module WsdlMapper
+  module Naming
+    # Represents the value of an enumeration value, consisting of the constant to
+    # generate and the string key, that will be the enumeration value.
+    class EnumerationValueName
+      attr_reader :constant_name, :key_name
+
+      # @param [String] constant_name Name for the constant to generate.
+      # @param [String] key_name String value.
+      def initialize(constant_name, key_name)
+        @constant_name = constant_name
+        @key_name = key_name
+      end
+    end
+  end
+end

data/lib/wsdl_mapper/naming/inflector.rb

@@ -0,0 +1,42 @@
+module WsdlMapper
+  module Naming
+    # Module with inflection helper methods. As a permanent dependency on Rails'
+    # ActiveSupport library is not feasible, here are some quick re-implementations.
+    module Inflector
+      extend self
+
+      FIRST_CHAR = /^./
+      NON_WORD = /[^a-zA-Z]/
+      NON_AN = /[^a-zA-Z0-9]/
+      NON_WORD_FOLLOWED_BY_WORD = /[^a-zA-Z0-9]+([a-zA-Z0-9])/
+      CAPITALS = /([A-Z])/
+      DOWN_FOLLOWED_BY_UP = /([a-z0-9])([A-Z])/
+
+      # Camelize a string.
+      # @param [String] source String to camelize.
+      # @return [String] Camelized string.
+      # @example
+      #   camelize('foo_bar baz ') #=> 'FooBarBaz'
+      def camelize(source)
+        source.
+          strip.
+          gsub(NON_WORD_FOLLOWED_BY_WORD) { |_| $1.upcase }.
+          sub(FIRST_CHAR) { |s| s.upcase }
+      end
+
+      # Snake-cases a string.
+      # @param [String] source String to underscore.
+      # @return [String] snake-cased string.
+      # @example
+      #   underscore('Foo Bar') #=> 'foo_bar'
+      def underscore(source)
+        source.
+          strip.
+          gsub(DOWN_FOLLOWED_BY_UP) { |_| "#{$1}_#{$2.downcase}" }.
+          downcase.
+          gsub(NON_AN, '_').
+          gsub(/_+/, '_')
+      end
+    end
+  end
+end

data/lib/wsdl_mapper/naming/namer_base.rb

@@ -0,0 +1,115 @@
+require 'wsdl_mapper/naming/type_name'
+require 'wsdl_mapper/naming/inflector'
+
+module WsdlMapper
+  module Naming
+    # This is the base class of all namers, which implements common functionality.
+    #
+    # A namer is responsible for generating ruby class / module / attribute / constant
+    # names from schema information.
+    #
+    # For the most part, derivations such as {DefaultNamer} just implement
+    # common ruby conventions. The interface, though, also allows for complete
+    # customization.
+    class NamerBase
+      include Inflector
+
+      KEYWORDS = %w[
+        alias
+        and
+        begin
+        break
+        case
+        catch
+        class
+        def
+        do
+        elsif
+        else
+        fail
+        ensure
+        for
+        end
+        if
+        in
+        module
+        next
+        not
+        or
+        raise
+        redo
+        rescue
+        retry
+        return
+        then
+        throw
+        super
+        unless
+        undef
+        until
+        when
+        while
+        yield
+        true
+        false
+        nil
+        self
+      ]
+
+      attr_reader :module_path
+
+      def initialize(module_path: [])
+        @module_path = module_path
+      end
+
+      protected
+      def make_parents(path)
+        return if path.empty?
+
+        mod, path = path.last, path[0...-1]
+        type_name = TypeName.new mod, path, get_file_name(mod), get_file_path(path)
+        type_name.parent = make_parents path
+        type_name
+      end
+
+      def get_constant_name(name)
+        get_key_name(name).upcase
+      end
+
+      def get_key_name(name)
+        underscore sanitize name
+      end
+
+      def get_accessor_name(name)
+        get_key_name name
+      end
+
+      def get_var_name(name)
+        "@#{get_accessor_name(name)}"
+      end
+
+      def get_file_name(name)
+        underscore(name) + '.rb'
+      end
+
+      def get_file_path(path)
+        path.map do |m|
+          underscore m
+        end
+      end
+
+      def sanitize(name)
+        if valid_symbol? name
+          name
+        else
+          "x_#{name}"
+        end
+      end
+
+      def valid_symbol?(name)
+        name =~ /^[a-zA-Z]/ && !KEYWORDS.include?(name.to_s)
+      end
+    end
+  end
+end
+

data/lib/wsdl_mapper/naming/property_name.rb

@@ -0,0 +1,16 @@
+module WsdlMapper
+  module Naming
+    # Represents a name of a ruby property, consisting of its instance
+    # variable and its accessors (attribute).
+    class PropertyName
+      attr_reader :attr_name, :var_name
+
+      # @param [String] attr_name Name for the attribute accessors
+      # @param [String] var_name Name for the instance variable
+      def initialize(attr_name, var_name)
+        @attr_name = attr_name
+        @var_name = var_name
+      end
+    end
+  end
+end

data/lib/wsdl_mapper/naming/separating_namer.rb

@@ -0,0 +1,122 @@
+require 'wsdl_mapper/naming/default_namer'
+
+module WsdlMapper
+  module Naming
+    # Namer implementation which puts the generated classes into different namespaces,
+    # according to their funtion: `Types` for types, `S8r` for serializers and `D10r`
+    # for deserializers.
+    class SeparatingNamer < DefaultNamer
+
+      # @param [Array<String>] module_path Root module path, e.g. to generate classes in
+      #                                    `::MyApi::Types`, specify `['MyApi']` as root module path
+      # @param [String] content_attribute_name Sets name of the attribute generated for direct content
+      #                                        of types. You can change it, if this clashes with attributes
+      #                                        in your schema.
+      # @param [Array<String>] types_module Where to generate types
+      # @param [Array<String>] s8r_module Where to genereate serializers
+      # @param [Array<String>] d10r_module Where to generate deserializers
+      def initialize(module_path: [],
+          content_attribute_name: 'content',
+          soap_array_item_name: 'item',
+          types_module: ['Types'],
+          s8r_module: ['S8r'],
+          d10r_module: ['D10r'])
+
+        super(module_path: module_path,
+            content_attribute_name: content_attribute_name,
+            soap_array_item_name: soap_array_item_name)
+
+        @types_module = types_module
+        @s8r_module = s8r_module
+        @d10r_module = d10r_module
+      end
+
+      protected
+      def get_s8r_module_path(type)
+        @module_path + @s8r_module
+      end
+
+      def get_class_module_path(type)
+        @module_path + @types_module
+      end
+
+      def get_d10r_module_path(type)
+        @module_path + @d10r_module
+      end
+
+      def get_class_file_path(type)
+        get_file_path get_class_module_path type
+      end
+
+      def get_s8r_file_path(type)
+        get_file_path get_s8r_module_path type
+      end
+
+      def get_d10r_file_path(type)
+        get_file_path get_d10r_module_path type
+      end
+
+      def get_d10r_file_name(type)
+        underscore(type.name.name) + '_deserializer.rb'
+      end
+
+      def get_d10r_class_name(type)
+        get_camelized_name(type.name.name) + 'Deserializer'
+      end
+
+      def get_s8r_file_name(type)
+        underscore(type.name.name) + '_serializer.rb'
+      end
+
+      def get_s8r_class_name(type)
+        get_camelized_name(type.name.name) + 'Serializer'
+      end
+
+      def get_class_name(type)
+        get_camelized_name type.name.name
+      end
+
+      def get_class_file_name(type)
+        get_file_name type.name.name
+      end
+
+      def get_constant_name(name)
+        get_key_name(name).upcase
+      end
+
+      def get_key_name(name)
+        underscore sanitize name
+      end
+
+      def get_accessor_name(name)
+        get_key_name name
+      end
+
+      def get_var_name(name)
+        "@#{get_accessor_name(name)}"
+      end
+
+      def get_camelized_name(name)
+        camelize name
+      end
+
+      def get_file_name(name)
+        underscore(name) + '.rb'
+      end
+
+      def get_file_path(path)
+        path.map do |m|
+          underscore m
+        end
+      end
+
+      def sanitize(name)
+        if valid_symbol? name
+          name
+        else
+          "value_#{name}"
+        end
+      end
+    end
+  end
+end