whereby-ruby 0.1.4 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9855721503efc20f105aef1039daec4e4bd78342097b385459c3f178a2c6d7f2
-  data.tar.gz: 33584783c746b352b37bcff4338b144df7f7baf071f2590abbb3b6f00aa1a582
+  metadata.gz: 45795394cb6d7781f4a95b4dbfe1743936aa9a481ce705c087c655e1a1414d44
+  data.tar.gz: b398759018a9d83579e3cfd0c2d870e323bb5f202fc5d2ec8aa2f2de04025c14
 SHA512:
-  metadata.gz: 4a7c178ca9a840a1142a69fabde7a64926a2487f4361a4986092a29dec6504190357fb7dfd11c39bbc742345bd554484664809184724d9f2c6f7cac88693102d
-  data.tar.gz: 5d45a3122767abda0469278a2df275f459cf963b4f8c5c0f39319c7b99349d88e8163ecd3f1f5f8a7e3b915e9685902d7bef901613553a4be88cd7b1d499357a
+  metadata.gz: e2474e5b8ad6db3fd56aa3d3168f847ef2c11c6172bc29b7d2b073a4277283b0ea23b610e68f2f641a339e4b509b8742674cbcc259f15ba06e7119fbfcd6e5ee
+  data.tar.gz: 1e7624bb7ccc39f692ba712b7ae7f3a523d9e253c19715fdd39d0b94e178567629cdad96760ea7269ce3191eed1a5bec95afd5b375f4c317265df2cfcef1bfb0

data/README.md

@@ -1,6 +1,6 @@
 # Whereby Ruby HTTP API Wrapper
 
