adwords4r 0.7 → 11.0.2

data/Authors.txt

@@ -1,2 +1,4 @@
+jeffy@google.com (Current)
 opensource@google.com
-chanezon@google.com
+chanezon@google.com
+leavengood@gmail.com

data/ChangeLog.txt

@@ -1,4 +1,21 @@
-0.7
+11.0.0
+- Jeffrey Posnick (jeffy@google.com) takes over as maintainer of this project
+- added support for AdWords API v11
+- removed support for AdWords API v9
+- added support for the ADWORDS4R_DEBUG environment variable--if set to TRUE, SOAP logs will be written to the current directory when the API is used
+
+1.0
+- added support for API v10
+- removed support for APIs v6, v7 and v8
+- used soap4r v1.5.6 to generate the API files from the WSDL
+- added soap4r v1.5.6 and http-access2 v2.0.5 as gem dependencies
+- cleaned up some of the kludges that were needed for older soap4r libraries
+0.8
+- Ryan Leavengood takes over as maintainer of this project
+- added support for APIs v7, v8 and v9
+- removed support for v4 and v5
+- updated the examples amd made it so they will use the adwords4r in their parent directory
+0.7
 - added support for API v6
 - uncommented clientEmail in sample property file
 0.6

data/Rakefile

@@ -1,35 +1,26 @@
-require 'wsdl/soap/wsdl2ruby'
-require 'net/https'
 require 'fileutils'
-require 'rake/clean'
+require 'net/https'
 require 'logger'
-begin
-  require 'rubygems'
-  require 'rake/gempackagetask'
-rescue Exception
-  nil
-end
-begin
-  require 'lib/adwords4r/services'
-rescue Exception
-  puts 'require services not found'
-  nil
-end
+require 'rake/clean'
+
+require 'rubygems'
+gem 'rake'
+require 'rake/gempackagetask'
+gem 'soap4r'
+require 'wsdl/soap/wsdl2ruby'
+require 'xsd/codegen/classdef'
+
+require 'lib/adwords4r/services'
 
 # Determine the current version of the software
 
 CLOBBER.include('pkg')
 
-CURRENT_VERSION = '0.7'
+CURRENT_VERSION = '11.0.2'
 PKG_VERSION = ENV['REL'] ? ENV['REL'] : CURRENT_VERSION
 
 SRC_RB = FileList['lib/**/*.rb']
 
-# The default task is run if rake is given no explicit arguments.
-
-#desc "Default Task"
-#task :default => :test_all
-
 WSDLDIR = 'wsdl'
 LIBDIR = 'lib'
 GENDIR = LIBDIR + '/adwords4r'
@@ -68,6 +59,7 @@ task :generate do
             worker.opt.update(getWsdlOpt(name))
             worker.run
             fixImport(v, File.join(gendir, "#{name}Driver.rb"))
+            fixImport(v, File.join(gendir, "#{name}MappingRegistry.rb"))
             fixImport(v, File.join(gendir, "#{name}.rb"))
         end
     end
@@ -78,33 +70,28 @@ def fixImport(version, file)
     tempfile = file + '.tmp'
     outfile = File.new(tempfile,"w")
     File.open(file, "r") do |infile|
-        outfile.puts "module AdWords"
-        #outfile.puts "module AdWordsV#{version}"
         infile.each do |l|
-            if (l =~/require.*Service.rb/) then
-#                outfile.puts l.gsub(/require \'(.*)Service.rb\'/, 'require #\'adwords4r/' + vname + '/\1Service\'')
-                outfile.puts l.gsub(/require \'(.*)Service.rb\'/, 'require \'adwords4r/' + vname + '/\1Service\'')
+            if (l =~ /require.*Service.*\.rb/) then
+                outfile.puts l.gsub(/require '(.*)Service(.*)\.rb'/, "require 'adwords4r/#{vname}/\\1Service\\2'")
             else
                 outfile.puts l
             end
         end
-        outfile.puts "end"
     end
     outfile.close
     File.rename(tempfile, file)
 end 
 
-
 def getWsdlOpt(s)
     optcmd= {}
     s << "Service"
     optcmd['classdef'] = s
