firstjob 1.0.0

data/lib/firstjob/http_parser.rb

@@ -0,0 +1,49 @@
+module Firstjob
+  class HttpParser
+    def self.parse_json_to_hash(json, hash)
+      json.each{|object| hash[object["id"]] ? hash[object["id"]].merge!(object) : hash[object["id"]] = object}
+      return hash
+    end
+
+    def self.parse_response(response)
+      Firstjob.last_response = response
+      Firstjob.last_request = response.request
+      case response.code
+        when 200..201
+          # "All good!"
+          return response.body
+        when 401
+          Firstjob.invalidate_access_token!
+          raise "Error 401: Unauthorized. Check login info.\n #{response.body}"
+        when 403
+          raise "Error 403: Forbidden"
+        when 404
+          raise "Error 404 not found"
+        when 500...600
+          raise "ZOMG ERROR #{response.code}: #{response.request.path}, #{response.body}"
+        else
+          raise "Error #{response.code}, unkown response: #{response.request.path}, #{response.body}"
+      end
+    end
+    def self.parse_json_response(response)
+      Firstjob.last_response = response
+      Firstjob.last_request = response.request
+      case response.code
+        when 200..201
+          # "All good!"
+          return JSON.parse(response.body)
+        when 401
+          Firstjob.invalidate_access_token!
+          raise "Error 401: Unauthorized. Check login info.\n #{response.body}"
+        when 403
+          raise "Error 403: Forbidden"
+        when 404
+          raise "Error 404 not found"
+        when 500...600
+          raise "ZOMG ERROR #{response.code}: #{response.request.path}, #{response.body}"
+        else
+          raise "Error #{response.code}, unkown response: #{response.request.path}, #{response.body}"
+      end
+    end
+  end
+end

data/lib/firstjob/looking_for.rb

@@ -0,0 +1,15 @@
+module Firstjob
+  class LookingFor
+    LOOKING_FORS = YAML.load_file("lib/data/looking_fors.yaml")["looking_fors"].symbolize_keys!
+
+    # Poor's man all
+    def self.all
+      LOOKING_FORS
+    end
+
+    # Poor's man find
+    def self.find(id)
+      LOOKING_FORS[id]
+    end
+  end
+end

data/lib/firstjob/publication.rb

@@ -0,0 +1,97 @@
+module Firstjob
+  class Publication
+    attr_accessor :title, :description, :career_status_id,
+      :looking_for_id, :location, :years_experience, :salary,
+      :english_level_id, :excel_level_id, :careers_ids,
+      :universities_ids, :id, :slug, :status, :postulantes
+  
+    def initialize(attributes={})
+      # Default values
+      @salary = 0
+      @location = "Chile"
+      @career_status_id = 1
+      @years_experience = 0
+      @english_level_id = 1
+      @excel_level_id = 1
+
+      attributes.each do |key, value|
+        self.send("#{key}=", value)
+      end
+    end
+
+    def body
+      default_publication_json()
+    end
+
+    def self.create(params)
+      publication = new(params)
+      response = publication.publish()
+    end
+
+    def publish
+      # Post publication
+      response = Firstjob.post("/api/publish_job",
+                               Firstjob.options.merge(
+                                 body: Firstjob.body.merge({publish_job: self.body}).to_json
+                                )
+                              )
+      response_body = HttpParser.parse_json_response(response)
+
+      # load results
+      @slug = response_body["slug"]
+      @id = response_body["id"]
+      @status = response_body["status"]
+      return self
+    end
+
+    def url
+      "#{Firstjob.base_uri}/jobs/#{slug}"
+    end
+
+    def postulants
+      # Get postulants
+      response = Firstjob.post("/api/get_applicants_job",
+                               Firstjob.options.merge(
+                                 body: Firstjob.body.merge({job_id: @id}).to_json
+                                )
+                              )
+      response_body = HttpParser.parse_json_response(response)
+
+      # load results
+      @postulantes = response_body["postulantes"]
+      return @postulantes
+    end
+
+    def destroy
+      response = Firstjob.post("/api/doregister_job",
+                               Firstjob.options.merge(
+                                 body: Firstjob.body.merge({job_id: id}).to_json
+                                )
+                              )
+      response_body = HttpParser.parse_response(response)
+    end
+  
+    private
+    def default_publication_json
+      hash = {
+        title:               title, # required
+        description:         description, # required, max 300 caracters
+        career_status:       career_status_id, # required
+        looking_for:         looking_for_id, # required
+        location:            location, # required
+        years_experience:    years_experience, # required, number
+        salary:              salary, # required, number. Can be 0
+        english_level:       english_level_id, # required, number 
+        excel_level:         excel_level_id, # required, number 
+      }
+      if careers_ids.present?
+        hash[:careers] = careers_ids   # optional, array or NOT PRESENT
+      end
+      if universities_ids.present?
+        hash[:universities] = universities_ids # optional, array or NOT PRESENT
+      end
+      return hash
+    end
+  
+  end
+end

