vufer 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 37b1f7eabe4d44ddbed09b792ea708797399ac040d251531ed107d0f61fb2031
+  data.tar.gz: 0a52113db5b1ca594645d9ca0958052c9d80eed138350f41558d45fd64a609db
+SHA512:
+  metadata.gz: '05258d5f26375ce25a8b68bad6e65acacb45c895dbb4fed89ab9ad794404a7c36b8f224a35388dcece5be457ecce6723e99cdaa21fef5e49e316f9bc12481091'
+  data.tar.gz: 61911e13a78b6e960804078fcf8c72abbcb514188b2fe0563d2571eebf946bd0c03d01a7c6e0b328ea2c6fb71e51bd66bd045300782cb2859bcb0d4864fa13b8

data/.env.example

@@ -0,0 +1,2 @@
+VWS_ACCESS_KEY=
+VWS_SECRET_KEY=

data/.gitignore

@@ -0,0 +1,14 @@
+/.bundle/
+/.yardoc
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+
+# rspec failure tracking
+.rspec_status
+
+# remove .env files for access and secret keys
+.env

data/.rspec

@@ -0,0 +1,3 @@
+--format documentation
+--color
+--require spec_helper

data/.ruby-version

@@ -0,0 +1 @@
+2.6.3

data/.travis.yml

@@ -0,0 +1,10 @@
+sudo: false
+language: ruby
+cache: bundler
+rvm:
+- 2.6.3
+before_install: gem install bundler -v 2.0.2
+env:
+  global:
+  - secure: XliWUXF9Ezv/QbLY1OqP9KzOq9++7yab5iQJuF0Lvh7tJwH6e9EoB2/0ndrsYhHxTjrBZWn99CDRbbOle9vBdl7sCnQyIHk387FXD0hygduiKohFsYiCWathA6g++Kymsp8Avs3brvJACvArZndVXDQBa/7ElV6kx/eRvIZJy5cXdZyHIsFNuCJrqrzS8I9sZaafvwTmOutmGxqfd/yLxG+3uONbC6UO3y9lrUaquMia2ojDCQH1/ftV4EPFKhXkngUTftyp1ncDycgZIO8o4IH98eYpdrltHnzAShL44SHTg5lX2f/Bn0YyQBpyHcrVgLCwhtPxJ42SIFQ1p5Agepz7KfgWapvzTH2oBwmX2kFMsqBwgn6JeEwgfQoCh5oq7i9xA4eaBOhzv4RV9/s2/Vw2bGV3k2HKpjeUtBkirQquzN0BbnzcDgul81YdefVtr+jDjQuDpBskZQlx1Mv3wEZ6r8h3W+WtKsCfpDOAWzxKZ/Pozw2zaWj83wR5RwEOOE/t/M+TvECG89bl/s4O7La3gvKHDBjj8mlB7XCOd3uWn62BGw23o2GHjB+JbXSdCaNit2HP/Rwd/fiGwITGezoFSNhwETWFZgp63LsTYCD6NMOc8ImYOZhodwysG0MLXUnwKdCxG1uPzuOEK04Mrio3KtfGKjyJI6jMqS2PVN0=
+  - secure: dZJZ6lAQh0Q5r42r1yqAySbLdGVdkTvy0LSp3s802yFUMYKXKSmvuY9LjG6vrSDNymIvP2yRn0uEXFnFWf78SeJV81CmkJLaF4dxURsID058tmZIjs7HqmVQLVQPELscnGxFa1pkb0wmaumCSRfTIzEluay98UdksjnlItW+6nalLX8cx8oOzfwy5RYO+UOxMXbbzNNAQoXSMRK8LnbnYlLtbiUmPU9lT7wmCobOQNerjIYHzKGQyDwzYthzkp7LgRL7JOOD0mx15qvRmeDPcmdLWYVgOTGw+Xy+HMk3f3/K3P0X56BopaibWl9NC3IjheOFqGQGnc2l5807jCC3Nx8mqZrVBKe5lXUAFGdxfRa7wRU/OlWOUBJZ2DQ/G6YjkNIuChkTJ6t7uK4EA1+/ByvPL2RhSUSeqh5fEUFBUvQP1kaW8HIsj+TQxLg9T7efyBti7p6/u7OX25PSgYwPhV5gx8AG0T28l+d4HYzpjmZabBgSQxg8XiR7EHvK2RYLYXrFzYeMiPH0eyW2YYwQDvHYyA9Bjhyce5JkwqeY5OEIC/a5YZZGU8r/yWEflT1q84+Q28hY8dfnyQJA1gWpsdKNC2QiUfO4Bzgq8WLcpdJJn3U/CqC+NYRUC5sOLtLxmr+foITDM7ItbAQuqXzrqkS5wDUb5DyD3W3KZZezjCM=

