ruby-office365 0.1.0 → 0.1.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3d07710145d0950ccf59cbb228b1ad453d4f157e7dfb941f912c76338e859548
-  data.tar.gz: 7d62a6296186c5bb8813402890d911ff31e9c9f998e797932f1726a38b76751f
+  metadata.gz: d2c2997d3d775d3450dd11a6774e3edee59fc22b307b85b7d525ac561cd19eeb
+  data.tar.gz: 02bf02e037717417d889e4a81bbead7ead87210390adfb57f9d1643d851b905e
 SHA512:
-  metadata.gz: 3fbea9fe5c09e3ea418f40dbb8fdb90126e0768cd47afd37a698aae0461fbf5d01efe885cd3cc96e55d220ef2067034b4e9cb1d1a1b54db041bd3aff794e20bf
-  data.tar.gz: ff15f4d0b53888a343b2c39f3bfe060816b7317155b2908bb7d52f341bc0235a7c1ebfcea1cf93a1d6d1a0d4e824b1b1a975bfeae8e36f7bf8092e0c30927823
+  metadata.gz: e33d6e7f5d01292a86ecfd6dd70b432f8d4ed88cccdc427a2c09a0c9506610242444a1f49bf48f1c95a306213c7d11d995af5dabcb0fc76073749ea8d0aca14a
+  data.tar.gz: 707cd85b26cf08352590ae658cc76f981b0cca8a8c3ded186d44cc712e4ee334bf6ef59bc89ac5097f33441e4ea4c49f7f306dcd51d87d300832650fe25bdeb2

data/.rubocop.yml

@@ -10,4 +10,13 @@ Style/StringLiteralsInInterpolation:
   EnforcedStyle: double_quotes
 
 Layout/LineLength:
-  Max: 120
+  Max: 150
+
+Metrics/AbcSize:
+  Max: 150
+
+Style/Documentation:
+  Enabled: false
+
+Metrics/BlockLength:
+  Max: 150

data/CHANGELOG.md

@@ -2,4 +2,23 @@
 
 ## [0.1.0] - (2022-10-19)
 
-### Project Setup
+- Project setup and push to rubugems
+
+## [0.1.1] - (2022-10-21)
+
+- Integrate REST API to get data from Graph API
+  - get profile `client.me`
+  - get mailbox `client.messages`
+  - get calenders `client.calenders`
+
+## [0.1.2] - (2022-10-21)
+
+- Integrate REST API to get mailbox with pagination
+  - get mailbox data with next link `client.messages({next_link: 'xxx'})`
+  - get mailbox data with next link `client.calenders({next_link: 'xxx'})`
+
+## [0.1.3] - (2022-10-26)
+
+- Integrate REST API to get contacts
+  - get profile `client.contacts`
+  - get contacts data with next link `client.contacts({next_link: 'xxx'})`

data/Gemfile

@@ -8,5 +8,3 @@ gemspec
 gem "rake", "~> 13.0"
 
 gem "rspec", "~> 3.0"
-
-gem "rubocop", "~> 1.21"

data/Gemfile.lock

@@ -1,17 +1,56 @@
 PATH
   remote: .
   specs:
-    ruby-office365 (0.1.0)
+    ruby-office365 (0.1.3)
+      faraday
+      faraday_middleware
 
 GEM
   remote: https://rubygems.org/
   specs:
+    addressable (2.8.1)
+      public_suffix (>= 2.0.2, < 6.0)
     ast (2.4.2)
+    coderay (1.1.3)
+    crack (0.4.5)
+      rexml
     diff-lcs (1.5.0)
+    faraday (1.10.2)
+      faraday-em_http (~> 1.0)
+      faraday-em_synchrony (~> 1.0)
+      faraday-excon (~> 1.1)
+      faraday-httpclient (~> 1.0)
+      faraday-multipart (~> 1.0)
+      faraday-net_http (~> 1.0)
+      faraday-net_http_persistent (~> 1.0)
+      faraday-patron (~> 1.0)
+      faraday-rack (~> 1.0)
+      faraday-retry (~> 1.0)
+      ruby2_keywords (>= 0.0.4)
+    faraday-em_http (1.0.0)
+    faraday-em_synchrony (1.0.0)
+    faraday-excon (1.1.0)
+    faraday-httpclient (1.0.1)
+    faraday-multipart (1.0.4)
+      multipart-post (~> 2)
+    faraday-net_http (1.0.1)
+    faraday-net_http_persistent (1.2.0)
+    faraday-patron (1.0.0)
+    faraday-rack (1.0.0)
+    faraday-retry (1.0.3)
+    faraday_middleware (1.2.0)
+      faraday (~> 1.0)
+    hashdiff (1.0.1)
     json (2.6.2)
