help_provas_api 0.0.1

data/.gitattributes

@@ -0,0 +1,22 @@
+# Auto detect text files and perform LF normalization
+* text=auto
+
+# Custom for Visual Studio
+*.cs     diff=csharp
+*.sln    merge=union
+*.csproj merge=union
+*.vbproj merge=union
+*.fsproj merge=union
+*.dbproj merge=union
+
+# Standard to msysgit
+*.doc	 diff=astextplain
+*.DOC	 diff=astextplain
+*.docx diff=astextplain
+*.DOCX diff=astextplain
+*.dot  diff=astextplain
+*.DOT  diff=astextplain
+*.pdf  diff=astextplain
+*.PDF	 diff=astextplain
+*.rtf	 diff=astextplain
+*.RTF	 diff=astextplain

data/.gitignore

@@ -0,0 +1,163 @@
+#################
+## Eclipse
+#################
+
+*.pydevproject
+.project
+.metadata
+bin/
+tmp/
+*.tmp
+*.bak
+*.swp
+*~.nib
+local.properties
+.classpath
+.settings/
+.loadpath
+
+# External tool builders
+.externalToolBuilders/
+
+# Locally stored "Eclipse launch configurations"
+*.launch
+
+# CDT-specific
+.cproject
+
+# PDT-specific
+.buildpath
+
+
+#################
+## Visual Studio
+#################
+
+## Ignore Visual Studio temporary files, build results, and
+## files generated by popular Visual Studio add-ons.
+
+# User-specific files
+*.suo
+*.user
+*.sln.docstates
+
+# Build results
+[Dd]ebug/
+[Rr]elease/
+*_i.c
+*_p.c
+*.ilk
+*.meta
+*.obj
+*.pch
+*.pdb
+*.pgc
+*.pgd
+*.rsp
+*.sbr
+*.tlb
+*.tli
+*.tlh
+*.tmp
+*.vspscc
+.builds
+*.dotCover
+
+## TODO: If you have NuGet Package Restore enabled, uncomment this
+#packages/
+
+# Visual C++ cache files
+ipch/
+*.aps
+*.ncb
+*.opensdf
+*.sdf
+
+# Visual Studio profiler
+*.psess
+*.vsp
+
+# ReSharper is a .NET coding add-in
+_ReSharper*
+
+# Installshield output folder
+[Ee]xpress
+
+# DocProject is a documentation generator add-in
+DocProject/buildhelp/
+DocProject/Help/*.HxT
+DocProject/Help/*.HxC
+DocProject/Help/*.hhc
+DocProject/Help/*.hhk
+DocProject/Help/*.hhp
+DocProject/Help/Html2
+DocProject/Help/html
+
+# Click-Once directory
+publish
+
+# Others
+[Bb]in
+[Oo]bj
+sql
+TestResults
+*.Cache
+ClientBin
+stylecop.*
+~$*
+*.dbmdl
+Generated_Code #added for RIA/Silverlight projects
+
+# Backup & report files from converting an old project file to a newer
+# Visual Studio version. Backup files are not needed, because we have git ;-)
+_UpgradeReport_Files/
+Backup*/
+UpgradeLog*.XML
+
+
+
+############
+## Windows
+############
+
+# Windows image file caches
+Thumbs.db
+
+# Folder config file
+Desktop.ini
+
+
+#############
+## Python
+#############
+
+*.py[co]
+
+# Packages
+*.egg
+*.egg-info
+dist
+build
+eggs
+parts
+bin
+var
+sdist
+develop-eggs
+.installed.cfg
+
+# Installer logs
+pip-log.txt
+
+# Unit test / coverage reports
+.coverage
+.tox
+
+#Translations
+*.mo
+
+#Mr Developer
+.mr.developer.cfg
+
+# Mac crap
+.DS_Store

data/Gemfile

@@ -0,0 +1,5 @@
+source "http://rubygems.org"
+#interface to your soap service
+gemspec
+
+gem "rest-client"

data/Rakefile

@@ -0,0 +1 @@
+require "bundler"

data/Readme.md