data/CHANGELOG.md

@@ -0,0 +1,27 @@
+# v1.0.0
+
+- Create `Vufer::Target.dups` to view duplated related targets.
+- Create `Vufer::Target.summary` to get a summary of a target.
+
+# v0.5.1
+
+- Create `Vufer::Target.destroy` to delete a specific target on the database.
+
+# v0.4.1
+
+- Create `Vufer::Target.create` method to add a new target on the database.
+- Create `Vufer::Target.update` to update a created target on the database.
+
+# v0.3.1
+
+- Create `Vufer::Target.all` method to load all ids from Vuforia associated with the server key.
+
+# v0.2.1
+
+- Create `Vufer.summary` to load info about targets, quota, requests, etc.. from Vuforia.
+- Implement a proper CI to run tests.
+
+# v0.1.1
+
+- Create `Vufer::Target.find(target_id)` method to get target from Vuforia.
+- Enable `.env.example` example on how to use environment variables.

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,74 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+In the interest of fostering an open and welcoming environment, we as
+contributors and maintainers pledge to making participation in our project and
+our community a harassment-free experience for everyone, regardless of age, body
+size, disability, ethnicity, gender identity and expression, level of experience,
+nationality, personal appearance, race, religion, or sexual identity and
+orientation.
+
+## Our Standards
+
+Examples of behavior that contributes to creating a positive environment
+include:
+
+* Using welcoming and inclusive language
+* Being respectful of differing viewpoints and experiences
+* Gracefully accepting constructive criticism
+* Focusing on what is best for the community
+* Showing empathy towards other community members
+
+Examples of unacceptable behavior by participants include:
+
+* The use of sexualized language or imagery and unwelcome sexual attention or
+advances
+* Trolling, insulting/derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or electronic
+  address, without explicit permission
+* Other conduct which could reasonably be considered inappropriate in a
+  professional setting
+
+## Our Responsibilities
+
+Project maintainers are responsible for clarifying the standards of acceptable
+behavior and are expected to take appropriate and fair corrective action in
+response to any instances of unacceptable behavior.
+
+Project maintainers have the right and responsibility to remove, edit, or
+reject comments, commits, code, wiki edits, issues, and other contributions
+that are not aligned to this Code of Conduct, or to ban temporarily or
+permanently any contributor for other behaviors that they deem inappropriate,
+threatening, offensive, or harmful.
+
+## Scope
+
+This Code of Conduct applies both within project spaces and in public spaces
+when an individual is representing the project or its community. Examples of
+representing a project or community include using an official project e-mail
+address, posting via an official social media account, or acting as an appointed
+representative at an online or offline event. Representation of a project may be
+further defined and clarified by project maintainers.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported by contacting the project team at orandson@gmail.com. All
+complaints will be reviewed and investigated and will result in a response that
+is deemed necessary and appropriate to the circumstances. The project team is
+obligated to maintain confidentiality with regard to the reporter of an incident.
+Further details of specific enforcement policies may be posted separately.
+
+Project maintainers who do not follow or enforce the Code of Conduct in good
+faith may face temporary or permanent repercussions as determined by other
+members of the project's leadership.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4,
+available at [http://contributor-covenant.org/version/1/4][version]
+
+[homepage]: http://contributor-covenant.org
+[version]: http://contributor-covenant.org/version/1/4/

data/Dockerfile

@@ -0,0 +1,19 @@
+FROM ruby:2.6.5
+
+ENV APP_HOME /app
+
+RUN mkdir $APP_HOME
+
+WORKDIR $APP_HOME
+
+COPY Gemfile $APP_HOME/Gemfile
+COPY Gemfile.lock $APP_HOME/Gemfile.lock
+COPY vufer.gemspec $APP_HOME/vufer.gemspec
+
+COPY . $APP_HOME
+
+ENV BUNDLE_GEMFILE=$APP_HOME/Gemfile BUNDLE_JOBS=2 BUNDLE_PATH=/bundle
+
+RUN gem install bundler
+RUN bundle install
+

data/Gemfile

@@ -0,0 +1,20 @@
+source 'https://rubygems.org'
+
+gemspec
+
+gem 'faraday'
+
+group :test do
+  gem 'pry'
+  gem 'vcr'
+  gem 'webmock'
+  gem 'rake'
+end
+
+group :coverage do
+  gem 'simplecov'
+end
+
+group :rubocop do
+  gem 'rubocop'
+end

data/Gemfile.lock

@@ -0,0 +1,83 @@
+PATH
+  remote: .
+  specs:
+    vufer (1.0.0)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    addressable (2.7.0)
+      public_suffix (>= 2.0.2, < 5.0)
+    ast (2.4.0)
+    coderay (1.1.2)
+    crack (0.4.3)
+      safe_yaml (~> 1.0.0)
+    diff-lcs (1.3)
+    docile (1.3.2)
+    faraday (0.17.0)
+      multipart-post (>= 1.2, < 3)
+    hashdiff (1.0.0)
+    jaro_winkler (1.5.4)
+    json (2.2.0)
+    method_source (0.9.2)
+    multipart-post (2.1.1)
+    parallel (1.19.0)
+    parser (2.6.5.0)
+      ast (~> 2.4.0)
+    pry (0.12.2)
+      coderay (~> 1.1.0)
+      method_source (~> 0.9.0)
+    public_suffix (4.0.1)
+    rainbow (3.0.0)
+    rake (10.5.0)
+    rspec (3.9.0)
+      rspec-core (~> 3.9.0)
+      rspec-expectations (~> 3.9.0)
+      rspec-mocks (~> 3.9.0)
+    rspec-core (3.9.0)
+      rspec-support (~> 3.9.0)
+    rspec-expectations (3.9.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.9.0)
+    rspec-mocks (3.9.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.9.0)
+    rspec-support (3.9.0)
+    rubocop (0.76.0)
+      jaro_winkler (~> 1.5.1)
+      parallel (~> 1.10)
+      parser (>= 2.6)
+      rainbow (>= 2.2.2, < 4.0)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (>= 1.4.0, < 1.7)
+    ruby-progressbar (1.10.1)
+    safe_yaml (1.0.5)
+    simplecov (0.17.1)
+      docile (~> 1.1)
+      json (>= 1.8, < 3)
+      simplecov-html (~> 0.10.0)
+    simplecov-html (0.10.2)
+    unicode-display_width (1.6.0)
+    vcr (5.0.0)
+    webmock (3.7.6)
+      addressable (>= 2.3.6)
+      crack (>= 0.3.2)
+      hashdiff (>= 0.4.0, < 2.0.0)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler (~> 2.0)
+  faraday
+  pry
+  rake
+  rspec (~> 3.0)
+  rubocop
+  simplecov
+  vcr
+  vufer!
+  webmock
+
+BUNDLED WITH
+   2.0.2

data/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2019 Randson
+
+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,56 @@
+<p align="center">
+  <img alt="Vufer logo" width="200" src="https://s3.amazonaws.com/arpia.pro/images/arpia-logo-rounded.png">
+</p>
+
+# Vufer [![Build Status](https://travis-ci.org/rands0n/vufer.svg?branch=master)](https://travis-ci.org/rands0n/vufer)
+
+A Ruby Gem to Interact with Vuforia Web Service API.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'vufer'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install vufer
+
+## Usage
+
+Configure your access and secret keys from Vuforia.
+
+```ruby
+Vufer.configure do |config|
+  config.access_key = 'MY_ACCESS_KEY'
+  config.secret_key = 'MY_SECRET_KEY'
+end
+```
+
+If you have `VWS_ACCESS_KEY` and `VWS_SECRET_KEY` set in your environment, Vufer will try to get these keys from the environment.
+
+[Use the docs](https://github.com/rands0n/vufer/wiki) to see on how to manage targets, view database and target summary.
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/rands0n/vufer. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](http://contributor-covenant.org) code of conduct.
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
+
+## Code of Conduct
+
+Everyone interacting in the Vufer project’s codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/rands0n/vufer/blob/master/CODE_OF_CONDUCT.md).

data/Rakefile

@@ -0,0 +1,6 @@
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec)
+
+task default: :spec

