LitleOnline 8.10.0

data/DESCRIPTION

@@ -0,0 +1,5 @@
+Litle Online Ruby SDK created for version 8.10 of Litle XML online format, see the XSD schema for specific fields that are supported by this format.
+
+This gem contains an application interface in the Ruby programming language created by Litle & Co.
+
+

data/LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2011 Litle & Co.
+
+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,69 @@
+Litle Online Ruby SDK
+=====================
+
+About Litle
+------------
+[Litle & Co.](http://www.litle.com) powers the payment processing engines for leading companies that sell directly to consumers through  internet retail, direct response marketing (TV, radio and telephone), and online services. Litle & Co. is the leading, independent authority in card-not-present (CNP) commerce, transaction processing and merchant services.
+
+
+About this SDK
+--------------
+The Litle Ruby SDK is a Ruby implementation of the [Litle & Co.](http://www.litle.com). XML API. This SDK was created to make it as easy as possible to connect process your payments with Litle.  This SDK utilizes  the HTTPS protocol to securely connect to Litle.  Using the SDK requires coordination with the Litle team in order to be provided with credentials for accessing our systems.
+
+Our Ruby SDK supports all of the functionality present in Litle XML v8. Please see the online copy of our XSD for Litle XML to get more details on what is supported by the Litle payments engine.
+
+This SDK is implemented to support the Ruby programming language and was created by Litle & Co. It is intended use is for online transactions processing utilizing your account on the Litle payments engine.
+
+See LICENSE file for details on using this software.
+
+Source Code available from : https://github.com/LitleCo/litle-sdk-for-ruby
+
+Please contact [Litle & Co.](http://www.litle.com) to receive valid merchant credentials in order to run tests successfully or if you require assistance in any way.  We are reachable at MerchantSDKSupport@litle.com
+
+Setup
+-----
+
+1) Install the LitleOnline Ruby gem from rubygems.org, this will install the latest SDK gem in your Ruby environment.
+Our gem is available publicly from rubygems.org.  Use the command below to install.
+
+>sudo gem install LitleOnline
+
+Note: If you get errors, you might have to configure your proxy.
+
+2) Once the gem is installed run our setup program to generate a configuration file.  The configuration file resides in your home directory
+$HOME/.litle_SDK_config.yml
+
+For more details on setup see our instructions [here](https://github.com/LitleCo/litle-sdk-for-ruby/blob/master/SETUP.md)
+
+3.) Create a ruby file similar to:  
+
+```ruby
+require 'LitleOnline'
+
+# Visa $10 Sale
+litleSaleTxn = {
+    'reportGroup'=>'rpt_grp',
+    'orderId'=>'1234567',
+    'card'=>{
+        'type'=>'VI',
+        'number' =>'4100000000000001',
+        'expDate' =>'1212'},
+        'orderSource'=>'ecommerce',
+        'amount'=>'1000'
+    }
+
+# Peform the transaction on the Litle Platform
+response = LitleOnlineRequest.sale(litleSaleTxn)
+
+# display result
+puts "Message: "+ response.message
+puts "Litle Transaction ID: "+ response.saleResponse.litleTxnId
+```
+
+3) Next run this file using ruby. You should see the following result provided you have connectivity to the Litle certification environment.  You will see an HTTP error if you don't have access to the Litle URL
+
+    Message: Valid Format
+    Litle Transaction ID: <your-numeric-litle-txn-id>
+
+
+Please contact Lilte & Co. with any further questions.   You can reach us at RubySupport@litle.com.

data/Rakefile