+    method_source (1.0.0)
+    multipart-post (2.2.3)
     parallel (1.22.1)
     parser (3.1.2.1)
       ast (~> 2.4.1)
+    pry (0.14.1)
+      coderay (~> 1.1)
+      method_source (~> 1.0)
+    public_suffix (5.0.0)
     rainbow (3.1.1)
     rake (13.0.6)
     regexp_parser (2.6.0)
@@ -42,16 +81,27 @@ GEM
     rubocop-ast (1.22.0)
       parser (>= 3.1.1.0)
     ruby-progressbar (1.11.0)
+    ruby2_keywords (0.0.5)
     unicode-display_width (2.3.0)
+    vcr (6.1.0)
+    webmock (3.18.1)
+      addressable (>= 2.8.0)
+      crack (>= 0.3.2)
+      hashdiff (>= 0.4.0, < 2.0.0)
 
 PLATFORMS
+  ruby
   x86_64-darwin-21
+  x86_64-linux
 
 DEPENDENCIES
+  pry
   rake (~> 13.0)
   rspec (~> 3.0)
-  rubocop (~> 1.21)
+  rubocop
   ruby-office365!
+  vcr
+  webmock
 
 BUNDLED WITH
-   2.3.22
+   2.3.9

data/LICENSE.md

@@ -0,0 +1,20 @@
+Copyright (c) 2022 Encore Shao
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -14,15 +14,127 @@ If bundler is not being used to manage dependencies, install the gem by executin
 
     $ gem install ruby-office365
 
-## Usage
+## Configuration
 
-TODO: Write usage instructions here
+You can pass configuration options as a block to `Office365::REST::Client.new`.
 
-## Development
+```ruby
+client = Office365::REST::Client.new do |config|
+  config.tenant_id          = "YOUR_ORG_TENANT_ID"
+  config.client_id          = "YOUR_APP_CLIENT_ID"
+  config.client_secret      = "YOUR_APP_CLIENT_SECRET"
+  config.redirect_uri       = "YOUR_APP_REDIRECT_URL"
+  config.access_token       = "YOUR_ACCESS_TOKEN"
+  config.refresh_token      = "YOUR_REFRESH_TOKEN"
+end
+```
 
-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.
+## Usage Examples
 