data/bin/console

@@ -0,0 +1,10 @@
+#!/usr/bin/env ruby
+
+require 'bundler/setup'
+require 'pry'
+require 'vufer'
+
+Vufer.access_key = ENV['VWS_ACCESS_KEY']
+Vufer.secret_key = ENV['VWS_SECRET_KEY']
+
+Pry.start

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/docker-compose.yml

@@ -0,0 +1,16 @@
+version: '3'
+
+services:
+  app:
+    build: .
+    command: bin/console
+    volumes:
+      - ./:/app
+      - bundle_path:/bundle
+    environment:
+      - BUNDLE_PATH=/bundle
+    tty: true
+    stdin_open: true
+
+volumes:
+  bundle_path:

data/lib/vufer/configure.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+module Vufer
+  module Configure
+    @@access_key = ''
+    @@secret_key = ''
+
+    def configure
+      yield self if block_given?
+    end
+
+    def access_key=(key)
+      @@access_key = key
+    end
+
+    def access_key
+      @@access_key
+    end
+
+    def secret_key=(key)
+      @@secret_key = key
+    end
+
+    def secret_key
+      @@secret_key
+    end
+
+    def use_defaults
+      configure do |config|
+        config.access_key ||= ENV['VWS_ACCESS_KEY']
+        config.secret_key ||= ENV['VWS_SECRET_KEY']
+      end
+    end
+  end
+end

