feat(spider): Adds client spider class.

Author: JohnnyIrvin

src/zapv2/client_spider.py

@@ -0,0 +1,73 @@
+# Zed Attack Proxy (ZAP) and its related class files.
+#
+# ZAP is an HTTP/HTTPS proxy for assessing web application security.
+#
+# Copyright 2022 the ZAP development team
+#
+# 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.
+"""
+This was hand typed by a human, not generated by a script.
+"""
+
+import warnings
+import six
+
+
+class ClientSpider:
+
+    def __init__(self, zap):
+        self.zap = zap
+
+    def status(self, scanid=None):
+        """
+        
+        This component is optional and therefore the API will only work if it is installed
+        """
+        params = {}
+        if scanid is not None:
+            params['scanId'] = scanid
+        return six.next(six.itervalues(self.zap._request(self.zap.base + 'clientSpider/view/status/', params)))
+
+
+    def scan(self,  url=None, browser=None, contextName=None, userName=None, subtreeonly=None, apikey=''):
+        """
+        Runs the spider against the given URL (or context). Optionally, the parameter 'contextName' can be used to constrain the scan to a Context and the parameter 'subtreeOnly' allows to restrict the spider under a site's subtree (using the specified 'url').
+        This component is optional and therefore the API will only work if it is installed.
+        """
+        if apikey:
+            warnings.warn("The 'apikey' parameter is deprecated (unused) and will be removed in a future release.")
+            
+        params = {}
+        if browser is not None:
+            params['browser'] = browser
+        if url is not None:
+            params['url'] = url
+        if contextName is not None:
+            params['contextName'] = contextName
+        if userName is not None:
+            params['userName'] = userName
+        if subtreeonly is not None:
+            params['subtreeOnly'] = subtreeonly
+        return six.next(six.itervalues(self.zap._request(self.zap.base + 'clientSpider/action/scan/', params)))
+
+    def stop(self, scanid=None, apikey=''):
+        """
+        This component is optional and therefore the API will only work if it is installed
+        """
+        if apikey:
+            warnings.warn("The 'apikey' parameter is deprecated (unused) and will be removed in a future release.")
+            
+        params = {}
+        if scanid is not None:
+            params['scanId'] = scanid
+        return six.next(six.itervalues(self.zap._request(self.zap.base + 'clientSpider/action/stop/', params)))