Merge pull request #8 from sassoftware/david2

Five new tools, replaced listcastables.py, fixed issue #3

README.md

@@ -99,11 +99,16 @@ Additional tools provide more complex functionality by combining multiple calls
 * **listrules.py** list authorization rules subset on a principal and/or a uri
 * **loginviauthinfo.py** use an authinfo file to authenticate to the CLI
 * **updateprefences.py** update preferences for a user or group of users
-* **updatedomain.py** Load a set of userids and passwords to a Viya domain from a csv file
+* **updatedomain.py** load a set of userids and passwords to a Viya domain from a csv file
-* **createfolders.py** Create a set of Viya folders from a csv file 
+* **createfolders.py** create a set of Viya folders from a csv file 
-* **explainaccess.py** Explains access for a folder, object or service endpoint
+* **explainaccess.py** explains access for a folder, object or service endpoint
-* **getpath.py** Return path of folder, report, or other object in folder
+* **getpath.py** return path of folder, report, or other object in folder
 * **listmemberswithpath.py** lists members of a folder, recursively if desired
+* **listcaslibs.py** list all CAS libraries on all servers
+* **listcastables.py** list all CAS tables in all CAS libraries on all servers
+* **listcaslibsandeffectiveaccess.py** list all effective access on all CAS libraries on all servers
+* **listcastablesandeffectiveaccess.py** list all effective access on all CAS tables in all CAS libraries on all servers
+* **listgroupsandmembers.py** list all groups and all their members
 
 Check back for additional tools and if you build a tool feel free to contribute it to the collection.
                    
@@ -246,6 +251,28 @@ FORMAT OF CSV file folder path (parents must exist), description
 \# Return list of all members of a folder identified by objectURI, recursively searching subfolders  
 *./listmemberswithpath.py -u /folders/folders/id -r*
 
+\# Return list of all CAS libraries on all servers  
+*./listcaslibs.py*
+
+\# Return list of all CAS tables in all CAS libraries on all servers  
+*./listcastables.py*
+
+\# Return list of all effective access on all CAS libraries on all servers  
+*./listcaslibsandeffectiveaccess.py*
+
+\# Return list of all effective access on all CAS tables in all CAS libraries on all servers  
+*./listcastablesandeffectiveaccess.py*
+
+\# Return list of members of a folder identified by objectURI  
+*./listmemberswithpath.py -u /folders/folders/id*
+
+\# Return list of all members of a folder identified by objectURI, recursively searching subfolders  
+*./listmemberswithpath.py -u /folders/folders/id -r*
+
+\# Return list of all groups and all their members  
+*./listgroupsandmembers.py*
+
+
 **Troubleshooting**
 
 The most common problem is an expired access token. You may see a message like:
@@ -285,6 +312,7 @@ The file sharedfunctions.py contains a set of generic functions that make it eas
 * data: optionally a python dictionary created from the json for the rest request
 * stoponerror: whether the function will stop all further processing if an error occurs (default 0 to not stop)
 
+We suggest you use listcaslibs_example.py as a simple example to copy from if you wish to develop your own python scripts, and are new to Python or some of the concepts we have used. If one of the other existing tools is similar to what you want, of course you could use that as the basis for a new tool too.
 
 ## Contributing
 

listcaslibs.py

@@ -1,59 +1,82 @@
 #!/usr/bin/python
 # -*- coding: utf-8 -*-
 #
-# listcaslibs.py December 2017
+# listcaslibs.py
+# January 2019
 #
-# listcaslibs an example of how easy it is to build a new tool. This tool is not really needed as you can do this easily with the CLI
+# Usage:
-# it is here for demo purposes. It lists the caslibs and there details accepting the cas server as a parameter
+# listcaslibs.py [--noheader] [-d]
 #
+# Examples:
 #
-# Change History
+# 1. Return list of all CAS libraries on all servers
+#        ./listcaslibs.py
 #
-# 27JAN2017 Comments added
+# Copyright © 2019, SAS Institute Inc., Cary, NC, USA.  All Rights Reserved.
 #