data/lib/vufer/signature.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+require 'openssl'
+require 'base64'
+require 'digest/md5'
+require 'json'
+require 'open-uri'
+
+module Vufer
+  class Signature
+    HEX_DIGEST = 'd41d8cd98f00b204e9800998ecf8427e'.freeze
+
+    class << self
+      ##
+      # Generates the signature based on path, body, http verb and time.
+      #
+      # @param Path [String] the actual path you're sending the request, eg: '/targets'.
+      # @param Body [Hash] the content when request is in POST or PUT formats.
+      # @param Verb [String] the HTTP verb used to send the request, eg: POST, PUT, GET, etc...
+      # @param Time [Time] time in GMT the request is made.
+      #
+      # @return [String] contains an encrypted token with all the above informartion.
+      def generate(path, body, verb, time)
+        raise KeyEnvironmentError if Vufer.access_key.empty? || Vufer.secret_key.empty?
+
+        hex_digest = HEX_DIGEST
+        content_type = ''
+
+        if verb == 'POST' || verb == 'PUT'
+          content_type = 'application/json'
+          hex_digest = Digest::MD5.hexdigest(body.to_json)
+        end
+
+        to_digest = "#{verb}\n#{hex_digest}\n#{content_type}\n#{time}\n#{path}"
+
+        Base64.encode64(
+          OpenSSL::HMAC.digest(
+            OpenSSL::Digest::SHA1.new,
+            Vufer.secret_key,
+            to_digest
+          )
+        )
+      end
+    end
+  end
+end

data/lib/vufer/target.rb

