genio 1.0.0

data/lib/genio/version.rb

@@ -0,0 +1,19 @@
+#
+#   Copyright 2013 PayPal Inc.
+#
+#   Licensed under the Apache License, Version 2.0 (the "License");
+#   you may not use this file except in compliance with the License.
+#   You may obtain a copy of the License at
+#
+#       http://www.apache.org/licenses/LICENSE-2.0
+#
+#   Unless required by applicable law or agreed to in writing, software
+#   distributed under the License is distributed on an "AS IS" BASIS,
+#   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+#   See the License for the specific language governing permissions and
+#   limitations under the License.
+#
+#
+module Genio
+  VERSION = "1.0.0"
+end

data/templates/sdk.rest_dotnet.erb

@@ -0,0 +1,174 @@
+<%
+#
+#   Copyright 2013 PayPal Inc.
+# 
+#   Licensed under the Apache License, Version 2.0 (the "License");
+#   you may not use this file except in compliance with the License.
+#   You may obtain a copy of the License at
+# 
+#       http://www.apache.org/licenses/LICENSE-2.0
+# 
+#   Unless required by applicable law or agreed to in writing, software
+#   distributed under the License is distributed on an "AS IS" BASIS,
+#   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+#   See the License for the specific language governing permissions and
+#   limitations under the License.
+#
+#
+%>
+<% imports(data_type, schema, package, classname, "rest").each do |import| %>
+using <%= import %>;
+<% end %>
+
+namespace <%= package %>
+{
+	public class <%= validate_class_name(classname) %><%= " : #{validate_class_name(data_type.extends)}" if data_type.extends %>
+	{
+<% const_args = {} %>
+<% data_type.properties.each do |name, property| %>
+<% vname = validate_property_name(name) %>
+<% const_args[vname] = get_property_class(property, classname) if property.required %>
+		private <%= get_property_class(property, classname) %><%= '?' if (is_nullable_type(property) and !property.array) %> <%= vname %>Property;
+
+		/// <summary>
+		/// <%= property.description %>
+		/// </summary>
+		[JsonProperty(NullValueHandling = NullValueHandling.Ignore)]
+		public <%= get_property_class(property, classname) %><%= '?' if (is_nullable_type(property) and !property.array) %> <%= vname %>
+		{
+			get
+			{
+				return this.<%= vname %>Property;
+			}
+			set
+			{
+				this.<%= vname %>Property = value;
+			}
+		}
+
+<% end %>
+		/// <summary>
+		/// Default Constructor
+		/// </summary>
+		public <%= validate_class_name(classname) %>()
+		{
+		}
+
+<% if const_args.size > 0 %>
+		/// <summary>
+		/// Parameterized Constructor
+		/// </summary>
+		public <%= validate_class_name(classname) %>(<%= const_args.map{|name, type| "#{type} #{name}"}.join(", ") %>)
+		{
+<% const_args.each do |name, type| %>
+			this.<%= name %> = <%= name %>;
+<% end %>
+		}
+<% end %>
+
+<% service = schema.services[classname] %>
+<% if service %>
+<% service.operations.each do |name, property| %>
+<% static = is_static_method(property) %>
+<% hostIdCheck = check_host_id(classname, property) %>
+<% methodName = validate_method_name(name) %>
+<% argumentHash = form_rest_api_args(classname, property, name) %>
+<% resourcePath = validate_path(property.path) %>
+<% pathParameters = generate_format_hash(classname, property, resourcePath) %>
+<% payLoad = get_payload(classname, property) %>
+<% if options[:gen_deprecated_methods] %>
+
+		/// <summary>
+		/// <%= property.description %>
+		/// </summary>
+		/// <param name="accessToken">Access Token used for the API call.</param><% if argumentHash.size > 0 %><% argumentHash.each do |name, type| %>
+		/// <param name="<%= name %>"><%= type %></param><% end %><% end %>
+		/// <returns><% if property.response %><%= property.response %><% end %></returns>
+		public<%= " static" if static %><% if property.response %> <%= validate_class_name(property.response) %><% else %> void<% end %> <%= methodName %>(string accessToken<% if argumentHash.size > 0 %>, <%= argumentHash.map{|name, type| "#{type} #{name}"}.join(", ") %><% end %>)
+		{
+			APIContext apiContext = new APIContext(accessToken);
+<% if property.response %>
+			return <%= methodName %>(apiContext<% if argumentHash.size > 0 %>, <%= argumentHash.map{|name, type| "#{name}"}.join(", ") %><% end %>);
+<% else %>
+			<%= name.camelcase %>(apiContext<% if argumentHash.size > 0 %>, <%= argumentHash.map{|name, type| "#{name}"}.join(", ") %><% end %>);
+			return;
+<% end %>
+		}
+<% end %>
+
+		/// <summary>
+		/// <%= property.description %>
+		/// </summary>
+		/// <param name="apiContext">APIContext used for the API call.</param><% if argumentHash.size > 0 %><% argumentHash.each do |name, type| %>
+		/// <param name="<%= name %>"><%= type %></param><% end %><% end %>
+		/// <returns><% if property.response %><%= property.response %><% end %></returns>
+		public<%= " static" if static %><% if property.response %> <%= validate_class_name(property.response) %><% else %> void<% end %> <%= methodName %>(APIContext apiContext<% if argumentHash.size > 0 %>, <%= argumentHash.map{|name, type| "#{type} #{name}"}.join(", ") %><% end %>)
+		{
+		    if (apiContext == null)
+			{
+				throw new ArgumentNullException("APIContext cannot be null");
+			}
+<% if options[:mandate_oauth] %>
+			if (string.IsNullOrEmpty(apiContext.AccessToken))
+			{
+				throw new ArgumentNullException("AccessToken cannot be null or empty");
+			}
+<% end %>
+            if (apiContext.HTTPHeaders == null)
+			{
+				apiContext.HTTPHeaders = new Dictionary<string, string>();
+			}
+			apiContext.HTTPHeaders.Add(BaseConstants.CONTENT_TYPE_HEADER, BaseConstants.CONTENT_TYPE_JSON);
+			apiContext.SdkVersion = new SDKVersionImpl();
+<% if hostIdCheck %>
+			if (this.id == null)
+			{
+				throw new ArgumentNullException("Id cannot be null");
+			}
+<% end %>
+<% if argumentHash.size > 0 %>
+<% argumentHash.each do |name, type| %>
+<% if name != 'queryParameters' %>
+			if (<%= name %> == null)
+			{
+				throw new ArgumentNullException("<%= name%> cannot be null");
+			}
+<% end %>
+<% end %>
+<% end %>
+			Dictionary<string, string> pathParameters = new Dictionary<string, string>();
+<% pathParameters.each do |name, value| %>
+			pathParameters.Add("<%= name %>", <%= value %>);
+<% end %>
+			string pattern = "<%= resourcePath %>";
+<% if property.type != 'POST' and property.type != 'PATCH' and property.type != 'PUT' %>
+			string resourcePath = SDKUtil.FormatURIPath(pattern, pathParameters, queryParameters);
+<% else %>
+			string resourcePath = SDKUtil.FormatURIPath(pattern, pathParameters);
+<% end %>
+			string payLoad = <%= payLoad %>;
+<% if property.response %>
+			return PayPalResource.ConfigureAndExecute<<%= validate_class_name(property.response) %>>(apiContext, <%= "HttpMethod." + property.type %>, resourcePath, payLoad);
+<% else %>
+			PayPalResource.ConfigureAndExecute<object>(apiContext, <%= "HttpMethod." + property.type %>, resourcePath, payLoad);
+			return;
+<% end %>
+		}
+
+<% end %>
+<% end %>
+		/// <summary>
+		/// Converts the object to JSON string
+		/// </summary>
+		public string ConvertToJson()
+		{
+			return JsonFormatter.ConvertToJson(this);
+		}
+
+		public override string ToString()
+		{
+			return ConvertToJson();
+		}
+
+	}
+}

