timetree 0.3.2 → 1.0.0

data/lib/timetree/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module TimeTree
-  VERSION = '0.3.2'
+  VERSION = '1.0.0'
 end

data/timetree.gemspec

@@ -30,6 +30,7 @@ Gem::Specification.new do |spec|
 
   spec.add_runtime_dependency 'faraday', '>= 1.0.1'
   spec.add_runtime_dependency 'faraday_middleware', '>= 1.0.0'
+  spec.add_runtime_dependency 'jwt', '>= 2.2.2'
 
   spec.add_development_dependency 'bundler'
   spec.add_development_dependency 'codecov'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: timetree
 version: !ruby/object:Gem::Version
-  version: 0.3.2
+  version: 1.0.0
 platform: ruby
 authors:
 - Kenji Koshikawa
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2020-11-18 00:00:00.000000000 Z
+date: 2020-11-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -38,6 +38,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: 1.0.0
+- !ruby/object:Gem::Dependency
+  name: jwt
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.2.2
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.2.2
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
@@ -143,15 +157,19 @@ files:
 - bin/setup
 - lib/timetree.rb
 - lib/timetree/api_error.rb
-- lib/timetree/client.rb
+- lib/timetree/base_client.rb
+- lib/timetree/calendar_app/access_token.rb
+- lib/timetree/calendar_app/client.rb
 - lib/timetree/configuration.rb
 - lib/timetree/http_command.rb
 - lib/timetree/models/activity.rb
+- lib/timetree/models/application.rb
 - lib/timetree/models/base_model.rb
 - lib/timetree/models/calendar.rb
 - lib/timetree/models/event.rb
 - lib/timetree/models/label.rb
 - lib/timetree/models/user.rb
+- lib/timetree/oauth_app/client.rb
 - lib/timetree/version.rb
 - timetree.gemspec
 homepage: https://github.com/koshilife/timetree-api-ruby-client
@@ -161,7 +179,7 @@ metadata:
   homepage_uri: https://github.com/koshilife/timetree-api-ruby-client
   source_code_uri: https://github.com/koshilife/timetree-api-ruby-client
   changelog_uri: https://github.com/koshilife/timetree-api-ruby-client/blob/master/CHANGELOG.md
-  documentation_uri: https://www.rubydoc.info/gems/timetree/0.3.2
+  documentation_uri: https://www.rubydoc.info/gems/timetree/1.0.0
 post_install_message: 
 rdoc_options: []
 require_paths:

data/lib/timetree/client.rb