@@ -0,0 +1,182 @@
+# frozen_string_literal: true
+
+require 'time'
+require 'faraday'
+
+module Vufer
+  class Target
+    class << self
+      ##
+      # Find a specific target on Vuforia Web Services API.
+      #
+      # @param ID [String] The identifier that exists on Vuforia.
+      #
+      # @return [JSON] the object parsed in JSON from Vuforia.
+      def find(id)
+        time = Time.now.httpdate
+        signature = Vufer::Signature.generate("/targets/#{id}", nil, 'GET', time)
+
+        res = Faraday.get("#{Vufer::BASE_URI}/targets/#{id}", {}, {
+          Date: time,
+          Authorization: "VWS #{Vufer.access_key}:#{signature}"
+        })
+
+        JSON.parse(res.body)
+      rescue StandardError => e
+        e.message
+      end
+
+      ##
+      # List all targets associated with server access keys and cloud database.
+      #
+      # @return [Array] A list of target ids associated with the account
+      def all
+        time = Time.now.httpdate
+        signature = Vufer::Signature.generate('/targets', nil, 'GET', time)
+
+        res = Faraday.get("#{Vufer::BASE_URI}/targets", {}, {
+          Date: time,
+          Authorization: "VWS #{Vufer.access_key}:#{signature}"
+        })
+
+        JSON.parse(res.body)
+      rescue StandardError => e
+        e.message
+      end
+
+      ##
+      # Creates a new target on Vuforia Web Services API.
+      #
+      # @param Name [String] The name of the image to create
+      # @param FileURL [String] Contains the base64 encoded binary recognition image data
+      # @param Width [Fixnum] Width of the target in scene unit
+      # @param ActiveFlag [Boolean] Indicates whether or not the target is active for query, default: false
+      # @param Metadata [Hash] The base64 encoded application metadata associated with the target
+      #
+      # @return [JSON] A newly target id from Vuforia.
+      def create(name, file_path, width = 50.0, active_flag = false, metadata = nil)
+        time = Time.now.httpdate
+        file_encoded = Base64.encode64(open(file_path) { |io| io.read })
+        metadata_encoded = Base64.encode64(metadata.to_s)
+
+        body_hash = {
+          name: name, width: width, image: file_encoded,
+          active_flag: active_flag, application_metadata: metadata_encoded
+        }
+
+        signature = Vufer::Signature.generate(
+          '/targets', body_hash, 'POST', time
+        )
+
+        res = Faraday.post("#{Vufer::BASE_URI}/targets", body_hash.to_json, {
+          Date: time,
+          Authorization: "VWS #{Vufer.access_key}:#{signature}",
+          'Content-Type': 'application/json',
+          Accept: 'application/json'
+        })
+
+        JSON.parse(res.body)
+      rescue StandardError => e
+        e.message
+      end
+
+      ##
+      # Performs an update for a specific target on the database.
+      #
+      # @param ID [String] The ID(identifier) of the target on Vuforia.
+      # @param Name [String] The name of the image to create
+      # @param FileURL [String] Contains the base64 encoded binary recognition image data
+      # @param Width [Fixnum] Width of the target in scene unit
+      # @param ActiveFlag [Boolean] Indicates whether or not the target is active for query
+      # @param Metadata [Hash] The base64 encoded application metadata associated with the target
+      #
+      # @return [JSON] A info showing success that the target was updated.
+      def update(id, name = nil, file_path = nil, width = nil, active_flag = nil, metadata = nil)
+        time = Time.now.httpdate
+        contents_encoded = file_path ? Base64.encode64(open(file_path) { |io| io.read }) : nil
+        metadata_encoded = metadata ? Base64.encode64(metadata.to_s) : nil
+
+        body_hash = {}.merge(name ? { name: name } : {})
+        body_hash = body_hash.merge(width ? { width: width } : {})
+        body_hash = body_hash.merge(contents_encoded ? { image: contents_encoded } : {})
+        body_hash = body_hash.merge(!active_flag.nil? ? { active_flag: active_flag } : {})
+        body_hash = body_hash.merge(metadata_encoded ? { application_metadata: metadata_encoded } : {})
+
+        signature = Vufer::Signature.generate("/targets/#{id}", body_hash, 'PUT', time)
+
+        res = Faraday.put("#{Vufer::BASE_URI}/targets/#{id}", body_hash.to_json, {
+          Date: time,
+          Authorization: "VWS #{Vufer.access_key}:#{signature}",
+          'Content-Type': 'application/json',
+          Accept: 'application/json'
+        })
+
+        JSON.parse(res.body)
+      rescue StandardError => e
+        e.message
+      end
+
+      ##
+      # Deletes a specific targets from the database.
+      #
+      # Note: Targets in a processing status cannot be deleted.
+      #
+      # @param ID [String] The ID(identifier) of the target on the database.
+      #
+      # @return [JSON] The result code and transaction id indicating the update was ok.
+      def destroy(id)
+        time = Time.now.httpdate
+        signature = Vufer::Signature.generate("/targets/#{id}", nil, 'DELETE', time)
+
+        res = Faraday.delete("#{Vufer::BASE_URI}/targets/#{id}", {}, {
+          Date: time,
+          Authorization: "VWS #{Vufer.access_key}:#{signature}"
+        })
+
+        JSON.parse(res.body)
+      rescue StandardError => e
+        e.message
+      end
+
+      ##
+      # Review all duplicates targets from the database.
+      #
+      # @param ID [String] The identifier of the target on database.
+      #
+      # @return [JSON] An Array of ids of similar targets
+      def dups(id)
+        time = Time.now.httpdate
+        signature = Vufer::Signature.generate("/duplicates/#{id}", nil, 'GET', time)
+
+        res = Faraday.get("#{Vufer::BASE_URI}/duplicates/#{id}", {}, {
+          Date: time,
+          Authorization: "VWS #{Vufer.access_key}:#{signature}"
+        })
+
+        JSON.parse(res.body)
+      rescue StandardError =>
+        e.message
+      end
+
+      ##
+      # Load a summary of a specific target on the database.
+      #
+      # @param ID [String] The identifier of the target on database.
+      #
+      # @return [JSON] All the info about database and target.
+      def summary(id)
+        time = Time.now.httpdate
+        signature = Vufer::Signature.generate("/summary/#{id}", nil, 'GET', time)
+
+        res = Faraday.get("#{Vufer::BASE_URI}/summary/#{id}", {}, {
+          Date: time,
+          Authorization: "VWS #{Vufer.access_key}:#{signature}"
+        })
+
+        JSON.parse(res.body)
+      rescue StandardError =>
+        e.message
+      end
+    end
+  end
+end

