Add deletepublishdest.py, update README & EXAMPLES

EXAMPLES.md

@@ -106,6 +106,25 @@ INPUT JSON must be formatted as the endpoint expects. Example:
 }  
 ```
 
+**createpublishdest.py**
+
+```bash
+# List all existing publishing destinations
+ ./callrestapi.py -m get -e /modelPublish/destinations -o simple
+ 
+# Create new publishing destinations - one example each for CAS, Hadoop and Teradata
+./createpublishdest.py cas -n newcasdest -s cas-shared-default -c mycaslib -t thetable
+./createpublishdest.py hadoop -n newhadoopdest -s cas-shared-default -c myhadoop -hd /mydir
+./createpublishdest.py teradata -n newtddest -s cas-shared-default -c mycaslib  -dt teratable -db tera2
+```
+
+**deletepublishdest.py**
+
+```bash
+# Delete publishing destination
+./deletepublishdest.py -n newcasdest
+```
+
 **testfolderaccess.py**
 
 ```bash

README.md

@@ -98,6 +98,8 @@ Additional tools provide more complex functionality by combining multiple calls
 * **testfolderaccess** tests if a user or group has access to a folder
 * **createbinarybackup.py** creates a binary backup job
 * **createdomain.py** creates an authentication domain
+* **createpublishdest.py** creates CAS, Teradata or Hadoop publishing destinations
+* **detetepublishdest.py** deletes publishing destinations
 * **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

deletepublishdest.py

@@ -0,0 +1,72 @@
+#!/usr/bin/python
+# -*- coding: utf-8 -*-
+#
+# deletepublishdest.py
+# April 2020
+#
+# Delete a Viya publishing destination
+#
+# Change History
+#
+# Copyright © 2020, 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.
+#
+
+# Delete a publishing destination, after first validating that it exists
+
+debug=False
+folder_exists=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(description="Delete a publishing destination")
+parser.add_argument("-n","--name", help="Enter the name of the publishing destination to be deleted.",required=True)
+parser.add_argument("-d","--debug", action='store_true', help="Debug")
+args = parser.parse_args()
+publish_name=args.name
+debug=args.debug
+
+# Does a publishing destination of the specified name actually exist?
+# This call exits with a reasonably clear error message if the publishing destination does not exist,
+# so I decided that no other error handling is required for the case where the folder does not exist.
+reqval="/modelPublish/destinations/"+publish_name
+reqtype="get"
+test_exists_result_json=callrestapi(reqval,reqtype)
+#print(test_exists_result_json)
+#print('test_exists_result_json is a '+type(test_exists_result_json).__name__+' object') #test_exists_result_json is a dict object
+if test_exists_result_json['name'] == publish_name:
+   folder_exists=True
+   if debug:
+         print('Publishing destination '+publish_name+' found.')
+
+# Build the rest call
+# Aiming for something equivalent to ./callrestapi.py -e /modelPublish/destinations/newcasdest2 -m delete
+reqval="/modelPublish/destinations/"+publish_name
+reqtype="delete"
+
+# Delete the publishing destination
+callrestapi(reqval,reqtype)
+print('Publishing destination '+publish_name+' deleted.')