-To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and the created tag, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+After configuring a `client`, you can do the following things.
+
+**response**
+
+    - `results`: wrap all data into results
+    - `next_link`: get the new link for the next page of data
+
+**to JSON**
+
+    - `as_json`: convert office365 object to JSON format
+
+**Get Profile (as the authenticated user)**
+
+```ruby
+irb(main):004:0> response = client.me
+irb(main):010:0> response.display_name
+=> "Hello World"
+irb(main):004:0> response.as_json
+=> {
+    :odata_context=>"https://graph.microsoft.com/v1.0/$metadata#users/$entity",
+    :display_name=>"Hello World",
+    :surname=>"Hello",
+    :given_name=>"World",
+    :id=>"d7e954e0b50095ad",
+    :user_principal_name=>"hello.world@mail.com",
+    :business_phones=>[],
+    :job_title=>nil,
+    :mail=>nil,
+    :mobile_phone=>nil,
+    :office_location=>nil,
+    :preferred_language=>nil
+}
+```
+
+**Get my calendars**
+
+```ruby
+irb(main):005:0> client.calendars
+irb(main):005:0> client.calendars[:results]
+irb(main):005:0> client.calendars[:next_link]
+```
+
+**Get my mails**
+
+```ruby
+irb(main):005:0> client.messages
+irb(main):005:0> client.messages[:results]
+irb(main):005:0> client.messages({ filter: "createdDateTime lt 2022-01-01" })
+irb(main):005:0> client.messages({ filter: "createdDateTime lt 2022-01-01", next_link: 'https://....' })
+```
+
+**Get my contacts**
+
+```ruby
+irb(main):018:0> response = client.contacts
+irb(main):020:0> client.contacts[:results][0].display_name
+=> "Encore S."
+irb(main):018:0> response[:results][0].as_json
+=> {
+    :odata_etag=>"W/\"EQAAABYAAACbUc86NQthQ7+Mvj19ecwVAABjabQj\"",
+    :id=>"AQMkADAwATM3ZmYAZS00ZTU5LWY3NwBjLTAwAi0wMAoARgAAA4QFHqPHk4JJj7ZVaRPCKk4HAJtRzzo1C2FDv4y_PX15zBUAAAIBDgAAAJtRzzo1C2FDv4y_PX15zBUAAABja1I_AAAA",
+    :created_date_time=>"2022-10-24T02:48:56Z",
+    :last_modified_date_time=>"2022-10-24T02:48:57Z",
+    :change_key=>"EQAAABYAAACbUc86NQthQ7+Mvj19ecwVAABjabQj",
+    :categories=>[],
+    :parent_folder_id=>"AQMkADAwATM3ZmYAZS00ZTU5LWY3NwBjLTAwAi0wMAoALgAAA4QFHqPHk4JJj7ZVaRPCKk4BAJtRzzo1C2FDv4y_PX15zBUAAAIBDgAAAA==",
+    :birthday=>nil,
+    :file_as=>"",
+    :display_name=>"Name S.",
+    :given_name=>"Name",
+    :initials=>nil,
+    :middle_name=>nil,
+    :nick_name=>nil,
+    :surname=>"S.",
+    :title=>nil,
+    :yomi_given_name=>nil,
+    :yomi_surname=>nil,
+    :yomi_company_name=>"",
+    :generation=>nil,
+    :im_addresses=>[],
+    :job_title=>"",
+    :company_name=>nil,
+    :department=>"",
+    :office_location=>"",
+    :profession=>nil,
+    :business_home_page=>"",
+    :assistant_name=>"",
+    :manager=>"",
+    :home_phones=>[],
+    :mobile_phone=>"",
+    :business_phones=>[],
+    :spouse_name=>"",
+    :personal_notes=>"",
+    :children=>[],
+    :email_addresses=>[{"name"=>"name@google.com", "address"=>"name@google.com"}],
+    :home_address=>{},
+    :business_address=>{},
+    :other_address=>{}
+}
+```
+
+## Copyright
+
+Copyright (c) 2022 Encore Shao. See LICENSE for details.
 
 ## Contributing
 

data/lib/office365/client.rb

@@ -2,6 +2,43 @@
 
 module Office365
   class Client
-    autoload :Mailbox, "office365/requests/mailbox"
+    attr_accessor :client_id, :client_secret, :access_token, :refresh_token, :redirect_uri, :tenant_id, :debug
+
+    # Initializes a new Client object
+    #
+    # @param options [Hash]
+    # @return [Office365::Client]
+    def initialize(options = {})
+      options.each do |key, value|
+        instance_variable_set("@#{key}", value)
+      end
+      yield(self) if block_given?
+    end
+
+    # @return [Boolean]
+    def user_token?
+      !(blank_string?(access_token) || blank_string?(refresh_token))
+    end
+
+    # @return [Hash]
+    def credentials
+      {
+        client_id: client_id,
+        client_secret: client_secret,
+        access_token: access_token,
+        refresh_token: refresh_token
+      }
+    end
+
+    # @return [Boolean]
+    def credentials?
+      credentials.values.none? { |v| blank_string?(v) }
+    end
+
+    private
+
+    def blank_string?(string)
+      string.respond_to?(:empty?) ? string.empty? : !string
+    end
   end
 end

data/lib/office365/models/calendar.rb

@@ -2,7 +2,10 @@
 
 module Office365
   module Models
-    class Calendar
+    class Calendar < Base
+      # attr_accessor :id, :name, :color, :hex_color, :is_default_calendar, :change_key, :can_share, :can_view_private_items,
+      #               :can_edit, :allowed_online_meeting_providers, :default_online_meeting_provider, :is_tallying_responses,
+      #               :is_removable, :owner
     end
   end
 end

