bigbluebutton-api-ruby 1.7.0 → 1.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 281b4e206ec398cc651d0525256a68dd048d3db3
-  data.tar.gz: 4c6a8bddc03d8c5289926fab24d589442bc16095
+SHA256:
+  metadata.gz: 25726eaedf0a5b63156a7786a793f27a419e349a177419fdaecb0e0aac0295d6
+  data.tar.gz: 6e8ec707b2f53e06ba21163d2f5d34766436e49f852991434d3aa787a4108deb
 SHA512:
-  metadata.gz: 2a2105c7f2d8f6b03a82e0f2bc42052f932e75de76318bcb7885d72e75b492696bd279dbc33e6bc537d37ed2a18e7d444e34ec4b2abe58d2e7e73421b4061164
-  data.tar.gz: 130aa32c3945507d661ef188dd158f545a0755be304ee3b1a55cdfc1bcd57ef168f41b5fd9e5a5488f62bf0b636566a6347ff85708dc32e35d2e3c87a8241bc3
+  metadata.gz: 810382ae7b2f54be6ac766e10db46a61f76a4120c84bb1a99600012266db562da53149d7ee0bde1c7a2b3939542398556a7faa85dd24153c669f04875ac90213
+  data.tar.gz: 229132ef71db18f0a972daefb0b5b0ad49c53c63655877923323a163f99d15b383d4f0ac7344ebba61a6b5961f3a08abc2dc50a9ef217d4eccf0fcbfc2fdc527

data/.gitignore