data/lib/firstjob/university.rb

@@ -0,0 +1,15 @@
+module Firstjob
+  class University
+    UNIVERSITIES = YAML.load_file("lib/data/universities.yaml")["universities"].symbolize_keys!
+
+    # Poor's man all
+    def self.all
+      UNIVERSITIES
+    end
+
+    # Poor's man find
+    def self.find(id)
+      UNIVERSITIES[id]
+    end
+  end
+end

data/lib/firstjob/version.rb

@@ -0,0 +1,3 @@
+module Firstjob
+  VERSION = "1.0.0"
+end

data/lib/firstjob.rb

@@ -0,0 +1,142 @@
+require 'rails'
+require 'time'
+require 'httparty'
+require 'erb'
+
+require 'firstjob/university'
+require 'firstjob/career'
+require 'firstjob/career_status'
+require 'firstjob/english_level'
+require 'firstjob/excel_level'
+require 'firstjob/looking_for'
+require 'firstjob/university'
+require 'firstjob/publication'
+require 'firstjob/http_parser'
+
+module Firstjob
+  include HTTParty
+  base_uri 'https://api.firstjob.com'
+
+  # API login configuration, need initialization setup to work
+  mattr_accessor :grant_type
+  @@grant_type = "password"
+
+  mattr_accessor :client_id
+  @@client_id = nil
+
+  mattr_accessor :username
+  @@username = nil
+
+  mattr_accessor :email
+  @@email    = nil
+
+  mattr_accessor :password
+  @@password    = nil
+
+  mattr_accessor :access_token
+  @@access_token = nil
+
+  @@token_type= nil
+
+  mattr_accessor :expires_in
+  @@expires_in = nil
+
+  mattr_accessor :access_token_updated_at
+  @@access_token_updated_at = nil
+
+  mattr_accessor :options
+  @@options = nil
+
+  mattr_accessor :body
+  @@body = nil
+
+  mattr_accessor :last_request
+  mattr_accessor :last_response
+  @@last_request = nil
+  @@last_response = nil
+
+  @@try_counter = 0
+  
+
+  # Default way to setup Firstjob.
+  def self.setup
+    yield self
+    # It does not use basic http auth, it passes the username and password in the body of the request...
+    #@@options = {headers: { "Accept" => "application/json", "Content-Type" => "application/json"}, basic_auth: {username: @@username, password: @@password}}
+    @@options = {headers: { "Accept" => "application/json", "Content-Type" => "application/json"}}
+    @@body = {username: @@username, password: @@password}
+  end
+
+  # Publicaciones
+  # creates and publish a publication
+  def self.publish(params)
+    publication = Firstjob::Publication.create(params)
+    return publication
+  end
+
+  def self.update_publication(publication_id, json)
+    update_publication_path = "/v0/empresas/avisos/#{publication_id}"
+    response = self.post(update_publication_path, @@options.merge(body: json, headers: { "Accept" => "application/json", "Content-Type" => "application/json"}))
+
+    if HttpParser.parse_response(response)
+      case response.code
+        when 201
+          # "Publication updated, All good!"
+          return response # body contains id del proceso publicado
+        when 200
+          # "TODO: Uhm.. no idea, is this good?"
+          return response # body contains id del proceso publicado?
+      end
+    end
+  end
+
+  def self.publish_publication(publication_id, pais_id, plan_publication_id)
+    publish_publication_path = "/v0/empresas/avisos/#{publication_id}/publicacion/#{plan_publication_id}"
+    response = self.put(publish_publication_path, @@options.merge(query: @@options[:query].merge({paisId: pais_id})))
+
+    if HttpParser.parse_response(response)
+      case response.code
+        when 201
+          # "Publication created, All good!"
+          return response # body contains id del proceso publicado
+        when 200
+          # "TODO: Uhm.. no idea, is this good?"
+          return response # body contains id del proceso publicado?
+      end
+    end
+  end
+
+  def self.get_publication_url(publication_id)
+    "http://www.laborum.cl/empleos/#{publication_id}.html"
+  end
+
+  def self.get_publication(publication_id)
+    get_publication_path = "/v0/empresas/avisos/#{publication_id}"
+    response = self.get(get_publication_path, @@options)
+
+    return HttpParser.parse_response_to_json(response)
+  end
+
+  def self.get_postulations_in_publication(publication_id, page=0, postulations_per_page=20)
+    get_postulations_in_publication_path = "/v0/empresas/avisos/#{publication_id}/postulaciones"
+    response = self.get(get_postulations_in_publication_path, @@options.merge(query: @@options[:query].merge({page: page, perPage: postulations_per_page})))
+
+    return HttpParser.parse_response_to_json(response)
+  end
+
+  def self.get_postulation(postulation_id)
+    get_postulation_path = "/v0/empresas/postulaciones/#{postulation_id}"
+    response = self.get(get_postulation_path, @@options)
+
+    return HttpParser.parse_response_to_json(response)
+  end
+
+  def self.destroy_publication(publication_id)
+    destroy_publication_path = "/v0/empresas/avisos/#{publication_id}"
+    response = self.delete(destroy_publication_path, @@options)
+
+    return HttpParser.parse_response(response)
+  end
+
+end
+