-    #should work but doesn't, driver name is derived from classname
-    #if you specify both it breaks, same thing for client_skelton
-    #optcmd['driver'] = s
-    optcmd['driver'] = nil
-    #optcmd['client_skelton'] = nil
     optcmd['force'] = true
+    optcmd['mapping_registry'] = true
+    optcmd['driver'] = nil
+
+    # Causes soap4r to wrap the classes it outputs into the given modules
+    optcmd['module_path'] = ['AdWords', s]
     return optcmd
 end
   
@@ -155,12 +142,12 @@ PKG_FILES = FileList[
   'scripts/**/*.rb'
 ]
 
-puts PKG_FILES
+#puts PKG_FILES
 
 PKG_FILES.exclude(/\._/)
 
 if ! defined?(Gem)
-  puts "Package Target requires RubyGEMs"
+  puts "Package Target requires RubyGems"
 else
   spec = Gem::Specification.new do |s|
     
@@ -173,9 +160,8 @@ else
 Adwords4r provides an easy to use way to access the AdWords API in ruby.\
 Currently the following AdWords API versions are supported:\
 \
-* V4\
-* V5\
-* V6\
+* V10\
+* V11\
 }
 
     s.files = PKG_FILES.to_a
@@ -192,18 +178,17 @@ Currently the following AdWords API versions are supported:\
 #      '--main' << 'README' <<
 #      '--line-numbers'
     
-    s.author = "Patrick Chanezon"
-    s.email = "patrick@chanezon.com"
-    s.homepage = "http://rubyforge.org/projects/adwords4r/"
-    s.requirements << 'soap4r v 1.5.4 or greater'
-    s.requirements << 'http-access2 v 2.0.5 or greater'
-    s.rubyforge_project = 'adwords4r'
+    s.author = "Jeffrey Posnick, Patrick Chanezon, Ryan Leavengood"
+    s.email = "jeffy@google.com"
+    s.homepage = "http://rubyforge.org/projects/google4r/"
+    s.requirements << 'soap4r v1.5.6 or greater'
+    s.requirements << 'httpclient v2.1.2 or greater'
+    s.rubyforge_project = 'google4r'
+    s.add_dependency('soap4r', '>= 1.5.6')
+    s.add_dependency('httpclient', '>= 2.1.2')
   end
   
-    Rake::GemPackageTask.new(spec) do |t|
-      t.need_tar = true
-    end
+  Rake::GemPackageTask.new(spec) do |t|
+    t.need_tar = true
+  end
 end
-
-#require 'scripts/publish'
-

data/Readme.txt

@@ -1,19 +1,31 @@
-Google adwwords4r Library
-----------------------
+Google adwwords4r Library
+-------------------------
 
-Welcome to adwords4r, bringing the delights of ruby programming to the AdWords world: AdWords::API.new.getAllAdWordsCampaigns(123).each {|c| puts c.name}
+Welcome to adwords4r: Bringing the delights of ruby programming to the AdWords world!
 
-Not much doc or comments yet
+	 AdWords::API.new.getAllAdWordsCampaigns(123).each {|c| puts c.name}
 
-docs for users
+Documentation and comments are a work in progress.
+
+
+Useful Web Resources
+--------------------
+
+- AdWords home: https://adwords.google.com/
+- The AdWords API main documentation: http://www.google.com/apis/adwords/developer/index.html
+- This project's Google Code page: http://code.google.com/p/google-api-adwords-ruby/
+
+
+Docs for Users
 --------------
 
 adwords4r is a ruby gem.  See http://docs.rubygems.org/read/book/1
+
 Install it using the gem install command.
 > gem install --remote adwords4r
 
 Requirements are:
-    s.requirements << 'soap4r v 1.5.4 or greater'
+    s.requirements << 'soap4r v 1.5.6 or greater'
     s.requirements << 'http-access2 v 2.0.5 or greater'
 (see gem file for details)
 
@@ -45,7 +57,7 @@ adwords = AdWords::API.new(credentials, version)
 
 In order to use the sandbox, you can add a credential named
 alternateUrl, like:
-alternateUrl=https://sandbox.google.com/api/adwords/v5/
+alternateUrl=https://sandbox.google.com/api/adwords/v11/
 
 Then just use methods of the API against your driver.
 adwords.getAllAdWordsCampaigns(123).each {|c| puts c.name}
@@ -57,8 +69,15 @@ Many: warning: already initialized constant XXX
 A few: at depth 0 - 20: unable to get local issuer certificate
 These are not serious: I need to make them go but they do not affect the correctness of the program.
 
-docs for developers
+It is often useful to see a trace of the raw SOAP XML being sent and received.
+To enable this, set the ADWORDS4R_DEBUG environment variable to TRUE.
+e.g. in the bash shell, 'export ADWORDS4R_DEBUG=TRUE'
+The SOAP logs will be written to the current directory.
+
+
+Docs for Developers
 -------------------
+
 rake getwsdl
     to get the wsdl files
 rake generate
@@ -79,6 +98,4 @@ CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
 GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
 HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
 LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF
-THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 
-
-It is fun to use adwords4r anyway...
+THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

data/Todo.txt

@@ -18,12 +18,4 @@ SOAP::Property.loadproperty("adwords.properties")'
 - pass in a hash for complex objects
 - comments everywhere, rdoc
 - documentation
-- more samples: traffic_estimator, report, 
-
-OK- generate v4
-OK- get rid of yaml dependency
-OK- change the property file name to adwords.properties
-OK- make it work with all generated classes in their own module
-OK- fix bug in InfoService
-OK- gem file
-OK- traditional setup file
+- more samples: traffic_estimator, report,

data/adwords.properties

@@ -1,7 +1,7 @@
-token=my_token
-useragent=P@ playing with the API from ruby
-password=my_very_secret_password
-email=toto@example.com
-clientEmail=titi@example.com
-applicationToken=
-alternateUrl=https://sandbox.google.com/api/adwords/v6/
+token=DEVELOPER_TOKEN
+applicationToken=APPLICATION_TOKEN
+useragent=APPLICATION_NAME
+password=ADWORDS_PASSWORD
+email=ADWORDS_MCC_LOGIN
+clientEmail=OPTIONAL_CLIENT_LOGIN
+#alternateUrl=https://sandbox.google.com/api/adwords/v11/

data/examples/campaign.rb

@@ -1,7 +1,9 @@
 #!/usr/bin/env ruby
 
+# Use adwords4r in parent dir
+$LOAD_PATH.unshift '../lib/'
+
 require 'adwords4r'
-require 'pp'
 
 SEP = "---"
 
@@ -20,14 +22,14 @@ end
 begin
     adwords = AdWords::API.new
     
-    res = adwords.getAllAdWordsCampaigns(123)
+    res = adwords.getAllAdWordsCampaigns(123).getAllAdWordsCampaignsReturn
     res.each {|c| puts dumpObj(c)}
-    #adwords.getAllAdWordsCampaigns(123).each {|c| puts dumpObj(c)}
+
     c = AdWords::Campaign.new
     c.dailyBudget = 10000
     c.status = 'Paused'
-    c.name = "Test P@ #{rand(10000)}"
-    c.endDay = SOAP::SOAPDate.new("2011-01-01+01:00")
+    c.name = "Test Campaign #{rand(10000)}"
+    c.endDay = SOAP::SOAPDate.new("2010-01-01")
     puts dumpObj(adwords.addCampaign(c).addCampaignReturn)
 
 rescue AdWords::Error::UnknownAPICall => e

data/examples/framework.rb

@@ -1,6 +1,8 @@
 #!/usr/bin/env ruby
 
+# Use adwords4r in parent dir
+$LOAD_PATH.unshift '../lib/'
+
 require 'adwords4r'
-require 'pp'
 
 adwords = AdWords::API.new

data/examples/get_free_usage_this_month.rb

@@ -1,7 +1,9 @@
 #!/usr/bin/env ruby
 
+# Use adwords4r in parent dir
+$LOAD_PATH.unshift '../lib/'
+
 require 'adwords4r'
-require 'pp'
 
 begin
     adwords = AdWords::API.new

data/examples/get_unit_count.rb

@@ -1,11 +1,16 @@
 #!/usr/bin/env ruby
 
+# Use adwords4r in parent dir
+$LOAD_PATH.unshift '../lib/'
+
 require 'adwords4r'
