rexpense-client-ruby

A Ruby client for the Rexpense REST API

Rexpense API docs: http://developers.rexpense.com

Installation

Add this line to your application's Gemfile:

gem 'rexpense'

And then execute:

$ bundle

Or install it yourself as:

$ gem install rexpense

Configuration

Use Rexpense.configure to setup your environment:

require 'rexpense'

Rexpense.configure do |config|
  config.url = 'https://app.rexpense.com' # URL of the Rexpense
  config.version = 'v1' # Current API version
  config.user_agent = 'My App v1.0' # optional, but you should pass a custom user-agent identifying your app
end

Usage

Given your token, create an instance of Rexpense::Client, as below:

client = Rexpense.client("YOUR_TOKEN_HERE")

Now you have access to these API endpoints:

Available Endpoints

• Advancement Participants ruby client.advancements.participants(:advancement_id) client.advancements.leave_participant(:advancement_id)

• Reimbursement Participants

  client.reimbursements.participants(:reimbursement_id)
  client.reimbursements.leave_participant(:reimbursement_id)
  

• Expense Participants

  client.expenses.participants(:expense_id)
  client.expenses.leave_participant(:expense_id)
  

• Comments

  client.advancements.comments(:advancement_id)
  client.advancements.find_comment(:advancement_id, :comment_id)
  client.advancements.create_comment(:advancement_id, params)
  client.advancements.update_comment(:advancement_id, :comment_id, params)
  client.advancements.destroy_comment(:advancement_id, :comment_id)
  

client.reimbursement.comments(:advancement_id) client.reimbursement.find_comment(:advancement_id, :comment_id) client.reimbursement.create_comment(:advancement_id, params) client.reimbursement.update_comment(:advancement_id, :comment_id, params) client.reimbursement.destroy_comment(:advancement_id, :comment_id)

client.expenses.comments(:advancement_id) client.expenses.find_comment(:advancement_id, :comment_id) client.expenses.create_comment(:advancement_id, params) client.expenses.update_comment(:advancement_id, :comment_id, params) client.expenses.destroy_comment(:advancement_id, :comment_id)

- [Activities](http://developers.rexpense.com/api/v1/activities/)
```ruby
  client.activitites.find_all

• Advancements

  client.advancements.find_all
  client.advancements.find(:advancement_id)
  client.advancements.create(params)
  client.advancements.update(:advancement_id, params)
  client.advancements.destroy(:advancement_id)
  

• Advancement Devolutions

  client.advancement_devolutions.create
  

• Expenses

  client.expenses.find_all
  client.expenses.find(:expense_id)
  client.expenses.create(params)
  client.expenses.update(:expense_id, params)
  client.expenses.destroy(:expense_id)
  

• Organizations

  client.organizations.find_all
  client.organizations.find(:organization_id)
  client.organizations.update(:organization_id, params)
  client.organizations.destroy(:organization_id)
  

• Memberships

  client.organizations.memberships(:organization_id)
  client.organizations.find_memberships(:organization_id, :membership_id)
  client.organizations.create_memberships(:organization_id, params)
  client.organizations.update_memberships(:organization_id, :membership_id, params)
  client.organizations.destroy_memberships(:organization_id, :membership_id)
  

• PreExpenses

  client.pre_expenses.find_all
  client.pre_expenses.find(:pre_expense_id)
  client.pre_expenses.ignore(:pre_expense_id)
  client.pre_expenses.restore(:pre_expense_id)
  client.pre_expenses.convert(:pre_expense_id, params)
  

• Tags

  client.tags.find_all(:organization_id)
  client.tags.find(:organization_id, :tag_id)
  client.tags.create(:organization_id, params)
  client.tags.update(:organization_id, :tag_id, params)
  client.tags.destroy(:organization_id, :tag_id)
  

• Webhooks

  client.webhooks.find_all(:organization_id)
  client.webhooks.find(:organization_id, :webhook_id)
  client.webhooks.create(:organization_id, params)
  client.webhooks.update(:organization_id, :webhook_id, params)
  client.webhooks.destroy(:organization_id, :webhook_id)
  

Development

After checking out the repo, run bin/setup to install dependencies. Then, run rake spec to run the tests. You can also run bin/console for an interactive prompt that will allow you to experiment.

To install this gem onto your local machine, run bundle exec rake install.

Release

To release a new version, update the version number in lib/rexpense/version.rb, run bundle install and commit & push the changes to the repository.

If this is your first time publishing a RubyGem in your local device, you will have to download your credentials. To do this, follow the instructions in your profile page in RubyGems or just type the following in your command line, replacing $username with your RubyGems username.

$ curl -u $username https://rubygems.org/api/v1/api_key.yaml > ~/.gem/credentials; chmod 0600 ~/.gem/credentials

Then run bundle exec rake release, which will create a git tag for the version, push git commits and tags, and push the .gem file to rubygems.org. Make sure you have publishing rights for the gem on RubyGems beforehand, though.

After publishing the new version, add a comment to each pull request that was included in this release like this:

:shipit: released on [version x.y.z](https://rubygems.org/gems/rexpense/versions/x.y.z)

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/myfreecomm/rexpense-client-ruby. This project is intended to be a safe and welcoming space for collaboration.

License

The gem is available as open source under the terms of the MIT License.