@@ -0,0 +1,92 @@
+=begin
+Copyright (c) 2011 Litle & Co.
+
+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.
+=end
+require 'rubygems'
+require 'rubygems/package_task'
+require 'rake/testtask'
+require 'rake/clean'
+
+spec = Gem::Specification.new do |s|
+  FileUtils.rm_rf('pkg')
+  s.name = "LitleOnline"
+  s.summary = "Ruby SDK produced by Litle & Co. for online transaction processing using Litle XML format v8.10"
+  s.description = File.read(File.join(File.dirname(__FILE__), 'DESCRIPTION'))
+  s.requirements =
+  [ 'Contact sdksupport@litle.com for more information' ]
+  s.version = "8.10.0"
+  s.author = "Litle & Co"
+  s.email = "sdksupport@litle.com"
+  s.homepage = "http://www.litle.com/developers"
+  s.platform = Gem::Platform::RUBY
+  s.required_ruby_version = '>=1.9'
+  s.files = Dir['**/**']
+  s.executables = [ 'sample_driver.rb', 'Setup.rb' ]
+  s.test_files = Dir["test/unit/ts_unit.rb"]
+  s.has_rdoc = true
+  s.add_dependency('i18n')
+  s.add_dependency('xml-simple')
+  s.add_dependency('activesupport')
+  s.add_dependency('xml-object')
+  s.add_development_dependency('mocha')
+end
+
+Gem::PackageTask.new(spec) do |pkg|
+  pkg.gem_spec = spec
+  pkg.need_zip = true
+  pkg.need_tar = true
+end
+
+namespace :test do
+
+  Rake::TestTask.new do |t|
+    t.libs << '.'
+    t.name = 'unit'
+    t.test_files = FileList['test/unit/ts_unit.rb']
+    t.verbose = true
+  end
+
+  Rake::TestTask.new do |t|
+    t.libs << '.'
+    t.name = 'functional'
+    t.test_files = FileList['test/functional/ts_all.rb']
+    t.verbose = true
+  end
+
+  Rake::TestTask.new do |t|
+    t.libs << '.'
+    t.name = 'certification'
+    t.test_files = FileList['test/certification/certTest*.rb']
+    t.verbose = true
+  end
+  
+  Rake::TestTask.new do |t|
+    t.libs << '.'
+    t.name = 'all'
+    t.test_files = FileList['test/**/*.rb']
+    t.verbose = true
+  end
+  
+end
+
+task :default =>'gem'

data/SETUP.md

@@ -0,0 +1,47 @@
+Setting up and Configuring the Litle SDK
+=========================================
+
+Running the built in configuration file generator
+-------------------------------------------------
+The Ruby SDK ships with a built in program which can be used to generate your specific configuration.
+
+This program runs as follows:
+   
+```
+>Setup.rb 
+Welcome to Litle Ruby_SDK
+please input your user name:
+test_user
+please input your password:
+test_password
+Please choose Litle url from the following list (example: 'cert') or directly input another URL:
+cert => https://cert.litle.com/vap/communicator/online
+precert => https://precert.litle.com/vap/communicator/online
+production1 => https://payments.litle.com/vap/communicator/online
+production2 => https://payments2.litle.com/vap/communicator/online
+cert
+Please input the proxy address, if no proxy hit enter key: 
+
+Please input the proxy port, if no proxy hit enter key: 
+
+The Litle configuration file has been generated, the file is located at: /<your-home-directory>/.litle_SDK_config.yml 
+```
+
+Modifying your configuration
+----------------------------
+You may change the configuration values at anytime by running Setup.rb again, or simpy opening the configuration file directly in the editor of your choice and changing the appropriate fields. 
+
+Changing the location of the Litle configuration file:
+------------------------------------------------------
+NOTICE you can set the environment variable $LITLE_CONFIG_DIR to locate your configuration file in a location other than the $HOME Directory, the the file will reside in $LITLE_CONFIG_DIR/.litle_SDK_config.yml  
+
+Sample configuration file contents
+----------------------------------
+```
+user: test_user
+password: test_password
+version: 8.10
+url: https://precert.litle.com/vap/communicator/online
+proxy_addr: yourproxyserver
+proxy_port: 8080
+```

data/bin/Setup.rb

