timely-app

Ruby client for the Timely API.

Sponsored by Kisko Labs.

Install

Using Bundler:

bundle add timely-app

Using RubyGems:

gem install timely-app

Usage for CLI

Register your local service at https://app.timelyapp.com/{account_id}/oauth_applications

Install timely-app gem as dependency or globally.

Run auth:

TIMELY_CLIENT_ID=<client_id> TIMELY_CLIENT_SECRET=<client_secret> bundle exec timely-app auth -s

Usage for web service

Example web server: ./examples/auth_server.rb

Implement link to Timely OAuth authorization page:

<%= link_to "Sign in with Timely", TimelyApp::Client.new.get_oauth_authorize_url(client_id: ENV.fetch("TIMELY_CLIENT_ID"), redirect_uri: ENV.fetch("TIMELY_REDIRECT_URI")) %>

Implement callback action to get access token (devise example):

def timely_auth_callback
  skip_verify_authorized!

  client = TimelyApp::Client.new
  token = client.post_oauth_token(client_id: ENV.fetch("TIMELY_CLIENT_ID"), client_secret: ENV.fetch("TIMELY_CLIENT_SECRET"), code: params["code"], redirect_uri: ENV.fetch("TIMELY_REDIRECT_URI"), grant_type: "authorization_code")

  if token["access_token"].present?
    client.access_token = token["access_token"]
    timely_user = client.get_current_user

    user = User.find_or_create_by(email: timely_user["email"])
    user.update!(timely_id: timely_user["id"], timely_access_token: token["access_token"], timely_refresh_token: token["refresh_token"])

    sign_in(user)

    redirect_to "/authorized"
  else
    redirect_to "/not-authorized"
  end
rescue TimelyApp::Error => _e
  redirect_to "/not-authorized"
end

Client usage

timely = TimelyApp::Client.new(access_token: <USER_TOKEN_AFTER_OAUTH>, account_id: <ACCOUNT_ID>)

timely.get_projects.each do |project|
  puts project.name
end

How to test callbacks

You can use localhost.run to test callbacks locally.

There are large list of available tools for tunneling: awesome-tunneling

Acknowledgment

• thanks to timcraft and the team for Noko API client that was used as starting point

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/amkisko/timely-app

Publishing

rm timely-app-*.gem
gem build timely-app.gemspec
gem push timely-app-*.gem

License

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