@@ -0,0 +1,90 @@
+#Help Provas Api
+
+Integração com Help Provas
+
+##Funcionalidades
+
+* Gerar voucher
+* Resgatar voucher
+* Cancelar voucher
+* Gerar acesso
+
+##Utilização
+```ruby
+gem install help_provas_api
+```
+
+###Rails
+```ruby
+rails g help_provas_api:install
+```
+Este comando irá gerar um arquivo config/initializers/help_provas_api.rb onde você deverá informar os dados para os ambientes de desenvolvimento e produção.
+
+config/initializers/help_provas_api.rb
+```ruby
+HelpProvasApi.setup do |config|
+  env = Rails.env
+  if(env == "production")
+    config.environment = :production
+    config.token = ""
+    config.version = ""
+  else 
+    config.environment = :development
+    config.token = ""
+    config.version = ""
+  end
+end
+```
+
+###Exemplo de utilização
+Verifique os campos de retorno conforme o manual que lhe foi concedido.
+
+Gerar voucher:
+```ruby
+voucher = HelpProvasApi::Voucher.new
+response = voucher.generate(product_code,plan_code)
+puts response["CodigoRetorno"]
+```
+
+Resgatar voucher:
+```ruby
+voucher = HelpProvasApi::Voucher.new
+response = voucher.reedem(voucher_code, name, email, password, phone, plan_code)
+puts response["CodigoRetorno"]
+```
+
+Cancelar voucher:
+```ruby
+voucher = HelpProvasApi::Voucher.new
+response = voucher.cancel(voucher_code)
+puts response["CodigoRetorno"]
+```
+
+Gerar acesso:
+```ruby
+voucher = HelpProvasApi::Voucher.new
+response = voucher.access(product_code, name, email, password, phone, plan_code)
+puts response["CodigoRetorno"]
+```
+
+##Licensa
+Copyright(c)2013 Tarik Boschi.
+
+A permissão é concedida, de forma gratuita, para qualquer pessoa que obtenha
+parceria com a Help Provas possa fazer uma cópia deste software e arquivos, 
+para lidar com o Software sem restrição, incluindo
+sem limitação, os direitos de usar, copiar, modificar, mesclar, publicar,
+distribuir, sublicenciar e / ou vender cópias do Software, e
+permitir às pessoas a quem o Software é fornecido a fazê-lo, desde que
+nas seguintes condições:
+
+O aviso de copyright acima e este aviso de permissão devem ser
+incluído em todas as cópias ou partes substanciais do Software.
+
+O SOFTWARE É FORNECIDO "COMO ESTÁ", SEM GARANTIA DE QUALQUER TIPO,
+EXPRESSA OU IMPLÍCITA, INCLUINDO, SEM LIMITAÇÃO, AS GARANTIAS DE
+COMERCIALIZAÇÃO, ADEQUAÇÃO A UM DETERMINADO FIM E LEGALIDADE. EM
+NENHUM CASO OS AUTORES OU DETENTORES DE DIREITOS AUTORAIS SÃO
+RESPONSÁVEIS POR QUALQUER RECLAMAÇÃO, DANOS OU OUTRAS RESPONSABILIDADES, 
+SEJA EM UMA AÇÃO DE CONTRATO, OU DE OUTRA FORMA, DECORRENTES DE OU CONEXÃO
+COM O SOFTWARE OU O USO OU OUTRA APLICAÇÃO DO SOFTWARE.

data/help_provas_api.gemspec

@@ -0,0 +1,27 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+
+require "help_provas_api/version"
+
+Gem::Specification.new do |s|
+  s.name        = "help_provas_api"
+  s.version     = HelpProvasApi::VERSION
+  s.authors     = ["Tarik"]
+  s.email       = ["tarik@boschi.com.br"]
+  s.homepage    = "https://github.com/tarikboschi/help_provas_api"
+  s.summary     = %q{Integração API Help Provas}
+  s.description = %q{GEM para integração com a API da Help Provas}
+
+  s.rubyforge_project = "help_provas_api"
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+  
+  s.add_dependency 'rest-client'
+  
+  # specify any dependencies here; for example:
+  # s.add_development_dependency "rspec"
+  # s.add_runtime_dependency "rest-client"
+end

data/lib/generators/help_provas_api/install_generator.rb

@@ -0,0 +1,13 @@
+module HelpProvasApi
+  module Generators
+    class InstallGenerator < Rails::Generators::Base
+      source_root File.expand_path("../../templates",__FILE__)
+      
+      desc "Cria o initializer da API Help Provas"
+      
+      def copy_initializer
+        template "help_provas_api.rb", "config/initializers/help_provas_api.rb"
+      end
+    end
+  end
+end