@@ -0,0 +1,103 @@
+#!/usr/bin/env ruby
+
+=begin
+Copyright (c) 2011 Litle & Co.
+
+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.
+=end
+
+# make setup file executable
+
+#
+# Configuration generation for URL and credentials
+#
+class Setup
+  attr_reader :handle, :path
+  def initialize(filename)
+    @handle = File.new(filename, File::CREAT|File::TRUNC|File::RDWR, 0600)
+    File.open(filename, "w") do |f|
+      puts "Welcome to Litle Ruby_SDK"
+      puts "Please input your user name:"
+      f.puts  "user: "+ gets
+      puts "Please input your password:"
+      f.puts	"password: " + gets
+      puts "Please input your merchantId:"
+      f.puts "currency_merchant_map:"
+      f.puts "  DEFAULT: " + gets
+      f.puts "default_report_group: 'Default Report Group'"
+      f.puts	"version: '8.10'"
+      puts "Please choose Litle url from the following list (example: 'cert') or directly input another URL: \nsandbox => https://www.testlitle.com/sandbox/communicator/online \ncert => https://cert.litle.com/vap/communicator/online \nprecert => https://precert.litle.com/vap/communicator/online \nproduction1 => https://payments.litle.com/vap/communicator/online \nproduction2 => https://payments2.litle.com/vap/communicator/online"
+      f.puts "url: " + Setup.choice(gets)
+      puts "Please input the proxy address, if no proxy hit enter key: "
+      f.puts	"proxy_addr: " + gets
+      puts "Please input the proxy port, if no proxy hit enter key: "
+      f.puts	"proxy_port: " + gets
+      f.puts "printxml: false"
+      f.puts "timeout: 65"
+    end
+  end
+
+  def finished
+    @handle.close
+  end
+
+  def Setup.choice(litle_env)
+    litle_online_ctx = 'vap/communicator/online'
+    if litle_env == "sandbox\n"
+      return 'https://www.testlitle.com/sandbox/communicator/online'
+    elsif litle_env == "cert\n"
+      return 'https://cert.litle.com/' + litle_online_ctx
+    elsif litle_env == "precert\n"
+      return 'https://precert.litle.com/' + litle_online_ctx
+    elsif litle_env == "production1\n"
+      return 'https://payments.litle.com/' + litle_online_ctx
+    elsif litle_env == "production2\n"
+      return 'https://payments2.litle.com/' + litle_online_ctx
+    else
+      return 'https://www.testlitle.com/sandbox/communicator/online'
+    end
+  end
+end
+
+#
+#
+# Optionally enable the configuration to reside in a custom location
+# if the $LITLE_CONFIG_DIR directory is set
+#
+
+# make the config.yml file in the LITLE_CONFIG_DIR directory or HOME directory
+if !(ENV['LITLE_CONFIG_DIR'].nil?)
+  path = ENV['LITLE_CONFIG_DIR']
+else
+  path = ENV['HOME']
+end
+
+# make the config.yml file hidden
+# create a config file contain all the configuration data
+config_file = path + "/.litle_SDK_config.yml"
+f = Setup.new(config_file)
+
+# return the path of the config file and the path file
+@path = File.expand_path(config_file)
+puts "The Litle configuration file has been generated, the file is located at: " + @path
+f.finished
+

data/bin/sample_driver.rb

@@ -0,0 +1,49 @@
+#!/usr/bin/env ruby
+
+=begin
+Copyright (c) 2011 Litle & Co.
+
+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.
+=end
+
+#Sample Driver
+require 'LitleOnline'
+
+hash = {
+  'reportGroup'=>'product1',
+  'orderId'=>'12344',
+  'card'=>{
+    'type'=>'VI',
+    'number' =>'4100000000000001',
+    'expDate' =>'1210'
+    },
+  'orderSource'=>'ecommerce',
+  'amount'=>'106'
+}
+
+#perform credit transaction
+response= LitleOnlineRequest.new.credit(hash)
+
+#display results
+
+puts "Message: "+response.message
+puts "Litle Transaction ID: "+response.creditResponse.litleTxnId

data/index.html