data/spec/firstjob_initializer_helper.rb

@@ -0,0 +1,5 @@
+Firstjob.setup do |config|
+  config.username = ENV["FIRSTJOB_USERNAME"]
+  config.password = ENV["FIRSTJOB_PASSWORD"]
+  config.base_uri ENV["FIRSTJOB_BASE_URI"]
+end

data/spec/fixtures/firstjob_fixture.rb

@@ -0,0 +1,69 @@
+class FirstjobFixture
+  def self.publication
+    publication =  Firstjob::Publication.new
+    publication.body[:descripcion]             = "Descripcion de la publicacion de prueba"    # required
+    publication.body[:titulo]                  = "Publicacion de prueba"                      # required
+    #publication.body[:referencia]              = ""  #optional
+
+    # We can use an id for denominacion
+    publication.body[:denominacion][:id]      = 0                                             # required
+    # or we can create a new one
+    #publication.body[:denominacion][:nombre]  = ""
+    #publication.body[:denominacion][:logo]    = ""
+
+    #publication.body[:preguntas]  # optional
+    publication.body[:preguntas][0][:simple][:texto] = "Pregunta de prueba"                   # optional
+    publication.body[:preguntas] << {choice: {texto: "Pregunta de alternativas", indiceCorrecta: 2, opciones: [{opcion: "respuesta 1"}, {opcion: "respuesta 2"}, {opcion: "respuesta 3"}, {opcion: "respuesta 4"}]}}      # optional
+
+    #publication.body["postulantesDiscapacitados"] false, #optional
+
+    #publication.body["lugarTrabajo"]
+    #publication.body[:lugarTrabajo][:id]                = 0  # TODO: found in the developers site but not in the documentation
+    publication.body[:lugarTrabajo][:paisId]            = 1                      # required
+    publication.body[:lugarTrabajo][:zonaId]            = 18                     # required
+    publication.body[:lugarTrabajo][:localidadId]       = 6050                   # required
+    publication.body[:lugarTrabajo][:direccion]         = "San Martin 256"       # required
+    publication.body[:lugarTrabajo][:mostrarDireccionEnAviso] = false      # required
+
+    publication.body[:recepcionCandidato][:electronica][:email] = "test@domain.com" # required
+    # recepcionCandidato can aslo be with dias, rangoHorario and direccion
+    publication.body[:areaId]             = 19        # required
+    publication.body[:subAreaId]          = 26        # required
+    ####publication.body[:requisitos]               # optional
+    ###publication.body[:requisitos][:experiencia]
+    publication.body[:requisitos][:experiencia][:minimo]     = 60             # required
+    publication.body[:requisitos][:experiencia][:excluyente] = false          # required
+    ###publication.body[:requisitos][:edad]
+    publication.body[:requisitos][:edad][:edadMinima] = 18                    # required
+    publication.body[:requisitos][:edad][:edadMaxima] = 40                    # required
+    publication.body[:requisitos][:edad][:excluyente] = false                 # required
+    ###publication.body["requisitos"]["educacion"]
+    publication.body[:requisitos][:educacion][:estadoEstudioId] = 2           # required
+    publication.body[:requisitos][:educacion][:tipoEstudioId]   = 3           # required
+    publication.body[:requisitos][:educacion][:excluyente]      = false       # required
+    ###publication.body["requisitos"]["idiomas"]
+    publication.body[:requisitos][:idiomas][0][:nivelId]    = 10              # required
+    publication.body[:requisitos][:idiomas][0][:idiomaId]   = 1               # required
+    publication.body[:requisitos][:idiomas][0][:excluyente] = false           # required
+    ###publication.body["requisitos"]["residencia"]
+    publication.body[:requisitos][:residencia][:cercania]   = "provincia"     # required
+    #publication.body[:requisitos][:residencia][:cantidadKm] = 0              # optional
+    publication.body[:requisitos][:residencia][:excluyente] = false           # required
+    ###publication.body["requisitos"]["salario"]
+    publication.body[:requisitos][:salario][:tipo]             = "bruto"      # required
+    publication.body[:requisitos][:salario][:salarioMinimo]    = 200000       # required
+    publication.body[:requisitos][:salario][:salarioMaximo]    = 1000000      # required
+    publication.body[:requisitos][:salario][:frecuenciaPagoId] = 4            # required
+    publication.body[:requisitos][:salario][:mostrarAviso]     = true         # required
+    publication.body[:requisitos][:salario][:solicitarCandidato] = true       # required
+    publication.body[:requisitos][:salario][:excluyente]       = false        # optional
+    ###publication.body[:requisitos][:genero]
+    publication.body[:requisitos][:genero][:nombre]     = "masculino"       # required
+    publication.body[:requisitos][:genero][:excluyente] = false             # required
+    publication.body[:tipoTrabajoId] =  4                                   # required
+
+    return publication
+
+    # publish(publication.body.to_publication.body)
+  end
+end