-#
+#  Licensed under the Apache License, Version 2.0 (the License);
-# Copyright © 2018, SAS Institute Inc., Cary, NC, USA.  All Rights Reserved.
+#  you may not use this file except in compliance with the License.
-#
+#  You may obtain a copy of the License at
-#  Licensed under the Apache License, Version 2.0 (the License); you may not use this file except in compliance with the License. You may obtain a copy of the License at
 #
 #      http://www.apache.org/licenses/LICENSE-2.0
 #
-#  Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either 
+#  Unless required by applicable law or agreed to in writing, software
-#  express or implied. See the License for the specific language governing permissions and limitations under the License.
+#  distributed under the License is distributed on an "AS IS" BASIS,
-# 
+#  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+#  See the License for the specific language governing permissions and
+#  limitations under the License.
+#
 
-import argparse 
+debug=False
-from sharedfunctions import callrestapi,printresult
 
-# setup command-line arguements. In this block which is common to all the tools you setup what parameters
+# Import Python modules
-# are passed to the tool
+import argparse
-# the --output parameter is a common one which supports the three styles of output json, simple or csv
+import sys
+from sharedfunctions import callrestapi
 
-parser = argparse.ArgumentParser() 
+# Define exception handler so that we only output trace info from errors when in debug mode
-parser.add_argument("-s","--server", help="The CAS SERVER.",required='True',default="cas-shared-default")
+def exception_handler(exception_type, exception, traceback, debug_hook=sys.excepthook):
-parser.add_argument("-o","--output", help="Output Style", choices=['csv','json','simple'],default='json')
+    if debug:
-args = parser.parse_args()
+        debug_hook(exception_type, exception, traceback)
-casserver=args.server
+    else:
-output_style=args.output
+        print "%s: %s" % (exception_type.__name__, exception)
+
+sys.excepthook = exception_handler
 
-# set the request type
+parser = argparse.ArgumentParser()
-reqtype='get'
+parser.add_argument("--noheader", action='store_true', help="Do not print the header row")
+parser.add_argument("-d","--debug", action='store_true', help="Debug")
+args = parser.parse_args()
+noheader=args.noheader
+debug=args.debug
 
-# set the endpoint to call
+# Print header row unless noheader argument was specified
-reqval='/casManagement/servers/'+casserver+'/caslibs'
+if not noheader:
+    print('server,caslib')
+    
+endpoint='/casManagement/servers'
+method='get'
 
-#make the rest call using the callrestapi function. You can have one or many calls
+#make the rest call
-caslib_result_json=callrestapi(reqval,reqtype)
+serverlist_result_json=callrestapi(endpoint,method)
 
-# example of overriding the columns for csv output
+if debug:
-cols=['name','type','path','scope','attributes','description']
+    print(serverlist_result_json)
+    print('serverlist_result_json is a '+type(serverlist_result_json).__name__+' object') #serverlist_result_json is a dict object
 
-# print result accepts
+servers = serverlist_result_json['items']
-# the json returned
-# the output style
-# optionally the columns for csv outtput, if you don't pass in columns you get defaults
 
-# You can just print results r post process the results as you need to
+for server in servers:
+    servername=server['name']
 
-printresult(caslib_result_json,output_style,cols)
+    # List the caslibs in this server
+    endpoint='/casManagement/servers/'+servername+'/caslibs?excludeItemLinks=true'
+    method='get'
+    caslibs_result_json=callrestapi(endpoint,method)
+    if debug:
+        print(caslibs_result_json)
+        print('caslibs_result_json is a '+type(caslibs_result_json).__name__+' object') #caslibs_result_json is a dict object
+    caslibs=caslibs_result_json['items']
 
+    for caslib in caslibs:
+        print(server['name']+','+caslib['name'])

listcaslibs_example.py

