lipstick 1.0.0.pre

checksums.yaml

@@ -0,0 +1,15 @@
+---
+!binary "U0hBMQ==":
+  metadata.gz: !binary |-
+    ODY3NmJjZmI3ODJkODBmMzVmNmMzYjZiYzUxODg2YTg0YjAyYTA2Nw==
+  data.tar.gz: !binary |-
+    MDYzZTM4ZWY1ODBkZmI4YjFiODQ2MmMyZmUzYTVjNTAyYzcwYTRjOA==
+SHA512:
+  metadata.gz: !binary |-
+    ZWY5ZmU4ODM5NGYyMjlhMWQzNDU4ZTg2MTYwZWFhZGI2M2NmZjljMTBkNzZj
+    YmUzNmY2ZDkwODQwY2I3YWMzNmQ5Zjc3OWM4OTE1Y2U0MDM4MmE1N2YyOGVi
+    ZDY5MzA3MmJlMWYyY2VhZjk2ZWZjZTA2ZGQ3NzFjNzY1MDIwMGQ=
+  data.tar.gz: !binary |-
+    NDNjMTlhYWJhOGYzYmE5NDkxOWY3MWZiYjkyNjZlNjAzMDZiZTIzMmRjOGE2
+    ODg3MmRmMTcxZWY2ODA5ODEyYTQ5Y2U5M2Q5NjQyNTMwMWQwYmUxNTdlNGJi
+    M2E4MGZiZDc5YjQzYjIzZTIxYWQ5NTY1MDk0ZGExNzZjYzdkNTU=

data/.document

@@ -0,0 +1,5 @@
+lib/**/*.rb
+bin/*
+- 
+features/**/*.feature
+LICENSE.txt

data/Gemfile

@@ -0,0 +1,15 @@
+source "http://rubygems.org"
+# Add dependencies required to use your gem here.
+# Example:
+#   gem "activesupport", ">= 2.3.5"
+
+# Add dependencies to develop your gem here.
+# Include everything needed to run rake, tests, features, etc.
+group :development do
+  gem "minitest", ">= 0"
+  gem "yard", "~> 0.7"
+  gem "rdoc", "~> 3.12"
+  gem "bundler", "~> 1.0"
+  gem "jeweler", "~> 2.0.1"
+  gem "simplecov", ">= 0"
+end

data/Gemfile.lock

@@ -0,0 +1,67 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    addressable (2.3.6)
+    builder (3.2.2)
+    descendants_tracker (0.0.4)
+      thread_safe (~> 0.3, >= 0.3.1)
+    docile (1.1.5)
+    faraday (0.9.0)
+      multipart-post (>= 1.2, < 3)
+    git (1.2.8)
+    github_api (0.12.2)
+      addressable (~> 2.3)
+      descendants_tracker (~> 0.0.4)
+      faraday (~> 0.8, < 0.10)
+      hashie (>= 3.3)
+      multi_json (>= 1.7.5, < 2.0)
+      nokogiri (~> 1.6.3)
+      oauth2
+    hashie (3.3.1)
+    highline (1.6.21)
+    jeweler (2.0.1)
+      builder
+      bundler (>= 1.0)
+      git (>= 1.2.5)
+      github_api
+      highline (>= 1.6.15)
+      nokogiri (>= 1.5.10)
+      rake
+      rdoc
+    json (1.8.1)
+    jwt (1.0.0)
+    mini_portile (0.6.1)
+    minitest (5.4.2)
+    multi_json (1.10.1)
+    multi_xml (0.5.5)
+    multipart-post (2.0.0)
+    nokogiri (1.6.4.1)
+      mini_portile (~> 0.6.0)
+    oauth2 (1.0.0)
+      faraday (>= 0.8, < 0.10)
+      jwt (~> 1.0)
+      multi_json (~> 1.3)
+      multi_xml (~> 0.5)
+      rack (~> 1.2)
+    rack (1.5.2)
+    rake (10.3.2)
+    rdoc (3.12.2)
+      json (~> 1.4)
+    simplecov (0.9.1)
+      docile (~> 1.1.0)
+      multi_json (~> 1.0)
+      simplecov-html (~> 0.8.0)
+    simplecov-html (0.8.0)
+    thread_safe (0.3.4)
+    yard (0.8.7.6)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler (~> 1.0)
+  jeweler (~> 2.0.1)
+  minitest
+  rdoc (~> 3.12)
+  simplecov
+  yard (~> 0.7)

data/LICENSE.txt

@@ -0,0 +1,20 @@
+Copyright (c) 2014 Piers Chambers and South Beach Skin Care, LLC
+
+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.rdoc