data/spec/lib/bumeran_spec.rb

@@ -0,0 +1,174 @@
+require 'spec_helper'
+
+describe Bumeran do
+  it 'is a sanity test' do
+  end
+
+  it 'has a valid model' do
+    Bumeran.has_valid_access_token?.should be_true
+  end
+
+  it 'can create publication', create: true do
+    publication = BumeranFixture.publication
+    result = Bumeran.create_aviso(publication.body.to_json)
+    pp result
+    result.to_i.should > 0
+  end
+
+  it 'can publish publication', create: true do
+    publication = BumeranFixture.publication
+    published_publication_id = Bumeran.publish(publication.body.to_json, 1, 30) # pais Argentina = 1, plan publicacion "simple" = 30 
+    pp published_publication_id
+    published_publication_id.to_i.should > 0
+  end
+
+  it 'can create, get, publish and destroy publication', publish: true do
+    publication = BumeranFixture.publication
+    publication_id = Bumeran.create_aviso(publication.body.to_json)
+    pp publication_id
+    publication_id.should > 0
+
+    publication = Bumeran.get_publication(publication_id)
+    pp publication
+    publication["id"].should > 0
+
+    published_publication = Bumeran.publicar_aviso(publication_id, 1, 30) # pais Argentina = 1, plan publicacion "simple" = 30 
+    pp published_publication
+
+    deleted_publication = Bumeran.destroy_aviso(publication_id)
+    pp deleted_publication
+  end
+
+  it 'can get areas', getters: true do
+    pp Bumeran.areas
+    Bumeran.areas.count.should > 0
+  end
+
+  it 'can get subareas', getters: true do
+    pp Bumeran.subareas
+    Bumeran.subareas.count.should > 0
+  end
+
+  it 'can get frecuencias_pago', getters: true do
+    pp Bumeran.frecuencias_pago
+    Bumeran.frecuencias_pago.count.should > 0
+  end
+
+  it 'can get paises' do
+    pp Bumeran.paises
+    Bumeran.paises.count.should > 0
+  end
+
+  # localidades gives error! (API problem)
+  it 'can get paises, zonas, localidades, and plan plublicaciones' do
+    pp Bumeran.paises
+    Bumeran.paises.count.should > 0
+    Bumeran.zonas.count.should > 0
+    #Bumeran.localidades.count.should > 0
+    Bumeran.plan_publicaciones.count.should > 0
+  end
+
+  it 'can get denominaciones', getters: true do
+    pp Bumeran.denominaciones
+    Bumeran.denominaciones.count.should > 0
+  end
+
+  it 'can get direcciones', getters: true do
+    pp Bumeran.direcciones
+    Bumeran.direcciones.count.should > 0
+  end
+
+  it 'can get frecuencias_pago', getters: true do
+    pp Bumeran.frecuencias_pago
+    Bumeran.frecuencias_pago.count.should > 0
+  end
+
+
+  it 'can get idiomas', getters: true do
+    pp Bumeran.idiomas
+    Bumeran.idiomas.count.should > 0
+  end
+
+  it 'can get industrias', getters: true do
+    pp Bumeran.industrias
+    Bumeran.industrias.count.should > 0
+  end
+
+  it 'can get niveles_idiomas', getters: true do
+    pp Bumeran.niveles_idiomas
+    Bumeran.niveles_idiomas.count.should > 0
+  end
+
+  it 'can get tipos_trabajo', getters: true do
+    pp Bumeran.tipos_trabajo
+    Bumeran.tipos_trabajo.count.should > 0
+  end
+
+  it 'can get areas_estudio', getters: true do
+    pp Bumeran.areas_estudio
+    Bumeran.areas_estudio.count.should > 0
+  end
+
+  it 'can get estados_estudio', getters: true do
+    pp Bumeran.estados_estudio
+    Bumeran.estados_estudio.count.should > 0
+  end
+
+  it 'can get tipos_estudio', getters: true do
+    pp Bumeran.tipos_estudio
+    Bumeran.tipos_estudio.count.should > 0
+  end
+
+  it 'can get tipos_estudio', getters: true do
+    pp Bumeran.tipos_estudio
+    Bumeran.tipos_estudio.count.should > 0
+  end
+
+  it 'can get estudio', getters: true do
+    params = {}
+    params['curriculum_id']=1000
+    estudio = Bumeran.get_estudio(1285190, params)
+    pp estudio
+    estudio["titulo"].class.should be String
+  end
+
+  it 'can get conocimiento', getters: true do
+    #conocimiento = Bumeran.get_conocimiento(140)
+    #pp conocimiento
+    #conocimiento["nombre"].class.should be String
+    params = {}
+    params['curriculum_id']=1000
+    conocimiento = Bumeran.get_conocimiento(140, params)
+    pp conocimiento
+    conocimiento["nombre"].class.should be String
+  end
+
+  it 'can get conocimiento_custom', getters: true do
+    params = {}
+    params['curriculum_id']=1000
+    conocimiento_custom = Bumeran.get_conocimiento_custom(623710, params)
+    pp conocimiento_custom
+    conocimiento_custom["nombre"].class.should be String
+  end
+
+  it 'can get experiencia_laboral', getters: true do
+    params = {}
+    params['curriculum_id']=1000
+    experiencia_laboral = Bumeran.get_experiencia_laboral(1651500, params)
+    pp experiencia_laboral
+    experiencia_laboral["puesto"].class.should be String
+  end
+
+  it 'can get postulacion', getters: true do
+    postulacion = Bumeran.get_postulacion(1000)
+    pp postulacion
+    postulacion["estado"].class.should be String
+  end
+
+  it 'can get curriculum', getters: true do
+    curriculum = Bumeran.get_curriculum(1000)
+    pp curriculum
+    curriculum["nombre"].class.should be String
+  end
+
+end

data/spec/spec_helper.rb

@@ -0,0 +1,29 @@
+# This file was generated by the `rspec --init` command. Conventionally, all
+# specs live under a `spec` directory, which RSpec adds to the `$LOAD_PATH`.
+# Require this file using `require "spec_helper"` to ensure that it is only
+# loaded once.
+
+#
+# See http://rubydoc.info/gems/rspec-core/RSpec/Core/Configuration
+RSpec.configure do |config|
+  config.treat_symbols_as_metadata_keys_with_true_values = true
+  config.run_all_when_everything_filtered = true
+  config.filter_run focus: true
+
+  Dir["./spec/fixtures/*.rb"].sort.each { |f| require f }
+
+  # Run specs in random order to surface order dependencies. If you find an
+  # order dependency and want to debug it, you can fix the order by providing
+  # the seed, which is printed after each run.
+  #     --seed 1234
+  config.order = 'random'
+end
+
+require 'firstjob'
+require 'firstjob/publication'
+begin
+  require 'firstjob_initializer_helper'
+rescue Exception => e
+  raise "firstjob_initializer_helper does't exist, follow the instructions in the README"
+end
+require 'pry-byebug'