@@ -0,0 +1,59 @@
+#!/usr/bin/python
+# -*- coding: utf-8 -*-
+#
+# listcaslibs.py December 2017
+#
+# listcaslibs an example of how easy it is to build a new tool. This tool is not really needed as you can do this easily with the CLI
+# it is here for demo purposes. It lists the caslibs and there details accepting the cas server as a parameter
+#
+#
+# Change History
+#
+# 27JAN2017 Comments added
+#
+#
+# Copyright © 2018, SAS Institute Inc., Cary, NC, USA.  All Rights Reserved.
+#
+#  Licensed under the Apache License, Version 2.0 (the License); you may not use this file except in compliance with the License. You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+#  Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either 
+#  express or implied. See the License for the specific language governing permissions and limitations under the License.
+# 
+
+import argparse 
+from sharedfunctions import callrestapi,printresult
+
+# setup command-line arguements. In this block which is common to all the tools you setup what parameters
+# are passed to the tool
+# the --output parameter is a common one which supports the three styles of output json, simple or csv
+
+parser = argparse.ArgumentParser() 
+parser.add_argument("-s","--server", help="The CAS SERVER.",required='True',default="cas-shared-default")
+parser.add_argument("-o","--output", help="Output Style", choices=['csv','json','simple'],default='json')
+args = parser.parse_args()
+casserver=args.server
+output_style=args.output
+
+# set the request type
+reqtype='get'
+
+# set the endpoint to call
+reqval='/casManagement/servers/'+casserver+'/caslibs'
+
+#make the rest call using the callrestapi function. You can have one or many calls
+caslib_result_json=callrestapi(reqval,reqtype)
+
+# example of overriding the columns for csv output
+cols=['name','type','path','scope','attributes','description']
+
+# print result accepts
+# the json returned
+# the output style
+# optionally the columns for csv outtput, if you don't pass in columns you get defaults
+
+# You can just print results r post process the results as you need to
+
+printresult(caslib_result_json,output_style,cols)
+

listcaslibsandeffectiveaccess.py

@@ -0,0 +1,108 @@
+#!/usr/bin/python
+# -*- coding: utf-8 -*-
+#
+# listcaslibsandeffectiveaccess.py
+# January 2019
+#
+# Usage:
+# listcaslibsandeffectiveaccess.py [--noheader] [-d]
+#
+# Examples:
+#
+# 1. Return list of all effective access on all CAS libraries on all servers
+#        ./listcaslibsandeffectiveaccess.py
+#
+# Copyright © 2019, SAS Institute Inc., Cary, NC, USA.  All Rights Reserved.
+#
+#  Licensed under the Apache License, Version 2.0 (the License);
+#  you may not use this file except in compliance with the License.
+#  You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+#  Unless required by applicable law or agreed to in writing, software
+#  distributed under the License is distributed on an "AS IS" BASIS,
+#  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+#  See the License for the specific language governing permissions and
+#  limitations under the License.
+#
+
+debug=False
+
+
+# Import Python modules
+import argparse
+import sys
+from sharedfunctions import callrestapi
+
+# Define exception handler so that we only output trace info from errors when in debug mode
+def exception_handler(exception_type, exception, traceback, debug_hook=sys.excepthook):
+    if debug:
+        debug_hook(exception_type, exception, traceback)
+    else:
+        print "%s: %s" % (exception_type.__name__, exception)
+
+sys.excepthook = exception_handler
+
+identity_cols=['identity','identityType']
+permissions=['readInfo','select','limitedPromote','promote','createTable','dropTable','deleteSource','insert','update','delete','alterTable','alterCaslib','manageAccess']
+
+parser = argparse.ArgumentParser()
+parser.add_argument("--noheader", action='store_true', help="Do not print the header row")
+parser.add_argument("-d","--debug", action='store_true', help="Debug")
+args = parser.parse_args()
+noheader=args.noheader
+debug=args.debug
+
+# Print header row unless noheader argument was specified
+if not noheader:
+    print('server,caslib,'+','.join(map(str, identity_cols))+','+','.join(map(str, permissions)))
+
+endpoint='/casManagement/servers'
+method='get'
+
+#make the rest call
+serverlist_result_json=callrestapi(endpoint,method)
+
+if debug:
+    print(serverlist_result_json)
+    print('serverlist_result_json is a '+type(serverlist_result_json).__name__+' object') #serverlist_result_json is a dict object
+
+servers = serverlist_result_json['items']
+
+for server in servers:
+    servername=server['name']
+
+    # List the caslibs in this server
+    endpoint='/casManagement/servers/'+servername+'/caslibs?excludeItemLinks=true'
+    method='get'
+    caslibs_result_json=callrestapi(endpoint,method)
+    if debug:
+        print(caslibs_result_json)
+        print('caslibs_result_json is a '+type(caslibs_result_json).__name__+' object') #caslibs_result_json is a dict object
+    caslibs=caslibs_result_json['items']
+
+    for caslib in caslibs:
+        caslibname=caslib['name']
+        #print(servername+','+caslibname)
+      
+        # Get effective Access Controls on this caslib
+        endpoint='/casAccessManagement/servers/'+servername+'/caslibControls/'+caslibname+'?accessControlType=effective'
+        method='get'
+        caslibaccess_result_json=callrestapi(endpoint,method)
+
+        #print(caslibaccess_result_json)
+        for ai in caslibaccess_result_json['items']:
+            output=servername+','+caslibname
+            for col in identity_cols:
+                if col in ai:
+                     output=output+','+ai[col]
+                else:
+                     output=output+','
+            for col in permissions:
+                if col in ai:
+                     output=output+','+ai[col]
+                else:
+                     output=output+','
+            print output
+        