-Just a simple Whereby HTTP API wrapper written for Ruby projects.
+This gem is a very simple [Whereby](https://whereby.com) HTTP API wrapper written for Ruby/Rails projects, to easly create video meetings and conferences. 
 
 ## Installation
 
@@ -20,16 +20,18 @@ Or install it yourself as:
 
 ## Usage
 
-If using Rails put the following into a initializer. If just Ruby, run this before trying to use the API.
+If using Rails put the following into an initializer. If you use plain Ruby, run this code before trying to use the API.
 
 ```ruby
 require 'whereby'
 Whereby.configure do |config|
-  config.api_key = 'YOUR_KEY_HERE'
+  config.api_key = "Your api key!"
 end
 ```
+By default, this gem try to read the `WHEREBY_API_KEY` environment variable and use that as api key. The above statement is therefore equivalent to setting this environment variable.
 
-### Instantiate an API object.
+
+### Instantiate an API object
 
 ```ruby
 api = Whereby::Api.new
@@ -42,6 +44,12 @@ api.meeting(id)                     # GET     /v1/meetings/:id
 api.create_meeting(options)         # POST    /v1/meetings
 api.delete_meeting(id)              # DELETE  /v1/meetings/:id
 ```
+Read more about the different endpoints and options at https://whereby.dev/http-api/
+
+### Example creating a meeting
+```ruby
+api.create_meeting(room_name_prefix: '/example', room_mode: "normal", start_date: "2020-08-01T00:00:00Z", end_date: "2020-08-01T15:00:00Z", fields: ["hostRoomUrl"])
+```
 
 ## Contributing
 

data/lib/whereby.rb

@@ -6,7 +6,7 @@ require 'whereby/api'
 
 module Whereby
   class << self
-    attr_accessor :configuration
+    attr_writer :configuration
   end
 
   def self.api_key
@@ -20,6 +20,23 @@ module Whereby
   def self.configure
     yield(configuration)
   end
+end
 
+class String
+  def whereby_underscore
+    gsub(/::/, '/')
+      .gsub(/([A-Z]+)([A-Z][a-z])/,'\1_\2')
+      .gsub(/([a-z\d])([A-Z])/,'\1_\2')
+      .tr('-', '_')
+      .downcase
+  end
+
+  def whereby_camelize
+    split('_').collect(&:capitalize).join
+  end
 
+  def whereby_lower_camelize
+    res = whereby_camelize
+    res[0].downcase + res[1..-1]
+  end
 end

data/lib/whereby/api.rb

@@ -1,60 +1,60 @@
 require 'httparty'
+require 'json'
+
 module Whereby
   class WherebyError < StandardError; end
 
   class Api
-    API_VERSION = 'v1'
-    BASE_URL = "https://api.whereby.dev/#{API_VERSION}"
+    API_VERSION = 'v1'.freeze
+    BASE_URL = "https://api.whereby.dev/#{API_VERSION}".freeze
 
     # GET /v1/meetings/:id
     def meeting(id)
-      Meeting.new(whereby_request(:get, "meetings/#{id.to_s}"))
+      Meeting.new(whereby_request(:get, "meetings/#{id}"))
     end
 
     # POST /v1/meetings/
-    def create_meeting(options={})
-      Meeting.new(whereby_request(:post, "meetings", options))
+    def create_meeting(**options)
+      Meeting.new(whereby_request(:post, 'meetings', options))
     end
 
     # DELETE /v1/meetings/:id
     def delete_meeting(id)
-      whereby_request(:delete, "meetings/#{id.to_s}")
+      whereby_request(:delete, "meetings/#{id}")
     end
 
     private
-    def whereby_request(method, url, options={})
-      url = "#{BASE_URL}/#{url}"
-
-      # Convert hash keys into camel case
-      options = Hash[options.map { |k,v| [k.to_s.camelize, v]}]
 
-      http_attrs = {headers: headers}
-      http_attrs.merge!(options)
-
-      # TODO: Create case/when for special cases for options
-
-      result = HTTParty.send(method, url, http_attrs)
+    def whereby_request(method, url, options = {})
+      url = "#{BASE_URL}/#{url}"
+      result = HTTParty.send(method, url, { headers: headers, body: body(options) })
 
       if [200, 201].include? result.code
-        JSON.parse(result.body) # Create / Get
+        JSON.parse(result.body)
       elsif result.code == 204
-        true # Delete
+        true
       else
         raise WherebyError.new error(result.code)
       end
     end
 
-    def error(code)
-      return "Access token is missing or invalid" if code == 401
-      return "The requested resource doesn't exist" if code == 404
-      "Major fuck-up."
+    def body(options)
+      Hash[options.map { |k, v| [k.to_s.whereby_lower_camelize, v] }].to_json
     end
 
     def headers
       {
-          "Content-type" => "application/json",
-          "Authorization" => "Bearer #{Whereby.api_key}"
+          'Content-type' => 'application/json',
+          'Authorization' => "Bearer #{Whereby.api_key}"
       }
     end
+
+    def error(code)
+      return 'Access token is missing or invalid' if code == 401
+      return 'The requested resource does not exist' if code == 404
+
+      "The API resulted in an unknown status code: #{code}"
+    end
+
   end
 end

data/lib/whereby/configuration.rb

@@ -3,7 +3,7 @@ module Whereby
     attr_accessor :api_key
 
     def initialize
-      @api_key = nil
+      @api_key = ENV["WHEREBY_API_KEY"]
     end
   end
 end

data/lib/whereby/element.rb

@@ -2,7 +2,7 @@ module Whereby
   class Element
     def initialize(attrs = {})
       # Only set attributes if the method exists
-      attrs.each{ |k,v| send("#{k.underscore}=", v) if respond_to?("#{k.underscore}") }
+      attrs.each{ |k,v| send("#{k.whereby_underscore}=", v) if respond_to?(k.whereby_underscore.to_s) }
     end
 
     def to_h

data/lib/whereby/version.rb

@@ -1,3 +1,3 @@
 module Whereby
-  VERSION = "0.1.4"
+  VERSION = "1.0.0"
 end

data/whereby-ruby.gemspec

@@ -10,7 +10,7 @@ Gem::Specification.new do |spec|
   spec.email         = ["tech@poption.com"]
 
   spec.summary       = "A Ruby Whereby Wrapper"
-  spec.description   = "Easily use Whereby's HTTP API using this gem"
+  spec.description   = "Easily use Whereby's HTTP API to create video rooms and conferences"
   spec.homepage      = "https://github.com/poption/whereby-ruby"
   spec.license       = "MIT"
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: whereby-ruby
 version: !ruby/object:Gem::Version
-  version: 0.1.4
+  version: 1.0.0
 platform: ruby
 authors:
 - Daniel Kittilsen Henriksen
-autorequire: 
+autorequire:
 bindir: exe
 cert_chain: []
-date: 2020-07-27 00:00:00.000000000 Z
+date: 2020-07-31 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: httparty
@@ -24,7 +24,7 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '0.18'
-description: Easily use Whereby's HTTP API using this gem
+description: Easily use Whereby's HTTP API to create video rooms and conferences
 email:
 - tech@poption.com
 executables: []
@@ -54,7 +54,7 @@ metadata:
   homepage_uri: https://github.com/poption/whereby-ruby
   source_code_uri: https://github.com/poption/whereby-ruby
   changelog_uri: https://github.com/poption/whereby-ruby
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -69,8 +69,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.3
-signing_key: 
+rubygems_version: 3.0.8
+signing_key:
 specification_version: 4
 summary: A Ruby Whereby Wrapper
 test_files: []