@@ -1,298 +0,0 @@
-# frozen_string_literal: true
-
-module TimeTree
-  # TimeTree apis client.
-  class Client
-    API_HOST = 'https://timetreeapis.com'
-    # @return [String]
-    attr_reader :token
-    # @return [Integer]
-    attr_reader :ratelimit_limit
-    # @return [Integer]
-    attr_reader :ratelimit_remaining
-    # @return [Time]
-    attr_reader :ratelimit_reset_at
-
-    # @param token [String] a TimeTree's access token.
-    def initialize(token = nil)
-      @token = token || TimeTree.configuration.token
-      check_token
-      @http_cmd = HttpCommand.new(API_HOST, self)
-    end
-
-    #
-    # Get current user information.
-    #
-    # @return [TimeTree::User]
-    # @raise [TimeTree::ApiError] if the http response status will not success.
-    # @since 0.0.1
-    def current_user
-      res = @http_cmd.get '/user'
-      raise ApiError.new(res) if res.status != 200
-
-      to_model res.body[:data]
-    end
-
-    #
-    # Get a single calendar's information.
-    #
-    # @param cal_id [String] calendar's id.
-    # @param include_relationships [Array<symbol>]
-    # includes association's object in the response.
-    # @return [TimeTree::Calendar]
-    # @raise [TimeTree::Error] if the cal_id arg is empty.
-    # @raise [TimeTree::ApiError] if the http response status will not success.
-    # @since 0.0.1
-    def calendar(cal_id, include_relationships: nil)
-      check_calendar_id cal_id
-      params = relationships_params(include_relationships, Calendar::RELATIONSHIPS)
-      res = @http_cmd.get "/calendars/#{cal_id}", params
-      raise ApiError.new(res) if res.status != 200
-
-      to_model(res.body[:data], included: res.body[:included])
-    end
-
-    #
-    # Get calendar list that current user can access.
-    #
-    # @param include_relationships [Array<symbol>]
-    # includes association's object in the response.
-    # @return [Array<TimeTree::Calendar>]
-    # @raise [TimeTree::ApiError] if the http response status will not success.
-    # @since 0.0.1
-    def calendars(include_relationships: nil)
-      params = relationships_params(include_relationships, Calendar::RELATIONSHIPS)
-      res = @http_cmd.get '/calendars', params
-      raise ApiError.new(res) if res.status != 200
-
-      included = res.body[:included]
-      res.body[:data].map { |item| to_model(item, included: included) }
-    end
-
-    #
-    # Get a calendar's label information used in event.
-    #
-    # @param cal_id [String] calendar's id.
-    # @return [Array<TimeTree::Label>]
-    # @raise [TimeTree::Error] if the cal_id arg is empty.
-    # @raise [TimeTree::ApiError] if the http response status will not success.
-    # @since 0.0.1
-    def calendar_labels(cal_id)
-      check_calendar_id cal_id
-      res = @http_cmd.get "/calendars/#{cal_id}/labels"
-      raise ApiError.new(res) if res.status != 200
-
-      res.body[:data].map { |item| to_model(item) }
-    end
-
-    #
-    # Get a calendar's member information.
-    #
-    # @param cal_id [String] calendar's id.
-    # @return [Array<TimeTree::User>]
-    # @raise [TimeTree::Error] if the cal_id arg is empty.
-    # @raise [TimeTree::ApiError] if the http response status will not success.
-    # @since 0.0.1
-    def calendar_members(cal_id)
-      check_calendar_id cal_id
-      res = @http_cmd.get "/calendars/#{cal_id}/members"
-      raise ApiError.new(res) if res.status != 200
-
-      res.body[:data].map { |item| to_model item }
-    end
-
-    #
-    # Get the event's information.
-    #
-    # @param cal_id [String] calendar's id.
-    # @param event_id [String] event's id.
-    # @param include_relationships [Array<symbol>]
-    # includes association's object in the response.
-    # @return [TimeTree::Event]
-    # @raise [TimeTree::Error] if the cal_id arg is empty.
-    # @raise [TimeTree::Error] if the event_id arg is empty.
-    # @raise [TimeTree::ApiError] if the http response status will not success.
-    # @since 0.0.1
-    def event(cal_id, event_id, include_relationships: nil)
-      check_calendar_id cal_id
-      check_event_id event_id
-      params = relationships_params(include_relationships, Event::RELATIONSHIPS)
-      res = @http_cmd.get "/calendars/#{cal_id}/events/#{event_id}", params
-      raise ApiError.new(res) if res.status != 200
-
-      ev = to_model(res.body[:data], included: res.body[:included])
-      ev.calendar_id = cal_id
-      ev
-    end
-
-    #
-    # Get the events' information after a request date.
-    #
-    # @param cal_id[String] calendar's id.
-    # @param days [Integer] The number of days to get.
-    # @param timezone [String] Timezone.
-    # @param include_relationships [Array<symbol>]
-    # includes association's object in the response.
-    # @return [Array<TimeTree::Event>]
-    # @raise [TimeTree::Error] if the cal_id arg is empty.
-    # @raise [TimeTree::ApiError] if the http response status will not success.
-    # @since 0.0.1
-    def upcoming_events(cal_id, days: 7, timezone: 'UTC', include_relationships: nil)
-      check_calendar_id cal_id
-      params = relationships_params(include_relationships, Event::RELATIONSHIPS)
-      params.merge!(days: days, timezone: timezone)
-      res = @http_cmd.get "/calendars/#{cal_id}/upcoming_events", params
-      raise ApiError.new(res) if res.status != 200
-
-      included = res.body[:included]
-      res.body[:data].map do |item|
-        ev = to_model(item, included: included)
-        ev.calendar_id = cal_id
-        ev
-      end
-    end
-
-    #
-    # Creates an event to the calendar.
-    #
-    # @param cal_id [String] calendar's id.
-    # @param params [Hash] TimeTree request body format.
-    # @return [TimeTree::Event]
-    # @raise [TimeTree::Error] if the cal_id arg is empty.
-    # @raise [TimeTree::ApiError] if the http response status will not success.
-    # @since 0.0.1
-    def create_event(cal_id, params)
-      check_calendar_id cal_id
-      res = @http_cmd.post "/calendars/#{cal_id}/events", params
-      raise ApiError.new(res) if res.status != 201
-
-      ev = to_model res.body[:data]
-      ev.calendar_id = cal_id
-      ev
-    end
-
-    #
-    # Updates an event.
-    #
-    # @param cal_id [String] calendar's id.
-    # @param event_id [String] event's id.
-    # @param params [Hash]
-    # event's information specified in TimeTree request body format.
-    # @return [TimeTree::Event]
-    # @raise [TimeTree::Error] if the cal_id arg is empty.
-    # @raise [TimeTree::Error] if the event_id arg is empty.
-    # @raise [TimeTree::ApiError] if the http response status will not success.
-    # @since 0.0.1
-    def update_event(cal_id, event_id, params)
-      check_calendar_id cal_id
-      check_event_id event_id
-      res = @http_cmd.put "/calendars/#{cal_id}/events/#{event_id}", params
-      raise ApiError.new(res) if res.status != 200
-
-      ev = to_model res.body[:data]
-      ev.calendar_id = cal_id
-      ev
-    end
-
-    #
-    # Deletes an event.
-    #
-    # @param cal_id [String] calendar's id.
-    # @param event_id [String] event's id.
-    # @return [true] if the operation succeeded.
-    # @raise [TimeTree::Error] if the cal_id arg is empty.
-    # @raise [TimeTree::Error] if the event_id arg is empty.
-    # @raise [TimeTree::ApiError] if the http response status will not success.
-    # @since 0.0.1
-    def delete_event(cal_id, event_id)
-      check_calendar_id cal_id
-      check_event_id event_id
-      res = @http_cmd.delete "/calendars/#{cal_id}/events/#{event_id}"
-      raise ApiError.new(res) if res.status != 204
-
-      true
-    end
-
-    #
-    # Creates comment to an event.
-    #
-    # @param cal_id [String] calendar's id.
-    # @param event_id [String] event's id.
-    # @param params [Hash]
-    # comment's information specified in TimeTree request body format.
-    # @return [TimeTree::Activity]
-    # @raise [TimeTree::Error] if the cal_id arg is empty.
-    # @raise [TimeTree::Error] if the event_id arg is empty.
-    # @raise [TimeTree::ApiError] if the http response status is not success.
-    # @since 0.0.1
-    def create_activity(cal_id, event_id, params)
-      check_calendar_id cal_id
-      check_event_id event_id
-      res = @http_cmd.post "/calendars/#{cal_id}/events/#{event_id}/activities", params
-      raise ApiError.new(res) if res.status != 201
-
-      activity = to_model res.body[:data]
-      activity.calendar_id = cal_id
-      activity.event_id = event_id
-      activity
-    end
-
-    def inspect
-      limit_info = nil
-      if defined?(@ratelimit_limit) && @ratelimit_limit
-        limit_info = " ratelimit:#{ratelimit_remaining}/#{ratelimit_limit}"
-      end
-      if defined?(@ratelimit_reset_at) && @ratelimit_reset_at
-        limit_info = "#{limit_info}, reset_at:#{ratelimit_reset_at.strftime('%m/%d %R')}"
-      end
-      "\#<#{self.class}:#{object_id}#{limit_info}>"
-    end
-
-    #
-    # update ratelimit properties
-    #
-    # @param res [Faraday::Response]
-    # apis http response.
-    def update_ratelimit(res)
-      limit = res.headers['x-ratelimit-limit']
-      remaining = res.headers['x-ratelimit-remaining']
-      reset = res.headers['x-ratelimit-reset']
-      @ratelimit_limit = limit.to_i if limit
-      @ratelimit_remaining = remaining.to_i if remaining
-      @ratelimit_reset_at = Time.at reset.to_i if reset
-    end
-
-  private
-
-    def check_token
-      check_required_property(@token, 'token')
-    end
-
-    def check_calendar_id(value)
-      check_required_property(value, 'calendar_id')
-    end
-
-    def check_event_id(value)
-      check_required_property(value, 'event_id')
-    end
-
-    def check_required_property(value, name)
-      err = Error.new "#{name} is required."
-      raise err if value.nil?
-      raise err if value.to_s.empty?
-
-      true
-    end
-
-    def to_model(data, included: nil)
-      TimeTree::BaseModel.to_model data, client: self, included: included
-    end
-
-    def relationships_params(relationships, default)
-      params = {}
-      relationships ||= default
-      params[:include] = relationships.join ',' if relationships.is_a? Array
-      params
-    end
-  end
-end