data/lib/office365/models/concerns/base.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+require "ostruct"
+
+module Office365
+  module Models
+    class Base < OpenStruct
+      def initialize(response = {})
+        super(response.transform_keys(&:o_underscore))
+      end
+
+      def as_json
+        to_h
+      end
+    end
+  end
+end

data/lib/office365/{requests/mailbox.rb → models/contact.rb}

@@ -1,8 +1,8 @@
 # frozen_string_literal: true
 
 module Office365
-  module Requests
-    class Mailbox
+  module Models
+    class Contact < Base
     end
   end
 end

data/lib/office365/models/directory.rb

@@ -2,7 +2,7 @@
 
 module Office365
   module Models
-    class Directory
+    class Directory < Base
     end
   end
 end

data/lib/office365/models/email_address.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module Office365
+  module Models
+    class EmailAddress < Base
+      # attr_accessor :name, :address
+    end
+  end
+end

data/lib/office365/models/mailbox.rb

@@ -2,7 +2,13 @@
 
 module Office365
   module Models
-    class Mailbox
+    class Mailbox < Base
+      # attr_accessor :id, :createdDateTime, :lastModifiedDateTime, :categories, :changeKey,
+      #               :receivedDateTime, :sentDateTime, :hasAttachments, :internetMessageId,
+      #               :subject, :importance, :parentFolderId, :conversationId, :conversationIndex,
+      #               :isDeliveryReceiptRequested, :isReadReceiptRequested, :isRead, :isDraft,
+      #               :webLink, :inferenceClassification, :sender, :from, :toRecipients, :ccRecipients,
+      #               :bccRecipients, :replyTo, :flag
     end
   end
 end

data/lib/office365/models/owner.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module Office365
+  module Models
+    class Owner < Base
+      # attr_accessor :name, :address
+    end
+  end
+end

data/lib/office365/models/user.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+module Office365
+  module Models
+    class User < Base
+      # attr_accessor :display_name, :surname, :given_name, :id, :user_principal_name, :business_phones, :job_title, :mail,
+      #               :mobile_phone, :office_location, :preferred_language
+    end
+  end
+end

data/lib/office365/models.rb

@@ -2,8 +2,13 @@
 
 module Office365
   module Models
-    autoload :Directory,  "office365/models/directory"
-    autoload :Mailbox,    "office365/models/mailbox"
-    autoload :Calendar,   "office365/models/calendar"
+    autoload :Base,               "office365/models/concerns/base"
+    autoload :Directory,          "office365/models/directory"
+    autoload :Mailbox,            "office365/models/mailbox"
+    autoload :Calendar,           "office365/models/calendar"
+    autoload :User,               "office365/models/user"
+    autoload :Owner,              "office365/models/owner"
+    autoload :EmailAddress,       "office365/models/email_address"
+    autoload :Contact,            "office365/models/contact"
   end
 end

data/lib/office365/rest/api.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+require_relative "./user"
+require_relative "./mailbox"
+require_relative "./calendar"
+require_relative "./contact"
+require_relative "./token"
+
+module Office365
+  module REST
+    module API
+      include Office365::REST::User
+      include Office365::REST::Mailbox
+      include Office365::REST::Calendar
+      include Office365::REST::Contact
+      include Office365::REST::Token
+    end
+  end
+end

data/lib/office365/rest/calendar.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+require_relative "./concerns/base"
+
+module Office365
+  module REST
+    module Calendar
+      include Concerns::Base
+
+      # params: args => { next_link: (nil / next_page_url) }
+      # response { results: [], next_link: '...' }
+      def calendars(args = {})
+        response = message_response(args: args.merge(base_uri: "/me/calendars"))
+
+        {
+          results: response["value"].map { |v| Models::Calendar.new(v) },
+          next_link: response["@odata.nextLink"]
+        }
+      end
+    end
+  end
+end

data/lib/office365/rest/client.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+require "faraday"
+require "faraday_middleware"
+require "logger"
+require "json"
+
+require_relative "./api"
+
+module Office365
+  module REST
+    class Client < Office365::Client
+      include Office365::REST::API
+      attr_accessor :bearer_token
+
+      # @return [Boolean]
+      def bearer_token?
+        !!bearer_token
+      end
+
+      # @return [Boolean]
+      def credentials?
+        super || bearer_token?
+      end
+    end
+  end
+end