data/templates/sdk.rest_java.erb

@@ -0,0 +1,231 @@
+<%
+#
+#   Copyright 2013 PayPal Inc.
+# 
+#   Licensed under the Apache License, Version 2.0 (the "License");
+#   you may not use this file except in compliance with the License.
+#   You may obtain a copy of the License at
+# 
+#       http://www.apache.org/licenses/LICENSE-2.0
+# 
+#   Unless required by applicable law or agreed to in writing, software
+#   distributed under the License is distributed on an "AS IS" BASIS,
+#   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+#   See the License for the specific language governing permissions and
+#   limitations under the License.
+#
+#
+%>
+package <%= package %>;
+
+<% imports(data_type, schema, package, classname, "rest").each do |import| %>
+import <%= import %>;
+<% end %>
+
+public class <%= validate_class_name(classname) %> <%= "extends #{validate_class_name(data_type.extends)}" if data_type.extends %> {
+
+<% const_args = {} %>
+<% data_type.properties.each do |name, property| %>
+<% vname = validate_property_name(name) %>
+<% const_args[vname] = get_property_class(property, classname) if property.required %>
+	/**
+	 * <%= property.description %>
+	 */
+	private <%= get_property_class(property, classname) %> <%= vname %>;
+
+<% end %>
+<% if schema.services[classname] and !options[:skip_stub_operations] %>
+	/**
+	 * Returns the last request sent to the Service
+	 *
+	 * @return Last request sent to the server
+	 */
+	public static String getLastRequest() {
+		return PayPalResource.getLastRequest();
+	}
+
+	/**
+	 * Returns the last response returned by the Service
+	 *
+	 * @return Last response got from the Service
+	 */
+	public static String getLastResponse() {
+		return PayPalResource.getLastResponse();
+	}
+
+	/**
+	 * Initialize using InputStream(of a Properties file)
+	 *
+	 * @param is
+	 *            InputStream
+	 * @throws PayPalRESTException
+	 */
+	public static void initConfig(InputStream is) throws PayPalRESTException {
+		PayPalResource.initConfig(is);
+	}
+
+	/**
+	 * Initialize using a File(Properties file)
+	 *
+	 * @param file
+	 *            File object of a properties entity
+	 * @throws PayPalRESTException
+	 */
+	public static void initConfig(File file) throws PayPalRESTException {
+		PayPalResource.initConfig(file);
+	}
+
+	/**
+	 * Initialize using Properties
+	 *
+	 * @param properties
+	 *            Properties object
+	 */
+	public static void initConfig(Properties properties) {
+		PayPalResource.initConfig(properties);
+	}
+<% end %>
+	/**
+	 * Default Constructor
+	 */
+	public <%= validate_class_name(classname) %>() {
+	}
+
+<% if const_args.size > 0 %>
+	/**
+	 * Parameterized Constructor
+	 */
+	public <%= validate_class_name(classname) %>(<%= const_args.map{|name, type| "#{type} #{name}"}.join(", ") %>) {
+<% const_args.each do |name, type| %>
+		this.<%= name %> = <%= name %>;
+<% end %>
+	}
+
+<% end %>
+<% data_type.properties.each do |name, property| %>
+<% vname = validate_property_name(name) %>
+<% methodname = validate_class_name(name) %>
+
+	/**
+	 * Setter for <%= vname %>
+	 */
+	public <%= classname %> set<%= methodname %>(<%= get_property_class(property, classname) %> <%= vname %>) {
+		this.<%= vname%> = <%= vname %>;
+		return this;
+	}
+
+	/**
+	 * Getter for <%= vname %>
+	 */
+	public <%= get_property_class(property, classname) %> get<%= methodname %>() {
+		return this.<%= vname%>;
+	}
+
+<% end %>
+<% service = schema.services[classname] %>
+<% if service and !options[:skip_stub_operations] %>
+<% service.operations.each do |name, property| %>
+<% static = is_static_method(property) %>
+<% methodName = validate_method_name(name) %>
+<% hostIdCheck = check_host_id(classname, property) %>
+<% argumentHash = form_rest_api_args(classname, property, name) %>
+<% resourcePath = validate_path(property.path) %>
+<% pathParameters = generate_format_hash(classname, property, resourcePath) %>
+<% payLoad = get_payload(classname, property) %>
+<% if options[:gen_deprecated_methods] %>
+
+	/**
+	 * <%= property.description %>
+	 * @deprecated
+	 * @param accessToken
+	 *            Access Token used for the API call.<% if argumentHash.size > 0 %><% argumentHash.each do |name, type| %>
+	 * @param <%= name %>
+	 *            <%= type %><% end %><% end %>
+	 * @return <% if property.response %><%= property.response %><% end %>
+	 * @throws PayPalRESTException
+	 */
+	public<%= " static" if static %><% if property.response %> <%= validate_class_name(property.response) %><% else %> void<% end %> <%= methodName %>(String accessToken<% if argumentHash.size > 0 %>, <%= argumentHash.map{|name, type| "#{type.camelcase} #{name}"}.join(", ") %><% end %>) throws PayPalRESTException {
+		APIContext apiContext = new APIContext(accessToken);
+<% if property.response %>
+		return <%= methodName %>(apiContext<% if argumentHash.size > 0 %>, <%= argumentHash.map{|name, type| "#{name}"}.join(", ") %><% end %>);
+<% else %>
+		<%= methodName %>(apiContext<% if argumentHash.size > 0 %>, <%= argumentHash.map{|name, type| "#{name}"}.join(", ") %><% end %>);
+		return;
+<% end %>
+	}
+<% end %>
+
+	/**
+	 * <%= property.description %>
+	 * @param apiContext
+	 *            {@link APIContext} used for the API call.<% if argumentHash.size > 0 %><% argumentHash.each do |name, type| %>
+	 * @param <%= name %>
+	 *            <%= type %><% end %><% end %>
+	 * @return <% if property.response %><%= property.response %><% end %>
+	 * @throws PayPalRESTException
+	 */
+	public<%= " static" if static %><% if property.response %> <%= validate_class_name(property.response) %><% else %> void<% end %> <%= methodName %>(APIContext apiContext<% if argumentHash.size > 0 %>, <%= argumentHash.map{|name, type| "#{type.camelcase} #{name}"}.join(", ") %><% end %>) throws PayPalRESTException {
+		if (apiContext == null) {
+			throw new IllegalArgumentException("APIContext cannot be null");
+		}
+<% if options[:mandate_oauth] %>
+		if (apiContext.getAccessToken() == null || apiContext.getAccessToken().trim().length() <= 0) {
+			throw new IllegalArgumentException("AccessToken cannot be null or empty");
+		}
+<% end %>
+		if (apiContext.getHTTPHeaders() == null) {
+			apiContext.setHTTPHeaders(new HashMap<String, String>());
+		}
+		apiContext.getHTTPHeaders().put(Constants.HTTP_CONTENT_TYPE_HEADER, Constants.HTTP_CONTENT_TYPE_JSON);
+		apiContext.setSdkVersion(new SDKVersionImpl());
+<% if hostIdCheck %>
+		if (this.getId() == null) {
+			throw new IllegalArgumentException("Id cannot be null");
+		}
+<% end %>
+<% if argumentHash.size > 0 %>
+<% argumentHash.each do |name, type| %>
+<% if name != 'queryParameters' %>
+		if (<%= name%> == null) {
+			throw new IllegalArgumentException("<%= name%> cannot be null");
+		}
+<% end %>
+<% end %>
+<% end %>
+		Map<String, String> pathParameters = new HashMap<String, String>();
+<% pathParameters.each do |name, value| %>
+		pathParameters.put("<%= name %>", <%= value%>);
+<% end %>
+		String pattern = "<%= resourcePath %>";
+<% if property.type != 'POST' and property.type != 'PATCH' and property.type != 'PUT' %>
+		String resourcePath = RESTUtil.formatURIPath(pattern, pathParameters, queryParameters);
+<% else %>
+		String resourcePath = RESTUtil.formatURIPath(pattern, pathParameters);
+<% end %>
+		String payLoad = <%= payLoad %>;
+<% if property.response %>
+		return PayPalResource.configureAndExecute(apiContext, <%= "HttpMethod." + property.type %>, resourcePath, payLoad, <%= validate_class_name(property.response) %>.class);
+<% else %>
+		PayPalResource.configureAndExecute(apiContext, <%= "HttpMethod." + property.type %>, resourcePath, payLoad, null);
+		return;
+<% end %>
+	}
+
+<% end %>
+<% end %>
+<% if !options[:skip_stub_operations] %>
+	/**
+	 * Returns a JSON string corresponding to object state
+	 *
+	 * @return JSON representation
+	 */
+	public String toJSON() {
+		return JSONFormatter.toJSON(this);
+	}
+
+	@Override
+	public String toString() {
+		return toJSON();
+	}
+<% end %>
+}