listcastables.py

@@ -0,0 +1,109 @@
+#!/usr/bin/python
+# -*- coding: utf-8 -*-
+#
+# listcastables.py
+# January 2019
+#
+# Usage:
+# listcastables.py [--noheader] [-d]
+#
+# Examples:
+#
+# 1. Return list of all CAS tables in all CAS libraries on all servers
+#        ./listcastables.py
+#
+# Copyright © 2019, SAS Institute Inc., Cary, NC, USA.  All Rights Reserved.
+#
+#  Licensed under the Apache License, Version 2.0 (the License);
+#  you may not use this file except in compliance with the License.
+#  You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+#  Unless required by applicable law or agreed to in writing, software
+#  distributed under the License is distributed on an "AS IS" BASIS,
+#  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+#  See the License for the specific language governing permissions and
+#  limitations under the License.
+#
+
+debug=False
+
+# Import Python modules
+import argparse
+import sys
+from sharedfunctions import callrestapi
+
+# Define exception handler so that we only output trace info from errors when in debug mode
+def exception_handler(exception_type, exception, traceback, debug_hook=sys.excepthook):
+    if debug:
+        debug_hook(exception_type, exception, traceback)
+    else:
+        print "%s: %s" % (exception_type.__name__, exception)
+
+sys.excepthook = exception_handler
+
+parser = argparse.ArgumentParser()
+parser.add_argument("--noheader", action='store_true', help="Do not print the header row")
+parser.add_argument("-d","--debug", action='store_true', help="Debug")
+args = parser.parse_args()
+noheader=args.noheader
+debug=args.debug
+
+# Print header row unless noheader argument was specified
+if not noheader:
+    print('server,caslib,table')
+
+endpoint='/casManagement/servers'
+method='get'
+
+#make the rest call
+serverlist_result_json=callrestapi(endpoint,method)
+
+if debug:
+    print(serverlist_result_json)
+    print('serverlist_result_json is a '+type(serverlist_result_json).__name__+' object') #serverlist_result_json is a dict object
+
+servers = serverlist_result_json['items']
+
+for server in servers:
+    servername=server['name']
+    #print(servername)
+
+    # List the caslibs in this server
+    endpoint='/casManagement/servers/'+servername+'/caslibs?excludeItemLinks=true'
+    method='get'
+    caslibs_result_json=callrestapi(endpoint,method)
+    if debug:
+        print(caslibs_result_json)
+        print('caslibs_result_json is a '+type(caslibs_result_json).__name__+' object') #caslibs_result_json is a dict object
+    caslibs=caslibs_result_json['items']
+
+    for caslib in caslibs:
+        caslibname=caslib['name']
+        #print('a: '+servername+','+caslibname)
+
+        # List the tables in the caslib
+        endpoint='/casManagement/servers/'+servername+'/caslibs/'+caslibname+'/tables?excludeItemLinks=true'
+        method='get'
+        #print('about to list tables')
+
+        tables_result_json=callrestapi(endpoint,method,stoponerror=False)
+
+        if debug:
+            print(tables_result_json)
+            print('tables_result_json is a '+type(tables_result_json).__name__+' object') #tables_result_json is a dict object
+        if tables_result_json is not None:
+            if tables_result_json['count']==0:
+                print(servername+','+caslibname+',[0 tables]')
+            if 'items' not in tables_result_json:
+                print(servername+','+caslibname+','+tables_result_json['message'])
+            else:
+                tables=tables_result_json['items']
+
+                for table in tables:
+                    tablename=table['name']
+                    print(servername+','+caslibname+','+tablename)
+        else:
+            #tables_result_json is None
+            print(servername+','+caslibname+',[error getting tables]')