data/lib/office365/rest/concerns/base.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module Office365
+  module REST
+    module Concerns
+      module Base
+        private
+
+        def message_response(args: {})
+          next_link = args.delete(:next_link)
+
+          request_uri = if next_link
+                          next_link
+                        else
+                          base_uri = args.delete(:base_uri)
+
+                          req_uri = ["/", Office365::API_VERSION, base_uri].join
+                          req_uri += ["?", args.to_query].join if args.any?
+                          req_uri
+                        end
+
+          Request.new(access_token, debug: debug).get(request_uri)
+        end
+      end
+    end
+  end
+end

data/lib/office365/rest/contact.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+require_relative "./concerns/base"
+
+module Office365
+  module REST
+    module Contact
+      include Concerns::Base
+
+      # params: args => { next_link: (nil / next_page_url) }
+      # response { results: [], next_link: '...' }
+      def contacts(args = {})
+        response = message_response(args: args.merge(base_uri: "/me/contacts"))
+
+        {
+          results: response["value"].map { |v| Models::Contact.new(v) },
+          next_link: response["@odata.nextLink"]
+        }
+      end
+    end
+  end
+end

data/lib/office365/rest/mailbox.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+require_relative "./concerns/base"
+
+module Office365
+  module REST
+    module Mailbox
+      include Concerns::Base
+
+      # params: args => { next_link: (nil / next_page_url) }
+      # response { results: [], next_link: '...' }
+      def messages(args = {})
+        response = message_response(args: args.merge(base_uri: "/me/messages"))
+
+        {
+          results: response["value"].map { |v| Models::Mailbox.new(v) },
+          next_link: response["@odata.nextLink"]
+        }
+      end
+    end
+  end
+end

data/lib/office365/rest/request.rb

@@ -0,0 +1,62 @@
+# frozen_string_literal: true
+
+require "faraday"
+require "faraday_middleware"
+require "logger"
+require "json"
+
+module Office365
+  module REST
+    class Request
+      attr_accessor :access_token, :debug
+
+      def initialize(access_token, debug: false)
+        @access_token = access_token
+        @debug = debug
+      end
+
+      def get(uri, args: {})
+        r_uri = URI(uri.start_with?("https") ? uri : (Office365::API_HOST + uri))
+
+        response = Faraday.new(url: [r_uri.scheme, "://", r_uri.hostname].join, headers: headers) do |faraday|
+          faraday.adapter Faraday.default_adapter
+          faraday.response :json
+          faraday.response :logger, ::Logger.new($stdout), bodies: true if dev_developement?
+        end.get(r_uri.request_uri, *args)
+
+        resp_body = response.body
+        return resp_body if response.status == 200
+        raise InvalidAuthenticationTokenError, resp_body.dig("error", "message") if response.status == 401
+
+        raise Error, resp_body["error"]
+      end
+
+      def post(uri, args)
+        response = Faraday.new(url: Office365::API_HOST, headers: headers) do |faraday|
+          faraday.adapter Faraday.default_adapter
+          faraday.response :json
+          faraday.response :logger, ::Logger.new($stdout), bodies: true if dev_developement?
+        end.post(uri, args)
+
+        resp_body = response.body
+        return resp_body if response.status == 200
+        raise InvalidAuthenticationTokenError, resp_body.dig("error", "message") if response.status == 401
+
+        raise Error, resp_body["error"]
+      end
+
+      private
+
+      def headers
+        {
+          "Content-Type" => "application/json",
+          "Authorization" => "Bearer #{access_token}"
+        }
+      end
+
+      def dev_developement?
+        debug
+      end
+    end
+  end
+end

data/lib/office365/rest/token.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+module Office365
+  module REST
+    module Token
+      def token_refresh
+        args = {
+          refresh_token: refresh_token,
+          client_id: client_id,
+          client_secret: client_secret,
+          grant_type: "refresh_token"
+        }
+
+        post(oauth_client.token_url, args)
+      end
+
+      private
+
+      def oauth_client
+        @oauth_client ||= OAuth2::Client.new(
+          client_id,
+          client_secret,
+          authorize_url: AUTHORIZE_URL,
+          site: LOGIN_HOST,
+          token_url: TOKEN_URL,
+          redirect_uri: redirect_uri
+        )
+      end
+    end
+  end
+end

