2021-12-07 Fred Gleason <fredg@paravelsystems.com>

* Added a 'RivWebPyError' exception type to the 'rivwebpyapi' API.
	* Modified the 'rivwebpyapi.AddCart()' method to return a single
	dictionary.
	* Modified the 'rivwebpyapi.AddCut()' method to return a single
	dictionary.
	* Modified the 'rivwebpyapi.AudioInfo()' method to return a single
	dictionary.
	* Modified the 'rivwebpyapi.AssignSchedCode()' method to return a
	single dictionary.
	* Modified the 'rivwebpyapi.AudioStore()' method to return a single
	dictionary.
	* Modified the 'rivwebpyapi.ListCart()' method to return a single
	dictionary.
	* Modified the 'rivwebpyapi.ListCut()' method to return a single
	dictionary.
	* Modified the 'rivwebpyapi.ListGroup()' method to return a single
	dictionary.
	* Modified the 'rivwebpyapi.ListSystemSettings()' method to return a
	single dictionary.

Signed-off-by: Fred Gleason <fredg@paravelsystems.com>

apis/rivwebpyapi/tests/add_cart.py

@@ -25,12 +25,14 @@
 import getpass
 import rivwebpyapi
 import sys
+def eprint(*args,**kwargs):
+    print(*args,file=sys.stderr,**kwargs)
 
 url='';
 username=''
 password=''
 cart_number=0
-cart_type='audio'
+cart_type=''
 group_name=''
 
 #
@@ -56,47 +58,63 @@ for arg in sys.argv:
 if(not password):
     password=getpass.getpass()
 if((not url)or(not username)):
-    print(usage)
+    eprint(usage)
+    sys.exit(1)
+if(not group_name):
+    eprint('you must supply "--group-name"')
+    sys.exit(1)
+if(not cart_type):
+    eprint('you must supply "--cart-type"')
+    sys.exit(1)
+if(cart_number==0):
+    eprint('you must supply "--cart-number"')
     sys.exit(1)
 
 #
 # Get the cut list
 #
 webapi=rivwebpyapi.rivwebpyapi(url=url,username=username,password=password)
-carts=webapi.AddCart(group_name=group_name,cart_type=cart_type,cart_number=cart_number)
+try:
+    cart=webapi.AddCart(group_name=group_name,cart_type=cart_type,cart_number=cart_number)
+except rivwebpyapi.RivWebPyError as err:
+    eprint('*** ERROR ***')
+    eprint('Response Code: '+str(err.responseCode))
+    eprint('ErrorString: '+str(err.errorString))
+    eprint('*************')
+    eprint('')
+    sys.exit(1)
 
 #
 # Display the cart list
 #
-for cart in carts:
-    print('ADDED')
-    print('number: '+str(cart['number']))
-    print('type: '+str(cart['type']))
-    print('groupName: '+str(cart['groupName']))
-    print('title: '+str(cart['title']))
-    print('artist: '+str(cart['artist']))
-    print('album: '+str(cart['album']))
-    print('year: '+str(cart['year']))
-    print('label: '+str(cart['label']))
-    print('client: '+str(cart['client']))
-    print('agency: '+str(cart['agency']))
-    print('publisher: '+str(cart['publisher']))
-    print('composer: '+str(cart['composer']))
-    print('conductor: '+str(cart['conductor']))
-    print('userDefined: '+str(cart['userDefined']))
-    print('usageCode: '+str(cart['usageCode']))
-    print('forcedLength: '+str(cart['forcedLength']))
-    print('averageLength: '+str(cart['averageLength']))
-    print('lengthDeviation: '+str(cart['lengthDeviation']))
-    print('averageSegueLength: '+str(cart['averageSegueLength']))
-    print('averageHookLength: '+str(cart['averageHookLength']))
-    print('minimumTalkLength: '+str(cart['minimumTalkLength']))
-    print('maximumTalkLength: '+str(cart['maximumTalkLength']))
-    print('cutQuantity: '+str(cart['cutQuantity']))
-    print('lastCutPlayed: '+str(cart['lastCutPlayed']))
-    print('enforceLength: '+str(cart['enforceLength']))
-    print('asyncronous: '+str(cart['asyncronous']))
-    print('owner: '+str(cart['owner']))
-    print('metadataDatetime: '+str(cart['metadataDatetime']))
-    print('songId: '+str(cart['songId']))
-    print('')
+print('ADDED')
+print('number: '+str(cart['number']))
+print('type: '+str(cart['type']))
+print('groupName: '+str(cart['groupName']))
+print('title: '+str(cart['title']))
+print('artist: '+str(cart['artist']))
+print('album: '+str(cart['album']))
+print('year: '+str(cart['year']))
+print('label: '+str(cart['label']))
+print('client: '+str(cart['client']))
+print('agency: '+str(cart['agency']))
+print('publisher: '+str(cart['publisher']))
+print('composer: '+str(cart['composer']))
+print('conductor: '+str(cart['conductor']))
+print('userDefined: '+str(cart['userDefined']))
+print('usageCode: '+str(cart['usageCode']))
+print('forcedLength: '+str(cart['forcedLength']))
+print('averageLength: '+str(cart['averageLength']))
+print('lengthDeviation: '+str(cart['lengthDeviation']))
+print('averageSegueLength: '+str(cart['averageSegueLength']))
+print('averageHookLength: '+str(cart['averageHookLength']))
+print('minimumTalkLength: '+str(cart['minimumTalkLength']))
+print('maximumTalkLength: '+str(cart['maximumTalkLength']))
+print('cutQuantity: '+str(cart['cutQuantity']))
+print('lastCutPlayed: '+str(cart['lastCutPlayed']))
+print('enforceLength: '+str(cart['enforceLength']))
+print('asyncronous: '+str(cart['asyncronous']))
+print('owner: '+str(cart['owner']))
+print('metadataDatetime: '+str(cart['metadataDatetime']))
+print('songId: '+str(cart['songId']))
+print('')