-require 'pp'
 
 begin
     adwords = AdWords::API.new
-    puts "result = #{adwords.getUnitCount(Date.new(2006, 4,1), Date.new(2006,4,13)).getUnitCountReturn}"
+    # Get the units for the last month or so
+    end_date = Date.today
+    start_date = end_date - 31
+    puts "result = #{adwords.getUnitCount(start_date, end_date).getUnitCountReturn}"
 
 rescue AdWords::Error::UnknownAPICall => e
     puts e

data/examples/keyword_tool_demo.rb

@@ -1,5 +1,8 @@
 #!/usr/bin/env ruby
 
+# Use adwords4r in parent dir
+$LOAD_PATH.unshift '../lib/'
+
 require 'adwords4r'
 
 def printkw(kw, gname)
@@ -7,8 +10,8 @@ def printkw(kw, gname)
 end
 
 begin
-    if (ARGV.length < 1) then
-        puts "usage keyword_tool_demo.rb url" 
+    if (ARGV.length < 1)
+        puts "Usage: #$0 <url>" 
         exit
     end
     adwords = AdWords::API.new

data/examples/traffic_estimator.rb

@@ -1,7 +1,9 @@
 #!/usr/bin/env ruby
 
+# Use adwords4r in parent dir
+$LOAD_PATH.unshift '../lib/'
+
 require 'adwords4r'
-require 'pp'
 
 SEP = "---"
 
@@ -20,7 +22,8 @@ end
 begin
     adwords = AdWords::API.new
     
-    res = adwords.estimateKeywordList([AdWords::KeywordRequest.new(nil, 50000, false, 'flowers', 'Broad')])
+    res = adwords.estimateKeywordList(
+        [AdWords::KeywordRequest.new(nil, 50000, false, 'flowers', 'Broad')]).estimateKeywordListReturn
     res.each {|c| puts dumpObj(c)}
 
 rescue AdWords::Error::UnknownAPICall => e

data/lib/adwords4r.rb

@@ -1,162 +1,172 @@
+require 'rubygems'
+begin
+  gem 'soap4r'
+rescue
+  require_gem 'soap4r'
+end
 require 'soap/soap'
+require 'soap/mapping'
 require 'adwords4r/credentials'
 require 'adwords4r/services'
 
+# Fix an issue with SOAPDate. Google complains if the dates have any timezone
+# info in them. There are probably better ways to fix this.
+module SOAP
+  class SOAPDate
+    def of2tz(offset)
+      diffmin = offset * 24 * 60
+      if diffmin.zero?
+        ''
+      else
+        ((diffmin < 0) ? '-' : '+') << format('%02d:%02d',
+          (diffmin.abs / 60.0).to_i, (diffmin.abs % 60.0).to_i)
+      end
+    end
+  end
+end
+
 module AdWords
 