@@ -0,0 +1,176 @@
+<!doctype html>
+<!--[if lt IE 7 ]> <html lang="en" class="no-js ie6"> <![endif]-->
+<!--[if IE 7 ]>    <html lang="en" class="no-js ie7"> <![endif]-->
+<!--[if IE 8 ]>    <html lang="en" class="no-js ie8"> <![endif]-->
+<!--[if IE 9 ]>    <html lang="en" class="no-js ie9"> <![endif]-->
+<!--[if (gt IE 9)|!(IE)]><!--> <html lang="en" class="no-js"><!--<![endif]-->
+	<head>
+		<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+		<meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1">
+		<title>Welcome to Grails</title>
+		<meta name="viewport" content="width=device-width, initial-scale=1.0">
+		<link rel="shortcut icon" href="/sandbox/static/images/favicon.ico" type="image/x-icon">
+		<link rel="apple-touch-icon" href="/sandbox/static/images/apple-touch-icon.png">
+		<link rel="apple-touch-icon" sizes="114x114" href="/sandbox/static/images/apple-touch-icon-retina.png">
+		<link rel="stylesheet" href="/sandbox/static/css/main.css" type="text/css">
+		<link rel="stylesheet" href="/sandbox/static/css/mobile.css" type="text/css">
+		
+		<meta name="layout" content="main"/>
+		
+		<style type="text/css" media="screen">
+			#status {
+				background-color: #eee;
+				border: .2em solid #fff;
+				margin: 2em 2em 1em;
+				padding: 1em;
+				width: 12em;
+				float: left;
+				-moz-box-shadow: 0px 0px 1.25em #ccc;
+				-webkit-box-shadow: 0px 0px 1.25em #ccc;
+				box-shadow: 0px 0px 1.25em #ccc;
+				-moz-border-radius: 0.6em;
+				-webkit-border-radius: 0.6em;
+				border-radius: 0.6em;
+			}
+
+			.ie6 #status {
+				display: inline; /* float double margin fix http://www.positioniseverything.net/explorer/doubled-margin.html */
+			}
+
+			#status ul {
+				font-size: 0.9em;
+				list-style-type: none;
+				margin-bottom: 0.6em;
+				padding: 0;
+			}
+
+			#status h1 {
+				text-transform: uppercase;
+				font-size: 1.1em;
+				margin: 0 0 0.3em;
+			}
+
+			#page-body {
+				margin: 2em 1em 1.25em 18em;
+			}
+
+			h2 {
+				margin-top: 1em;
+				margin-bottom: 0.3em;
+				font-size: 1em;
+			}
+
+			p {
+				margin: 0.25em 0;
+			}
+
+			#controller-list ul {
+				list-style-position: inside;
+			}
+
+			#controller-list li {
+				list-style-position: inside;
+				margin: 0.25em 0;
+			}
+
+			@media screen and (max-width: 480px) {
+				#status {
+					display: none;
+				}
+
+				#page-body {
+					margin: 0 1em 1em;
+				}
+
+				#page-body h1 {
+					margin-top: 0;
+				}
+			}
+		</style>
+	
+        
+	</head>
+	<body>
+		<div id="grailsLogo" role="banner"><a href="http://grails.org"><img src="/sandbox/static/images/grails_logo.png" alt="Grails"/></a></div>
+		
+		<a href="#page-body" class="skip">Skip to content&hellip;</a>
+		<div id="status" role="complementary">
+			<h1>Application Status</h1>
+			<ul>
+				<li>App version: 0.1</li>
+				<li>Grails version: 2.0.0</li>
+				<li>Groovy version: 1.8.4</li>
+				<li>JVM version: 1.6.0_10</li>
+				<li>Reloading active: false</li>
+				<li>Controllers: 1</li>
+				<li>Domains: 8</li>
+				<li>Services: 2</li>
+				<li>Tag Libraries: 12</li>
+			</ul>
+			<h1>Installed Plugins</h1>
+			<ul>
+				
+					<li>logging - 2.0.0</li>
+				
+					<li>core - 2.0.0</li>
+				
+					<li>i18n - 2.0.0</li>
+				
+					<li>urlMappings - 2.0.0</li>
+				
+					<li>groovyPages - 2.0.0</li>
+				
+					<li>codecs - 2.0.0</li>
+				
+					<li>servlets - 2.0.0</li>
+				
+					<li>dataSource - 2.0.0</li>
+				
+					<li>jquery - 1.7.1</li>
+				
+					<li>resources - 1.1.5</li>
+				
+					<li>controllers - 2.0.0</li>
+				
+					<li>domainClass - 2.0.0</li>
+				
+					<li>mimeTypes - 2.0.0</li>
+				
+					<li>scaffolding - 2.0.0</li>
+				
+					<li>hibernate - 2.0.0</li>
+				
+					<li>filters - 2.0.0</li>
+				
+					<li>validation - 2.0.0</li>
+				
+					<li>converters - 2.0.0</li>
+				
+					<li>services - 2.0.0</li>
+				
+			</ul>
+		</div>
+		<div id="page-body" role="main">
+			<h1>Welcome to Grails</h1>
+			<p>Congratulations, you have successfully started your first Grails application! At the moment
+			   this is the default page, feel free to modify it to either redirect to a controller or display whatever
+			   content you may choose. Below is a list of controllers that are currently deployed in this application,
+			   click on each to execute its default action:</p>
+
+			<div id="controller-list" role="navigation">
+				<h2>Available Controllers:</h2>
+				<ul>
+					
+						<li class="controller"><a href="/sandbox/communicator/index">com.litle.sandbox.CommunicatorController</a></li>
+					
+				</ul>
+			</div>
+		</div>
+	
+		<div class="footer" role="contentinfo"></div>
+		<div id="spinner" class="spinner" style="display:none;">Loading&hellip;</div>
+		
+        <script src="/sandbox/static/js/application.js" type="text/javascript" ></script>
+
+	</body>
+</html>