data/lib/office365/rest/user.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+require_relative "request"
+
+module Office365
+  module REST
+    module User
+      def me
+        profile_uri = ["/", Office365::API_VERSION, "/me"].join
+        Models::User.new(Request.new(access_token, debug: debug).get(profile_uri))
+      end
+    end
+  end
+end

data/lib/office365/rest.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+module Office365
+  module REST
+    autoload :Client,     "office365/rest/client"
+    autoload :Request,    "office365/rest/request"
+  end
+end

data/lib/office365/utils/string.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+class String
+  def o_underscore
+    gsub(/::/, "/")
+      .gsub(/@/, "")
+      .gsub(/\./, "_")
+      .gsub(/([A-Z]+)([A-Z][a-z])/, '\1_\2')
+      .gsub(/([a-z\d])([A-Z])/, '\1_\2')
+      .tr("-", "_")
+      .downcase
+  end
+end

data/lib/office365/utils/to_query.rb

@@ -0,0 +1,89 @@
+# frozen_string_literal: true
+
+require "cgi"
+
+class Object
+  # Alias of <tt>to_s</tt>.
+  def to_param
+    to_s
+  end
+
+  # Converts an object into a string suitable for use as a URL query string,
+  # using the given <tt>key</tt> as the param name.
+  def to_query(key)
+    "#{CGI.escape(key.to_param)}=#{CGI.escape(to_param.to_s)}"
+  end
+end
+
+class NilClass
+  # Returns +self+.
+  def to_param
+    self
+  end
+end
+
+class TrueClass
+  # Returns +self+.
+  def to_param
+    self
+  end
+end
+
+class FalseClass
+  # Returns +self+.
+  def to_param
+    self
+  end
+end
+
+class Array
+  # Calls <tt>to_param</tt> on all its elements and joins the result with
+  # slashes. This is used by <tt>url_for</tt> in Action Pack.
+  def to_param
+    collect(&:to_param).join "/"
+  end
+
+  # Converts an array into a string suitable for use as a URL query string,
+  # using the given +key+ as the param name.
+  #
+  #   ['Rails', 'coding'].to_query('hobbies') # => "hobbies%5B%5D=Rails&hobbies%5B%5D=coding"
+  def to_query(key)
+    prefix = "#{key}[]"
+
+    if empty?
+      nil.to_query(prefix)
+    else
+      collect { |value| value.to_query(prefix) }.join "&"
+    end
+  end
+end
+
+class Hash
+  # Returns a string representation of the receiver suitable for use as a URL
+  # query string:
+  #
+  #   {name: 'David', nationality: 'Danish'}.to_query
+  #   # => "name=David&nationality=Danish"
+  #
+  # An optional namespace can be passed to enclose key names:
+  #
+  #   {name: 'David', nationality: 'Danish'}.to_query('user')
+  #   # => "user%5Bname%5D=David&user%5Bnationality%5D=Danish"
+  #
+  # The string pairs "key=value" that conform the query string
+  # are sorted lexicographically in ascending order.
+  #
+  # This method is also aliased as +to_param+.
+  def to_query(namespace = nil)
+    query = collect do |key, value|
+      unless (value.is_a?(Hash) || value.is_a?(Array)) && value.empty?
+        value.to_query(namespace ? "#{namespace}[#{key}]" : key)
+      end
+    end.compact
+
+    query.sort! unless namespace.to_s.include?("[]")
+    query.join("&")
+  end
+
+  alias to_param to_query
+end

data/lib/office365/utils.rb

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+
+require "office365/utils/string"
+require "office365/utils/to_query"

data/lib/office365/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Office365
-  VERSION = "0.1.0"
+  VERSION = "0.1.3"
 end

data/lib/office365.rb

@@ -2,15 +2,21 @@
 
 require_relative "office365/version"
 
-require "office365/config"
+require "office365/utils"
 require "office365/client"
+require "office365/rest"
 require "office365/models"
 
 module Office365
-  API_DOMAIN    = "https://graph.microsoft.com"
+  API_HOST      = "https://graph.microsoft.com"
+  LOGIN_HOST    = "https://login.microsoftonline.com/"
+
+  AUTHORIZE_URL = "common/oauth2/authorize"
+  TOKEN_URL     = "common/oauth2/token"
   API_VERSION   = "v1.0"
