catocli 1.0.14__tar.gz → 1.0.17__tar.gz

{catocli-1.0.14/catocli.egg-info → catocli-1.0.17}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.2
 Name: catocli
-Version: 1.0.14
+Version: 1.0.17
 Summary: Cato Networks cli wrapper for the GraphQL API.
 Home-page: https://github.com/Cato-Networks/cato-cli
 Author: Cato Networks
@@ -18,5 +18,14 @@ License-File: LICENSE
 Requires-Dist: urllib3
 Requires-Dist: certifi
 Requires-Dist: six
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: home-page
+Dynamic: license
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
 
 The package provides a simple to use CLI that reflects industry standards (such as the AWS cli), and enables customers to manage Cato Networks configurations and processes via the [Cato Networks GraphQL API](https://api.catonetworks.com/api/v1/graphql2) easily integrating into configurations management, orchestration or automation frameworks to support the DevOps model.

{catocli-1.0.14 → catocli-1.0.17}/catocli/Utils/clidriver.py

@@ -19,12 +19,14 @@ CATO_DEBUG = bool(os.getenv("CATO_DEBUG", False))
 from ..parsers.raw import raw_parse
 from ..parsers.custom import custom_parse
 from ..parsers.query_siteLocation import query_siteLocation_parse
+from ..parsers.mutation_accountManagement import mutation_accountManagement_parse
 from ..parsers.mutation_admin import mutation_admin_parse
 from ..parsers.mutation_container import mutation_container_parse
 from ..parsers.mutation_policy import mutation_policy_parse
 from ..parsers.mutation_site import mutation_site_parse
 from ..parsers.mutation_sites import mutation_sites_parse
 from ..parsers.query_accountBySubdomain import query_accountBySubdomain_parse
+from ..parsers.query_accountManagement import query_accountManagement_parse
 from ..parsers.query_accountMetrics import query_accountMetrics_parse
 from ..parsers.query_accountRoles import query_accountRoles_parse
 from ..parsers.query_accountSnapshot import query_accountSnapshot_parse
@@ -41,6 +43,7 @@ from ..parsers.query_eventsTimeSeries import query_eventsTimeSeries_parse
 from ..parsers.query_hardwareManagement import query_hardwareManagement_parse
 from ..parsers.query_licensing import query_licensing_parse
 from ..parsers.query_policy import query_policy_parse
+from ..parsers.query_site import query_site_parse
 from ..parsers.query_subDomains import query_subDomains_parse
 from ..parsers.query_xdr import query_xdr_parse
 
@@ -51,7 +54,18 @@ configuration.host = "{}".format(catocli.__cato_host__)
 configuration.debug = CATO_DEBUG
 configuration.version = "{}".format(catocli.__version__)
 
-parser = argparse.ArgumentParser(prog='catocli', usage='%(prog)s <operationType> <operationName> [options]', description="CLI for query on CATO via API.")
+defaultReadmeStr = """
+The Cato CLI is a command-line interface tool designed to simplify the management and automation of Cato Networks’ configurations and operations. 
+It enables users to interact with Cato’s API for tasks such as managing Cato Management Application (CMA) site and account configurations, security policies, retrieving events, etc.
+
+
+For assistance in generating syntax for the cli to perform various operations, please refer to the Cato API Explorer application.
+
+
+https://github.com/catonetworks/cato-api-explorer
+"""
+
+parser = argparse.ArgumentParser(prog='catocli', usage='%(prog)s <operationType> <operationName> [options]', description=defaultReadmeStr)
 parser.add_argument('--version', action='version', version=catocli.__version__)
 subparsers = parser.add_subparsers()
 custom_parsers = custom_parse(subparsers)
@@ -63,12 +77,14 @@ query_siteLocation_parser = query_siteLocation_parse(query_subparsers)
 mutation_parser = subparsers.add_parser('mutation', help='Mutation', usage='catocli mutation <operationName> [options]')
 mutation_subparsers = mutation_parser.add_subparsers(description='valid subcommands', help='additional help')
 
+mutation_accountManagement_parser = mutation_accountManagement_parse(mutation_subparsers)
 mutation_admin_parser = mutation_admin_parse(mutation_subparsers)
 mutation_container_parser = mutation_container_parse(mutation_subparsers)
 mutation_policy_parser = mutation_policy_parse(mutation_subparsers)
 mutation_site_parser = mutation_site_parse(mutation_subparsers)
 mutation_sites_parser = mutation_sites_parse(mutation_subparsers)
 query_accountBySubdomain_parser = query_accountBySubdomain_parse(query_subparsers)
+query_accountManagement_parser = query_accountManagement_parse(query_subparsers)
 query_accountMetrics_parser = query_accountMetrics_parse(query_subparsers)
 query_accountRoles_parser = query_accountRoles_parse(query_subparsers)
 query_accountSnapshot_parser = query_accountSnapshot_parse(query_subparsers)
@@ -85,6 +101,7 @@ query_eventsTimeSeries_parser = query_eventsTimeSeries_parse(query_subparsers)
 query_hardwareManagement_parser = query_hardwareManagement_parse(query_subparsers)
 query_licensing_parser = query_licensing_parse(query_subparsers)
 query_policy_parser = query_policy_parse(query_subparsers)
+query_site_parser = query_site_parse(query_subparsers)
 query_subDomains_parser = query_subDomains_parse(query_subparsers)
 query_xdr_parser = query_xdr_parse(query_subparsers)
 
@@ -117,7 +134,7 @@ def main(args=None):
 	except Exception as e:
 		if isinstance(e, AttributeError):
 			print('Missing arguments. Usage: catocli <operation> -h')
-			if "v" in args and args.v==True:
+			if args.v==True:
 				print('ERROR: ',e)
 				traceback.print_exc()
 		else:

{catocli-1.0.14 → catocli-1.0.17}/catocli/__init__.py

@@ -1,2 +1,2 @@
-__version__ = "1.0.14"
+__version__ = "1.0.17"
 __cato_host__ = "https://api.catonetworks.com/api/v1/graphql2"

catocli-1.0.17/catocli/parsers/mutation_accountManagement/README.md

@@ -0,0 +1,7 @@
+
+## CATO-CLI - mutation.accountManagement:
+[Click here](https://api.catonetworks.com/documentation/#mutation-accountManagement) for documentation on this operation.
+
+### Usage for mutation.accountManagement:
+
+`catocli mutation accountManagement -h`

catocli-1.0.17/catocli/parsers/mutation_accountManagement/__init__.py

@@ -0,0 +1,51 @@
+
+from ..parserApiClient import createRequest, get_help
+
+def mutation_accountManagement_parse(mutation_subparsers):
+	mutation_accountManagement_parser = mutation_subparsers.add_parser('accountManagement', 
+			help='accountManagement() mutation operation', 
+			usage=get_help("mutation_accountManagement"))
+
+	mutation_accountManagement_subparsers = mutation_accountManagement_parser.add_subparsers()
+
+	mutation_accountManagement_addAccount_parser = mutation_accountManagement_subparsers.add_parser('addAccount', 
+			help='addAccount() accountManagement operation', 
+			usage=get_help("mutation_accountManagement_addAccount"))
+
+	mutation_accountManagement_addAccount_parser.add_argument('json', help='Variables in JSON format.')
+	mutation_accountManagement_addAccount_parser.add_argument('-accountID', help='Override the CATO_ACCOUNT_ID environment variable with this value.')
+	mutation_accountManagement_addAccount_parser.add_argument('-t', const=True, default=False, nargs='?', 
+		help='Print test request preview without sending api call')
+	mutation_accountManagement_addAccount_parser.add_argument('-v', const=True, default=False, nargs='?', 
+		help='Verbose output')
+	mutation_accountManagement_addAccount_parser.add_argument('-p', const=True, default=False, nargs='?', 
+		help='Pretty print')
+	mutation_accountManagement_addAccount_parser.set_defaults(func=createRequest,operation_name='mutation.accountManagement.addAccount')
+
+	mutation_accountManagement_removeAccount_parser = mutation_accountManagement_subparsers.add_parser('removeAccount', 
+			help='removeAccount() accountManagement operation', 
+			usage=get_help("mutation_accountManagement_removeAccount"))
+
+	mutation_accountManagement_removeAccount_parser.add_argument('json', help='Variables in JSON format.')
+	mutation_accountManagement_removeAccount_parser.add_argument('-accountID', help='Override the CATO_ACCOUNT_ID environment variable with this value.')
+	mutation_accountManagement_removeAccount_parser.add_argument('-t', const=True, default=False, nargs='?', 
+		help='Print test request preview without sending api call')
+	mutation_accountManagement_removeAccount_parser.add_argument('-v', const=True, default=False, nargs='?', 
+		help='Verbose output')
+	mutation_accountManagement_removeAccount_parser.add_argument('-p', const=True, default=False, nargs='?', 
+		help='Pretty print')
+	mutation_accountManagement_removeAccount_parser.set_defaults(func=createRequest,operation_name='mutation.accountManagement.removeAccount')
+
+	mutation_accountManagement_updateAccount_parser = mutation_accountManagement_subparsers.add_parser('updateAccount', 
+			help='updateAccount() accountManagement operation', 
+			usage=get_help("mutation_accountManagement_updateAccount"))
+
+	mutation_accountManagement_updateAccount_parser.add_argument('json', help='Variables in JSON format.')
+	mutation_accountManagement_updateAccount_parser.add_argument('-accountID', help='Override the CATO_ACCOUNT_ID environment variable with this value.')
+	mutation_accountManagement_updateAccount_parser.add_argument('-t', const=True, default=False, nargs='?', 
+		help='Print test request preview without sending api call')
+	mutation_accountManagement_updateAccount_parser.add_argument('-v', const=True, default=False, nargs='?', 
+		help='Verbose output')
+	mutation_accountManagement_updateAccount_parser.add_argument('-p', const=True, default=False, nargs='?', 
+		help='Pretty print')
+	mutation_accountManagement_updateAccount_parser.set_defaults(func=createRequest,operation_name='mutation.accountManagement.updateAccount')

catocli-1.0.17/catocli/parsers/mutation_accountManagement_addAccount/README.md

@@ -0,0 +1,17 @@
+
+## CATO-CLI - mutation.accountManagement.addAccount:
+[Click here](https://api.catonetworks.com/documentation/#mutation-addAccount) for documentation on this operation.
+
+### Usage for mutation.accountManagement.addAccount:
+
+`catocli mutation accountManagement addAccount -h`
+
+`catocli mutation accountManagement addAccount <json>`
+
+`catocli mutation accountManagement addAccount "$(cat < addAccount.json)"`
+
+`catocli mutation accountManagement addAccount '{"addAccountInput": {"description": {"description": "String"}, "name": {"name": "String"}, "tenancy": {"tenancy": "enum(AccountTenancy)"}, "timezone": {"timezone": "TimeZone"}, "type": {"type": "enum(AccountProfileType)"}}}'`
+
+#### Operation Arguments for mutation.accountManagement.addAccount ####
+`accountId` [ID] - (required) N/A 
+`addAccountInput` [AddAccountInput] - (required) N/A 

catocli-1.0.17/catocli/parsers/mutation_accountManagement_removeAccount/README.md

@@ -0,0 +1,16 @@
+
+## CATO-CLI - mutation.accountManagement.removeAccount:
+[Click here](https://api.catonetworks.com/documentation/#mutation-removeAccount) for documentation on this operation.
+
+### Usage for mutation.accountManagement.removeAccount:
+
+`catocli mutation accountManagement removeAccount -h`
+
+`catocli mutation accountManagement removeAccount <json>`
+
+`catocli mutation accountManagement removeAccount "$(cat < removeAccount.json)"`
+
+`catocli mutation accountManagement removeAccount '{}'`
+
+#### Operation Arguments for mutation.accountManagement.removeAccount ####
+`accountId` [ID] - (required) N/A 

catocli-1.0.17/catocli/parsers/mutation_accountManagement_updateAccount/README.md

@@ -0,0 +1,17 @@
+
+## CATO-CLI - mutation.accountManagement.updateAccount:
+[Click here](https://api.catonetworks.com/documentation/#mutation-updateAccount) for documentation on this operation.
+
+### Usage for mutation.accountManagement.updateAccount:
+
+`catocli mutation accountManagement updateAccount -h`
+
+`catocli mutation accountManagement updateAccount <json>`
+
+`catocli mutation accountManagement updateAccount "$(cat < updateAccount.json)"`
+
+`catocli mutation accountManagement updateAccount '{"updateAccountInput": {"description": {"description": "String"}}}'`
+
+#### Operation Arguments for mutation.accountManagement.updateAccount ####
+`accountId` [ID] - (required) N/A 
+`updateAccountInput` [UpdateAccountInput] - (required) N/A 

catocli-1.0.17/catocli/parsers/mutation_admin_addAdmin/README.md

@@ -0,0 +1,17 @@
+
+## CATO-CLI - mutation.admin.addAdmin:
+[Click here](https://api.catonetworks.com/documentation/#mutation-addAdmin) for documentation on this operation.
+
+### Usage for mutation.admin.addAdmin:
+
+`catocli mutation admin addAdmin -h`
+
+`catocli mutation admin addAdmin <json>`
+
+`catocli mutation admin addAdmin "$(cat < addAdmin.json)"`
+
+`catocli mutation admin addAdmin '{"addAdminInput": {"email": {"email": "String"}, "firstName": {"firstName": "String"}, "lastName": {"lastName": "String"}, "mfaEnabled": {"mfaEnabled": "Boolean"}, "passwordNeverExpires": {"passwordNeverExpires": "Boolean"}, "updateAdminRoleInput": {"allowedAccounts": {"allowedAccounts": ["ID"]}, "allowedEntities": {"id": {"id": "ID"}, "name": {"name": "String"}, "type": {"type": "enum(EntityType)"}}, "role": {"id": {"id": "ID"}, "name": {"name": "String"}}}}}'`
+
+#### Operation Arguments for mutation.admin.addAdmin ####
+`accountId` [ID] - (required) N/A 
+`addAdminInput` [AddAdminInput] - (required) N/A 

catocli-1.0.17/catocli/parsers/mutation_admin_updateAdmin/README.md

@@ -0,0 +1,18 @@
+
+## CATO-CLI - mutation.admin.updateAdmin:
+[Click here](https://api.catonetworks.com/documentation/#mutation-updateAdmin) for documentation on this operation.
+
+### Usage for mutation.admin.updateAdmin:
+
+`catocli mutation admin updateAdmin -h`
+
+`catocli mutation admin updateAdmin <json>`
+
+`catocli mutation admin updateAdmin "$(cat < updateAdmin.json)"`
+
+`catocli mutation admin updateAdmin '{"adminID": "ID", "updateAdminInput": {"firstName": {"firstName": "String"}, "lastName": {"lastName": "String"}, "mfaEnabled": {"mfaEnabled": "Boolean"}, "passwordNeverExpires": {"passwordNeverExpires": "Boolean"}, "updateAdminRoleInput": {"allowedAccounts": {"allowedAccounts": ["ID"]}, "allowedEntities": {"id": {"id": "ID"}, "name": {"name": "String"}, "type": {"type": "enum(EntityType)"}}, "role": {"id": {"id": "ID"}, "name": {"name": "String"}}}}}'`
+
+#### Operation Arguments for mutation.admin.updateAdmin ####
+`accountId` [ID] - (required) N/A 
+`adminID` [ID] - (required) N/A 
+`updateAdminInput` [UpdateAdminInput] - (required) N/A 

{catocli-1.0.14 → catocli-1.0.17}/catocli/parsers/mutation_container_delete/README.md

@@ -10,8 +10,8 @@
 
 `catocli mutation container delete "$(cat < delete.json)"`
 
-`catocli mutation container delete '{"DeleteContainerInput": {"ContainerRefInput": {"by": {"by": "enum(ObjectRefBy)"}, "input": {"input": "String"}}}}'`
+`catocli mutation container delete '{"deleteContainerInput": {"containerRefInput": {"by": {"by": "enum(ObjectRefBy)"}, "input": {"input": "String"}}}}'`
 
 #### Operation Arguments for mutation.container.delete ####
-`DeleteContainerInput` [DeleteContainerInput] - (required) N/A 
 `accountId` [ID] - (required) N/A 
+`deleteContainerInput` [DeleteContainerInput] - (required) N/A