The City Ruby Gem
A Ruby interface to the The City API. For more information about The City platform, see http://api.onthecity.org
gem install thecity
The City API requires you to authenticate via OAuth, so you'll need to register your application with The City under the Admin | API panel.
Your new application will be assigned a key/secret pair (app_id/app_secret). You'll need to configure these values before you make a request or else you'll get the error:
Bad Authentication data
You can pass configuration options as a block to
client = TheCity::API::Client.new do |config| config.app_id = "YOUR_APP_ID" config.app_secret = "YOUR_APP_SECRET" config.access_token = "OAUTH_ACCESS_TOKEN" end
client = TheCity::API::Client.new client.app_id = "YOUR_APP_ID" client.app_secret = "YOUR_APP_SECRET" client.access_token = "OAUTH_ACCESS_TOKEN"
Alternately, you can set the following environment variables:
THECITY_APP_ID THECITY_APP_SECRET THECITY_ACCESS_TOKEN THECITY_SUBDOMAIN
All examples require an authenticated TheCity client with a valid access_token. See the section on configuration.
After configuration, requests can be made like so:
Get the authenticated user (current user)
Post a topic
client.post_topic(:group_id => 1234567, :title => 'Mr. Watson, come here', :body => 'I want to see you.')
Fetch the groups the current user belongs to
For more usage examples, please see the full documentation.
The City Builder API Developer Group
For more in depth discussiong regarding The City app platform and APIs, please join the 'API' group on Builders.
Does your church or organization use this gem? Add it to the apps wiki!
The Faraday middleware stack is fully configurable and is exposed as a
Faraday::Builder object. You can modify the default middleware in-place:
client.middleware.insert_after TheCity::Response::RaiseError, CustomMiddleware
A custom adapter may be set as part of a custom middleware stack:
client.middleware = Faraday::Builder.new( &Proc.new do |builder| # Specify a middleware stack here builder.adapter :some_other_adapter end )
Contributing to thecity gem
Submitting an Issue
We use the GitHub issue tracker to track bugs and features. Before submitting a bug report or feature request, check to make sure it hasn't already been submitted. When submitting a bug report, please include a Gist that includes a stack trace and any details that may be necessary to reproduce the bug, including your gem version, Ruby version, and operating system. Ideally, a bug report should include a pull request with failing specs.
Submitting a Pull Request
- Fork the repository.
- Create a topic branch.
- Preferably, add specs for your unimplemented feature or bug fix.
bundle exec rake spec. If your specs pass, return to step 3.
- Implement your feature or bug fix.
bundle exec rake spec. If your specs fail, return to step 5.
- Add documentation for your feature or bug fix.
bundle exec rake yard.
- Commit and push your changes.
- Submit a pull request.
Copyright (c) 2013 Robert Leib. See LICENSE for details.