listcastablesandeffectiveaccess.py

@@ -0,0 +1,130 @@
+#!/usr/bin/python
+# -*- coding: utf-8 -*-
+#
+# listcastablesandeffectiveaccess.py
+# January 2019
+#
+# Usage:
+# listcastablesandeffectiveaccess.py [--noheader] [-d]
+#
+# Examples:
+#
+# 1. Return list of all effective access on all CAS tables in all CAS libraries on all servers
+#        ./listcastablesandeffectiveaccess.py
+#
+# Copyright © 2019, SAS Institute Inc., Cary, NC, USA.  All Rights Reserved.
+#
+#  Licensed under the Apache License, Version 2.0 (the License);
+#  you may not use this file except in compliance with the License.
+#  You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+#  Unless required by applicable law or agreed to in writing, software
+#  distributed under the License is distributed on an "AS IS" BASIS,
+#  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+#  See the License for the specific language governing permissions and
+#  limitations under the License.
+#
+
+debug=False
+
+
+# Import Python modules
+import argparse
+import sys
+from sharedfunctions import callrestapi
+
+# Define exception handler so that we only output trace info from errors when in debug mode
+def exception_handler(exception_type, exception, traceback, debug_hook=sys.excepthook):
+    if debug:
+        debug_hook(exception_type, exception, traceback)
+    else:
+        print "%s: %s" % (exception_type.__name__, exception)
+
+sys.excepthook = exception_handler
+
+identity_cols=['identity','identityType']
+permissions=['readInfo','select','limitedPromote','promote','createTable','dropTable','deleteSource','insert','update','delete','alterTable','alterCaslib','manageAccess']
+
+parser = argparse.ArgumentParser()
+parser.add_argument("--noheader", action='store_true', help="Do not print the header row")
+parser.add_argument("-d","--debug", action='store_true', help="Debug")
+args = parser.parse_args()
+noheader=args.noheader
+debug=args.debug
+
+# Print header row unless noheader argument was specified
+if not noheader:
+    print('server,caslib,table,'+','.join(map(str, identity_cols))+','+','.join(map(str, permissions)))
+
+endpoint='/casManagement/servers'
+method='get'
+
+#make the rest call
+serverlist_result_json=callrestapi(endpoint,method)
+
+if debug:
+    print(serverlist_result_json)
+    print('serverlist_result_json is a '+type(serverlist_result_json).__name__+' object') #serverlist_result_json is a dict object
+
+servers = serverlist_result_json['items']
+
+for server in servers:
+    servername=server['name']
+
+    # List the caslibs in this server
+    endpoint='/casManagement/servers/'+servername+'/caslibs?excludeItemLinks=true'
+    method='get'
+    caslibs_result_json=callrestapi(endpoint,method)
+    if debug:
+        print(caslibs_result_json)
+        print('caslibs_result_json is a '+type(caslibs_result_json).__name__+' object') #caslibs_result_json is a dict object
+    caslibs=caslibs_result_json['items']
+
+    for caslib in caslibs:
+        caslibname=caslib['name']
+        #print(servername+','+caslibname)
+        
+        # Get the tables in the caslib
+        endpoint='/casManagement/servers/'+servername+'/caslibs/'+caslibname+'/tables?excludeItemLinks=true'
+        method='get'
+        #print('about to list tables')
+
+        tables_result_json=callrestapi(endpoint,method,stoponerror=False)
+
+        if debug:
+            print(tables_result_json)
+            print('tables_result_json is a '+type(tables_result_json).__name__+' object') #tables_result_json is a dict object
+        if tables_result_json is not None:
+            if tables_result_json['count']==0:
+                print(servername+','+caslibname+',[0 tables]')
+            if 'items' not in tables_result_json:
+                print(servername+','+caslibname+','+tables_result_json['message'])
+            else:
+                tables=tables_result_json['items']
+                for table in tables:
+                    tablename=table['name']
+                    # Get effective Access Controls on this table
+                    endpoint='/casAccessManagement/servers/'+servername+'/caslibs/'+caslibname+'/tableControls/'+tablename+'?accessControlType=effective'
+                    method='get'
+                    tableaccess_result_json=callrestapi(endpoint,method)
+
+                    #print(tableaccess_result_json)
+                    for ai in tableaccess_result_json['items']:
+                        output=servername+','+caslibname+','+tablename
+                        for col in identity_cols:
+                            if col in ai:
+                                 output=output+','+ai[col]
+                            else:
+                                 output=output+','
+                        for col in permissions:
+                            if col in ai:
+                                 output=output+','+ai[col]
+                            else:
+                                 output=output+','
+                        print output
+        else:
+            #tables_result_json is None
+            print(servername+','+caslibname+',[error getting tables]')
+        

