bamboozled-gitlab 0.2.9

data/.travis.yml

@@ -0,0 +1,18 @@
+language: ruby
+sudo: false
+rvm:
+  - 2.2
+  - 2.3.0
+  - 2.4.0
+  - ruby-head
+  - jruby-head
+
+script:
+  - bundle exec rspec
+  - bundle exec rubocop
+
+matrix:
+  fast_finish: true
+  allow_failures:
+    - rvm: ruby-head
+    - rvm: jruby-head

data/CHANGELOG.md

@@ -0,0 +1,48 @@
+# Changelog
+
+## develop (unreleased)
+
+### New Features
+
+### Changes
+
+### Bug Fixes
+
+## 0.2.0 (2019-03-01)
+
+### New Features
+
+* New method `Report#custom` allows fetching a custom report of employees. ([@artfuldodger][])
+* Make httpparty options configurable ([@ivanovv][])
+* Add time tracking api interface ([@nlively][])
+
+### Changes
+
+* Using github actions for linting and testing
+
+### Bug Fixes
+
+* Fix Metadata API calls. Fixes [Issue #38](https://github.com/Skookum/bamboozled/issues/36) and [Issue #5](https://github.com/Skookum/bamboozled/issues/5)
+
+## 0.1.0 (2016-06-14)
+
+### New Features
+
+* New method `Employee#add` allows client to create new employees. ([@kylefdoherty][])
+* New method `Employee#update` allows client to update new employees. ([@kylefdoherty][])
+
+### Changes
+
+### Bug Fixes
+
+* Added missing documentation for `Employee#add`. ([@mjording][])
+
+[@markrickert]: https://github.com/markrickert
+[@enriikke]: https://github.com/Enriikke
+[@kylefdoherty]: https://github.com/kylefdoherty
+[@mjording]: https://github.com/mjording
+[@artfuldodger]: https://github.com/artfuldodger
+[@splybon]: https://github.com/splybon
+[@chrisman]: https://github.com/chrisman
+[@ivanovv]: https://github.com/ivanovv
+[@nlively]: https://github.com/nlively

data/CONTRIBUTING.md

@@ -0,0 +1,91 @@
+# Contributing
+
+Contributions are always welcome! If you discover issues or have ideas for
+improvements, report them or submit pull requests. Please follow the guidelines
+below when doing so.
+
+## Issue Reporting
+
+* Make sure the issue has not already been reported.
+* Check that the issue has not already been fixed in `develop`.
+* Open a [new issue](https://github.com/Skookum/bamboozled/issues/new) with a
+  clear and concise description of the problem.
+* Include any relevant code or error output in the issue summary.
+
+## Pull Request
+
+* Fork the project.
+* Create a new branch for your feature/bug **off of develop**.
+* Get coding!
+* Write good tests. See [Testing](#testing).
+* Follow the same coding conventions as the rest of the project. See [Coding Style](#coding-style).
+* Squash related commits when needed and write good commit messages.
+* Add an entry to the [Changelog](CHANGELOG.md) accordingly. See [Changelog Entries](#changelog-entries).
+* Make sure the test suite is passing and that there are no style violations
+  before pushing your code.
+* Pull requests should be related to a single subject.
+* Open a pull request until you are happy with your contribution.
+
+### Testing
+
+Always include tests with you code. Bamboozled uses [RSpec](https://github.com/rspec/rspec)
+for testing. We like to follow the recommendations listed in [Better Specs](http://betterspecs.org/).
+
+```sh
+# Run the entire test suite.
+bundle exec rspec
+
+# Run specific test files.
+bundle exec rspec spec/lib/bamboozled/lib/employee_spec.rb
+```
+
+Alternatively, the `Gemfile` includes [Guard](https://github.com/guard/guard), a
+file watcher that will automatically run `rspec` when a file is saved. This is
+not a requirement but we encourage running `bundle exec guard` before starting
+development so that you are able to catch failed tests as you code away :-).
+
+### Coding Style
+
+Bamboozled leverages [Hound](https://houndci.com/) to maintain the code style
+consistent. Hound uses [rubocop](https://github.com/bbatsov/rubocop), which you
+can run locally:
+
+```sh
+# Run for the entire codebase.
+bundle exec rubocop
+
+# Run for a specific file.
+bundle exec rubocop lib/bamboozled.rb
+```
+
+Just like with tests, `guard` will automatically run `rubocop` when a file is
+saved (unless a test fails). Once again, we would like to encourage running
+`bundle exec guard` before starting development.
+
+Hound will comment on pull requests with style violations, and pull requests
+won't be merged until violations are corrected.
+
+### Changelog Entries
+
+* Use [Markdown syntax](http://daringfireball.net/projects/markdown/syntax).
+* The entry line should start with a bullet point `*`.
+* If the change has a related GitHub issue, include a link to it as
+  `[#1](https://github.com/Skookum/bamboozled/issues/1):`.
+* Provide a brief summary of the change.
+* At the end of the entry, add an implicit link to your GitHub user page as `([@username][])`.
+* If this is your first contribution, add a link definition for the implicit
+  link to the bottom of the changelog as `[@username]:
+  https://github.com/username`.
+
+Here are a few examples:
+
+```
+* [#3](https://github.com/Skookum/bamboozled/issues/3): Added `HashWithIndifferentAccess` to to fix inconsistencies when accessing data. ([@markrickert][])
+* New method `Employee#add` allows client to create new employees. ([@kylefdoherty][])
+```
+
+---
+
+<p align="center">
+  <img src="logos/skookum_mark_black.png" alt="Skookum" width="100" />
+</p>

data/Dockerfile

@@ -0,0 +1,8 @@
+FROM ruby:2.5
+
+ENV APP_HOME /app
+RUN apt-get update -qq && apt-get install -y build-essential
+RUN mkdir $APP_HOME
+WORKDIR $APP_HOME
+ADD . $APP_HOME/
+RUN bundle install

data/Gemfile

@@ -0,0 +1,16 @@
+source "http://rubygems.org"
+gemspec
+
+group :test do
+  gem "coveralls", require: false
+end
+
+group :development, :test do
+  gem "listen", "3.0.7"
+  gem "guard"
+  gem "guard-rspec", require: false
+  gem "guard-rubocop", require: false
+  gem "rubocop", "~> 0.63.1", require: false
+  gem "rubocop-rspec", require: false
+
+end

data/Guardfile

@@ -0,0 +1,21 @@
+group :tdd, halt_on_fail: true do
+  guard :rspec, cmd: "bundle exec rspec" do
+    require "guard/rspec/dsl"
+    dsl = Guard::RSpec::Dsl.new(self)
+
+    # RSpec files
+    rspec = dsl.rspec
+    watch(rspec.spec_helper) { rspec.spec_dir }
+    watch(rspec.spec_support) { rspec.spec_dir }
+    watch(rspec.spec_files)
+
+    # Ruby files
+    ruby = dsl.ruby
+    dsl.watch_spec_files_for(ruby.lib_files)
+  end
+
+  guard :rubocop, all_on_start: false, cmd: "rubocop --require rubocop-rspec" do
+    watch(%r{.+\.rb$}) { |m| m[0] }
+    watch(%r{(?:.+/)?\.rubocop\.yml$}) { |m| File.dirname(m[0]) }
+  end
+end

data/LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2014 Mark Rickert & Skookum Digital Works
+
+MIT License
+
+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,170 @@
+[![Gem Version](https://img.shields.io/gem/v/bamboozled.svg)][rubygems]
+[![Build Status](https://img.shields.io/travis/Skookum/bamboozled.svg)][travis]
+[![Code Climate](https://img.shields.io/codeclimate/github/Skookum/bamboozled.svg)][codeclimate]
+[![Coverage Status](https://img.shields.io/coveralls/Skookum/bamboozled.svg)][coveralls]
+[![Inline Docs](http://inch-ci.org/github/Skookum/bamboozled.svg?style=shields)][inchdocs]
+
+[rubygems]: https://rubygems.org/gems/bamboozled
+[travis]: https://travis-ci.org/Skookum/bamboozled
+[codeclimate]: https://codeclimate.com/github/Skookum/bamboozled
+[coveralls]: https://coveralls.io/r/Skookum/bamboozled
+[inchdocs]: http://inch-ci.org/github/Skookum/bamboozled
+
+---
+
+<p align="center">
+  <img src="logos/bamboozled_logo_black.png" alt="Bamboozled" />
+</p>
+
+Bamboozled is a Ruby wrapper for the [BambooHR API](http://www.bamboohr.com/api/documentation/).
+
+## Versioning
+
+Bamboozled follows [Semantic Versioning 2.0.0](http://semver.org/). Make sure to
+always bound the major version when installing if you want to avoid breaking
+changes.
+
+## Documentation
+
+This documentation tracks the latest changes in the `master` branch of this
+repo. Some of the features described might not be available in older versions of
+the gem (including the current stable version). Please consult the relevant git
+tag (e.g. v0.0.7) if you need documentation for a specific Bamboozled version.
+
+## Installation
+
+Bamboozled's installation follows the standard gem installation process:
+
+```sh
+$ gem install bamboozled
+```
+
+If you prefer to install Bamboozled through `bundler` then add it to your
+`Gemfile`:
+
+```ruby
+gem "bamboozled"
+```
+
+## Usage
+
+Create a `client` and provide it with your BambooHR subdomain and an API key:
+
+```ruby
+# Create the client:
+client = Bamboozled.client(subdomain: "your_subdomain", api_key: "your_api_key")
+```
+
+> TIP! Create an API key by logging into your BambooHR account, then click your
+> image in the upper right corner and select "API Keys".
+
+### Employee related data:
+
+You can pass an array of fields to `all` or `:all` to get all fields your user
+is allowed to access. Because BambooHR's API doesn't allow for specifying fields
+on the `/employees/directory` API endpoint, passing a list of fields to retrieve
+will be signifigantly slower than getting just the default fields since the gem
+will get the directory of employees, then request the data for each individual
+employee resulting in `employees.count + 1` API calls. To get around this,
+consider using a custom report.
+
+```ruby
+# Returns an array of all employees
+client.employee.all # Gets all employees with default fields
+client.employee.all(:all) # Gets all fields for all employees
+client.employee.all(["hireDate", "displayName"])
+client.employee.all("hireDate,displayName")
+
+# Get the employee records which have changed since a given date
+client.employee.last_changed("2015-01-01T00:00:00-08:00", :updated)
+client.employee.last_changed("2015-01-01T00:00:00-08:00", :inserted)
+client.employee.last_changed("2015-01-01T00:00:00-08:00", :deleted)
+client.employee.last_changed("2015-01-01T00:00:00-08:00") # Return all changes
+
+# Returns a hash of a single employee
+client.employee.find(employee_id, fields = nil)
+
+# Adds an employee
+client.employee.add(employee_details_hash)
+
+# Tabular employee data
+client.employee.job_info(employee_id)
+client.employee.employment_status(employee_id)
+client.employee.compensation(employee_id)
+client.employee.dependents(employee_id)
+client.employee.contacts(employee_id)
+
+# Time off estimate for employee. Requires end date in Date or Time format or YY-MM-DD string.
+client.employee.time_off_estimate(employee_id, end_date)
+
+# Photos for an employee
+client.employee.photo_url(employee_work_email)
+client.employee.photo_url(employee_id)
+client.employee.photo_binary(employee_id)
+```
+
+### Time off data
+
+```ruby
+# Get time off requests filtered by a number of parameters
+# :id - the ID of the time off request
+# :action -
+# :employeeId - the ID of the employee you're looking for
+# :start - filter start date
+# :end - filter end date
+# :type - type of time off request
+# :status - must be one or more of the following: approved denied superceded requested canceled
+client.time_off.requests(:employeeId: employee_id, start: Time.now)
+
+# See who is out when.
+client.time_off.whos_out(Time.now, "2014-12-31")
+```
+
+### Reports
+
+```ruby
+# Get a list of employees with specified fields
+# Send `:all` for `fields` to get all fields.
+# Note that this can get a list of employees with additional fields via a single
+# API request instead of one per employee when using the `employees` endpoint.
+client.report.custom(fields, format = "JSON")
+```
+
+
+```ruby
+# Find a report by its number
+client.report.find(report_number, format = "JSON", fd = true)
+```
+
+### Metadata
+
+```ruby
+# Get fields
+client.meta.fields
+# Get lists
+client.meta.lists
+# Get tables
+client.meta.tables
+# Get users
+# Note: this is all uses in the system, whereas client.employee.all only gets active employees
+client.meta.users
+```
+
+## Contributing
+
+Thank you for contributing! We always welcome bug reports and/or pull requests.
+Please take the time to go through our [contribution guidelines](CONTRIBUTING.md).
+
+Special thanks to all the awesome people who have helped make this gem better.
+You can see a list of them [here](https://github.com/Skookum/bamboozled/graphs/contributors).
+
+## License
+
+This project is licensed under the terms of the MIT license. See the
+[LICENSE](/LICENSE) file.
+
+---
+
+<p align="center">
+  <img src="logos/skookum_mark_black.png" alt="Skookum" width="100" />
+</p>

data/Rakefile

@@ -0,0 +1,11 @@
+require "bundler/gem_tasks"
+
+require "rspec/core/rake_task"
+RSpec::Core::RakeTask.new(:spec)
+
+desc "Open an irb session preloaded with this library"
+task :console do
+  sh "irb -rubygems -I lib -r bamboozled.rb"
+end
+
+task default: :spec

data/bamboozled.gemspec

@@ -0,0 +1,30 @@
+# coding: utf-8
+lib = File.expand_path("lib", __dir__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require "bamboozled/version"
+
+Gem::Specification.new do |spec|
+  spec.name          = "bamboozled-gitlab"
+  spec.version       = Bamboozled::VERSION
+  spec.authors       = ["Mark Rickert"]
+  spec.email         = ["mjar81@gmail.com"]
+  spec.summary       = "A Ruby wrapper for the BambooHR API http://www.bamboohr.com/"
+  spec.description   = "Bamboozled wraps the BambooHR API without the use of Rails dependencies."
+  spec.homepage      = "http://github.com/Skookum/bamboozled"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0")
+  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"
+
+  spec.add_development_dependency "bundler", ">= 1.10"
+  spec.add_development_dependency "rake", "~> 10.4"
+  spec.add_development_dependency "rspec", "~> 3.1"
+  spec.add_development_dependency "webmock", "~> 1.20"
+
+  spec.add_dependency "httparty", "~> 0.13"
+  spec.add_dependency "json", "~> 2.3.0"
+end