@@ -0,0 +1,24 @@
+= Lipstick
+
+Unofficial ruby wrapper for the following Lime Light CRM APIs:
+
+* {Membership API}[http://help.limelightcrm.com/entries/317874-Membership-API-Documentation]
+* {Transaction API}[http://help.limelightcrm.com/entries/22934241-Transaction-API-Documentation]
+
+Note this wrapper attempts to fix some of the inconsistencies in the underlying APIs.
+
+To run the tests you will need your own Lime Light CRM account with a valid campaign and test payment method.
+
+== Contributing to lipstick
+ 
+* Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet.
+* Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it.
+* Fork the project.
+* Start a feature/bugfix branch.
+* Commit and push until you are happy with your contribution.
+* Make sure to add tests for it. This is important so I don't break it in a future version unintentionally.
+* Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.
+
+Copyright (c) 2014 Piers Chambers and South Beach Skin Care, LLC. See LICENSE.txt for
+further details.
+

data/Rakefile

@@ -0,0 +1,44 @@
+# encoding: utf-8
+
+require 'rubygems'
+require 'bundler'
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+require 'rake'
+
+require 'jeweler'
+Jeweler::Tasks.new do |gem|
+  # gem is a Gem::Specification... see http://guides.rubygems.org/specification-reference/ for more options
+  gem.name = "lipstick"
+  gem.homepage = "http://github.com/varyonic/lipstick"
+  gem.license = "MIT"
+  gem.summary = %Q{Unofficial ruby wrapper for the Lime Light CRM APIs.}
+  gem.description = %Q{Unofficial ruby wrapper for the Lime Light CRM membership and transaction APIs}
+  gem.email = "piers@varyonic.com"
+  gem.authors = ["Piers Chambers"]
+  # dependencies defined in Gemfile
+end
+Jeweler::RubygemsDotOrgTasks.new
+
+require 'rake/testtask'
+Rake::TestTask.new(:test) do |test|
+  test.libs << 'lib' << 'test'
+  test.pattern = 'test/**/test_*.rb'
+  test.verbose = true
+end
+
+desc "Code coverage detail"
+task :simplecov do
+  ENV['COVERAGE'] = "true"
+  Rake::Task['test'].execute
+end
+
+task :default => :test
+
+require 'yard'
+YARD::Rake::YardocTask.new

data/VERSION

@@ -0,0 +1 @@
+1.0.0.pre

data/lib/lipstick.rb

@@ -0,0 +1,10 @@
+require 'logger'
+require 'lipstick/api/session.rb'
+require 'lipstick/api/response.rb'
+require 'lipstick/api/campaign_view_response.rb'
+require 'lipstick/api/campaign_find_active_response.rb'
+require 'lipstick/api/customer_find_active_product_response.rb'
+require 'lipstick/api/new_order_response.rb'
+require 'lipstick/api/order_find_response.rb'
+require 'lipstick/api/order_find_updated_response.rb'
+require 'lipstick/api/order_view_response.rb'

data/lib/lipstick/api/campaign_find_active_response.rb

@@ -0,0 +1,12 @@
+module Lipstick
+  module Api
+    class CampaignFindActiveResponse < Response
+      int_csv_field :campaign_id
+      csv_field :campaign_name
+      def initialize(fields)
+        fields[:response_code] = fields.delete(:response)
+        super fields
+      end
+    end
+  end
+end

data/lib/lipstick/api/campaign_view_response.rb

@@ -0,0 +1,10 @@
+module Lipstick
+  module Api
+    class CampaignViewResponse < Response
+      csv_field :product_id, :product_name, :is_upsell
+      csv_field :shipping_id, :shipping_name, :shipping_description
+      csv_field :shipping_recurring_price, :shipping_initial_price
+      csv_field :countries, :payment_name
+    end
+  end
+end

data/lib/lipstick/api/customer_find_active_product_response.rb

@@ -0,0 +1,7 @@
+module Lipstick
+  module Api
+    class CustomerFindActiveProductResponse < Response
+      int_csv_field :product_ids
+    end
+  end
+end

data/lib/lipstick/api/new_order_response.rb

@@ -0,0 +1,17 @@
+module Lipstick
+  module Api
+    class NewOrderResponse < Response
+      def initialize(fields)
+        fields.keys.each do |key|
+          fields[underscore(key.to_s).to_sym] = fields.delete(key)
+        end
+        if fields[:response_code] == '100'
+          fields[:test] = (fields[:test] == '1')
+          fields[:customer_id] = fields.delete(:customer_id).to_i
+          fields[:order_id] = fields.delete(:order_id).to_i
+        end
+	    super(fields)
+      end
+    end
+  end
+end

data/lib/lipstick/api/order_find_response.rb

@@ -0,0 +1,7 @@
+module Lipstick
+  module Api
+    class OrderFindResponse < Response
+      int_csv_field :order_ids
+    end
+  end
+end

data/lib/lipstick/api/order_find_updated_response.rb

@@ -0,0 +1,7 @@
+module Lipstick
+  module Api
+    class OrderFindUpdatedResponse < Response
+      int_csv_field :order_ids
+    end
+  end
+end

data/lib/lipstick/api/order_view_response.rb

@@ -0,0 +1,65 @@
+require 'pp'
+require 'bigdecimal'
+require 'ostruct'
+
+module Lipstick
+  module Api
+    class OrderViewResponse < Response
+      def initialize(fields)
+        fields.keys.each do |key|
+          fields[underscore(key.to_s).to_sym] = fields.delete(key)
+        end
+        fields[:customer] = OpenStruct.new(
+          id:          fields.delete(:customer_id).to_i,
+          first_name:  fields.delete(:first_name),
+          last_name:   fields.delete(:last_name),
+          telephone:   fields.delete(:customers_telephone),
+          email_address: fields.delete(:email_address)
+        )
+        fields[:shipping] = OpenStruct.new(
+          first_name:      fields.delete(:shipping_first_name),
+          last_name:       fields.delete(:shipping_last_name),
+          street_address:  fields.delete(:shipping_street_address),
+          street_address2: fields.delete(:shipping_street_address2),
+          city:            fields.delete(:shipping_city),
+          state:           fields.delete(:shipping_state),
+          state_id:        fields.delete(:shipping_state_id),
+          postcode:        fields.delete(:shipping_postcode),
+          country:         fields.delete(:shipping_country),
+        )
+        fields[:billing] = OpenStruct.new(
+          first_name:      fields.delete(:billing_first_name),
+          last_name:       fields.delete(:billing_last_name),
+          street_address:  fields.delete(:billing_street_address),
+          street_address2: fields.delete(:billing_street_address2),
+          city:            fields.delete(:billing_city),
+          state:           fields.delete(:billing_state),
+          state_id:        fields.delete(:billing_state_id),
+          postcode:        fields.delete(:billing_postcode),
+          country:         fields.delete(:billing_country),
+        )
+        fields[:order] = OpenStruct.new(
+          customer:        fields[:customer],
+          ancestor_id:     fields.delete(:ancestor_id).to_i,
+          child_id:        fields.delete(:child_id).to_i,
+          status:          fields.delete(:order_status).to_i,
+          is_recurring:    fields.delete(:is_recurring)=='1',
+          shipping:        fields[:shipping],
+          shipping_method_name: fields.delete(:shipping_method_name),
+          billing:         fields[:billing],
+          created_at:      DateTime.strptime(fields.delete(:time_stamp),'%Y-%m-%d %H:%M:%S'),
+          cc_number:       fields.delete(:cc_number),
+          cc_expires:      fields.delete(:cc_expires),
+          campaign_id:     fields.delete(:campaign_id).to_i,
+
+          order_total:     BigDecimal.new(fields.delete(:order_total)),
+          parent_id:       fields.delete(:parent_id).to_i,
+          transaction_id:  fields.delete(:transaction_id),
+          auth_id:         fields.delete(:auth_id),
+        )
+      	# PP.pp fields # TODO: parse remaining fields
+        super
+      end
+    end
+  end
+end

data/lib/lipstick/api/response.rb

@@ -0,0 +1,155 @@
+module Lipstick
+  module Api
+    class Response
+      CODES = {
+        100 => 'Success',
+        200 => 'Invalid login credentials',
+        320 => 'Invalid Product Id',
+        321 => 'Existing Product Category Id Not Found',
+        322 => 'Invalid Category Id',
+        323 => 'Digital Delivery and Digital URL must be paired together and digital URL must be a valid URL',
+        324 => 'Invalid rebill_product or rebill_days value',
+        325 => 'Length Does Not Meet Minimum',
+        326 => 'URL is invalid',
+        327 => 'Payment Type Invalid',
+        328 => 'Expiration Date Invalid (Must be in the format of MMYY with no special characters)',
+        329 => 'Credit card must be either 15 or 16 digits numeric only',
+        330 => 'No Status Passed',
+        331 => 'Invalid Criteria',
+        332 => 'Start and end date are required',
+        333 => 'No Orders Found',
+        334 => 'Invalid Start Date format',
+        335 => 'Invalid End Date format',
+        336 => 'Wild Card Unsupported for this search criteria',
+        337 => 'Last 4 or First 4 must be 4 characters exactly',
+        338 => 'Timestamp invalid',
+        339 => 'Total Amount must be numeric and non-negative',
+        340 => 'Invalid country code',
+        341 => 'Invalid state code',
+        342 => 'Invalid Email Address',
+        343 => 'Data Element Has Same Value As Value Passed No Update done (Information ONLY, but still a success)',
+        344 => 'Invalid Number Format',
+        345 => 'Must be a 1 or 0.  "1" being "On" or true. "0" being "Off" or false.',
+        346 => 'Invalid date format. Use mm/dd/yyyy',
+        347 => 'Invalid RMA reason',
+        348 => 'Order is already flagged as RMA',
+        349 => 'Order is not flagged as RMA',
+        350 => 'Invalid order Id supplied',
+        351 => 'Invalid status or action supplied',
+        352 => 'Uneven Order/Status/Action Pairing',
+        353 => 'Cannot stop recurring',
+        354 => 'Cannot reset recurring',
+        355 => 'Cannot start recurring',
+        356 => 'Credit card has expired',
+        360 => 'Cannot stop upsell recurring',
+        370 => 'Invalid amount supplied',
+        371 => 'Invalid keep recurring flag supplied',
+        372 => 'Refund amount exceeds current order total',
+        373 => 'Cannot void a fully refunded order',
+        374 => 'Cannot reprocess non-declined orders',
+        375 => 'Cannot blacklist test payment method',
+        376 => 'Invalid tracking number',
+        377 => 'Cannot ship pending orders',
+        378 => 'Order already shipped',
+        379 => 'Order is fully refunded/voided',
+        380 => 'Order is not valid for force bill',
+        381 => 'Customer is blacklisted',
+        382 => 'Invalid US state',
+        383 => 'All military states must have a city of either "APO", "FPO". or "DPO"',
+        384 => 'Invalid date mode',
+        385 => 'Invalid billing cycle filter',
+        386 => 'Order has already been returned',
+        387 => 'Invalid return reason',
+        388 => 'Rebill discount exceeds maximum for product',
+        389 => 'Refund  amount must be greater than 0',
+        390 => 'Invalid number of days supplied',
+        400 => 'Invalid campaign Id supplied',
+        401 => 'Invalid subscription type',
+        402 => 'Subscription type 3 requires subscription week and subscription day values',
+        403 => 'Invalid subscription week value',
+        404 => 'Invalid subscription day value',
+        405 => 'Subscription type 3 required for subscription week and subscription day values',
+        406 => 'Rebill days must be a value between 1 and 31 for subscription type 2',
+        407 => 'Rebill days must be greater than 0 if subscription type is 1 or 2',
+        408 => 'Rebill days is invalid unless type is 1 or 2',
+        409 => 'Subscription type 0, other subscription fields invalid',
+        410 => 'API user: (api_username) has reached the limit of requests per minute: (limit) for method: (method_name)',
+        411 => 'Invalid subscription field',
+        412 => 'Missing subscription field',
+        413 => 'Product is not subscription based',
+        415 => 'Invalid subscription value',
+        420 => 'Campaign does not have fulfillment provider attached',
+        421 => 'This order was placed on hold',
+        422 => 'This order has not been sent to fulfillment yet',
+        423 => 'Invalid SKU',
+        424 => 'Fulfillment Error, provider did not specify',
+        425 => 'This order has been sent to fulfillment but has not been shipped',
+        500 => 'Invalid customer Id supplied',
+        600 => 'Invalid product Id supplied',
+        601 => 'Invalid prospect Id supplied',
+        602 => 'No prospects found',
+        603 => 'Invalid customer Id supplied',
+        604 => 'No customers found',
+        700 => 'Invalid method supplied',
+        701 => 'Action not permitted by gateway',
+        702 => 'Invalid gateway Id',
+        800 => 'Transaction was declined',
+        901 => 'Invalid return URL',
+        902 => 'Invalid cancel URL',
+        903 => 'Error retrieving alternative provider data',
+        904 => 'Campaign does not support an alternative payment provider',
+        905 => 'Product quantity/dynamic price does not match',
+        906 => 'Invalid quantity',
+        907 => 'Invalid shipping Id',
+        908 => 'Payment was already approved',
+        1000 => 'SSL is required'
+      }
+      attr_reader :code, :message
+
+      class << self
+        def csv_field(*args)
+          @csv_fields ||= []
+          @csv_fields = @csv_fields + args
+        end
+        def int_csv_field(*args)
+          @int_csv_fields ||= []
+          @int_csv_fields = @int_csv_fields + args
+        end
+      end
+
+      def initialize(resp)
+        @code = resp.delete(:response_code).to_i
+        @message = CODES[@code]
+
+        if @code == 100
+          self.class.csv_field.each do |key|
+            resp[key] = CSV.parse_line(resp[key])
+          end
+          self.class.int_csv_field.each do |key|
+            resp[key] = CSV.parse_line(resp[key]).map(&:to_i)
+          end
+        end
+
+        if !resp.empty?
+          resp.each do |att, val|
+            self.class.__send__(:attr_accessor, att)
+            self.__send__("#{att}=", val)
+          end
+        end
+      end
+
+      # partly copied from activesupport/inflector
+      def underscore(camel_cased_word)
+        word = camel_cased_word.to_s.dup
+        word.gsub!(/([A-Z\d]+)([A-Z][a-z])/,'\1_\2')
+        word.gsub!(/([a-z\d])([A-Z])/,'\1_\2')
+        word.tr!("-", "_")
+        word.tr!("[", "_")
+        word.tr!("]", "")
+        word.downcase!
+        word
+      end
+
+    end
+  end
+end

data/lib/lipstick/api/session.rb

@@ -0,0 +1,193 @@
+require 'csv'
+
+module Lipstick
+  module Api
+    class Session
+      # API endpoint, eg. {https://example.com/admin}[https://example.com/admin]
+      attr_reader :base_url
+
+      # Hash containing :username, :password
+      attr_reader :credentials
+
+      # Used for logging request and response info.
+      attr_reader :logger
+
+      # Public: Initialize session.
+      #
+      # params - Hash
+      # * +:url+ - API endpoint, eg. {https://example.com/admin}[https://example.com/admin]
+      # * +:username+
+      # * +:password+
+      # * +:logger+ - Used for logging request and response info.
+      def initialize(params)
+        @base_url = params[:url] || raise("url not defined.")
+        raise("username missing") unless params[:username]
+        raise("password missing") unless params[:password]
+        @credentials = { username: params[:username], password: params[:password] }
+        @logger   = params[:logger] || Logger.new('/dev/null')
+      end
+
+      # Find all active campaigns.
+      def campaign_find_active
+        call_api(:campaign_find_active)
+      end
+
+      # Fetch details for a given campaign.
+      def campaign_view(campaign_id)
+        call_api(:campaign_view, campaign_id: campaign_id)
+      end
+
+      def customer_find_active_product(customer_id, campaign_id = nil)
+        params = { customer_id: customer_id }
+        params.merge!(campaign_id: campaign_id) if campaign_id
+        call_api(:customer_find_active_product, params)
+      end
+
+      # Create order for new customer
+      def new_order(params)
+        camelcase_params!(params)
+        call_api('NewOrder', params)
+      end
+
+      def order_find(start_time, end_time, params = {})
+        params.merge!(
+          start_date: start_time.strftime('%m/%d/%Y'),
+          start_time: start_time.strftime('%H:%M:%S'),
+          end_date:   end_time.strftime('%m/%d/%Y'),
+          end_time:   end_time.strftime('%H:%M:%S'))
+        params[:campaign_id] ||= 'all'
+        params[:product_id]  ||= 'all'
+        params[:criteria]    ||= 'all'
+        call_api(:order_find, params)
+      end
+
+      def order_find_updated(start_time, end_time, params = {})
+        params.merge!(
+          start_date: start_time.strftime('%m/%d/%Y'),
+          start_time: start_time.strftime('%H:%M:%S'),
+          end_date:   end_time.strftime('%m/%d/%Y'),
+          end_time:   end_time.strftime('%H:%M:%S'))
+        params[:campaign_id] ||= 'all'
+        call_api(:order_find_updated, params)
+      end
+
+      def order_refund(order_id, amount, keep_recurring = true)
+        call_api(:order_refund,
+                 order_id: order_id,
+                 amount: amount.to_s,
+                 keep_recurring: keep_recurring ? '1' : '0')
+      end
+
+      def order_update(order_id, action, value)
+        call_api(:order_update, order_ids: order_id, actions: action, values: value)
+      end
+
+      def order_update_recurring(order_id, status)
+        call_api(:order_update_recurring, order_id: order_id, status: status)
+      end
+
+      def order_view(order_id)
+        call_api(:order_view, order_id: order_id)
+      end
+
+      def order_void(order_id)
+        call_api(:order_void, order_id: order_id)
+      end
+
+      def shipping_method_find(campaign_id = 'all')
+        call_api(:shipping_method_find, campaign_id: campaign_id) do |fields|
+          if fields[:response_code] == '100'
+            [:shipping_ids].each do |key|
+              fields[key] = CSV.parse_line(fields[key]).map(&:to_i)
+            end
+          end
+        end
+      end
+
+      def validate_credentials
+        call_api(:validate_credentials)
+      end
+
+      # partly copied from activesupport/inflector
+      def underscore(camel_cased_word)
+        word = camel_cased_word.to_s.dup
+        word.gsub!(/([A-Z\d]+)([A-Z][a-z])/,'\1_\2')
+        word.gsub!(/([a-z\d])([A-Z])/,'\1_\2')
+        word.tr!("-", "_")
+        word.tr!("[", "_")
+        word.tr!("]", "")
+        word.downcase!
+        word
+      end
+
+      def camelize(str)
+        return str.to_s unless str.to_s.include?(?_)
+        str.to_s.split("_").each {|s| s.capitalize! }.join
+      end
+
+      protected
+      # Munge params into style accepted by transaction API.
+      def camelcase_params!(params)
+        params.keys.select {|key| key.is_a?(Symbol) && key.to_s.include?(?_) }.each do |key|
+          camelcase_key = camelize(key)
+          camelcase_key[0] = camelcase_key[0].chr.downcase
+          params[camelcase_key] = params.delete(key)
+        end
+      end
+
+      def call_api(method, params = {}, &block)
+        params = params.merge(method: method)
+        logger.info "request = #{params.inspect}"
+        response = post_form(uri_for(method), params.merge(credentials))
+        logger.info "response = #{response.inspect}"
+        logger.debug "response.body = #{response.body}"
+        if block_given?
+          api_response = parse_response(response, &block)
+        else
+          fields = response_fields(response)
+          klassname = "#{camelize(method)}Response".to_sym
+          klass = Lipstick::Api.constants.include?(klassname) ? Lipstick::Api.const_get(klassname) : Lipstick::Api::Response
+          api_response = klass.new(fields)
+        end
+        logger.info "API response = #{api_response.inspect}"
+        api_response
+      end
+
+      def uri_for(method)
+        api = ['NewOrder'].include?(method) ? 'transact' : 'membership'
+        URI.parse("#{base_url}/#{api}.php")
+      end
+
+      def post_form(uri, params)
+        post = Net::HTTP::Post.new(uri.request_uri)
+        post.set_form_data(params)
+        request(uri, post)
+      end
+
+      def request(uri, request)
+        http = Net::HTTP.new(uri.host, uri.port)
+        http.use_ssl = true
+        http.verify_mode = OpenSSL::SSL::VERIFY_NONE
+        http.request(request)
+      end
+
+      def response_fields(response)
+        if response.body.include?(?=)
+          CGI::unescape(response.body).split('&').inject({}) do |h,kv|
+            k,v = kv.split('=')
+            k = k.to_sym if k.match(/\w/)
+            h.merge( k => v )
+          end
+        else
+          { response_code: response.body }
+        end
+      end
+
+      def parse_response(response, &block)
+        fields = response_fields(response)
+        yield fields if block_given?
+        Lipstick::Api::Response.new(fields)
+      end
+    end
+  end
+end

data/lipstick.gemspec

@@ -0,0 +1,76 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
+# -*- encoding: utf-8 -*-
+# stub: lipstick 1.0.0.pre ruby lib
+
+Gem::Specification.new do |s|
+  s.name = "lipstick"
+  s.version = "1.0.0.pre"
+
+  s.required_rubygems_version = Gem::Requirement.new("> 1.3.1") if s.respond_to? :required_rubygems_version=
+  s.require_paths = ["lib"]
+  s.authors = ["Piers Chambers"]
+  s.date = "2014-11-28"
+  s.description = "Unofficial ruby wrapper for the Lime Light CRM membership and transaction APIs"
+  s.email = "piers@varyonic.com"
+  s.extra_rdoc_files = [
+    "LICENSE.txt",
+    "README.rdoc"
+  ]
+  s.files = [
+    ".document",
+    "Gemfile",
+    "Gemfile.lock",
+    "LICENSE.txt",
+    "README.rdoc",
+    "Rakefile",
+    "VERSION",
+    "lib/lipstick.rb",
+    "lib/lipstick/api/campaign_find_active_response.rb",
+    "lib/lipstick/api/campaign_view_response.rb",
+    "lib/lipstick/api/customer_find_active_product_response.rb",
+    "lib/lipstick/api/new_order_response.rb",
+    "lib/lipstick/api/order_find_response.rb",
+    "lib/lipstick/api/order_find_updated_response.rb",
+    "lib/lipstick/api/order_view_response.rb",
+    "lib/lipstick/api/response.rb",
+    "lib/lipstick/api/session.rb",
+    "lipstick.gemspec",
+    "test/helper.rb",
+    "test/test_lipstick.rb",
+    "test/test_order_view_response.rb"
+  ]
+  s.homepage = "http://github.com/varyonic/lipstick"
+  s.licenses = ["MIT"]
+  s.rubygems_version = "2.2.2"
+  s.summary = "Unofficial ruby wrapper for the Lime Light CRM APIs."
+
+  if s.respond_to? :specification_version then
+    s.specification_version = 4
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_development_dependency(%q<minitest>, [">= 0"])
+      s.add_development_dependency(%q<yard>, ["~> 0.7"])
+      s.add_development_dependency(%q<rdoc>, ["~> 3.12"])
+      s.add_development_dependency(%q<bundler>, ["~> 1.0"])
+      s.add_development_dependency(%q<jeweler>, ["~> 2.0.1"])
+      s.add_development_dependency(%q<simplecov>, [">= 0"])
+    else
+      s.add_dependency(%q<minitest>, [">= 0"])
+      s.add_dependency(%q<yard>, ["~> 0.7"])
+      s.add_dependency(%q<rdoc>, ["~> 3.12"])
+      s.add_dependency(%q<bundler>, ["~> 1.0"])
+      s.add_dependency(%q<jeweler>, ["~> 2.0.1"])
+      s.add_dependency(%q<simplecov>, [">= 0"])
+    end
+  else
+    s.add_dependency(%q<minitest>, [">= 0"])
+    s.add_dependency(%q<yard>, ["~> 0.7"])
+    s.add_dependency(%q<rdoc>, ["~> 3.12"])
+    s.add_dependency(%q<bundler>, ["~> 1.0"])
+    s.add_dependency(%q<jeweler>, ["~> 2.0.1"])
+    s.add_dependency(%q<simplecov>, [">= 0"])
+  end
+end
+

data/test/helper.rb

@@ -0,0 +1,81 @@
+require 'simplecov'
+
+module SimpleCov::Configuration
+  def clean_filters
+    @filters = []
+  end
+end
+
+SimpleCov.configure do
+  clean_filters
+  load_adapter 'test_frameworks'
+end
+
+ENV["COVERAGE"] && SimpleCov.start do
+  add_filter "/.rvm/"
+end
+require 'rubygems'
+require 'bundler'
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+require 'minitest/autorun'
+require 'minitest/unit'
+
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+require 'lipstick'
+
+require 'yaml'
+
+module Lipstick
+  module Fixtures
+    HOME_DIR = RUBY_PLATFORM =~ /mswin32/ ? ENV['HOMEPATH'] : ENV['HOME'] unless defined?(HOME_DIR)
+    LOCAL_CREDENTIALS = File.join(HOME_DIR.to_s, '.lipstick/fixtures.yml') unless defined?(LOCAL_CREDENTIALS)
+
+    def address(prefix, options = {})
+      {
+        "#{prefix}Address1" => '1234 My Street',
+        "#{prefix}Address2" => 'Apt 1',
+        "#{prefix}City"     => 'Ottawa',
+        "#{prefix}State"    => 'ON',
+        "#{prefix}Zip"      => 'K1C2N6',
+        "#{prefix}Country"  => 'CA',
+      }.update(options)
+    end
+
+    def all_fixtures
+      @@fixtures ||= load_fixtures
+    end
+
+    def fixtures(key)
+      data = all_fixtures[key] || raise(StandardError, "No fixture data was found for '#{key}'")
+      data.dup
+    end
+
+    def load_fixtures
+      [LOCAL_CREDENTIALS].inject({}) do |credentials, file_name|
+        if File.exist?(file_name)
+          yaml_data = YAML.load(File.read(file_name))
+          credentials.merge!(symbolize_keys(yaml_data))
+        end
+        credentials
+      end
+    end
+
+    def symbolize_keys(hash)
+      return hash unless hash.is_a?(Hash)
+      hash.each_with_object({}){|(k,v), h| h[k.to_sym] = symbolize_keys(v)}
+    end
+  end
+end
+
+def context(*args, &block)
+  describe(*args, &block)
+end
+
+Minitest.autorun

data/test/test_lipstick.rb

@@ -0,0 +1,186 @@
+require 'helper'
+
+include Lipstick::Fixtures
+
+describe 'Lipstick::Api::Session' do
+  before(:each) do
+    params = fixtures(:credentials)
+    params[:logger] = Logger.new(STDOUT) if ENV['DEBUG_LIPSTICK'] == 'true'
+    @session = Lipstick::Api::Session.new(params)
+  end
+
+  describe '#campaign_find_active' do
+    it "finds all active campaigns" do
+      api_response = @session.campaign_find_active
+      assert api_response.code == 100, "unexpected response: #{api_response.inspect}"
+      assert api_response.campaign_id.is_a?(Array)
+      assert api_response.campaign_id[0].is_a?(Integer)
+      assert api_response.campaign_name.is_a?(Array)
+    end
+  end
+
+  describe '#campaign_view' do
+    it "fetches attributes of a campaign" do
+      api_response = @session.campaign_find_active
+      campaign_id = api_response.campaign_id.sample
+      api_response = @session.campaign_view(campaign_id)
+      assert api_response.code == 100
+      assert api_response.product_id.is_a?(Array)
+      assert api_response.shipping_id.is_a?(Array)
+    end
+  end
+
+  context "sample campaign" do
+    let (:order_params) {
+      {
+        campaign_id: @campaign_id,
+        product_id:  @product_id,
+        first_name: 'Jim',
+        last_name:  'Smith',
+        phone:      '(555)555-5555',
+        email:      'test@test.com', # jim.smith@example.com'
+        credit_card_type: @credit_card_type,
+        credit_card_number: fixtures(:test_card_number),
+        expiration_date: '1219',
+        "CVV" => '123',
+        tran_type: 'NewOrder',
+        shipping_id: @shipping_method_id,
+        ip_address: '127.0.0.1',
+        upsell_count: 0,
+      }.update(address('shipping')).update(address('billing'))
+    }
+    before (:all) do
+      api_response = @session.campaign_find_active
+      @campaign_id = api_response.campaign_id.sample
+      @campaign = @session.campaign_view(@campaign_id)
+      @product_id = @campaign.product_id.sample
+      @credit_card_type = @campaign.payment_name.sample
+      @shipping_method_id = @campaign.shipping_id.sample
+    end
+
+    describe '#new_order' do
+      it "creates order" do
+        api_response = @session.new_order(order_params)
+        assert api_response.code == 100
+        assert api_response.test, "Expected #{api_response.test.inspect} to be true"
+        assert api_response.customer_id.is_a?(Integer), "Expected #{api_response.customer_id.inspect} to be an integer"
+        assert api_response.order_id.is_a?(Integer)
+        assert api_response.transaction_id == 'Not Available'
+        assert api_response.auth_id == 'Not Available'
+      end
+    end
+
+    context "existing order" do
+      before (:all) do
+        api_response = @session.new_order(order_params)
+        @order_id = api_response.order_id
+        @customer_id = api_response.customer_id
+      end
+
+      describe '#customer_find_active_product' do
+        it "fetches product ids" do
+          api_response = @session.customer_find_active_product(@customer_id)
+          assert api_response.code == 100
+          assert api_response.product_ids.is_a?(Array)
+          assert api_response.product_ids[0].is_a?(Integer)
+        end
+      end
+
+      describe '#order_find' do
+        it "returns orders matching criteria" do
+          api_response = @session.order_find(Time.now - 120, Time.now)
+          assert api_response.code == 100, "unexpected response: #{api_response.inspect}"
+          assert api_response.order_ids.is_a?(Array)
+          assert api_response.order_ids[0].is_a?(Integer)
+        end
+      end
+
+      describe '#order_refund' do
+        it "refunds the customer" do
+          api_response = @session.order_refund(@order_id, 0.01)
+          assert api_response.code == 100
+        end
+      end
+
+      describe '#order_view' do
+        it "returns details of an order" do
+          api_response = @session.order_view(@order_id)
+          assert api_response.code == 100, "unexpected response: #{api_response.inspect}"
+        end
+      end
+
+      describe '#order_update1' do
+        it 'posts chages to an order' do
+          api_response = @session.order_update(@order_id, :tracking_number, 'LC123456789012345678US')
+          assert api_response.code == 100
+        end
+      end
+
+      context "updated order" do
+        before (:each) do
+          api_response = @session.order_update(@order_id, :tracking_number, 'LC123456789012345678US')
+        end
+
+        describe '#order_find_updated' do
+          it "finds updated orders" do
+            api_response = @session.order_find_updated(Time.now - 128, Time.now)
+            assert api_response.code == 100, "unexpected response: #{api_response.inspect}"
+            assert api_response.order_ids.is_a?(Array)
+            assert api_response.order_ids[0].is_a?(Integer)
+          end
+        end
+      end
+    end # existing order
+
+    context "new order" do
+      before (:each) do
+        api_response = @session.new_order(order_params)
+        @new_order_id = api_response.order_id
+      end
+
+      describe '#order_update_recurring' do
+        it "cancels a new order" do
+          api_response = @session.order_update_recurring(@new_order_id,'stop')
+          assert api_response.code == 100, "unexpected response: #{api_response.inspect}"
+        end
+      end
+
+      describe '#order_void' do
+        it "cancels a new order" do
+          api_response = @session.order_void(@new_order_id)
+          assert api_response.code == 100, "unexpected response: #{api_response.inspect}"
+        end
+      end
+    end
+  end # sample campaign
+
+  describe '#shipping_method_find' do
+    it "finds shipping methods" do
+      api_response = @session.shipping_method_find
+      assert api_response.code == 100
+      assert api_response.shipping_ids.is_a?(Array)
+      assert api_response.shipping_ids[0].is_a?(Integer)
+    end
+  end
+
+  describe "validate_credentials" do
+    it "returns true if credentials valid" do
+      api_response = @session.validate_credentials
+      assert api_response.code == 100, "Credentials not valid."
+    end
+
+    it "returns false if credentials invalid" do
+      invalid_credentials = fixtures(:credentials).merge!(password: 'invalid')
+      @invalid_session = Lipstick::Api::Session.new(invalid_credentials)
+      api_response = @invalid_session.validate_credentials
+      assert api_response.code == 200, "Invalid credentials not detected."
+    end
+  end
+
+  describe '#underscore' do
+    it 'munges whatsit' do
+      foobar = @session.underscore('FooBar')
+      assert foobar == 'foo_bar', ">> #{foobar} <<"
+    end
+  end
+end

data/test/test_order_view_response.rb

@@ -0,0 +1,127 @@
+require 'helper'
+
+describe 'Lipstick::Api::OrderViewResponse' do
+  describe 'initialize' do
+    it 'parses the fields' do
+      fields = {
+        :response_code=>"100",
+        :ancestor_id=>"581006",
+        :customer_id=>"30346",
+        :parent_id=>"2081410",
+        :child_id=>nil,
+        :order_status=>"11",
+        :is_recurring=>"0",
+        :first_name=>"Jim",
+        :last_name=>"Smith",
+        :shipping_first_name=>"Jim",
+        :shipping_last_name=>"Smith",
+        :shipping_street_address=>"1234 My Street",
+        :shipping_street_address2=>"Apt 1",
+        :shipping_city=>"Ottawa",
+        :shipping_state=>"ON",
+        :shipping_state_id=>"ON",
+        :shipping_postcode=>"K1C2N6",
+        :shipping_country=>"CA",
+        :billing_first_name=>"Jim",
+        :billing_last_name=>"Smith",
+        :billing_street_address=>"1234 My Street",
+        :billing_street_address2=>"Apt 1",
+        :billing_city=>"Ottawa",
+        :billing_state=>"ON",
+        :billing_state_id=>"ON",
+        :billing_postcode=>"K1C2N6",
+        :billing_country=>"CA",
+        :customers_telephone=>"(555)555-5555",
+        :time_stamp=>"2014-11-26 16:34:33",
+        :recurring_date=>"0000-00-00",
+        :retry_date=>"N/A",
+        :cc_type=>"offline",
+        :cc_number=>"2822", # "N/A",
+        :check_account_last_4=>"N/A",
+        :check_routing_last_4=>"N/A",
+        :check_ssn_last_4=>"N/A",
+        :cc_expires=>"1219",
+        :prepaid_match=>"N/A",
+        :main_product_id=>"17",
+        :main_product_quantity=>"1",
+        :upsell_product_quantity=>nil,
+        :upsell_product_id=>nil,
+        :shipping_id=>"1",
+        :shipping_method_name=>"USPS",
+        :order_total=>"4.25",
+        :transaction_id=>"5804215901", # "Not Available",
+        :auth_id=>"02553Z", # "Not Available",
+        :tracking_number=>nil,
+        :on_hold=>"0",
+        :on_hold_by=>nil,
+        :hold_date=>nil,
+        :shipping_date=>"Not Shipped",
+        :email_address=>"test@test.com",
+        :gateway_id=>"1",
+        :preserve_gateway=>"0",
+        :amount_refunded_to_date=>"0.00",
+        :order_confirmed=>"NO_STATUS",
+        :order_confirmed_date=>nil,
+        :is_chargeback=>"0",
+        :is_fraud=>"0",
+        :is_rma=>"0",
+        :rma_number=>nil,
+        :rma_reason=>nil,
+        :ip_address=>"127.0.0.1",
+        :affiliate=>nil,
+        :sub_affiliate=>nil,
+        :decline_reason=>"N/A",
+        :campaign_id=>"23",
+        :order_sales_tax=>"0.00",
+        :order_sales_tax_amount=>"0.00",
+        :processor_id=>nil,
+        :created_by_user_name=>nil,
+        :created_by_employee_name=>nil,
+        :billing_cycle=>"0",
+        :click_id=>nil,
+        :product_qty_17=>"1",
+        :"products[0][product_id]"=>"1",
+        :"products[0][sku]"=>"094922807700",
+        :"products[0][price]"=>"0.00",
+        :"products[0][name]"=>"Lipstick",
+        :"products[0][on_hold]"=>"0",
+        :"products[0][is_recurring]"=>"1",
+        :"products[0][recurring_date]"=>"2014-12-26",
+        :"products[0][product_qty]"=>"1",
+        :"products[0][subscription_id]"=>"653cfc05e89438543a943731bbe6dbce",
+        :"products[0][subscription_type]"=>"Bill by cycle",
+        :"products[0][subscription_desc]"=>"Bills every 30 days"
+      }
+      response = Lipstick::Api::OrderViewResponse.new(fields)
+      customer = response.customer
+      assert_equal customer.id, 30346
+      assert_equal customer.first_name, "Jim"
+      assert_equal customer.last_name, "Smith"
+      assert_equal customer.telephone, "(555)555-5555"
+      assert_equal customer.email_address, "test@test.com"
+      
+      order = response.order
+      assert_equal order.ancestor_id, 581006
+      # assert_equal order.customer.id, 30346
+      assert_equal order.parent_id, 2081410
+      assert_equal order.status, 11
+
+      assert_equal order.shipping.first_name, "Jim"
+      assert_equal order.shipping.last_name, "Smith"
+      assert_equal order.shipping.street_address, "1234 My Street"
+      assert_equal order.shipping.street_address2, "Apt 1"
+      assert_equal order.shipping.postcode, "K1C2N6"
+      assert_equal order.shipping.country, "CA"
+      assert_equal order.billing.marshal_dump, order.shipping.marshal_dump
+      assert_equal order.created_at, DateTime.new(2014,11,26,16,34,33)
+      assert_equal order.cc_number, "2822"
+
+      assert_equal order.cc_expires, "1219"
+      assert_equal order.shipping_method_name, "USPS"
+      assert_equal order.order_total, BigDecimal.new('4.25')
+      assert_equal order.transaction_id, '5804215901'
+      assert_equal order.auth_id, '02553Z'
+      assert_equal order.campaign_id, 23
+    end
+  end
+end

metadata

@@ -0,0 +1,151 @@
+--- !ruby/object:Gem::Specification
+name: lipstick
+version: !ruby/object:Gem::Version
+  version: 1.0.0.pre
+platform: ruby
+authors:
+- Piers Chambers
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-11-28 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0.7'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0.7'
+- !ruby/object:Gem::Dependency
+  name: rdoc
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '3.12'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '3.12'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: jeweler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.0.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.0.1
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Unofficial ruby wrapper for the Lime Light CRM membership and transaction
+  APIs
+email: piers@varyonic.com
+executables: []
+extensions: []
+extra_rdoc_files:
+- LICENSE.txt
+- README.rdoc
+files:
+- .document
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- README.rdoc
+- Rakefile
+- VERSION
+- lib/lipstick.rb
+- lib/lipstick/api/campaign_find_active_response.rb
+- lib/lipstick/api/campaign_view_response.rb
+- lib/lipstick/api/customer_find_active_product_response.rb
+- lib/lipstick/api/new_order_response.rb
+- lib/lipstick/api/order_find_response.rb
+- lib/lipstick/api/order_find_updated_response.rb
+- lib/lipstick/api/order_view_response.rb
+- lib/lipstick/api/response.rb
+- lib/lipstick/api/session.rb
+- lipstick.gemspec
+- test/helper.rb
+- test/test_lipstick.rb
+- test/test_order_view_response.rb
+homepage: http://github.com/varyonic/lipstick
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ! '>'
+    - !ruby/object:Gem::Version
+      version: 1.3.1
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.2.2
+signing_key: 
+specification_version: 4
+summary: Unofficial ruby wrapper for the Lime Light CRM APIs.
+test_files: []