-    class API
-        attr_reader :credentials, :drivers, :version
-        @methodMap = Hash.new
-        
-        def initialize(*parm)
-            if parm[0] 
-                @credentials = parm[0]
-            else
-                @credentials = AdWordsCredentials.new
-            end
-            if parm[1] 
-                @version = parm[1]
-            else
-                @version = Service.getVersions.sort.last
-            end
-            @drivers = Hash.new
-            prepareDrivers
-            fix_soap4r
-        end
-        
-        def method_missing(m, *args)
-            methodName = m.id2name
-            requestName = AdWords::fix_case_up(m.id2name) # upper first character
-            if valid_call?(methodName)
-                constructor = eval("AdWords::#{requestName}.method(\"new\")")
-                req = constructor.call(*args)
-                resp = eval("getDriver(methodName).#{methodName}(req)")
-                return resp
-            else
-                raise(Error::UnknownAPICall, "Unknown API Call: #{requestName}", caller)
-            end
-            # Handle AdWords Application-level error
-            rescue SOAP::FaultError => fault
-                raise(Error::ApiError.new(fault), "#{methodName} Call Failed: #{fault.faultstring.to_s}", caller)
-        end
-        
-        private
-        
-        #nasty but does the job
-        #Todo: remove when Hiroshi fix soap4r bug
-        #Todo: it would be more elegant to use alias_method but I could not
-        #make it work with class methods
-        #Todo: could also check if the class is in my module before adding it
-        def fix_soap4r
-          a = %q{
-          def self.class_from_name(name, lenient = false)
-            const = const_from_name('AdWords::' + name, lenient)
-            if const.is_a?(::Class)
-              const
-            else
-              nil
-            end
+  class API
+    attr_reader :credentials, :drivers, :version
+    @methodMap = Hash.new
+
+    def initialize(credentials = AdWordsCredentials.new, version = Service.getVersions.sort.last)
+      @credentials, @version = credentials, version
+      @drivers = Hash.new
+      prepareDrivers
+    end
+
+    def method_missing(m, *args)
+      methodName = m.id2name
+      requestName = AdWords::fix_case_up(m.id2name) # upper first character
+      if valid_call?(methodName)
+        driver = getDriver(methodName)
+        moduleName = driver.class.name.split("::")[0..-2].join("::")
+        constructor = eval("#{moduleName}::#{requestName}.method('new')")
+        req = constructor.call(*args)
+        return driver.send(methodName, req)
+      else
+        raise(Error::UnknownAPICall, "Unknown API Call: #{requestName}", caller)
+      end
+      # Handle AdWords Application-level error
+    rescue SOAP::FaultError => fault
+      raise(Error::ApiError.new(fault), "#{methodName} Call Failed: #{fault.faultstring.to_s}", caller)
+    end
+
+    def prepareDrivers()
+      Service.doRequire(@version)
+      Service.getServices(@version).each {|s| @drivers[s] = prepareDriver(s)}
+      @methodMap = Service.getMethodMap(@drivers)
+    end
+
+    #pass in call name, get the driver back
+    def getDriver(call)
+      return @methodMap[call]
+    end
+
+    def prepareDriver(s)
+      # Include the module for this service
+      AdWords.class_eval("include #{s}Service")
+
+      #set alternateurl if it has been set in credentials
+      if (@credentials.alternateUrl) then
+        endpointUrl = @credentials.alternateUrl + s + 'Service'
+        driver = eval("AdWords::#{getServiceName(s)}.new(\"#{endpointUrl}\")")
+      elsif
+        driver = eval("AdWords::#{getServiceName(s)}.new")
+      end
+      @credentials.handlers.each {|h| driver.headerhandler << h}
+
+      if ENV['ADWORDS4R_DEBUG'].upcase == 'TRUE'
+        driver.wiredump_file_base = "SOAP_#{$$}"
+      end
+
+      driver.options['protocol.http.ssl_config.verify_mode'] = nil
+      #set driver.proxy if you are behing a proxy
+      return driver
+    end
+
+    def getServiceName(s)
+      s + "Interface"
+    end
+
+    def valid_call?(call)
+      return @methodMap.has_key?(call)
+    end
+
+  end
+
+  class Error
+    class Error < StandardError; end
+
+    # Raised if a call is made to a method that does not exist in the AdWords SOAP API
+    class UnknownAPICall < Error; end
+
+    # Raised if an attempt is made to instantiate a type that does not exist in the AdWords SOAP API
+    class UnknownType < Error; end
+
+    # Raised if a call returns with a SOAP error, gives you easy access to adwords error fields
+    class ApiError < Error
+
+      attr_accessor :soap_faultcode
+      attr_accessor :soap_faultstring
+      attr_accessor :top_code
+      attr_accessor :internal
+      attr_accessor :message
+      attr_accessor :code
+      attr_accessor :detail
+      attr_accessor :field
+      attr_accessor :index
+      attr_accessor :isExemptable
+      attr_accessor :textIndex
+      attr_accessor :textLength
+      attr_accessor :trigger
+
+      def initialize(soap_fault)
+        @soap_faultcode = protect { soap_fault.faultcode }
+        @soap_faultstring = protect { soap_fault.faultstring }
+        if protect { soap_fault.detail and soap_fault.detail.fault }
+          fault = soap_fault.detail.fault
+          @top_code = protect { fault.code }
+          @internal = protect { fault.internal }
+          @message = protect { fault.message }
+          if protect { fault.errors and fault.errors.size > 0 }
+            error = fault.errors.first
+            @code = protect { error.code }
+            @detail = protect { error.detail }
+            @field = protect { error.field }
+            @index = protect { error.index }
+            @isExemptable = protect { error.isExemptable }
+            @textIndex = protect { error.textIndex }
+            @textLength = protect { error.textLength }
+            @trigger = protect { error.trigger }
           end
-          }
-          
-          SOAP::Mapping.module_eval(a)
         end