data/templates/sdk.rest_php.erb

@@ -0,0 +1,120 @@
+<%
+#
+#   Copyright 2013 PayPal Inc.
+# 
+#   Licensed under the Apache License, Version 2.0 (the "License");
+#   you may not use this file except in compliance with the License.
+#   You may obtain a copy of the License at
+# 
+#       http://www.apache.org/licenses/LICENSE-2.0
+# 
+#   Unless required by applicable law or agreed to in writing, software
+#   distributed under the License is distributed on an "AS IS" BASIS,
+#   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+#   See the License for the specific language governing permissions and
+#   limitations under the License.
+#
+#
+%>
+<?php
+<% service = schema.services[classname] %>
+namespace <%= package %>;
+
+<% imports(data_type, schema, package, classname, "rest").each do |import| %>
+use <%= import %>;
+<% end %>
+
+class <%= classname %> <%= data_type.extends ? "extends #{valid_class_name(data_type.extends)} " : "extends PPModel " %><%= "implements IResource " if service %>{
+<% if service %>
+
+<% end %>
+<% data_type.properties.each do |name, property| %>
+<% vname = to_underscore(name) %>
+<% vtype = get_php_type(property, schema, classname) %>
+	/**
+	 * <%= property.description %>
+	 *
+	<% if property.array %>
+	 * @array
+	<% end %>
+	 * @param <%= "#{get_namespace(schema.data_types[vtype].package || schema.endpoint )}\\" if schema.data_types[vtype] %><%= vtype %> $<%= name %>
+	 */
+	public function set<%= valid_class_name(name) %>(<%if property.array %>array <%end%>$<%= vname %>) {
+		<% if vname != name%>
+		$this->{"<%= name %>"} = $<%= vname %>;
+		<% else %>
+		$this-><%= vname %> = $<%= vname %>;
+		<% end %>
+		return $this;
+	}
+
+	/**
+	 * <%= property.description %>
+	 *
+	 * @return <%= "#{get_namespace(schema.data_types[vtype].package || schema.endpoint )}\\" if schema.data_types[vtype] %><%= vtype %>
+	 */
+	public function get<%= valid_class_name(name) %>() {
+		<% if vname != name%>
+		return $this->{"<%= name %>"};
+		<% else %>
+		return $this-><%= vname %>;
+		<% end %>
+	}
+
+<% end %>
+<% if service %>
+<% service.operations.each do |name, property| %>
+<% static = is_static_method(property) %>
+<% hostId_check = check_host_id(classname, property) %>
+<% argument_hash = form_arguments(classname, property, name) %>
+<% object_array = get_object_array(classname, name, property, argument_hash) %>
+<% payload = get_payload(classname, property) %>
+	/*
+	 * <%= property.description %>
+	 *
+<% argument_hash.each do |name, type| %>
+	 * @param <%= type %> $<%= name %>
+<% end %>
+<% if( property.parameters && allowed_params(property.parameters).size > 0 )%>
+	 * allowed queryparameters <%= allowed_params(property.parameters).map{|k,v| "'#{k}'" }.join(", ") %>
+<% end %>
+	 * @param PayPal\Rest\ApiContext $apiContext is the APIContext for this call. It can be used to pass dynamic configuration, credentials, and additional headers.
+	 * @return <%= "#{get_namespace(schema.data_types[property.response].package || schema.endpoint )}\\" if schema.data_types[property.response] %><%= property.response || 'string' %>
+	 */
+	public<%= " static" if static %> function <%= validate_function_name(name) %>(<% if argument_hash.size > 0 %><%= argument_hash.map{|name, type| type == "array" ? "array $#{name}" : "$#{name}"}.join(", ") %>, <% end %>$apiContext) {
+		<% if hostId_check %>
+		if ($this->getId() == null) {
+			throw new \InvalidArgumentException("Id cannot be null");
+		}
+		<% end %>
+		<% if argument_hash.size > 0 %>
+		<% argument_hash.each do |name, type| %>
+		<% if name != 'queryParameters'%>
+
+		if ($<%= name %> == null<%= " || strlen($#{name}) == 0" if type == "string" %>) {
+			throw new \InvalidArgumentException("<%= name%> cannot be null or empty");
+		}
+		<% end %>
+		<% end %>
+		<% end %>
+		$payload = <%= payload %>;
+		$call = new PPRestCall($apiContext);
+		$json = $call->execute(array('PayPal\Rest\RestHandler'), <%= process_path_with_placeholders(classname, name, property.path, hostId_check, argument_hash, property.parameters) %>, "<%= property.type %>", $payload);
+		<% if property.request == classname %>
+		$this->fromJson($json);
+		return $this;
+		<% elsif property.response %>
+		<% if property.response == "string" %>
+		return $json;
+		<% else %>
+		$ret = new <%= property.response %>();
+		$ret->fromJson($json);
+		return $ret;
+		<% end %>
+		<% else %>
+		return $json;
+		<% end %>
+	}
+	<% end %>
+<% end %>
+}