data/lib/vufer/version.rb

@@ -0,0 +1,3 @@
+module Vufer
+  VERSION = '1.0.0'
+end

data/lib/vufer.rb

@@ -0,0 +1,35 @@
+require 'time'
+
+require 'vufer/version'
+require 'vufer/configure'
+require 'vufer/signature'
+require 'vufer/target'
+
+module Vufer
+  extend Configure
+
+  BASE_URI = 'https://vws.vuforia.com'.freeze
+
+  class Error < StandardError; end
+  class KeyEnvironmentError < Error; end
+
+  class << self
+    ##
+    # Returns a summary from targets, quota and images from Vuforia.
+    #
+    # @result [JSON] object containing all the info about targets, quota and images.
+    def summary
+      time = Time.now.httpdate
+      signature = Vufer::Signature.generate('/summary', nil, 'GET', time)
+
+      res = Faraday.get("#{Vufer::BASE_URI}/summary", {}, {
+        'Date': time,
+        'Authorization': "VWS #{Vufer.access_key}:#{signature}"
+      })
+
+      JSON.parse(res.body)
+    rescue StandardError => e
+      e.message
+    end
+  end
+end

data/vufer.gemspec

@@ -0,0 +1,32 @@
+lib = File.expand_path('lib', __dir__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+
+require 'vufer/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'vufer'
+  spec.version       = Vufer::VERSION
+  spec.authors       = ['Randson']
+  spec.email         = ['orandson@gmail.com']
+
+  spec.summary       = 'A Ruby Gem to Interact with Vuforia Web Service API'
+  spec.homepage      = 'https://github.com/rands0n/vufer'
+  spec.license       = 'MIT'
+
+  spec.metadata['homepage_uri'] = spec.homepage
+  spec.metadata['source_code_uri'] = spec.homepage
+  spec.metadata['changelog_uri'] = "#{spec.homepage}/tree/master/CHANGELOG.md"
+
+  # Specify which files should be added to the gem when it is released.
+  # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
+  spec.files         = Dir.chdir(File.expand_path('..', __FILE__)) do
+    `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  end
+  spec.bindir        = 'exe'
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ['lib']
+
+  spec.add_development_dependency 'bundler', '~> 2.0'
+  spec.add_development_dependency 'rake', '~> 10.0'
+  spec.add_development_dependency 'rspec', '~> 3.0'
+end

metadata

@@ -0,0 +1,110 @@
+--- !ruby/object:Gem::Specification
+name: vufer
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Randson
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2019-11-28 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+description: 
+email:
+- orandson@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".env.example"
+- ".gitignore"
+- ".rspec"
+- ".ruby-version"
+- ".travis.yml"
+- CHANGELOG.md
+- CODE_OF_CONDUCT.md
+- Dockerfile
+- Gemfile
+- Gemfile.lock
+- LICENSE
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- docker-compose.yml
+- lib/vufer.rb
+- lib/vufer/configure.rb
+- lib/vufer/signature.rb
+- lib/vufer/target.rb
+- lib/vufer/version.rb
+- vufer.gemspec
+homepage: https://github.com/rands0n/vufer
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/rands0n/vufer
+  source_code_uri: https://github.com/rands0n/vufer
+  changelog_uri: https://github.com/rands0n/vufer/tree/master/CHANGELOG.md
+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: '0'
+requirements: []
+rubygems_version: 3.0.3
+signing_key: 
+specification_version: 4
+summary: A Ruby Gem to Interact with Vuforia Web Service API
+test_files: []