A module for reading bbb meetings from bbb servers
Project description
bbbmeetings
A Library that helps with reading information regarding Big Blue Button via the BBB-API. The goal of bbbmeetings is to make it easy to generate stats about one or more BBB-Instances.
It was a non-goal to create a full coverage of the BBB-API, for ending meetings, creating meetings, managing recordings etc.
Installation
Via pip
pip install bbbmeetings
Usage
First we need to create a BBB Server. To allow the connection with that server you need to know its secret, which can be found using bbb-conf -- secret
as mentioned here. You can create a server like this:
from bbbmeetings import BBBServer
server = BBBServer(host="https://bbb.example.org", secret="!#%Random!#$%Fsecret!#$%")
For convenience bbbmeetings offers a way of treating multiple servers as one server:
from bbbmeetings import BBBServers, BBBServer
# Create a BBBServers Object from multiple BBBServer-Objects
servers = BBBServers.from_list([
BBBServer("https://bbb1.example.org", "!#%Random!#$%Fsecret!#$%"),
BBBServer("https://bbb2.example.org", "!#%Random!#$%Fsecret!#$%"),
BBBServer("https://bbb3.example.org", "!#%Random!#$%Fsecret!#$%"),
BBBServer("https://bbb4.example.org", "!#%Random!#$%Fsecret!#$%"),
BBBServer("https://bbb5.example.org", "!#%Random!#$%Fsecret!#$%"),
])
Most methods on BBBServer
and BBBServers
are the same, but in the following examples I will use servers
to showcase how this module may be used:
# Get a list of meetings running on all servers and print all details about them
for meeting in servers.meetings:
print(meeting)
You can also get some numbers directly (in this case I use python's formatting strings):
print(f"On all servers there are {servers.people} people in {servers.n_meetings} meetings. {servers.video_active} people have their webcam on, {servers.connected_with_mic} connected with mic. There are {servers.moderators} moderators.")
If you want to have a list of all people in all meetings on all servers run:
print(f"The names of everyone on all servers are {', '.join([a.name for a in servers.attendees])}")
If you just want a list with the names of Presenters you can run:
presenter_names = [a.name for a in servers.attendees if a.isPresenter]
Or if you want to know the longest running meeting:
print(f"Longest running meeting is {servers.longest_duration.name} with a duration of {servers.longest_duration.duration}")
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for bbbmeetings-0.1.4-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | fd68363f85019f10e970626faaede4af2e1c862996063f1d25b75b0b5995a686 |
|
MD5 | 196eeaa7a78b1b434517062a96aa8901 |
|
BLAKE2b-256 | c8f0929fb4eb246deee6d1010600e2bb30c8a554ca30d490d23e4dfd97e7a457 |