listgroupsandmembers.py

@@ -0,0 +1,91 @@
+#!/usr/bin/python
+# -*- coding: utf-8 -*-
+#
+# listgroupsandmembers.py
+# January 2019
+#
+# Usage:
+# listgroupsandmembers.py [--noheader] [-d]
+#
+# Examples:
+#
+# 1. Return list of all groups and all their members
+#        ./listgroupsandmembers.py
+#
+# Copyright © 2019, SAS Institute Inc., Cary, NC, USA.  All Rights Reserved.
+#
+#  Licensed under the Apache License, Version 2.0 (the License);
+#  you may not use this file except in compliance with the License.
+#  You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+#  Unless required by applicable law or agreed to in writing, software
+#  distributed under the License is distributed on an "AS IS" BASIS,
+#  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+#  See the License for the specific language governing permissions and
+#  limitations under the License.
+#
+
+debug=False
+
+# Import Python modules
+import argparse
+import sys
+from sharedfunctions import callrestapi
+
+# Define exception handler so that we only output trace info from errors when in debug mode
+def exception_handler(exception_type, exception, traceback, debug_hook=sys.excepthook):
+    if debug:
+        debug_hook(exception_type, exception, traceback)
+    else:
+        print "%s: %s" % (exception_type.__name__, exception)
+
+sys.excepthook = exception_handler
+
+parser = argparse.ArgumentParser()
+parser.add_argument("--noheader", action='store_true', help="Do not print the header row")
+parser.add_argument("-d","--debug", action='store_true', help="Debug")
+args = parser.parse_args()
+noheader=args.noheader
+debug=args.debug
+
+# Print header row unless noheader argument was specified
+if not noheader:
+    print('groupid,groupname,grouptype,groupproviderid,memberid,membername,membertype,memberproviderid')
+
+endpoint='/identities/groups'
+method='get'
+
+#make the rest call
+groupslist_result_json=callrestapi(endpoint,method)
+
+if debug:
+    print(groupslist_result_json)
+    print('groupslist_result_json is a '+type(groupslist_result_json).__name__+' object') #groupslist_result_json is a dict object
+
+groups = groupslist_result_json['items']
+
+for group in groups:
+    groupid=group['id']
+    groupname=group['name']
+    grouptype=group['type']
+    groupproviderid=group['providerId']
+
+    # List the members of this group
+    endpoint='/identities/groups/'+groupid+'/members'
+    method='get'
+    members_result_json=callrestapi(endpoint,method)
+    if debug:
+        print(members_result_json)
+        print('members_result_json is a '+type(members_result_json).__name__+' object') #members_result_json is a dict object
+
+    members=members_result_json['items']
+    
+    for member in members:
+        memberid=member['id']
+        membername=member['name']
+        membertype=member['type']
+        memberproviderid=member['providerId']
+
+        print(groupid+','+groupname+','+grouptype+','+groupproviderid+','+memberid+','+membername+','+membertype+','+memberproviderid)

