applidok 1.0.2 → 1.0.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 37be38906845a47ee4ad9da50935efb31e49e6db
-  data.tar.gz: 0ff626405fc146790be20b79800061f53ba491c1
+  metadata.gz: 0fd3b7508955f81e67bd6b031d3a8cb795d935eb
+  data.tar.gz: f5908069a4cc80e7cfaaf31170f1340ae1dea13b
 SHA512:
-  metadata.gz: 019ef816411aa907bc0c794c4525d9b4275c793f80595191cf0f2e381d805b0091a238da1ed0ba08fe5cf865e5dc15bf092de9df4b8bb0f4e0a29e04da0ec805
-  data.tar.gz: 889df835e9140a49efb06a8dacde2316049aa1976c9b143673fff2d9140d4dea9524f8b7ab445a2451676a93ccf288892707af551e4ad7b980e462e880bb0d79
+  metadata.gz: 6c6ac44a8ae19c037cd69556addb7d41ad4a2d520a33e2610ebe685650eb4283fa840d0aae0b4eb4fb67d26d04b43e21355ab39294002582de6a00207ccb9fe4
+  data.tar.gz: d9159b65c0391ab288a7ea11c3ee091ec73d948bb8679a040c95b8149025b74e29bf638aaccd81b96a2be07318be40025028d0acf77f1908f43d2c869e7541c0

data/lib/applidok.rb

@@ -1,12 +1,13 @@
 module Applidok
   require 'net/http'
   require 'uri'
+  require 'json'
 
   # Applidok client
-  # Author:: Applicius (mailto:contact@applidok.com)
+  # Author:: cchantep
   class Client
     
-    # Merge values with specified the specified Applidok template.
+    # Merges values with specified the specified Applidok template.
     # Arguments are the following.
     #
     # * token (string): Applidok application token
@@ -14,21 +15,8 @@ module Applidok
     # * values (hash): Map of one string value per area name
     # * ssl (boolean): Whether should use SSL (true) or not (false)
     def self.merge(token, template, values, ssl, &block)
-      if ssl == true
-        require 'openssl'
-      end
-
-      proto = (ssl == true) ? "https" : "http"
+      http = self._prepared_http(ssl)
       
-      # Prepare HTTP client for Applidok API
-      uri = URI.parse(proto + "://go.applidok.com/api/merge")
-      http = Net::HTTP.new(uri.host, uri.port)
-
-      if ssl == true
-        http.use_ssl = true
-        http.verify_mode = OpenSSL::SSL::VERIFY_NONE
-      end
-
       # Prepare parameters
       params = {
         "applidok_token" => token,
@@ -46,5 +34,49 @@ module Applidok
         yield response
       end
     end
+
+    # Authenticates as Applidok manager, and returns an admin token (string) 
+    # (not an application token, used for features such as merge).
+    # Arguments are the following.
+    #
+    # * email (string): Applidok user email (username)
+    # * password (string): Password of specified user (clear text)
+    # * ssl (boolean): Whether should use SSL (true; recommanded) or not (false)
+    def self.auth(email, password, ssl)
+      http = self._prepared_http(ssl)
+
+      # Prepare parameters
+      params = { "email" => email, "password" => password }
+
+      # Prepare request to merge feature
+      req = Net::HTTP::Post.new("/api/auth")
+      req.set_form_data(params)
+
+      res = http.request(req).body
+      obj = JSON.parse(res)
+
+      return obj["token"]
+    end
+
+    # (For internal use) Returns a prepared HTTP client.
+    # * ssl (boolean): Whether should use SSL (true) or not (false)
+    def self._prepared_http(ssl)
+      if ssl == true
+        require 'openssl'
+      end
+
+      scheme = (ssl == true) ? "https" : "http"
+      
+      # Prepare HTTP client for Applidok API
+      uri = URI.parse(scheme + "://go.applidok.com/api/merge")
+      http = Net::HTTP.new(uri.host, uri.port)
+
+      if ssl == true
+        http.use_ssl = true
+        http.verify_mode = OpenSSL::SSL::VERIFY_NONE
+      end
+
+      return http
+    end
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: applidok
 version: !ruby/object:Gem::Version
-  version: 1.0.2
+  version: 1.0.3
 platform: ruby
 authors:
-- Applicius
+- cchantep
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-12-24 00:00:00.000000000 Z
+date: 2015-01-26 00:00:00.000000000 Z
 dependencies: []
 description: Client API for Applidok PDF templating
 email: contact@applidok.com
@@ -17,7 +17,7 @@ extensions: []
 extra_rdoc_files: []
 files:
 - lib/applidok.rb
-homepage: https://github.com/applicius/applidok-ruby
+homepage: https://github.com/cchantep/applidok-ruby
 licenses:
 - MIT
 metadata: {}