data/lib/generators/templates/help_provas_api.rb

@@ -0,0 +1,14 @@
+# encoding: utf-8
+# Use esse arquivo para configurar a integração com a Cresca Brasil.
+HelpProvasApi.setup do |config|
+  env = Rails.env
+  if(env == "production")
+    config.environment = :production
+    config.token = ""
+    config.version = ""
+  else 
+    config.environment = :development
+    config.token = ""
+    config.version = ""
+  end
+end

data/lib/help_provas_api.rb

@@ -0,0 +1,30 @@
+require 'rest-client'
+require 'active_support/core_ext/class/attribute_accessors'
+require 'active_support/core_ext/module/attribute_accessors'
+require 'active_support/core_ext/hash'
+require 'builder'
+require 'json'
+[:version,:voucher].each { |lib| require "help_provas_api/#{lib}" }
+
+module HelpProvasApi
+  class Production
+    URL = "http://api.helpprovas.com.br/Voucher.svc"
+  end
+  
+  class Development
+    URL = "http://apisandbox.helpprovas.com.br/Voucher.svc"
+  end
+  
+  @@environment = :development
+  mattr_accessor :environment
+  @@token = ""
+  mattr_accessor :token
+  @@version = ""
+  mattr_accessor :version
+    
+  def self.setup
+    yield self
+  end
+  
+  class MissingArgumentError < StandardError; end
+end

data/lib/help_provas_api/version.rb

@@ -0,0 +1,3 @@
+module HelpProvasApi
+  VERSION = "0.0.1"
+end

data/lib/help_provas_api/voucher.rb

@@ -0,0 +1,43 @@
+#encoding: utf-8
+module HelpProvasApi
+  class Voucher
+    attr_reader :environment
+    def initialize
+      @environment = eval(HelpProvasApi.environment.to_s.capitalize)
+    end
+    
+    #cancela voucher
+    def cancel(voucher_code)
+      uri =  "#{self.environment::URL}/Cancelar/#{HelpProvasApi.token}/#{HelpProvasApi.version}/"
+      uri += "#{voucher_code}"
+      request uri
+    end
+
+    #gera o voucher
+    def generate(product_code, plan_code)
+      uri =  "#{self.environment::URL}/Gerar/#{HelpProvasApi.token}/#{HelpProvasApi.version}/"
+      uri += "#{product_code}/#{plan_code}"
+      request uri
+    end
+
+    #gera acesso do cliente no sistema
+    def access(product_code, name, email, password, phone, plan_code)
+      uri =  "#{self.environment::URL}/GerarAcesso/#{HelpProvasApi.token}/#{HelpProvasApi.version}/"
+      uri += "#{product_code}/#{name}/#{email}/#{password}/#{phone}/#{plan_code}"
+      request uri
+    end
+
+    #ativa o voucher
+    def redeem(voucher_code, name, email, password, phone, plan_code)
+      uri =  "#{self.environment::URL}/Resgatar/#{HelpProvasApi.token}/#{HelpProvasApi.version}/"
+      uri += "#{voucher_code}/#{name}/#{email}/#{password}/#{phone}"
+      request uri
+    end
+    
+    private
+      def request(uri)
+        resp = RestClient.get uri
+        JSON.parse(resp)
+      end
+  end
+end

metadata

@@ -0,0 +1,67 @@
+--- !ruby/object:Gem::Specification
+name: help_provas_api
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Tarik
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-05-11 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rest-client
+  requirement: &19910856 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *19910856
+description: GEM para integração com a API da Help Provas
+email:
+- tarik@boschi.com.br
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitattributes
+- .gitignore
+- Gemfile
+- Rakefile
+- Readme.md
+- help_provas_api.gemspec
+- lib/generators/help_provas_api/install_generator.rb
+- lib/generators/templates/help_provas_api.rb
+- lib/help_provas_api.rb
+- lib/help_provas_api/version.rb
+- lib/help_provas_api/voucher.rb
+homepage: https://github.com/tarikboschi/help_provas_api
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: help_provas_api
+rubygems_version: 1.8.16
+signing_key: 
+specification_version: 3
+summary: Integração API Help Provas
+test_files: []