caly 0.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 945baa4c6e37c1db04ff8c816f41043aaba3d97b5e1cafcf74075ce44b0cbf49
+  data.tar.gz: 480b5c3b07087fc3109672b8022609e9075a52b894c2a82305651ed020a52ad4
+SHA512:
+  metadata.gz: 6f1fc8b1328a3fe5b44735ab251e48de461f6dccacd5ecfde4a9ea6aea4ce78135b2e89e3f29917259b7ec410b8a206d8f9431a6dfcf75ba3f3f1905a6cd5345
+  data.tar.gz: 62a2de9963b1d22bd77033b9894f92ffb08bd1738804aefe255c4ec2de187473f3aa3b883710665289b3ed19d864cb2d80017f228be9dd6fb53c0b85bf706c7a

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright 2024 lucashudson
+
+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

@@ -0,0 +1,36 @@
+# Caly - One API, any Calendar
+[![Coverage](badge.svg)](https://github.com/Lucas-Hudson/caly)
+
+Caly unifies endpoints and object data models across many calendar APIs, helping you instantly integrate your app with 
+[Google Calendar](https://developers.google.com/calendar/api/guides/overview) and 
+[Microsoft Outlook](https://learn.microsoft.com/en-us/graph/api/resources/calendar?view=graph-rest-1.0) in one go.
+
+## Installation
+Add this line to your application's Gemfile:
+
+```ruby
+gem "caly"
+```
+
+And then execute:
+```bash
+$ bundle
+```
+
+Or install it yourself as:
+```bash
+$ gem install caly
+```
+
+## Usage
+```ruby
+account = Caly::Account.new(provider, token)
+
+account.list_calendars #=> Array of Caly::Calendar instances
+```
+
+## Contributing
+Contribution directions go here.
+
+## License
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/lib/caly/account.rb

@@ -0,0 +1,26 @@
+module Caly
+  class Account
+    attr_reader :provider, :token
+
+    def initialize(provider, token)
+      unless Caly::AVAILABLE_PROVIDERS.include?(provider.to_sym)
+        raise ArgumentError.new("#{provider} isn't a supported provider.")
+      end
+
+      @provider = provider
+      @token = token
+    end
+
+    def self.caly_provider_for(name)
+      Caly::Providers.const_get(Util.classify(name))
+    end
+
+    def caly_provider
+      @caly_provider ||= self.class.caly_provider_for(provider).new(token)
+    end
+
+    def list_calendars
+      caly_provider.list_calendars
+    end
+  end
+end

data/lib/caly/calendar.rb

@@ -0,0 +1,14 @@
+module Caly
+  class Calendar
+    attr_reader :id, :name, :description, :location, :timezone, :raw
+
+    def initialize(id: nil, name: nil, description: nil, location: nil, timezone: nil, raw: nil)
+      @id = id
+      @name = name
+      @description = description
+      @location = location
+      @timezone = timezone
+      @raw = raw
+    end
+  end
+end

data/lib/caly/client.rb

@@ -0,0 +1,26 @@
+module Caly
+  class Client
+    def initialize(url, headers)
+      @url = url
+      @headers = headers
+    end
+
+    def execute_request(method, path)
+      uri = URI.parse([@url, path].join("/"))
+
+      request = Net::HTTPGenericRequest.new(
+        method.to_s.upcase,
+        false,
+        true,
+        uri,
+        @headers
+      )
+
+      response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
+        http.request(request)
+      end
+
+      JSON.parse(response.body).merge("code" => response.code)
+    end
+  end
+end

data/lib/caly/error.rb

@@ -0,0 +1,10 @@
+module Caly
+  class Error
+    attr_reader :message, :code
+
+    def initialize(message:, code:)
+      @message = message
+      @code = code
+    end
+  end
+end

data/lib/caly/providers/base.rb

@@ -0,0 +1,20 @@
+module Caly
+  module Providers
+    class Base
+      extend Forwardable
+
+      def_delegator :@client, :execute_request
+
+      def initialize(token)
+        @headers = {Authorization: "Bearer #{token}", ContentType: "application/json"}
+        @client = Caly::Client.new(@url, @headers)
+      end
+
+      private
+
+      def error_from(response)
+        ::Caly::Error.new(message: response.dig("error", "message"), code: response.dig("code"))
+      end
+    end
+  end
+end

data/lib/caly/providers/google_oauth2.rb

@@ -0,0 +1,22 @@
+module Caly
+  module Providers
+    class GoogleOauth2 < Base
+      def initialize(token)
+        @url = "https://www.googleapis.com/calendar/v3"
+        super
+      end
+
+      def list_calendars
+        response = execute_request(:get, "users/me/calendarList")
+
+        return error_from(response) unless response["code"] == "200"
+
+        response["items"].map do |c|
+          if c["accessRole"] == "owner"
+            Caly::Calendar.new(id: c["id"], name: c["summary"], description: c["description"], location: c["location"], timezone: c["timeZone"], raw: c)
+          end
+        end.compact
+      end
+    end
+  end
+end

data/lib/caly/providers/microsoft_graph.rb

@@ -0,0 +1,20 @@
+module Caly
+  module Providers
+    class MicrosoftGraph < Base
+      def initialize(token)
+        @url = "https://graph.microsoft.com/v1.0/me"
+        super
+      end
+
+      def list_calendars
+        response = execute_request(:get, "calendars")
+
+        return error_from(response) unless response["code"] == "200"
+
+        response["value"].map do |c|
+          Caly::Calendar.new(id: c["id"], name: c["name"], raw: c) if c["canEdit"] == true
+        end.compact
+      end
+    end
+  end
+end

data/lib/caly/util.rb

@@ -0,0 +1,7 @@
+module Caly
+  class Util
+    def self.classify(str)
+      str.to_s.split("_").collect!(&:capitalize).join
+    end
+  end
+end

data/lib/caly/version.rb

@@ -0,0 +1,3 @@
+module Caly
+  VERSION = "0.0.0"
+end

data/lib/caly.rb

@@ -0,0 +1,20 @@
+require "net/http"
+require "json"
+require "forwardable"
+
+require "caly/version"
+
+require "caly/providers/base"
+require "caly/providers/google_oauth2"
+require "caly/providers/microsoft_graph"
+
+require "caly/account"
+require "caly/calendar"
+require "caly/client"
+require "caly/error"
+
+require "caly/util"
+
+module Caly
+  AVAILABLE_PROVIDERS = [:google_oauth2, :microsoft_graph].freeze
+end

metadata

@@ -0,0 +1,54 @@
+--- !ruby/object:Gem::Specification
+name: caly
+version: !ruby/object:Gem::Version
+  version: 0.0.0
+platform: ruby
+authors:
+- Lucas Hudson
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2024-04-21 00:00:00.000000000 Z
+dependencies: []
+description: Integrate easily with Google Calendar and Microsoft Outlook calendars.
+email: lucashudson.contact@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- MIT-LICENSE
+- README.md
+- lib/caly.rb
+- lib/caly/account.rb
+- lib/caly/calendar.rb
+- lib/caly/client.rb
+- lib/caly/error.rb
+- lib/caly/providers/base.rb
+- lib/caly/providers/google_oauth2.rb
+- lib/caly/providers/microsoft_graph.rb
+- lib/caly/util.rb
+- lib/caly/version.rb
+homepage: https://rubygems.org/gems/caly
+licenses:
+- MIT
+metadata: {}
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.2.33
+signing_key:
+specification_version: 4
+summary: Caly - One API, any Calendar
+test_files: []