-        
-        def prepareDrivers()
-            Service.doRequire(@version)
-            Service.getServices(@version).each {|s| @drivers[s] = prepareDriver(s)}
-            @methodMap = Service.getMethodMap(@drivers)
-        end
-        
-        #pass in call name, get the driver back
-        def getDriver(call)
-            return @methodMap[call]
-        end
-        
-        def prepareDriver(s)
-            #driver = eval("AdWordsV#{@version}::#{getServiceName(s)}.new")
-            #set alternateurl if it has been set in credentials
-            if (@credentials.alternateUrl) then
-               endpointUrl = @credentials.alternateUrl + s + 'Service'
-               driver = eval("#{getServiceName(s)}.new(\"#{endpointUrl}\")")
-            elsif
-                driver = eval("#{getServiceName(s)}.new")
-            end
-            @credentials.handlers.each {|h| driver.headerhandler << h}
-            #driver.wiredump_dev = STDOUT if @debug
-            driver.wiredump_file_base = "log"
-            driver.options['protocol.http.ssl_config.verify_mode'] = nil
-            #set driver.proxy if you are behing a proxy
-            return driver
-        end
-        
-        #workaround the bug: some services do not follow the naming convention
-        def getServiceName(s)
-            if s == "TrafficEstimator" then "TrafficEstimatorInterface"
-            elsif s == "Report" then "ReportServiceInterface"
-            elsif s == "Info" then "InfoServiceInterface"
-            elsif s == "KeywordTool" then "KeywordToolInterface"
-            else (s + "Service")
-            end
-        end
-        
-        def valid_call?(call)
-            return @methodMap.has_key?(call)
+      end
+
+      private
+      def protect(&block)
+        begin
+          block.call
+        rescue
+          nil
         end
-    
+      end
     end
+  end
 
-    #copied and adapted from ebay4r
-    #maybe these type of handlers should be generalized and put in soap4r 
-    #for other api projects to be able to get started more quickly
-    class Error
-        class Error < StandardError; end
-        
-        # Raised if a call is made to a method that does not exist in the AdWords SOAP API
-        class UnknownAPICall < Error; end
-        
-        # Raised if an attempt is made to instantiate a type that does not exist in the AdWords SOAP API
-        class UnknownType < Error; end
-        
-        # Raised if a call returns with a SOAP error, gives you easy access to adwords error fields
-        class ApiError < Error
-        
-            attr_accessor :soap_faultcode
-            attr_accessor :soap_faultstring
-            attr_accessor :code
-            attr_accessor :internal
-            attr_accessor :message
-            attr_accessor :trigger
-            attr_accessor :violations
-            
-            def initialize(fault)
-                @soap_faultcode = getOrNil(fault, 'faultcode')
-                @soap_faultstring = getOrNil(fault, 'faultstring')
-                @code = getOrNil(fault.detail, 'code')
-                @internal = getOrNil(fault.detail,'internal')
-                @message = getOrNil(fault.detail,'message')
-                @trigger = getOrNil(fault.detail,'trigger')
-                @violations = getOrNil(fault.detail,'violations')
-            end
-            
-            private
-            def getOrNil(obj, meth)
-                obj.respond_to?(meth) ? eval("obj.#{meth}") : nil
-            end
-        end
+  # These class module methods are helper functions
+  class <<self 
+
+    def fix_case_up(name)
+      name[0] = name[0, 1].upcase # upper first character
+      name
     end
 
-    # These class module methods are helper functions
-    class <<self 
-    
-      def fix_case_up(name)
-        name[0] = name[0,1].upcase # upper first character
-        name
-      end
-    
-      def fix_case_down(name)
-        name[0] = name[0,1].downcase
-        name
-      end
+    def fix_case_down(name)
+      name[0] = name[0, 1].downcase
+      name
     end
+  end
 end