ceritium-careerjetr 0.1.1

data/README.rdoc

@@ -0,0 +1,81 @@
+= Careerjetr
+
+== Description
+
+  Ruby interface to Careerjet's public search API 
+
+== Installation
+
+    sudo gem install careerjetr
+
+== Usage
+
+    require 'careerjetr'
+    
+    
+    All options have default values and are not mandatory
+  
+      keywords     : Keywords to search in job offers. Example: 'java manager'
+                     Default : none (All offers in the api country)
+  
+      location     : Location to search job offers in. Examples: 'London' , 'Yorkshire' ..
+                     Default: none ( All offers in the api country)
+  
+      sort         : Type of sort. Can be:
+                      'relevance' (default) - most relevant first 
+                      'date'                - freshest offer first 
+                      'salary'              - biggest salary first
+  
+      start_num    : Num of first offer returned in entire result space
+                     should be >= 1 and <= Number of hits
+                     Default : 1 
+  
+      pagesize     : Number of offers returned in one call
+                     Default : 20
+  
+      page         : Number of the asked page. 
+                     should be >=1
+                     The max number of page is given by $result->pages
+                     If this value is set, the eventually given start_num is overrided
+  
+      contracttype : Character code for contract type
+                      'p'    - permanent job
+                      'c'    - contract
+                      't'    - temporary
+                      'i'    - training
+                      'v'    - voluntary
+                     Default: none (all contract types)
+      
+      contractperiod : Character code for contract work period:
+                        'f'     - Full time
+                        'p'     - Part time
+                       Default: none (all work period)
+  
+  
+  Careerjetr.new(:es_ES, {:page => 3, :keywords => 'bullfighter'})
+    
+
+== License
+
+Copyright (c) 2009 José Galisteo
+
+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/Rakefile

@@ -0,0 +1,40 @@
+require 'rubygems'
+require 'rake/gempackagetask'
+require 'rake/testtask'
+
+require 'lib/careerjetr/version'
+
+task :default => :test
+
+spec = Gem::Specification.new do |s|
+  s.name             = 'careerjetr'
+  s.version          = Careerjetr::Version.to_s
+  s.has_rdoc         = true
+  s.extra_rdoc_files = %w(README.rdoc)
+  s.rdoc_options     = %w(--main README.rdoc)
+  s.summary          = "Ruby interface to Careerjet's public search API"
+  s.author           = 'José Galisteo'
+  s.email            = 'ceritium@gmail.com'
+  s.homepage         = 'http://github.com/ceritium/careerjetr/tree/master'
+  s.files            = %w(README.rdoc Rakefile) + Dir.glob("{lib,test}/**/*")
+  # s.executables    = ['careerjetr']
+  
+  # s.add_dependency('gem_name', '~> 0.0.1')
+end
+
+Rake::GemPackageTask.new(spec) do |pkg|
+  pkg.gem_spec = spec
+end
+
+Rake::TestTask.new do |t|
+  t.libs << 'test'
+  t.test_files = FileList["test/**/*_test.rb"]
+  t.verbose = true
+end
+
+desc 'Generate the gemspec to serve this Gem from Github'
+task :github do
+  file = File.dirname(__FILE__) + "/#{spec.name}.gemspec"
+  File.open(file, 'w') {|f| f << spec.to_ruby }
+  puts "Created gemspec: #{file}"
+end

data/lib/careerjetr.rb

@@ -0,0 +1,7 @@
+$:.unshift File.dirname(__FILE__)
+
+
+require 'net/http'
+require 'rubygems'
+require 'json'
+require 'careerjetr/careerjetr'

data/lib/careerjetr/careerjetr.rb