-  BASE_URI      = "#{API_DOMAIN}/#{API_VERSION}/"
+  SCOPE         = "User.read Calendars.read Mail.ReadBasic Contacts.Read"
 
   class Error < StandardError; end
+  class InvalidAuthenticationTokenError < StandardError; end
   # Your code goes here...
 end

data/ruby-office365.gemspec

@@ -12,6 +12,8 @@ Gem::Specification.new do |spec|
   spec.description = "A simple ruby library to interact with Microsoft Graph and Office 365 API."
   spec.homepage = "https://github.com/ekohe/ruby-office365"
   spec.required_ruby_version = ">= 2.5.0"
+  spec.license = "MIT"
+  spec.post_install_message = "Thanks for installing!"
 
   spec.metadata["allowed_push_host"] = "https://rubygems.org"
 
@@ -32,7 +34,16 @@ Gem::Specification.new do |spec|
 
   # Uncomment to register a new dependency of your gem
   # spec.add_dependency "example-gem", "~> 1.0"
-
+  spec.add_dependency "faraday"
+  spec.add_dependency "faraday_middleware"
+
+  # VCR for testing APIs
+  spec.add_development_dependency "vcr"
+  spec.add_development_dependency "webmock"
+  # Rubocop
+  spec.add_development_dependency "rubocop"
+  # For debug binding.pry
+  spec.add_development_dependency "pry"
   # For more information and examples about making a new gem, check out our
   # guide at: https://bundler.io/guides/creating_gem.html
 end

metadata

@@ -1,15 +1,99 @@
 --- !ruby/object:Gem::Specification
 name: ruby-office365
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.3
 platform: ruby
 authors:
 - Encore Shao
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2022-10-19 00:00:00.000000000 Z
-dependencies: []
+date: 2022-10-26 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: faraday
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: faraday_middleware
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: vcr
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 description: A simple ruby library to interact with Microsoft Graph and Office 365
   API.
 email:
@@ -23,27 +107,45 @@ files:
 - CHANGELOG.md
 - Gemfile
 - Gemfile.lock
+- LICENSE.md
 - README.md
 - Rakefile
 - lib/office365.rb
 - lib/office365/client.rb
-- lib/office365/config.rb
 - lib/office365/models.rb
 - lib/office365/models/calendar.rb
+- lib/office365/models/concerns/base.rb
+- lib/office365/models/contact.rb
 - lib/office365/models/directory.rb
+- lib/office365/models/email_address.rb
 - lib/office365/models/mailbox.rb
-- lib/office365/requests/mailbox.rb
+- lib/office365/models/owner.rb
+- lib/office365/models/user.rb
+- lib/office365/rest.rb
+- lib/office365/rest/api.rb
+- lib/office365/rest/calendar.rb
+- lib/office365/rest/client.rb
+- lib/office365/rest/concerns/base.rb
+- lib/office365/rest/contact.rb
+- lib/office365/rest/mailbox.rb
+- lib/office365/rest/request.rb
+- lib/office365/rest/token.rb
+- lib/office365/rest/user.rb
+- lib/office365/utils.rb
+- lib/office365/utils/string.rb
+- lib/office365/utils/to_query.rb
 - lib/office365/version.rb
 - ruby-office365.gemspec
 - sig/office365.rbs
 homepage: https://github.com/ekohe/ruby-office365
-licenses: []
+licenses:
+- MIT
 metadata:
   allowed_push_host: https://rubygems.org
   homepage_uri: https://github.com/ekohe/ruby-office365
   source_code_uri: https://github.com/ekohe/ruby-office365
   changelog_uri: https://github.com/ekohe/ruby-office365/blob/main/CHANGELOG.md
-post_install_message:
+post_install_message: Thanks for installing!
 rdoc_options: []
 require_paths:
 - lib
@@ -58,7 +160,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.15
+rubygems_version: 3.1.6
 signing_key:
 specification_version: 4
 summary: A simple ruby library to interact with Microsoft Graph and Office 365 API.

data/lib/office365/config.rb

@@ -1,18 +0,0 @@
-# frozen_string_literal: true
-
-require "singleton"
-
-# Should be config the client and secret first
-module Office365
-  class Config
-    include Singleton
-
-    attr_accessor :client, :secret
-  end
-
-  def self.config
-    yield Config.instance if block_given?
-
-    Config.instance
-  end
-end