listmemberswithpath.py

@@ -30,14 +30,11 @@
 #  limitations under the License.
 #
 
-
-clidir='/opt/sas/viya/home/bin/'
 debug=False
 
 # Import Python modules
 import argparse
 import sys
-
 from sharedfunctions import callrestapi,getpath
 
 # Define exception handler so that we only output trace info from errors when in debug mode

listrules.py

@@ -8,6 +8,7 @@
 #
 # Change History
 # December 2018 - Added custom CSV output code, which writes out consistent columns in a specific order for the result rules JSON
+# January 2019 - Added 'id' to list of desired output columns
 #
 # Copyright © 2018, SAS Institute Inc., Cary, NC, USA.  All Rights Reserved.
 #
@@ -44,7 +45,7 @@ output_style=args.output
 limitval=10000
 
 # Define columns we want to output for each rule item (whether the item has a value for that column or not)
-desired_output_columns=['objectUri','containerUri','principalType','principal','setting','permissions','description','reason','createdBy','createdTimestamp','modifiedBy','modifiedTimestamp','condition','matchParams','mediaType','enabled','version']
+desired_output_columns=['objectUri','containerUri','principalType','principal','setting','permissions','description','reason','createdBy','createdTimestamp','modifiedBy','modifiedTimestamp','condition','matchParams','mediaType','enabled','version','id']
 valid_permissions=['read','update','delete','secure','add','remove','create']
 
 # build the request depending on what options were passed in

unittestsadm34.sh

@@ -35,6 +35,10 @@
 # 01Jun2018 Initial version after refactoring tools
 # 18Oct2018 updated gerrulid test because -o changed to -u 
 # 03Dec2018 Added tests for explainaccess.py
+# 23Jan2019 Added tests for six new tools (listcaslibs.py, listcastables.py,
+#           listcaslibsandeffectiveaccess.py,
+#           listcastablesandeffectiveaccess.py, listmemberswithpath.py,
+#           listgroupsandmembers.py)
 #
 #
 # Copyright 2018, SAS Institute Inc., Cary, NC, USA.  All Rights Reserved.
@@ -186,3 +190,31 @@ echo
 echo "List members of a folder, with paths for each member"
 ./listmemberswithpath.py -u /folders/folders/$id -r
 echo
+
+echo "Return list of all CAS libraries on all servers"
+./listcaslibs.py
+echo
+
+echo "Return list of all CAS tables in all CAS libraries on all servers"
+./listcastables.py
+echo
+
+echo "Return list of all effective access on all CAS libraries on all servers"
+./listcaslibsandeffectiveaccess.py
+echo
+
+echo "Return list of all effective access on all CAS tables in all CAS libraries on all servers"
+./listcastablesandeffectiveaccess.py
+echo
+
+echo "Return list of members of a folder identified by objectURI"
+./listmemberswithpath.py -u /folders/folders/$id
+echo
+
+echo "Return list of all members of a folder identified by objectURI, recursively searching subfolders"
+./listmemberswithpath.py -u /folders/folders/$id -r
+echo
+
+echo "Return list of all groups and all their members"
+./listgroupsandmembers.py
+echo