@@ -0,0 +1,117 @@
+class Careerjetr                                                                                              
+                                                                                                                         
+  LOCALES = {
+    :cs_CZ  => {:language =>'Czech'         , :location =>  'Czech Republic'      , :url => 'http://www.careerjet.cz'        },
+    :da_DK  => {:language =>'Danish'        , :location =>  'Denmark'             , :url => 'http://www.careerjet.dk'        },
+    :de_AT  => {:language =>'German'        , :location =>  'Austria'             , :url => 'http://www.careerjet.at'        },
+    :de_CH  => {:language =>'German'        , :location =>  'Switzerland'         , :url => 'http://www.careerjet.ch'        },
+    :de_DE  => {:language =>'German'        , :location =>  'Germany'             , :url => 'http://www.careerjet.de'        },
+    :en_AE  => {:language =>'English'       , :location =>  'United Arab Emirates', :url => 'http://www.careerjet.ae'        },
+    :en_AU  => {:language =>'English'       , :location =>  'Australia'           , :url => 'http://www.careerjet.com.au'    },
+    :en_CA  => {:language =>'English'       , :location =>  'Canada'              , :url => 'http://www.careerjet.ca'        },
+    :en_CN  => {:language =>'English'       , :location =>  'China'               , :url => 'http://en.careerjet.cn'         },
+    :en_HK  => {:language =>'English'       , :location =>  'Hong Kong'           , :url => 'http://www.careerjet.hk'        },
+    :en_IE  => {:language =>'English'       , :location =>  'Ireland'             , :url => 'http://www.careerjet.ie'        },
+    :en_IN  => {:language =>'English'       , :location =>  'India'               , :url => 'http://www.careerjet.co.in'     },
+    :en_MY  => {:language =>'English'       , :location =>  'Malaysia'            , :url => 'http://www.careerjet.com.my'    },
+    :en_NZ  => {:language =>'English'       , :location =>  'New Zealand'         , :url => 'http://www.careerjet.co.nz'     },
+    :en_OM  => {:language =>'English'       , :location =>  'Oman'                , :url => 'http://www.careerjet.com.om'    },
+    :en_PH  => {:language =>'English'       , :location =>  'Philippines'         , :url => 'http://www.careerjet.ph'        },
+    :en_PK  => {:language =>'English'       , :location =>  'Pakistan'            , :url => 'http://www.careerjet.com.pk'    },
+    :en_QA  => {:language =>'English'       , :location =>  'Qatar'               , :url => 'http://www.careerjet.com.qa'    },
+    :en_SG  => {:language =>'English'       , :location =>  'Singapore'           , :url => 'http://www.careerjet.sg'        },
+    :en_GB  => {:language =>'English'       , :location =>  'United Kingdom'      , :url => 'http://www.careerjet.co.uk'     },
+    :en_US  => {:language =>'English'       , :location =>  'United States'       , :url => 'http://www.careerjet.com'       },
+    :en_ZA  => {:language =>'English'       , :location =>  'South Africa'        , :url => 'http://www.careerjet.co.za'     },
+    :en_TW  => {:language =>'English'       , :location =>  'Taiwan'              , :url => 'http://www.careerjet.com.tw'    },
+    :en_VN  => {:language =>'English'       , :location =>  'Vietnam'             , :url => 'http://www.careerjet.vn'        },
+    :es_AR  => {:language =>'Spanish'       , :location =>  'Argentina'           , :url => 'http://www.opcionempleo.com.ar' },
+    :es_BO  => {:language =>'Spanish'       , :location =>  'Bolivia'             , :url => 'http://www.opcionempleo.com.bo' },
+    :es_CL  => {:language =>'Spanish'       , :location =>  'Chile'               , :url => 'http://www.opcionempleo.cl'     },
+    :es_CR  => {:language =>'Spanish'       , :location =>  'Costa Rica'          , :url => 'http://www.opcionempleo.co.cr'  },
+    :es_DO  => {:language =>'Spanish'       , :location =>  'Dominican Republic'  , :url => 'http://www.opcionempleo.com.do' },
+    :es_EC  => {:language =>'Spanish'       , :location =>  'Ecuador'             , :url => 'http://www.opcionempleo.ec'     },
+    :es_ES  => {:language =>'Spanish'       , :location =>  'Spain'               , :url => 'http://www.opcionempleo.com'    },
+    :es_GT  => {:language =>'Spanish'       , :location =>  'Guatemala'           , :url => 'http://www.opcionempleo.com.gt' },
+    :es_MX  => {:language =>'Spanish'       , :location =>  'Mexico'              , :url => 'http://www.opcionempleo.com.mx' },
+    :es_PA  => {:language =>'Spanish'       , :location =>  'Panama'              , :url => 'http://www.opcionempleo.com.pa' },
+    :es_PE  => {:language =>'Spanish'       , :location =>  'Peru'                , :url => 'http://www.opcionempleo.com.pe' },
+    :es_PR  => {:language =>'Spanish'       , :location =>  'Puerto Rico'         , :url => 'http://www.opcionempleo.com.pr' },
+    :es_PY  => {:language =>'Spanish'       , :location =>  'Paraguay'            , :url => 'http://www.opcionempleo.com.py' },
+    :es_UY  => {:language =>'Spanish'       , :location =>  'Uruguay'             , :url => 'http://www.opcionempleo.com.uy' },
+    :es_VE  => {:language =>'Spanish'       , :location =>  'Venezuela'           , :url => 'http://www.opcionempleo.com.ve' },
+    :fi_FI  => {:language =>'Finnish'       , :location =>  'Finland'             , :url => 'http://www.careerjet.fi'        },
+    :fr_CA  => {:language =>'French'        , :location =>  'Canada'              , :url => 'http://fr.careerjet.ca'         },
+    :fr_BE  => {:language =>'French'        , :location =>  'Belgium'             , :url => 'http://www.optioncarriere.be'   },
+    :fr_CH  => {:language =>'French'        , :location =>  'Switzerland'         , :url => 'http://www.optioncarriere.ch'   },
+    :fr_FR  => {:language =>'French'        , :location =>  'France'              , :url => 'http://www.optioncarriere.com'  },
+    :fr_LU  => {:language =>'French'        , :location =>  'Luxembourg'          , :url => 'http://www.optioncarriere.lu'   },
+    :fr_MA  => {:language =>'French'        , :location =>  'Morocco'             , :url => 'http://www.optioncarriere.ma'   },
+    :hu_HU  => {:language =>'Hungarian'     , :location =>  'Hungary'             , :url => 'http://www.careerjet.hu'        },
+    :it_IT  => {:language =>'Italian'       , :location =>  'Italy'               , :url => 'http://www.careerjet.it'        },
+    :ja_JP  => {:language =>'Japanese'      , :location =>  'Japan'               , :url => 'http://www.careerjet.jp'        },
+    :ko_KR  => {:language =>'Korean'        , :location =>  'Korea'               , :url => 'http://www.careerjet.co.kr'     },
+    :nl_BE  => {:language =>'Dutch'         , :location =>  'Belgium'             , :url => 'http://www.careerjet.be'        },
+    :nl_NL  => {:language =>'Dutch'         , :location =>  'Netherlands'         , :url => 'http://www.careerjet.nl'        },
+    :no_NO  => {:language =>'Norwegian'     , :location =>  'Norway'              , :url => 'http://www.careerjet.no'        },
+    :pl_PL  => {:language =>'Polish'        , :location =>  'Poland'              , :url => 'http://www.careerjet.pl'        },
+    :pt_PT  => {:language =>'Portuguese'    , :location =>  'Portugal'            , :url => 'http://www.careerjet.pt'        },
+    :pt_BR  => {:language =>'Portuguese'    , :location =>  'Brazil'              , :url => 'http://www.careerjet.com.br'    },
+    :ru_RU  => {:language =>'Russian'       , :location =>  'Russia'              , :url => 'http://www.careerjet.ru'        },
+    :ru_UA  => {:language =>'Russian'       , :location =>  'Ukraine'             , :url => 'http://www.careerjet.com.ua'    },
+    :sv_SE  => {:language =>'Swedish'       , :location =>  'Sweden'              , :url => 'http://www.careerjet.se'        },
+    :sk_SK  => {:language =>'Slovak'        , :location =>  'Slovakia'            , :url => 'http://www.careerjet.sk'        },
+    :tr_TR  => {:language =>'Turkish'       , :location =>  'Turkey'              , :url => 'http://www.careerjet.com.tr'    },
+    :uk_UA  => {:language =>'Ukrainian'     , :location =>  'Ukraine'             , :url => 'http://www.careerjet.ua'        },
+    :vi_VN  => {:language =>'Vietnamese'    , :location =>  'Vietnam'             , :url => 'http://www.careerjet.com.vn'    },
+    :zh_CN  => {:language =>'Chinese'       , :location =>  'China'               , :url=>  'http://www.careerjet.cn'        }
+    } 
+  
+  attr_reader :url, :pages, :jobs
+  
+  def initialize(locale, params = {})                                                                                    
+    @url = get_url(locale, params)
+    
+    json = parse_json
+    
+    @current_page
+    @pages = json[:pages]
+    @jobs = json[:jobs]
+    @type = json[:type]
+    @hits = json[:hits]
+  end
+  
+  # Generamos la url completa para la llamada a la api
+  def get_url(locale, params)
+    URI.escape(get_base(locale) + '?' +  url_params(params))
+  end
+  
+  # Devuelve un hash con la información disponible
+  def parse_json
+    hash = {} 
+    json = JSON::Parser.new(Net::HTTP.get(URI.parse(@url))).parse
+    hash.store(:type, json['type'])
+    hash.store(:hits, json['hits'])
+    hash.store(:pages, json['pages'])
+    hash.store(:jobs, json['jobs'])
+    
+    hash
+  end
+  
+ 
+  private
+  
+  # Obtenemos el dominio según el key del locale
+  def get_base(locale)
+    LOCALES[locale][:url] + '/devel/search.api'
+  end
+  
+  # Pasamos a url los parametros de la busqueda
+  # NOTA: ¿Es necesario pasarle el urlencode?
+  def url_params(params)
+    params.to_a.collect{|x| "#{x.first}=#{x.last}"}.join('&')  
+  end
+  
+  
+  
+end

