2021-11-04 Fred Gleason <fredg@paravelsystems.com>

* Added a 'rivwebpyapi' API.

Signed-off-by: Fred Gleason <fredg@paravelsystems.com>
This commit is contained in:
Fred Gleason 2021-11-04 19:36:53 -04:00
parent 9231829495
commit 0b5a5e7807
9 changed files with 255 additions and 2 deletions

View File

@ -22571,3 +22571,5 @@
2021-10-28 Fred Gleason <fredg@paravelsystems.com>
* Moved the 'Daylight Saving Time Considerations' section in the
Operations Guide to after the 'The RDCatch Main Window' section.
2021-11-04 Fred Gleason <fredg@paravelsystems.com>
* Added a 'rivwebpyapi' API.

View File

@ -2,7 +2,7 @@
##
## Makefile.am for rivendell/apis
##
## (C) Copyright 2018 Fred Gleason <fredg@paravelsystems.com>
## (C) Copyright 2018-2021 Fred Gleason <fredg@paravelsystems.com>
##
## This program is free software; you can redistribute it and/or modify
## it under the terms of the GNU General Public License as
@ -21,7 +21,8 @@
## Use automake to process this into a Makefile.in
SUBDIRS = pypad\
rivwebcapi
rivwebcapi\
rivwebpyapi
CLEANFILES = *~\
*.idb\

View File

@ -0,0 +1,39 @@
## Makefile.am
##
## Automake.am for Python binding for the Rivendell Web API
##
## (C) Copyright 2021 Fred Gleason <fredg@paravelsystems.com>
##
## This program is free software; you can redistribute it and/or modify
## it under the terms of the GNU General Public License as
## published by the Free Software Foundation; either version 2 of
## the License, or (at your option) any later version.
##
## This program is distributed in the hope that it will be useful,
## but WITHOUT ANY WARRANTY; without even the implied warranty of
## MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
## GNU General Public License for more details.
##
## You should have received a copy of the GNU General Public
## License along with this program; if not, write to the Free Software
## Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
##
## Use automake to process this into a Makefile.in
SUBDIRS = api\
tests
CLEANFILES = *~\
*.idb\
*ilk\
*.obj\
*.pdb\
*.qm\
moc_*
MAINTAINERCLEANFILES = *~\
*.tar.gz\
aclocal.m4\
configure\
Makefile.in\
moc_*

View File

@ -0,0 +1,39 @@
## Makefile.am
##
## Automake.am for Python binding for the Rivendell Web API
##
## (C) Copyright 2021 Fred Gleason <fredg@paravelsystems.com>
##
## This program is free software; you can redistribute it and/or modify
## it under the terms of the GNU General Public License as
## published by the Free Software Foundation; either version 2 of
## the License, or (at your option) any later version.
##
## This program is distributed in the hope that it will be useful,
## but WITHOUT ANY WARRANTY; without even the implied warranty of
## MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
## GNU General Public License for more details.
##
## You should have received a copy of the GNU General Public
## License along with this program; if not, write to the Free Software
## Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
##
## Use automake to process this into a Makefile.in
rivendelldir = $(pyexecdir)
rivendell_PYTHON = rivwebpyapi.py
CLEANFILES = *~\
*.idb\
*ilk\
*.obj\
*.pdb\
*.qm\
moc_*
MAINTAINERCLEANFILES = *~\
*.tar.gz\
aclocal.m4\
configure\
Makefile.in\
moc_*

View File

