Project

bigbluebutton-api-ruby

0.07
Low commit activity in last 3 years
There's a lot of open issues
No release in over a year
bigbluebutton-api-rubymconf/bigbluebutton-api-rubyHomepageDocumentationSource CodeBug TrackerWiki
Provides methods to access BigBlueButton in a ruby application through its API
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Popularity
Downloads
199,941
Stars
49
Forks
39
Watchers
17
 Releases
Current version
1.9.1
Total releases
19
First release
2011-02-08
Latest release
2023-03-31
 Issues
Open Issues
8
Closed Issues
21
Total Issues
29
Issue Closure Rate
72%
 Pull Requests
Open Pull Requests
4
Closed Pull Requests
11
Merged Pull Requests
21
Pull Request Acceptance Rate
58%
 Development
Primary Language
Ruby
Licenses
MIT
Average date of last 50 commits
2021-05-28
Reverse Dependencies
1

 Dependencies

Runtime

xml-simple
~> 1.1
childprocess
>= 1.0.1
ffi
>= 1.9.24
json
>= 1.8.6
nokogiri
>= 1.10.4
rack
>= 1.6.11
rubyzip
>= 1.3.0
 Project Readme

bigbluebutton-api-ruby

This is a ruby gem that provides access to the API of BigBlueButton. See the documentation of the API here.

It enables a ruby application to interact with BigBlueButton by calling ruby methods instead of HTTP requests, making it a lot easier to interact with BigBlueButton. It also formats the responses to a ruby-friendly format and includes helper classes to deal with more complicated API calls, such as the pre-upload of slides.

A few features it has:

  • Provides methods to perform all API calls and get the responses;
  • Converts the XML responses to ruby hashes, that are easier to work with;
  • Converts the string values returned to native ruby types. For instance:
    • Dates are converted DateTime objects (e.g. "Thu Sep 01 17:51:42 UTC 2011");
    • Response codes are converted to boolean (e.g. "SUCCESS" becomes true);
  • Deals with errors (e.g. timeouts) throwing BigBlueButtonException exceptions;
  • Support to multiple BigBlueButton API versions (see below).

Supported versions

This gem is mainly used with Mconf-Web through BigbluebuttonRails. You can always use it as a reference for verions of dependencies and examples of how to use the gem.

BigBlueButton

The current version of this gem supports all the following versions of BigBlueButton:

  • 1.0
  • 0.9 (includes all 0.9.x)
  • 0.81
  • 0.8

Older versions:

  • 0.7 (including 0.7, 0.71 and 0.71a): The last version with support to 0.7* is version 1.2.0. It supports versions 0.7 and 0.8.
  • 0.64: see the branch api-0.64. The last version with support to 0.64 is version 0.0.10. It supports versions 0.64 and 0.7.

Ruby

Tested in rubies:

  • ruby-2.2 recommended
  • ruby-2.1
  • ruby-2.0 (p353)
  • ruby-1.9.3 (p484)
  • ruby-1.9.2 (p290)

Use these versions to be sure it will work. Other patches and patch versions of these rubies (e.g. ruby 1.9.3-p194 or 2.1.2) should work as well.

Releases

For a list of releases and release notes see CHANGELOG.md.

Development

Information for developers of bigbluebutton-api-ruby can be found in our wiki.

The development of this gem is guided by the requirements of the project Mconf. To know more about it visit the project's wiki.

License

Distributed under The MIT License (MIT). See LICENSE for the latest license, valid for all versions after 0.0.4 (including it), and LICENSE_003 for version 0.0.3 and all the previous versions.

Contact

This project is developed as part of Mconf (http://mconf.org).

Mailing list:

Contact: