Get apps by git repo url (closes #105)

Author: tjarrettveracode

docs/api.md

@@ -87,6 +87,7 @@ As an alternative to importing individual objects into your library, you can acc
 - `get_apps(policy_check_after(opt))` : get a list of Veracode applications (JSON format). If provided, returns only applications that have a policy check date on or after `policy_check_after` (format is `yyyy-mm-dd`).
 - `get_app(guid(opt),legacy_id(opt))`: get information for a single Veracode application using either the `guid` or the `legacy_id` (integer).
 - `get_app_by_name(name)`: get list of applications whose names contain the search string `name`.
+- `get_app_by_repo(git_repo_url)`: get list of applications associated with the `git_repo_url`.
 - `create_app(app_name, business_criticality, description(opt), business_unit(opt), teams(opt), policy_guid(opt), custom_fields(opt array), bus_owner_name(opt), bus_owner_email(opt),git_repo_url(opt),custom_kms_alias(opt))`: create an application profile.
   - `business_criticality`: one of "VERY HIGH", "HIGH", "MEDIUM", "LOW", "VERY LOW"
   - `description`: extended description of the application

docs/applications.md

@@ -7,6 +7,7 @@ The following methods call Veracode REST APIs and return JSON.
 - `Applications().get_all(policy_check_after(opt))` : get a list of Veracode applications (JSON format). If provided, returns only applications that have a policy check date on or after `policy_check_after` (format is `yyyy-mm-dd`).
 - `Applications().get(guid(opt),legacy_id(opt))`: get information for a single Veracode application using either the `guid` or the `legacy_id` (integer).
 - `Applications().get_by_name(name)`: get list of applications whose names contain the search string `name`.
+- `Applications().get_by_repo(git_repo_url)`: get list of applications associated with the `git_repo_url`.
 - `Applications().create(app_name, business_criticality, description(opt), business_unit(opt), teams(opt), policy_guid(opt), custom_fields(opt array), bus_owner_name(opt), bus_owner_email(opt),git_repo_url(opt),custom_kms_alias(opt))`: create an application profile.
   - `business_criticality`: one of "VERY HIGH", "HIGH", "MEDIUM", "LOW", "VERY LOW"
   - `description`: extended description of the application.

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = 'veracode_api_py'
-version = '0.9.59'
+version = '0.9.60'
 authors = [ {name = "Tim Jarrett", email="[email protected]"} ]
 description = 'Python helper library for working with the Veracode APIs. Handles retries, pagination, and other features of the modern Veracode REST APIs.'
 readme = 'README.md'
@@ -22,4 +22,4 @@ dependencies = {file = ["requirements.txt"]}
 [project.urls]
 "Homepage" = "https://github.com/veracode/veracode-api-py"
 "Bug Tracker" = "https://github.com/veracode/veracode-api-py/issues"
-"Download" = "https://github.com/veracode/veracode-api-py/archive/v_0959.tar.gz"
+"Download" = "https://github.com/veracode/veracode-api-py/archive/v_0960.tar.gz"

setup.py

@@ -7,15 +7,15 @@
 setup(
   name = 'veracode_api_py',         
   packages = ['veracode_api_py'],   
-  version = '0.9.59',      
+  version = '0.9.60',      
   license='MIT',        
   description = 'Python helper library for working with the Veracode APIs. Handles retries, pagination, and other features of the modern Veracode REST APIs.',   
   long_description = long_description,
   long_description_content_type="text/markdown",
   author = 'Tim Jarrett',                  
   author_email = '[email protected]',      
   url = 'https://github.com/tjarrettveracode',  
-  download_url = 'https://github.com/veracode/veracode-api-py/archive/v_0959tar.gz',    
+  download_url = 'https://github.com/veracode/veracode-api-py/archive/v_0960.tar.gz',    
   keywords = ['veracode', 'veracode-api'],   
   install_requires=[            
           'veracode-api-signing'

veracode_api_py/api.py

@@ -106,11 +106,14 @@ def get_apps(self):
         return Applications().get_all()
 
     def get_app(self, guid: UUID = None, legacy_id=None):
-        return Applications().get(guid, legacy_id)
+        return Applications().get(guid=guid, legacy_id=legacy_id)
 
     def get_app_by_name(self, appname):
-        return Applications().get_by_name(appname)
+        return Applications().get_by_name(appname=appname)
 
+    def get_app_by_repo(self, git_repo_url):
+        return Applications().get_by_repo(git_repo_url=git_repo_url)
+    
     def create_app(self, app_name, business_criticality, description: str=None, business_unit: UUID = None, teams=[], 
                    policy_guid = None, custom_fields=[],bus_owner_name = None, bus_owner_email = None,
                    git_repo_url = None, custom_kms_alias = None):

veracode_api_py/applications.py

@@ -33,6 +33,11 @@ def get_by_name (self,appname: str):
         params = {"name": parse.quote(appname)}
         return APIHelper()._rest_paged_request(uri="appsec/v1/applications",method="GET",element="applications",params=params)
 
+    def get_by_repo (self,git_repo_url: str):
+        """Gets a list of applications having a name that matches appname, using the Veracode Applications API."""
+        params = {"git_repo_url": parse.quote(git_repo_url)}
+        return APIHelper()._rest_paged_request(uri="appsec/v1/applications",method="GET",element="applications",params=params)
+    
     def create(self,app_name:str ,business_criticality, description: str=None, business_unit: UUID=None, teams=[], policy_guid:UUID=None,
                 custom_fields=[], bus_owner_name=None, bus_owner_email=None, git_repo_url=None, custom_kms_alias: str=None):
         return self._create_or_update("CREATE",app_name=app_name,business_criticality=business_criticality,