hawatel_search_jobs 0.1.3 → 0.2.0

data/.travis.yml

@@ -1,7 +1,7 @@
-language: ruby
-rvm:
-  - 2.0.0
-  - 2.1.0
-  - 2.2.1
-  - 2.2.4
+language: ruby
+rvm:
+  - 2.0.0
+  - 2.1.0
+  - 2.2.1
+  - 2.2.4
 before_install: gem install bundler -v 1.10.6

data/CODE_OF_CONDUCT.md

@@ -1,13 +1,13 @@
-# Contributor Code of Conduct
-
-As contributors and maintainers of this project, we pledge to respect all people who contribute through reporting issues, posting feature requests, updating documentation, submitting pull requests or patches, and other activities.
-
-We are committed to making participation in this project a harassment-free experience for everyone, regardless of level of experience, gender, gender identity and expression, sexual orientation, disability, personal appearance, body size, race, ethnicity, age, or religion.
-
-Examples of unacceptable behavior by participants include the use of sexual language or imagery, derogatory comments or personal attacks, trolling, public or private harassment, insults, or other unprofessional conduct.
-
-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. Project maintainers who do not follow the Code of Conduct may be removed from the project team.
-
-Instances of abusive, harassing, or otherwise unacceptable behavior may be reported by opening an issue or contacting one or more of the project maintainers.
-
-This Code of Conduct is adapted from the [Contributor Covenant](http://contributor-covenant.org), version 1.0.0, available at [http://contributor-covenant.org/version/1/0/0/](http://contributor-covenant.org/version/1/0/0/)
+# Contributor Code of Conduct
+
+As contributors and maintainers of this project, we pledge to respect all people who contribute through reporting issues, posting feature requests, updating documentation, submitting pull requests or patches, and other activities.
+
+We are committed to making participation in this project a harassment-free experience for everyone, regardless of level of experience, gender, gender identity and expression, sexual orientation, disability, personal appearance, body size, race, ethnicity, age, or religion.
+
+Examples of unacceptable behavior by participants include the use of sexual language or imagery, derogatory comments or personal attacks, trolling, public or private harassment, insults, or other unprofessional conduct.
+
+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. Project maintainers who do not follow the Code of Conduct may be removed from the project team.
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be reported by opening an issue or contacting one or more of the project maintainers.
+
+This Code of Conduct is adapted from the [Contributor Covenant](http://contributor-covenant.org), version 1.0.0, available at [http://contributor-covenant.org/version/1/0/0/](http://contributor-covenant.org/version/1/0/0/)

data/CONTRIBUTING.md

@@ -1,70 +1,70 @@
-# Contributing
-
-Bug reports and pull requests are welcome on GitHub at https://github.com/Hawatel/hawatel_search_jobs. This project is intended to be a safe, welcoming space for collaboration, and contributors.
-
-1. [Fork](https://help.github.com/articles/fork-a-repo/) the project, clone your fork,
-   and configure the remotes:
-
-   ```sh
-   # Clone your fork of the repo into the current directory
-   git clone https://github.com/<your-username>/hawatel_search_jobs
-   # Navigate to the newly cloned directory
-   cd hawatel_search_jobs
-   # Assign the original repo to a remote called "upstream"
-   git remote add upstream https://github.com/Hawatel/hawatel_search_jobs
-   ```
-
-2. If you cloned a while ago, get the latest changes from upstream:
-
-   ```bash
-   git checkout master
-   git pull upstream master
-   ```
-
-3. Create a new topic branch (off of `master`) to contain your feature, change,
-   or fix.
-
-   **IMPORTANT**: Making changes in `master` is discouraged. You should always
-   keep your local `master` in sync with upstream `master` and make your
-   changes in topic branches.
-
-   ```sh
-   git checkout -b <topic-branch-name>
-   ```
-
-4. Commit your changes in logical chunks. Keep your commit messages organized,
-   with a short description in the first line and more detailed information on
-   the following lines. Feel free to use Git's
-   [interactive rebase](https://help.github.com/articles/about-git-rebase/)
-   feature to tidy up your commits before making them public.
-
-5. Make sure all the tests are still passing.
-
-   ```sh
-   rake
-   ```
-
-6. Push your topic branch up to your fork:
-
-   ```sh
-   git push origin <topic-branch-name>
-   ```
-
-7. [Open a Pull Request](https://help.github.com/articles/using-pull-requests/)
-    with a clear title and description.
-
-8. If you haven't updated your pull request for a while, you should consider
-   rebasing on master and resolving any conflicts.
-
-   **IMPORTANT**: _Never ever_ merge upstream `master` into your branches. You
-   should always `git rebase` on `master` to bring your changes up to date when
-   necessary.
-
-   ```sh
-   git checkout master
-   git pull upstream master
-   git checkout <your-topic-branch>
-   git rebase master
-   ```
-
+# Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/Hawatel/hawatel_search_jobs. This project is intended to be a safe, welcoming space for collaboration, and contributors.
+
+1. [Fork](https://help.github.com/articles/fork-a-repo/) the project, clone your fork,
+   and configure the remotes:
+
+   ```sh
+   # Clone your fork of the repo into the current directory
+   git clone https://github.com/<your-username>/hawatel_search_jobs
+   # Navigate to the newly cloned directory
+   cd hawatel_search_jobs
+   # Assign the original repo to a remote called "upstream"
+   git remote add upstream https://github.com/Hawatel/hawatel_search_jobs
+   ```
+
+2. If you cloned a while ago, get the latest changes from upstream:
+
+   ```bash
+   git checkout master
+   git pull upstream master
+   ```
+
+3. Create a new topic branch (off of `master`) to contain your feature, change,
+   or fix.
+
+   **IMPORTANT**: Making changes in `master` is discouraged. You should always
+   keep your local `master` in sync with upstream `master` and make your
+   changes in topic branches.
+
+   ```sh
+   git checkout -b <topic-branch-name>
+   ```
+
+4. Commit your changes in logical chunks. Keep your commit messages organized,
+   with a short description in the first line and more detailed information on
+   the following lines. Feel free to use Git's
+   [interactive rebase](https://help.github.com/articles/about-git-rebase/)
+   feature to tidy up your commits before making them public.
+
+5. Make sure all the tests are still passing.
+
+   ```sh
+   rake
+   ```
+
+6. Push your topic branch up to your fork:
+
+   ```sh
+   git push origin <topic-branch-name>
+   ```
+
+7. [Open a Pull Request](https://help.github.com/articles/using-pull-requests/)
+    with a clear title and description.
+
+8. If you haven't updated your pull request for a while, you should consider
+   rebasing on master and resolving any conflicts.
+
+   **IMPORTANT**: _Never ever_ merge upstream `master` into your branches. You
+   should always `git rebase` on `master` to bring your changes up to date when
+   necessary.
+
+   ```sh
+   git checkout master
+   git pull upstream master
+   git checkout <your-topic-branch>
+   git rebase master
+   ```
+
 Thank you for your contributions!

data/Gemfile

@@ -1,4 +1,4 @@
-source 'https://rubygems.org'
-
-# Specify your gem's dependencies in hawatel_search_jobs.gemspec
-gemspec
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in hawatel_search_jobs.gemspec
+gemspec

data/LICENSE.txt

@@ -1,21 +1,21 @@
-The MIT License (MIT)
-
-Copyright (c) 2016 Daniel Iwaniuk
-
-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.
+The MIT License (MIT)
+
+Copyright (c) 2016 Daniel Iwaniuk
+
+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

@@ -35,25 +35,30 @@ HawatelSearchJobs.configure do |config|
   config.indeed[:api]       = 'api.indeed.com'
   config.indeed[:version]   = '2'
   config.indeed[:publisher] = 'secret-key'
+  config.indeed[:page_size] = 25 # allowed range <1,25>
 
   config.xing[:activated]           = true
   config.xing[:consumer_key]        = 'secret-key'
   config.xing[:consumer_secret]     = 'secret-key'
   config.xing[:oauth_token]         = 'secret-key'
   config.xing[:oauth_token_secret]  = 'secret-key'
+  config.xing[:page_size]           = 25 # allowed range <1,100>
 
   config.reed[:activated] = true
   config.reed[:api]       = 'reed.co.uk/api'
   config.reed[:clientid]  = 'secret-key'
   config.reed[:version]   = '1.0'
+  config.reed[:page_size] = 25 # allowed range <1,100>
 
   config.careerbuilder[:activated]  = true
   config.careerbuilder[:api]        = 'api.careerbuilder.com'
   config.careerbuilder[:clientid]   = 'secret-key'
   config.careerbuilder[:version]    = 'v2'
+  config.careerbuilder[:page_size]  = 25 # allowed range <1,100>
 
   config.careerjet[:activated]   = true
   config.careerjet[:api]         = 'public.api.careerjet.net'
+  config.careerjet[:page_size]   = 25 # allowed range <1,99>
 end
 ```
 
@@ -86,7 +91,8 @@ Instance variable *jobs_table* always has last returned job offers.
   p client.jobs_table
 ```
 
-Each API has a limit of returned records. For consistency, each API returns maximum `25` records.
+Each API has a default limit of returned records. For consistency, each API returns maximum `25` records.
+You can change this behavior by setting page_size option in block of HawatelSearchJobs.configure method.
 
 #### Get next page of job offers
 ```ruby
@@ -99,9 +105,9 @@ Each API has a limit of returned records. For consistency, each API returns maxi
 ```ruby
   client = HawatelSearchJobs::Client.new
   client.search_jobs({:keywords => 'ruby'})
-  
+
   job_offers = Array.new
-  
+
   begin
     job_offers << client.jobs_table
   end while(client.next)
@@ -124,15 +130,15 @@ Below is an example for indeed but each API has the same result structure.
   client = HawatelSearchJobs::Client.new
   client.search_jobs({:keywords => 'ruby'})
   result = client.jobs_table
-  
+
   result[:indeed][:code]            # HTTP status code (see https://en.wikipedia.org/wiki/List_of_HTTP_status_codes)
   result[:indeed][:message]         # HTTP message (seee https://en.wikipedia.org/wiki/List_of_HTTP_status_codes)
-  
+
   result[:indeed][:totalResults]    # Total results of job offers which matches to your search criteria on API provider
   result[:indeed][:page]            # Current results page number counted from index 0
   result[:indeed][:last]            # Last results page number
   result[:indeed][:key]             # Internal key which usuely keep last URL sent to API or last used keywords
-  
+
   result[:indeed][:jobs]            # OpenStruct array which store returned job offers from API provider
   result[:indeed][:jobs].jobtitle   # Job title
   result[:indeed][:jobs].location   # Job location
@@ -149,4 +155,3 @@ See [CONTRIBUTING](CONTRIBUTING.md)
 ## License
 
 The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).
-

data/Rakefile

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

data/hawatel_search_jobs.gemspec

@@ -1,32 +1,32 @@
-# coding: utf-8
-lib = File.expand_path('../lib', __FILE__)
-$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
-require 'hawatel_search_jobs/version'
-
-Gem::Specification.new do |spec|
-  spec.name          = "hawatel_search_jobs"
-  spec.version       = HawatelSearchJobs::VERSION
-  spec.authors       = ['Przemyslaw Mantaj','Daniel Iwaniuk']
-  spec.email         = ['przemyslaw.mantaj@hawatel.com', 'daniel.iwaniuk@hawatel.com']
-
-  spec.summary       = %q{Hawatel_search_jobs, it is gem which provides ease access to API from popular job websites to get current job offers.}
-  spec.description   = %q{Hawatel_search_jobs, it is gem which provides ease access to API from popular job websites
-                         to get current job offers.  At this moment, supported backends are indeed.com, careerjet.com,
-                         xing.com, careerbuilder.com and reed.co.uk.}
-  spec.homepage      = "http://github.com/Hawatel/hawatel_search_jobs"
-  spec.license       = "MIT"
-
-  spec.files         = `git ls-files`.split($/)
-  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
-  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
-  spec.require_paths = ["lib"]
-
-  spec.required_ruby_version = '>= 2.0.0'
-
-  spec.add_runtime_dependency 'xing_api'
-  spec.add_runtime_dependency 'activesupport'
-
-  spec.add_development_dependency "bundler", "~> 1.10"
-  spec.add_development_dependency "rake", "~> 10.0"
-  spec.add_development_dependency "rspec"
-end
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'hawatel_search_jobs/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "hawatel_search_jobs"
+  spec.version       = HawatelSearchJobs::VERSION
+  spec.authors       = ['Przemyslaw Mantaj','Daniel Iwaniuk']
+  spec.email         = ['przemyslaw.mantaj@hawatel.com', 'daniel.iwaniuk@hawatel.com']
+
+  spec.summary       = %q{Hawatel_search_jobs, it is gem which provides ease access to API from popular job websites to get current job offers.}
+  spec.description   = %q{Hawatel_search_jobs, it is gem which provides ease access to API from popular job websites
+                         to get current job offers.  At this moment, supported backends are indeed.com, careerjet.com,
+                         xing.com, careerbuilder.com and reed.co.uk.}
+  spec.homepage      = "http://github.com/Hawatel/hawatel_search_jobs"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files`.split($/)
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.required_ruby_version = '>= 2.0.0'
+
+  spec.add_runtime_dependency 'xing_api'
+  spec.add_runtime_dependency 'activesupport'
+
+  spec.add_development_dependency "bundler", "~> 1.10"
+  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "rspec"
+end

data/lib/hawatel_search_jobs.rb

@@ -1,64 +1,64 @@
-##
-# = Hawatel Search Jobs
-# More details how to use it was described here {HawatelSearchJobs::Client}
-module HawatelSearchJobs
-  require 'hawatel_search_jobs/helpers'
-  require 'hawatel_search_jobs/api'
-  require 'hawatel_search_jobs/client'
-
-  class << self
-    attr_accessor :indeed, :xing, :reed, :careerbuilder, :careerjet
-
-    ##
-    # How to configure APIs go to example {HawatelSearchJobs::Client#search_jobs}
-    def configure
-      @indeed         = default_indeed(Hash.new)
-      @xing           = default_xing(Hash.new)
-      @reed           = default_reed(Hash.new)
-      @careerbuilder  = default_careerbuilder(Hash.new)
-      @careerjet      = default_careerjet(Hash.new)
-      yield self if block_given?
-      true
-    end
-
-    private
-
-    def default_xing(settings)
-      settings[:activated]          = false
-      settings[:consumer_key]       = ''
-      settings[:consumer_secret]    = ''
-      settings[:oauth_token]        = ''
-      settings[:oauth_token_secret] = ''
-      return settings
-    end
-
-    def default_indeed(settings)
-      settings[:activated]  = false
-      settings[:api]        = 'api.indeed.com'
-      settings[:version]    = '2'
-      settings[:publisher]  = ''
-      return settings
-    end
-
-    def default_careerjet(settings)
-      settings[:activated]  = false
-      settings[:api]        = 'public.api.careerjet.net'
-      return settings
-    end
-
-    def default_reed(settings)
-      settings[:activated]  = false
-      settings[:api]        = 'reed.co.uk/api'
-      settings[:version]    = '1.0'
-      return settings
-    end
-
-    def default_careerbuilder(settings)
-      settings[:activated]  = false
-      settings[:api]        = 'api.careerbuilder.com'
-      settings[:version]    = 'v2'
-      return settings
-    end
-  end
-
-end
+##
+# = Hawatel Search Jobs
+# More details how to use it was described here {HawatelSearchJobs::Client}
+module HawatelSearchJobs
+  require 'hawatel_search_jobs/helpers'
+  require 'hawatel_search_jobs/api'
+  require 'hawatel_search_jobs/client'
+
+  class << self
+    attr_accessor :indeed, :xing, :reed, :careerbuilder, :careerjet
+
+    ##
+    # How to configure APIs go to example {HawatelSearchJobs::Client#search_jobs}
+    def configure
+      @indeed         = default_indeed(Hash.new)
+      @xing           = default_xing(Hash.new)
+      @reed           = default_reed(Hash.new)
+      @careerbuilder  = default_careerbuilder(Hash.new)
+      @careerjet      = default_careerjet(Hash.new)
+      yield self
+      true
+    end
+
+    private
+
+    def default_xing(settings)
+      settings[:activated]          = false
+      settings[:consumer_key]       = ''
+      settings[:consumer_secret]    = ''
+      settings[:oauth_token]        = ''
+      settings[:oauth_token_secret] = ''
+      return settings
+    end
+
+    def default_indeed(settings)
+      settings[:activated]  = false
+      settings[:api]        = 'api.indeed.com'
+      settings[:version]    = '2'
+      settings[:publisher]  = ''
+      return settings
+    end
+
+    def default_careerjet(settings)
+      settings[:activated]  = false
+      settings[:api]        = 'public.api.careerjet.net'
+      return settings
+    end
+
+    def default_reed(settings)
+      settings[:activated]  = false
+      settings[:api]        = 'reed.co.uk/api'
+      settings[:version]    = '1.0'
+      return settings
+    end
+
+    def default_careerbuilder(settings)
+      settings[:activated]  = false
+      settings[:api]        = 'api.careerbuilder.com'
+      settings[:version]    = 'v2'
+      return settings
+    end
+  end
+
+end