@ -0,0 +1,69 @@
# pypad.py
#
# Python binding for the Rivendell Web API
#
# (C) Copyright 2021 Fred Gleason <fredg@paravelsystems.com>
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License version 2 as
# published by the Free Software Foundation.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public
# License along with this program; if not, write to the Free Software
# Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
#
import requests
import untangle
class RivWebPyApi(object):
"""
Create a 'RivWebPyApi' object for accessing the Web API.
"""
def __init__(self,url,username,passwd):
"""
Initialize a WebAPI connection to a Rivendell instance.
Takes three arguments:
url - The URL of the service. Typically of the form
'http://rivendell.example.com/rd-bin/rdxport.cgi' (string).
username - The Rivendell Username to connect as (string).
password - The password for the specified Rivendell Username
(string).
"""
self.__connection_url=url
self.__connection_username=username
self.__connection_password=passwd
def ListServices(self,trackable):
"""
Returns a list of Rivendell services (Element).
Takes one argument:
trackable - Boolean. If True, return will include only services that
are configured to support voice tracking. If False,
all configured services will be included.
"""
trackarg='0'
if(trackable):
trackarg='1'
postdata={
'COMMAND': '21',
'LOGIN_NAME': self.__connection_username,
'PASSWORD': self.__connection_password,
'TRACKABLE': trackarg
}
r=requests.post(self.__connection_url,data=postdata)
if(r.status_code!=requests.codes.ok):
r.raise_for_status()
return untangle.parse(r.text)

View File

@ -0,0 +1,38 @@
## Makefile.am
##
## Automake.am for Python binding for the Rivendell Web API
##
## (C) Copyright 2021 Fred Gleason <fredg@paravelsystems.com>
##
## This program is free software; you can redistribute it and/or modify
## it under the terms of the GNU General Public License as
## published by the Free Software Foundation; either version 2 of
## the License, or (at your option) any later version.
##
## This program is distributed in the hope that it will be useful,
## but WITHOUT ANY WARRANTY; without even the implied warranty of
## MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
## GNU General Public License for more details.
##
## You should have received a copy of the GNU General Public
## License along with this program; if not, write to the Free Software
## Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
##
## Use automake to process this into a Makefile.in
EXTRA_DIST = list_services.py
CLEANFILES = *~\
*.idb\
*ilk\
*.obj\
*.pdb\
*.qm\
moc_*
MAINTAINERCLEANFILES = *~\
*.tar.gz\
aclocal.m4\
configure\
Makefile.in\
moc_*

View File

@ -0,0 +1,61 @@
#!%PYTHON_BANGPATH%
# login_test.py
#
# RivWebPyApi test script for Rivendell
#
# Attempt to log in to the Rivendell Web API
#
# (C) Copyright 2021 Fred Gleason <fredg@paravelsystems.com>
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License version 2 as
# published by the Free Software Foundation.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public
# License along with this program; if not, write to the Free Software
# Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
#
import getpass
import rivwebpyapi
import sys
url='';
username=''
password=''
#
# Get login parameters
#
usage='login_test --url=<rd-url> --username=<rd-username>'
for arg in sys.argv:
f0=arg.split('=')
if(len(f0)==2):
if(f0[0]=='--url'):
url=f0[1]
if(f0[0]=='--username'):
username=f0[1]
if(f0[0]=='--password'):
password=f0[1]
if(not password):
password=getpass.getpass()
if((not url)or(not username)):
print(usage)
sys.exit(1)
webapi=rivwebpyapi.RivWebPyApi(url=url,username=username,passwd=password)
services=webapi.ListServices(False)
for svc in services.serviceList.service:
print('NAME: '+svc.name.cdata)
if(svc.description.cdata):
print('DESCRIPTION: '+svc.description.cdata)
else:
print('DESCRIPTION: [none]')
print('')

View File

@ -0,0 +1 @@
../api/rivwebpyapi.py

View File

@ -610,6 +610,9 @@ AC_CONFIG_FILES([rivendell.spec \
apis/rivwebcapi/rivwebcapi.pc \
apis/rivwebcapi/rivwebcapi/Makefile \
apis/rivwebcapi/tests/Makefile \
apis/rivwebpyapi/Makefile \
apis/rivwebpyapi/api/Makefile \
apis/rivwebpyapi/tests/Makefile \
lib/rdpaths.h \
lib/Makefile \
rdhpi/Makefile \