@@ -5,4 +5,5 @@ features/config.yml
 logs/bbb.log
 rdoc/
 logs/*
-.bundle/
+.bundle/
+.volumes/

data/.ruby-version

@@ -1 +1 @@
-2.2.0
+2.6.5

data/CHANGELOG.md

@@ -1,13 +1,26 @@
 # Change Log
 
-
-------------------------------------
-
-All tickets below use references to IDs in our old issue tracking system.
-To find them, search for their description or ID in the new issue tracker.
-
-------------------------------------
-
+## [1.8.0] - 2021-12-06
+* [#43] Add keys to every `BigBlueButtonException`, to better identify them.
+* [#42] Change `BigBlueButtonException` to inherit from `StandardError` instead of `Exception`.
+* [#50] [BREAKING-CHANGE] Replace `debug` flag with a optional Logger. The application using the
+  gem can pass its own logger as argument for the `BigBlueButtonApi` initialization.
+  If none is passed, the gem will use its own default logger on `STDOUT` with `INFO` level.
+* [#40] Fix issue preventing documents from being preuploaded using the create call.
+* Fix parse of recordings with invalid times. It would break at `getRecordings` if one
+  of them had an empty `startTime` or `endTime`.
+* Add a Dockerfile and compose to help run tests.
+* Fix deprecated `TimeoutError` constant.
+* [#35] Make `get_recordings` accept multiple `state` params.
+* [#34] Update `rubyzip` gem to the newest version with no vulnerability, from 1.2.2 to 1.3.0
+* [#33] Upgrade dependencies:
+  - `childprocess` from 0.3.2 to 1.0.1
+  - `ffi` from 1.0.11 to 1.9.24
+  - `json` from 1.8.3 to 1.8.6
+  - `nokogiri` from 1.6.6.2 to 1.10.4
+  - `rack` from 1.4.1 to 1.6.11
+  - `rdoc` from 3.12 to 3.12.1
+  - `rubyzip` from 0.9.8 to 1.2.2
 
 ## [1.7.0] - 2018-08-17
 
@@ -153,6 +166,19 @@ were different in cases when they were not.
     (instead of browser URL). This call currently does not work as
     documented.
 
+<!-- PRs -->
+[#50]: https://github.com/mconf/bigbluebutton-api-ruby/pull/50
+[#43]: https://github.com/mconf/bigbluebutton-api-ruby/pull/43
+[#42]: https://github.com/mconf/bigbluebutton-api-ruby/pull/42
+[#40]: https://github.com/mconf/bigbluebutton-api-ruby/pull/40
+[#35]: https://github.com/mconf/bigbluebutton-api-ruby/pull/35
+[#34]: https://github.com/mconf/bigbluebutton-api-ruby/pull/34
+[#33]: https://github.com/mconf/bigbluebutton-api-ruby/pull/33
+[#31]: https://github.com/mconf/bigbluebutton-api-ruby/pull/31
+[#29]: https://github.com/mconf/bigbluebutton-api-ruby/pull/29
+
+<!-- Versions -->
+[1.8.0]: https://github.com/mconf/bigbluebutton-api-ruby/compare/v1.7.0...v1.8.0
 [1.7.0]: https://github.com/mconf/bigbluebutton-api-ruby/compare/v1.6.0...v1.7.0
 [1.6.0]: https://github.com/mconf/bigbluebutton-api-ruby/compare/v1.5.0...v1.6.0
 [1.5.0]: https://github.com/mconf/bigbluebutton-api-ruby/compare/v1.4.0...v1.5.0

data/Dockerfile

@@ -0,0 +1,13 @@
+FROM ruby:2.6.5
+
+ENV app /usr/src/app
+
+# Create app directory
+RUN mkdir -p $app
+WORKDIR $app
+
+# Bundle app source
+COPY . $app
+
+# Install app dependencies
+RUN bundle install

data/Gemfile

@@ -4,7 +4,7 @@ gemspec
 
 group :developement do
   gem 'rake', '>= 0.9'
-  gem 'rdoc'
+  gem 'rdoc', '3.12.1'
 end
 
 group :development, :test do

data/Gemfile.lock

@@ -7,7 +7,13 @@ GIT
 PATH
   remote: .
   specs:
-    bigbluebutton-api-ruby (1.7.0)
+    bigbluebutton-api-ruby (1.8.0)
+      childprocess (>= 1.0.1)
+      ffi (>= 1.9.24)
+      json (>= 1.8.6)
+      nokogiri (>= 1.10.4)
+      rack (>= 1.6.11)
+      rubyzip (>= 1.3.0)
       xml-simple (~> 1.1)
 
 GEM
@@ -22,8 +28,8 @@ GEM
       rack-test (>= 0.5.4)
       selenium-webdriver (~> 2.0)
       xpath (~> 0.1.4)
-    childprocess (0.3.2)
-      ffi (~> 1.0.6)
+    childprocess (1.0.1)
+      rake (< 13.0)
     cucumber (1.1.9)
       builder (>= 2.1.2)
       diff-lcs (>= 1.1.2)
@@ -35,24 +41,25 @@ GEM
       cucumber (>= 1.1.8)
       nokogiri (>= 1.5.0)
     diff-lcs (1.1.3)
-    ffi (1.0.11)
+    ffi (1.9.24)
     forgery (0.5.0)
     gherkin (2.9.3)
       json (>= 1.4.6)
-    json (1.8.3)
+    json (1.8.6)
     libwebsocket (0.1.3)
       addressable
     mime-types (1.18)
-    mini_portile (0.6.2)
+    mini_portile2 (2.4.0)
     multi_json (1.3.4)
-    nokogiri (1.6.6.2)
-      mini_portile (~> 0.6.0)
-    rack (1.4.1)
+    nokogiri (1.10.4)
+      mini_portile2 (~> 2.4.0)
+    rack (1.6.11)
     rack-test (0.6.1)
       rack (>= 1.0)
     rake (0.9.2.2)
-    rdoc (3.12)
+    rdoc (3.12.1)
       json (~> 1.4)
+    rexml (3.2.5)
     rspec (2.10.0)
       rspec-core (~> 2.10.0)
       rspec-expectations (~> 2.10.0)
@@ -61,7 +68,7 @@ GEM
     rspec-expectations (2.10.0)
       diff-lcs (~> 1.1.3)
     rspec-mocks (2.10.0)
-    rubyzip (0.9.8)
+    rubyzip (1.3.0)
     selenium-webdriver (2.21.2)
       childprocess (>= 0.2.5)
       ffi (~> 1.0)
@@ -69,7 +76,8 @@ GEM
       multi_json (~> 1.0)
       rubyzip
     term-ansicolor (1.0.7)
-    xml-simple (1.1.5)
+    xml-simple (1.1.9)
+      rexml
     xpath (0.1.4)
       nokogiri (~> 1.3)
 
@@ -82,5 +90,8 @@ DEPENDENCIES
   cucumber-rails
   forgery
   rake (>= 0.9)
-  rdoc
+  rdoc (= 3.12.1)
   rspec (~> 2.10)
+
+BUNDLED WITH
+   1.17.3

data/bigbluebutton-api-ruby.gemspec

@@ -2,7 +2,7 @@ $:.push File.expand_path("../lib", __FILE__)
 
 Gem::Specification.new do |s|
   s.name             = "bigbluebutton-api-ruby"
-  s.version          = "1.7.0"
+  s.version          = "1.8.0"
   s.licenses         = ["MIT"]
   s.extra_rdoc_files = ["README.md", "LICENSE", "LICENSE_003", "CHANGELOG.md"]
   s.summary          = "BigBlueButton integration for ruby"
@@ -14,5 +14,11 @@ Gem::Specification.new do |s|
   s.files            = `git ls-files`.split("\n")
   s.require_paths    = ["lib"]
 
-  s.add_runtime_dependency("xml-simple", "~> 1.1")
+  s.add_runtime_dependency('childprocess', '>= 1.0.1')
+  s.add_runtime_dependency('ffi', '>= 1.9.24')
+  s.add_runtime_dependency('json', '>= 1.8.6')
+  s.add_runtime_dependency('nokogiri', '>= 1.10.4')
+  s.add_runtime_dependency('rack', '>= 1.6.11')
+  s.add_runtime_dependency('rubyzip', '>= 1.3.0')
+  s.add_runtime_dependency('xml-simple', '~> 1.1')
 end

data/docker-compose.yml

@@ -0,0 +1,10 @@
+version: '2'
+services:
+
+  test:
+    build: .
+    tty: true
+    volumes:
+      - $PWD:/usr/src/app
+      - .volumes/bundle/:/usr/local/bundle
+    command: bundle exec rake

data/features/config.yml.example

@@ -1,4 +1,4 @@
-debug: false
+logger: nil
 
 # maximum wait for a response to any API request (secs)
 timeout_req: 60

data/features/step_definitions/common_steps.rb

@@ -4,7 +4,7 @@ When /^the default BigBlueButton server$/ do
   @api = BigBlueButton::BigBlueButtonApi.new(@config_server['url'],
                                              @config_server['secret'],
                                              @config_server['version'].to_s,
-                                             @config['debug'])
+                                             @config['logger'])
   @api.timeout = @config['timeout_req']
 end
 

data/lib/bigbluebutton_api.rb

@@ -9,6 +9,7 @@ require 'bigbluebutton_formatter'
 require 'bigbluebutton_modules'
 require 'bigbluebutton_config_xml'
 require 'bigbluebutton_config_layout'
+require 'logger'
 
 module BigBlueButton
 
@@ -50,8 +51,8 @@ module BigBlueButton
     # API version e.g. 0.81
     attr_accessor :version
 
-    # Flag to turn on/off debug mode
-    attr_accessor :debug
+    # logger to log reponses and infos
+    attr_accessor :logger
 
     # Maximum wait time for HTTP requests (secs)
     attr_accessor :timeout
@@ -67,21 +68,25 @@ module BigBlueButton
     # url::       URL to a BigBlueButton server (e.g. http://demo.bigbluebutton.org/bigbluebutton/api)
     # secret::    Shared secret for this server
     # version::   API version e.g. 0.81
-    def initialize(url, secret, version=nil, debug=false)
+    def initialize(url, secret, version=nil, logger=nil)
       @supported_versions = ['0.8', '0.81', '0.9', '1.0']
       @url = url
       @secret = secret
-      @debug = debug
       @timeout = 10         # default timeout for api requests
       @request_headers = {} # http headers sent in all requests
-
+      @logger = logger
+      if logger.nil?
+        @logger = Logger.new(STDOUT)
+        @logger.level = Logger::INFO
+      end
+      
       version = nil if version && version.strip.empty?
       @version = nearest_version(version || get_api_version)
       unless @supported_versions.include?(@version)
-        puts "BigBlueButtonAPI: detected unsupported version, using the closest one that is supported (#{@version})"
+        @logger.warn("BigBlueButtonAPI: detected unsupported version, using the closest one that is supported (#{@version})")
       end
 
-      puts "BigBlueButtonAPI: Using version #{@version}" if @debug
+      @logger.debug("BigBlueButtonAPI: Using version #{@version}")
     end
 
     # Creates a new meeting. Returns the hash with the response or throws BigBlueButtonException
@@ -461,6 +466,10 @@ module BigBlueButton
         options[:meetingID] = options[:meetingID].join(",") if options[:meetingID].instance_of?(Array)
       end
 
+      if options.has_key?(:state)
+        options[:state] = options[:state].join(",") if options[:state].instance_of?(Array)
+      end
+
       response = send_api_request(:getRecordings, options)
 
       formatter = BigBlueButtonFormatter.new(response)
@@ -632,7 +641,7 @@ module BigBlueButton
     # API's are equal if all the following attributes are equal.
     def ==(other)
       r = true
-      [:url, :supported_versions, :secret, :version, :debug].each do |param|
+      [:url, :supported_versions, :secret, :version, :logger].each do |param|
         r = r && self.send(param) == other.send(param)
       end
       r
@@ -739,7 +748,7 @@ module BigBlueButton
     # Otherwise uses GET
     def send_request(url, data=nil)
       begin
-        puts "BigBlueButtonAPI: URL request = #{url}" if @debug
+        @logger.debug("BigBlueButtonAPI: URL request = #{url}")
         url_parsed = URI.parse(url)
         http = Net::HTTP.new(url_parsed.host, url_parsed.port)
         http.open_timeout = @timeout
@@ -749,17 +758,22 @@ module BigBlueButton
         if data.nil?
           response = http.get(url_parsed.request_uri, @request_headers)
         else
-          puts "BigBlueButtonAPI: Sending as a POST request with data.size = #{data.size}" if @debug
-          opts = { 'Content-Type' => 'application/x-www-form-urlencoded' }.merge @request_headers
+          @logger.debug("BigBlueButtonAPI: Sending as a POST request with data.size = #{data.size}")
+          opts = { 'Content-Type' => 'application/xml' }.merge @request_headers
           response = http.post(url_parsed.request_uri, data, opts)
         end
-        puts "BigBlueButtonAPI: URL response = #{response.body}" if @debug
+        @logger.info("BigBlueButtonAPI: request=#{url} response_status=#{response.class.name} response_code=#{response.code}  message_key=#{response.message}")
+        @logger.debug("BigBlueButtonAPI: URL response = #{response.body}")
 
-      rescue TimeoutError => error
-        raise BigBlueButtonException.new("Timeout error. Your server is probably down: \"#{@url}\". Error: #{error}")
+      rescue Timeout::Error => error
+        exception = BigBlueButtonException.new("Timeout error. Your server is probably down: \"#{@url}\". Error: #{error}")
+        exception.key = 'TimeoutError'
+        raise exception
 
       rescue Exception => error
-        raise BigBlueButtonException.new("Connection error. Your URL is probably incorrect: \"#{@url}\". Error: #{error}")
+        exception = BigBlueButtonException.new("Connection error. Your URL is probably incorrect: \"#{@url}\". Error: #{error}")
+        exception.key = 'IncorrectUrlError'
+        raise exception
       end
 
       response
@@ -775,7 +789,9 @@ module BigBlueButton
 
       # we don't allow older versions than the one supported, use an old version of the gem for that
       if Gem::Version.new(version) < Gem::Version.new(@supported_versions[0])
-        raise BigBlueButtonException.new("BigBlueButton error: Invalid API version #{version}. Supported versions: #{@supported_versions.join(', ')}")
+        exception = BigBlueButtonException.new("BigBlueButton error: Invalid API version #{version}. Supported versions: #{@supported_versions.join(', ')}")
+        exception.key = 'APIVersionError'
+        raise exception
 
       # allow newer versions by using the newest one we support
       elsif Gem::Version.new(version) > Gem::Version.new(@supported_versions.last)

data/lib/bigbluebutton_config_layout.rb

@@ -29,7 +29,9 @@ module BigBlueButton
       begin
         @xml = XmlSimple.xml_in(xml, opts)
       rescue Exception => e
-        raise BigBlueButton::BigBlueButtonException.new("Error parsing the layouts XML. Error: #{e.message}")
+        exception = BigBlueButton::BigBlueButtonException.new("Error parsing the layouts XML. Error: #{e.message}")
+        exception.key = 'XMLParsingError'
+        raise exception
       end
     end
 

data/lib/bigbluebutton_config_xml.rb

@@ -33,7 +33,9 @@ module BigBlueButton
           @xml = XmlSimple.xml_in(xml, opts)
           @original_string = self.as_string.clone
         rescue Exception => e
-          raise BigBlueButton::BigBlueButtonException.new("Error parsing the config XML. Error: #{e.message}")
+          exception = BigBlueButton::BigBlueButtonException.new("Error parsing the config XML. Error: #{e.message}")
+          exception.key = 'XMLParsingError'
+          raise exception
         end
       end
     end

data/lib/bigbluebutton_exception.rb

@@ -1,6 +1,6 @@
 module BigBlueButton
 
-  class BigBlueButtonException < Exception
+  class BigBlueButtonException < StandardError
     attr_accessor :key
 
     def to_s

data/lib/bigbluebutton_formatter.rb

@@ -49,7 +49,9 @@ module BigBlueButton
         if value.is_a?(Numeric)
           result = value == 0 ? nil : DateTime.parse(Time.at(value/1000.0).to_s)
         else
-          if value.downcase == "null"
+          if (value.is_a?(Hash) || value.is_a?(Array)) && value.empty?
+            result = nil
+          elsif value.is_a?(String) && (value.empty? || value.downcase == 'null')
             result = nil
           else
             # note: just in case the value comes as a string in the format: "Thu Sep 01 17:51:42 UTC 2011"

data/lib/bigbluebutton_hash_to_xml.rb

@@ -10,7 +10,9 @@ module BigBlueButton
           hash = XmlSimple.xml_in(xml_io, opts)
           return symbolize_keys(hash)
         rescue Exception => e
-          raise BigBlueButtonException.new("Impossible to convert XML to hash. Error: #{e.message}")
+          exception = BigBlueButtonException.new("Impossible to convert XML to hash. Error: #{e.message}")
+          exception.key = 'XMLConversionError'  
+          raise exception
         end
       end
 

data/spec/bigbluebutton_api_0.81_spec.rb

@@ -7,8 +7,7 @@ describe BigBlueButton::BigBlueButtonApi do
   let(:url) { "http://server.com" }
   let(:secret) { "1234567890abcdefghijkl" }
   let(:version) { "0.81" }
-  let(:debug) { false }
-  let(:api) { BigBlueButton::BigBlueButtonApi.new(url, secret, version, debug) }
+  let(:api) { BigBlueButton::BigBlueButtonApi.new(url, secret, version) }
 
   describe "#get_default_config_xml" do
     let(:response) { "<response><returncode>1</returncode></response>" }

data/spec/bigbluebutton_api_0.9_spec.rb

@@ -7,8 +7,7 @@ describe BigBlueButton::BigBlueButtonApi do
   let(:url) { "http://server.com" }
   let(:secret) { "1234567890abcdefghijkl" }
   let(:version) { "0.9" }
-  let(:debug) { false }
-  let(:api) { BigBlueButton::BigBlueButtonApi.new(url, secret, version, debug) }
+  let(:api) { BigBlueButton::BigBlueButtonApi.new(url, secret, version) }
 
   describe "#create_meeting" do
     context "accepts the new parameters" do

data/spec/bigbluebutton_api_spec.rb

@@ -9,16 +9,17 @@ describe BigBlueButton::BigBlueButtonApi do
     # default variables and API object for all tests
     let(:url) { "http://server.com" }
     let(:secret) { "1234567890abcdefghijkl" }
-    let(:debug) { false }
-    let(:api) { BigBlueButton::BigBlueButtonApi.new(url, secret, version, debug) }
+    let(:logger) { Logger.new(STDOUT) }
+    let(:api) { BigBlueButton::BigBlueButtonApi.new(url, secret, version, logger) }
+    before { logger.level = Logger::INFO }
 
     describe "#initialize" do
       context "standard initialization" do
-        subject { BigBlueButton::BigBlueButtonApi.new(url, secret, version, debug) }
+        subject { BigBlueButton::BigBlueButtonApi.new(url, secret, version, logger) }
         it { subject.url.should == url }
         it { subject.secret.should == secret }
         it { subject.version.should == version }
-        it { subject.debug.should == debug }
+        it { subject.logger.should == logger }
         it { subject.timeout.should == 10 }
         it { subject.supported_versions.should include("0.8") }
         it { subject.supported_versions.should include("0.81") }
@@ -350,14 +351,14 @@ describe BigBlueButton::BigBlueButtonApi do
     end
 
     describe "#==" do
-      let(:api2) { BigBlueButton::BigBlueButtonApi.new(url, secret, version, debug) }
+      let(:api2) { BigBlueButton::BigBlueButtonApi.new(url, secret, version, logger) }
 
       context "compares attributes" do
         it { api.should == api2 }
       end
 
-      context "differs #debug" do
-        before { api2.debug = !api.debug }
+      context "differs #logger" do
+        before { api2.logger = !api.logger }
         it { api.should_not == api2 }
       end
 
@@ -559,17 +560,19 @@ describe BigBlueButton::BigBlueButtonApi do
     describe "#send_request" do
       let(:url) { "http://test-server:8080/res?param1=value1&checksum=12345" }
       let(:url_parsed) { URI.parse(url) }
+      let(:res) { Net::HTTPResponse.new(1.0, '200', 'OK') }
 
       before do
         @http_mock = mock(Net::HTTP)
         @http_mock.should_receive(:"open_timeout=").with(api.timeout)
         @http_mock.should_receive(:"read_timeout=").with(api.timeout)
         Net::HTTP.should_receive(:new).with("test-server", 8080).and_return(@http_mock)
+        res.stub(:body) { "ok" }
       end
 
       context "standard case" do
-        before { @http_mock.should_receive(:get).with("/res?param1=value1&checksum=12345", {}).and_return("ok") }
-        it { api.send(:send_request, url).should == "ok" }
+        before { @http_mock.should_receive(:get).with("/res?param1=value1&checksum=12345", {}).and_return(res) }
+        it { api.send(:send_request, url).should == res }
       end
 
       context "handles a TimeoutError" do
@@ -586,20 +589,20 @@ describe BigBlueButton::BigBlueButtonApi do
         let(:data) { "any data" }
         before {
           path = "/res?param1=value1&checksum=12345"
-          opts = { 'Content-Type' => 'application/x-www-form-urlencoded' }
-          @http_mock.should_receive(:post).with(path, data, opts).and_return("ok")
+          opts = { 'Content-Type' => 'application/xml' }
+          @http_mock.should_receive(:post).with(path, data, opts).and_return(res)
         }
         it {
-          api.send(:send_request, url, data).should == "ok"
+          api.send(:send_request, url, data).should == res
         }
       end
 
       context "get with headers" do
         let(:headers_hash) { { :anything => "anything" } }
-        before { @http_mock.should_receive(:get).with("/res?param1=value1&checksum=12345", headers_hash).and_return("ok") }
+        before { @http_mock.should_receive(:get).with("/res?param1=value1&checksum=12345", headers_hash).and_return(res) }
         it {
           api.request_headers = headers_hash
-          api.send(:send_request, url).should == "ok"
+          api.send(:send_request, url).should == res
         }
       end
 
@@ -608,12 +611,12 @@ describe BigBlueButton::BigBlueButtonApi do
         let(:data) { "any data" }
         before {
           path = "/res?param1=value1&checksum=12345"
-          opts = { 'Content-Type' => 'application/x-www-form-urlencoded', :anything => "anything" }
-          @http_mock.should_receive(:post).with(path, data, opts).and_return("ok")
+          opts = { 'Content-Type' => 'application/xml', :anything => "anything" }
+          @http_mock.should_receive(:post).with(path, data, opts).and_return(res)
         }
         it {
           api.request_headers = headers_hash
-          api.send(:send_request, url, data).should == "ok"
+          api.send(:send_request, url, data).should == res
         }
       end
     end

data/spec/bigbluebutton_formatter_spec.rb

@@ -100,14 +100,43 @@ describe BigBlueButton::BigBlueButtonFormatter do
     it { hash[:param7].should == nil }
     it { hash[:param8].should == nil }
 
-    context "returns nil if the param doesn't exists" do
-      subject { BigBlueButton::BigBlueButtonFormatter.new({ :param => 1}) }
-      it { subject.to_datetime(:inexistent).should == nil }
-    end
+    context "returns nil if" do
+      context "the param doesn't exists" do
+        subject { BigBlueButton::BigBlueButtonFormatter.new({ :param => 1}) }
+        it { subject.to_datetime(:inexistent).should == nil }
+      end
 
-    context "returns nil if the hash is nil" do
-      subject { BigBlueButton::BigBlueButtonFormatter.new(nil) }
-      it { subject.to_datetime(:inexistent).should == nil }
+      context "the hash is nil" do
+        subject { BigBlueButton::BigBlueButtonFormatter.new(nil) }
+        it { subject.to_datetime(:inexistent).should == nil }
+      end
+
+      context "the value is an empty string" do
+        subject { BigBlueButton::BigBlueButtonFormatter.new({ param1: '' }) }
+        it { subject.to_datetime(:param1).should == nil }
+      end
+
+      context "the value is nil" do
+        subject { BigBlueButton::BigBlueButtonFormatter.new({ param1: nil }) }
+        it { subject.to_datetime(:param1).should == nil }
+      end
+
+      context "the value is an empty hash" do
+        subject { BigBlueButton::BigBlueButtonFormatter.new({ param1: {} }) }
+        it { subject.to_datetime(:param1).should == nil }
+      end
+
+      context "the value is an empty array" do
+        subject { BigBlueButton::BigBlueButtonFormatter.new({ param1: [] }) }
+        it { subject.to_datetime(:param1).should == nil }
+      end
+
+      ['null', 'NULL'].each do |v|
+        context "the value is '#{v}'" do
+          subject { BigBlueButton::BigBlueButtonFormatter.new({ param1: v }) }
+          it { subject.to_datetime(:param1).should == nil }
+        end
+      end
     end
   end
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: bigbluebutton-api-ruby
 version: !ruby/object:Gem::Version
-  version: 1.7.0
+  version: 1.8.0
 platform: ruby
 authors:
 - Mconf
@@ -9,8 +9,92 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2018-08-17 00:00:00.000000000 Z
+date: 2021-12-06 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: childprocess
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.0.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.0.1
+- !ruby/object:Gem::Dependency
+  name: ffi
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.9.24
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.9.24
+- !ruby/object:Gem::Dependency
+  name: json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.8.6
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.8.6
+- !ruby/object:Gem::Dependency
+  name: nokogiri
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.10.4
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.10.4
+- !ruby/object:Gem::Dependency
+  name: rack
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.6.11
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.6.11
+- !ruby/object:Gem::Dependency
+  name: rubyzip
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.3.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.3.0
 - !ruby/object:Gem::Dependency
   name: xml-simple
   requirement: !ruby/object:Gem::Requirement
@@ -43,6 +127,7 @@ files:
 - ".ruby-version"
 - ".travis.yml"
 - CHANGELOG.md
+- Dockerfile
 - Gemfile
 - Gemfile.lock
 - LICENSE
@@ -50,6 +135,7 @@ files:
 - README.md
 - Rakefile
 - bigbluebutton-api-ruby.gemspec
+- docker-compose.yml
 - examples/config_xml.rb
 - examples/create.rb
 - examples/get_version_example.rb
@@ -113,8 +199,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.4.5
+rubygems_version: 3.0.3
 signing_key: 
 specification_version: 4
 summary: BigBlueButton integration for ruby