data/lib/careerjetr/version.rb

@@ -0,0 +1,13 @@
+module Careerjetr
+  module Version
+    
+    MAJOR = 0
+    MINOR = 1
+    TINY  = 1
+    
+    def self.to_s # :nodoc:
+      [MAJOR, MINOR, TINY].join('.')
+    end
+    
+  end
+end

data/test/test_helper.rb

@@ -0,0 +1,10 @@
+# http://sneaq.net/textmate-wtf
+$:.reject! { |e| e.include? 'TextMate' }
+
+require 'rubygems'
+require 'test/unit'
+require 'matchy'
+require 'context'
+require 'mocha'
+
+require File.dirname(__FILE__) + '/../lib/careerjetr'

data/test/unit/careerjetr_test.rb

@@ -0,0 +1,13 @@
+require File.dirname(__FILE__) + '/../test_helper'
+
+class CareerjetrTest < Test::Unit::TestCase
+
+  describe "An instance of the Careerjetr class" do
+
+    it "should flunk" do
+      flunk "Please provide some tests"
+    end
+    
+  end
+
+end

metadata

@@ -0,0 +1,62 @@
+--- !ruby/object:Gem::Specification 
+name: ceritium-careerjetr
+version: !ruby/object:Gem::Version 
+  version: 0.1.1
+platform: ruby
+authors: 
+- "Jos\xC3\xA9 Galisteo"
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-07-02 00:00:00 -07:00
+default_executable: 
+dependencies: []
+
+description: 
+email: ceritium@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README.rdoc
+files: 
+- README.rdoc
+- Rakefile
+- lib/careerjetr
+- lib/careerjetr/careerjetr.rb
+- lib/careerjetr/version.rb
+- lib/careerjetr.rb
+- test/test_helper.rb
+- test/unit
+- test/unit/careerjetr_test.rb
+has_rdoc: true
+homepage: http://github.com/ceritium/careerjetr/tree/master
+post_install_message: 
+rdoc_options: 
+- --main
+- README.rdoc
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.2.0
+signing_key: 
+specification_version: 2
+summary: Ruby interface to Careerjet's public search API
+test_files: []
+