diff options
Diffstat (limited to 'python-bbbmon.spec')
| -rw-r--r-- | python-bbbmon.spec | 339 |
1 files changed, 339 insertions, 0 deletions
diff --git a/python-bbbmon.spec b/python-bbbmon.spec new file mode 100644 index 0000000..926c0d3 --- /dev/null +++ b/python-bbbmon.spec @@ -0,0 +1,339 @@ +%global _empty_manifest_terminate_build 0 +Name: python-bbbmon +Version: 0.1.33 +Release: 1 +Summary: A small CLI utility to monitor bbb usage +License: GPL-3.0+ +URL: https://pypi.org/project/bbbmon/ +Source0: https://mirrors.nju.edu.cn/pypi/web/packages/63/cb/87c944c6ad4c216a5978cf398ab5a7497d6eaba2307d0970e9176c4c7444/bbbmon-0.1.33.tar.gz +BuildArch: noarch + +Requires: python3-requests +Requires: python3-click +Requires: python3-click-help-colors + +%description +# bbbmon + +A small python based CLI utility to monitor BigBlueButton-Usage. + +## Installation + +The easiest way to install bbbmon is to install it from the Python Package Index (PyPi). This project uses [python poetry](https://python-poetry.org/) for dependency management, so you could also run it without installing the package system wide, see instructions below. + +## Install with pip3 + +```bash +sudo pip3 install bbbmon --upgrade +``` + +Then run with: + +```bash +bbbmon +``` + +## Run with poetry (without pip) + +Clone the repo: + +```bash +git clone https://code.hfbk.net/bbb/bbbmon.git +``` + +Make sure you have poetry installed. Install instruction for poetry can be [found here](https://python-poetry.org/docs/#installation). +From inside the project directory run: + +```bash +poetry install +``` + +Run bbbmon with: + +```bash +poetry run bbbmon +``` + + + +# Configuration + +Run `bbbmon config --new` to create a new default configuration file. bbbmon will always ask you before it creates or overwrites anything. + +Within the config you can define one or more endpoints with running bbb instances – each with it's secret and bigbluebutton-URL. You can find the secret on your server in it's config-file via + +```bash +cat /usr/share/bbb-web/WEB-INF/classes/bigbluebutton.properties | grep securitySalt= +``` + +A example configuration file could look like this: +```toml +[bbb.example.com] +securitySalt=MY_SUPER_SECRET_SECRET +bigbluebutton.web.serverURL=https://bbb.example.com/ + +[Föö] +securitySalt=MY_SUPER_SECRET_SECRET2 +bigbluebutton.web.serverURL=https://bbb.foo.com/ +``` +The section names in the square brackets can be chosen arbitrarily (as long as they are unique) and will be used as display names (they support utf-8). It makes sense to keep them short as they can be used for filtering and/or ordering: + +```bash +bbbmon meetings -e Föö +``` + + + +# Usage + +For help run: + +```bash +bbbmon -h +``` + +bbbmon supports command abbreviations – these commands produce the same result: + +```bash +bbbmon meetings +bbbmon meeting +bbbmon mee +bbbmon m +``` + +This works as long as there is no other command starting with the same letters. + +%package -n python3-bbbmon +Summary: A small CLI utility to monitor bbb usage +Provides: python-bbbmon +BuildRequires: python3-devel +BuildRequires: python3-setuptools +BuildRequires: python3-pip +%description -n python3-bbbmon +# bbbmon + +A small python based CLI utility to monitor BigBlueButton-Usage. + +## Installation + +The easiest way to install bbbmon is to install it from the Python Package Index (PyPi). This project uses [python poetry](https://python-poetry.org/) for dependency management, so you could also run it without installing the package system wide, see instructions below. + +## Install with pip3 + +```bash +sudo pip3 install bbbmon --upgrade +``` + +Then run with: + +```bash +bbbmon +``` + +## Run with poetry (without pip) + +Clone the repo: + +```bash +git clone https://code.hfbk.net/bbb/bbbmon.git +``` + +Make sure you have poetry installed. Install instruction for poetry can be [found here](https://python-poetry.org/docs/#installation). +From inside the project directory run: + +```bash +poetry install +``` + +Run bbbmon with: + +```bash +poetry run bbbmon +``` + + + +# Configuration + +Run `bbbmon config --new` to create a new default configuration file. bbbmon will always ask you before it creates or overwrites anything. + +Within the config you can define one or more endpoints with running bbb instances – each with it's secret and bigbluebutton-URL. You can find the secret on your server in it's config-file via + +```bash +cat /usr/share/bbb-web/WEB-INF/classes/bigbluebutton.properties | grep securitySalt= +``` + +A example configuration file could look like this: +```toml +[bbb.example.com] +securitySalt=MY_SUPER_SECRET_SECRET +bigbluebutton.web.serverURL=https://bbb.example.com/ + +[Föö] +securitySalt=MY_SUPER_SECRET_SECRET2 +bigbluebutton.web.serverURL=https://bbb.foo.com/ +``` +The section names in the square brackets can be chosen arbitrarily (as long as they are unique) and will be used as display names (they support utf-8). It makes sense to keep them short as they can be used for filtering and/or ordering: + +```bash +bbbmon meetings -e Föö +``` + + + +# Usage + +For help run: + +```bash +bbbmon -h +``` + +bbbmon supports command abbreviations – these commands produce the same result: + +```bash +bbbmon meetings +bbbmon meeting +bbbmon mee +bbbmon m +``` + +This works as long as there is no other command starting with the same letters. + +%package help +Summary: Development documents and examples for bbbmon +Provides: python3-bbbmon-doc +%description help +# bbbmon + +A small python based CLI utility to monitor BigBlueButton-Usage. + +## Installation + +The easiest way to install bbbmon is to install it from the Python Package Index (PyPi). This project uses [python poetry](https://python-poetry.org/) for dependency management, so you could also run it without installing the package system wide, see instructions below. + +## Install with pip3 + +```bash +sudo pip3 install bbbmon --upgrade +``` + +Then run with: + +```bash +bbbmon +``` + +## Run with poetry (without pip) + +Clone the repo: + +```bash +git clone https://code.hfbk.net/bbb/bbbmon.git +``` + +Make sure you have poetry installed. Install instruction for poetry can be [found here](https://python-poetry.org/docs/#installation). +From inside the project directory run: + +```bash +poetry install +``` + +Run bbbmon with: + +```bash +poetry run bbbmon +``` + + + +# Configuration + +Run `bbbmon config --new` to create a new default configuration file. bbbmon will always ask you before it creates or overwrites anything. + +Within the config you can define one or more endpoints with running bbb instances – each with it's secret and bigbluebutton-URL. You can find the secret on your server in it's config-file via + +```bash +cat /usr/share/bbb-web/WEB-INF/classes/bigbluebutton.properties | grep securitySalt= +``` + +A example configuration file could look like this: +```toml +[bbb.example.com] +securitySalt=MY_SUPER_SECRET_SECRET +bigbluebutton.web.serverURL=https://bbb.example.com/ + +[Föö] +securitySalt=MY_SUPER_SECRET_SECRET2 +bigbluebutton.web.serverURL=https://bbb.foo.com/ +``` +The section names in the square brackets can be chosen arbitrarily (as long as they are unique) and will be used as display names (they support utf-8). It makes sense to keep them short as they can be used for filtering and/or ordering: + +```bash +bbbmon meetings -e Föö +``` + + + +# Usage + +For help run: + +```bash +bbbmon -h +``` + +bbbmon supports command abbreviations – these commands produce the same result: + +```bash +bbbmon meetings +bbbmon meeting +bbbmon mee +bbbmon m +``` + +This works as long as there is no other command starting with the same letters. + +%prep +%autosetup -n bbbmon-0.1.33 + +%build +%py3_build + +%install +%py3_install +install -d -m755 %{buildroot}/%{_pkgdocdir} +if [ -d doc ]; then cp -arf doc %{buildroot}/%{_pkgdocdir}; fi +if [ -d docs ]; then cp -arf docs %{buildroot}/%{_pkgdocdir}; fi +if [ -d example ]; then cp -arf example %{buildroot}/%{_pkgdocdir}; fi +if [ -d examples ]; then cp -arf examples %{buildroot}/%{_pkgdocdir}; fi +pushd %{buildroot} +if [ -d usr/lib ]; then + find usr/lib -type f -printf "/%h/%f\n" >> filelist.lst +fi +if [ -d usr/lib64 ]; then + find usr/lib64 -type f -printf "/%h/%f\n" >> filelist.lst +fi +if [ -d usr/bin ]; then + find usr/bin -type f -printf "/%h/%f\n" >> filelist.lst +fi +if [ -d usr/sbin ]; then + find usr/sbin -type f -printf "/%h/%f\n" >> filelist.lst +fi +touch doclist.lst +if [ -d usr/share/man ]; then + find usr/share/man -type f -printf "/%h/%f.gz\n" >> doclist.lst +fi +popd +mv %{buildroot}/filelist.lst . +mv %{buildroot}/doclist.lst . + +%files -n python3-bbbmon -f filelist.lst +%dir %{python3_sitelib}/* + +%files help -f doclist.lst +%{_docdir}/* + +%changelog +* Thu May 18 2023 Python_Bot <Python_Bot@openeuler.org> - 0.1.33-1 +- Package Spec generated |