README.md in calendlyr-0.3.3 vs README.md in calendlyr-0.3.5

- old
+ new

@@ -1,20 +1,24 @@ -[![](https://img.shields.io/github/license/araluce/calendly.rb)](https://github.com/araluce/calendly.rb/blob/master/LICENSE.txt) -![](https://github.com/araluce/calendly.rb/actions/workflows/ci.yml/badge.svg) -[![codecov](https://codecov.io/gh/araluce/calendly.rb/branch/master/graph/badge.svg?token=YSUU4PHM6Y)](https://codecov.io/gh/araluce/calendly.rb) -[![GitHub version](https://badge.fury.io/gh/araluce%2Fcalendly.rb.svg)](https://badge.fury.io/gh/araluce%2Fcalendly.rb) +[![](https://img.shields.io/github/license/araluce/calendlyr)](https://github.com/araluce/calendlyr/blob/master/LICENSE.txt) +![](https://github.com/araluce/calendlyr/actions/workflows/ci.yml/badge.svg) +[![codecov](https://codecov.io/gh/araluce/calendlyr/branch/master/graph/badge.svg?token=YSUU4PHM6Y)](https://codecov.io/gh/araluce/calendlyr) +[![Gem Version](https://badge.fury.io/rb/calendlyr.svg)](https://badge.fury.io/rb/calendlyr) -# Calendly API Rubygem +# Calendly API Rubygem LITE version Easy and complete rubygem for [Calendly](https://calendly.com/). Currently supports [API v2](https://calendly.stoplight.io/docs/api-docs). +No dependencies, just needed a Personal Access Token. + +> If you need a Oauth authentication maybe you need [calendly-api-ruby-client](https://github.com/koshilife/calendly-api-ruby-client) + ## Installation Add this line to your application's Gemfile: ```ruby -gem 'calendlyr', github: "araluce/calendly.rb" +gem 'calendlyr' ``` And then execute: $ bundle @@ -23,63 +27,63 @@ $ gem install calendlyr ## Usage -To access the API, you'll need to create a `Calendly::Client` and pass in your API key. You can generate your Personal Access Token at [https://calendly.com/integrations/api_webhooks](https://calendly.com/integrations/api_webhooks) +To access the API, you'll need to create a `Calendlyr::Client` and pass in your token. You can generate your Personal Access Token at [https://calendly.com/integrations/api_webhooks](https://calendly.com/integrations/api_webhooks) ```ruby -client = Calendly::Client.new(api_key: ENV["CALENDLY_API_KEY"]) +client = Calendlyr::Client.new(token: ENV["CALENDLY_TOKEN"]) ``` The client then gives you access to each of the resources. ## Resources The gem maps as closely as we can to the Calendly API so you can easily convert API examples to gem code. -Responses are created as objects like `Calendly::Event`. Having types like `Calendly::User` is handy for understanding what type of object you're working with. They're built using OpenStruct so you can easily access data in a Ruby-ish way. +Responses are created as objects like `Calendlyr::Event`. Having types like `Calendlyr::User` is handy for understanding what type of object you're working with. They're built using OpenStruct so you can easily access data in a Ruby-ish way. ##### Pagination `collection` endpoints return pages of results. The result object will have a `data` key to access the results, as well as pagination like `next_page` for retrieving the next pages. You may also specify the ```ruby results = client.me.events(count: 5) -#=> Calendly::Collection +#=> Calendlyr::Collection results.count #=> 5 results.data -#=> [#<Calendly::Event>, #<Calendly::Event>] +#=> [#<Calendlyr::Event>, #<Calendlyr::Event>] results.next_page_token #=> "KfKBetd7bS0wsFINjYky9mp8ZJXv76aL" # Retrieve the next page client.me.events(count: 5, next_page_token: results.next_page_token) -#=> Calendly::Collection +#=> Calendlyr::Collection ``` ### Users ```ruby client.me client.users.me client.retrieve(user_uuid: "uuid") client.organization -#=> #<Calendly::Organization> +#=> #<Calendlyr::Organization> client.me.event_types -#=> Calendly::Collection @data=[#<Calendly::EventType>, #<Calendly::EventType>] +#=> Calendlyr::Collection @data=[#<Calendlyr::EventType>, #<Calendlyr::EventType>] client.me.events -#=> Calendly::Collection @data=[#<Calendly::Event>, #<Calendly::Event>] +#=> Calendlyr::Collection @data=[#<Calendlyr::Event>, #<Calendlyr::Event>] client.me.memberships -#=> Calendly::Collection @data=[#<Calendly::MemberShip>, #<Calendly::MemberShip>] +#=> Calendlyr::Collection @data=[#<Calendlyr::MemberShip>, #<Calendlyr::MemberShip>] ``` ### Event Types ````ruby client.event_types.list user_uri: "user_uri", organization_uri: "organization_uri" @@ -144,16 +148,16 @@ client.data_compliance.delete_invitee_data ``` ## Contributing -1. Fork it ( https://github.com/araluce/calendly.rb/fork ) +1. Fork it ( https://github.com/araluce/calendlyr/fork ) 2. Create your feature branch (`git checkout -b my-new-feature`) 3. Commit your changes (`git commit -am 'Add some feature'`) 4. Push to the branch (`git push origin my-new-feature`) 5. Create a new Pull Request -When adding resources, add to the list of resources in lib/calendly.rb. Additionally, write a spec and add it to the list in the README. +When adding resources, add to the list of resources in lib/calendlyr. Additionally, write a spec and add it to the list in the README. ## Thanks Thanks [@excid3](https://github.com/excid3) and his [Vultr.rb](https://github.com/excid3/vultr.rb) rubygem project. \ No newline at end of file