Bump version no, docs

Author: tjarrettveracode

CONTRIBUTING.md

@@ -27,3 +27,4 @@ Please follow the instructions below to make a contribution.
 - [Bnreplah](https://github.com/bnreplah)
 - [Ashton Syed](https://github.com/ashtonsyed)
 - [Jbrule](https://github.com/jbrule)
+- [Cadonuno](https://github.com/cadonuno)

docs/xml.md

@@ -8,6 +8,7 @@ The following methods call Veracode XML APIs and return XML output. For a more d
 - `XMLAPI().get_build_list(app_id, sandbox_id(opt))`: get list of builds for the `app_id` (integer) passed. If `sandbox_id` (integer) passed, returns a list of builds in the sandbox.
 - `XMLAPI().get_build_info(app_id, build_id, sandbox_id(opt))`: get build info for the `build_id` (integer) and `app_id` (integer) passed. If `sandbox_id` (integer) passed, returns information for the `build_id` in the sandbox.
 - `XMLAPI().get_detailed_report(build_id)`: get detailed report XML for the `build_id` (integer) passed.
+- `XMLAPI().get_detailed_report_pdf(build_id)`: get detailed report PDF for the `build_id` (integer) passed.
 - `XMLAPI().set_mitigation_info(build_id,flaw_id_list,action,comment)`: create a mitigation of type `action` with comment `comment` for the flaws in `flaw_id_list` (comma separated list of integers) of build `build_id` (integer). Supported values for `action`: 'Mitigate by Design', 'Mitigate by Network Environment',  'Mitigate by OS Environment', 'Approve Mitigation', 'Reject Mitigation', 'Potential False Positive',  'Reported to Library Maintainer'. Any other value passed to `action` is interpreted as a comment.
 - `XMLAPI().generate_archer(payload)`: generate an Archer report based on the comma separated list of parameters provided. Possible parameters include `period` (`yesterday`, `last_week`, `last_month`; all time if omitted), `from_date` (mm-dd-yyyy format), `to_date` (mm-dd-yyyy format), `scan_type` (one of `static`, `dynamic`, `manual`). Returns a payload that contains a token to download an Archer report.
 - `XMLAPI().download_archer(token(opt))`: get Archer report corresponding to the token passed. If no token passed, retrieves the latest Archer report generated.

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = 'veracode_api_py'
-version = '0.9.66'
+version = '0.9.67'
 authors = [ {name = "Tim Jarrett", email="tjarrett@veracode.com"} ]
 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_0966.tar.gz"
+"Download" = "https://github.com/veracode/veracode-api-py/archive/v_0967.tar.gz"

requirements.txt

@@ -1,4 +1,4 @@
-requests==2.33
+requests==2.34.2
 veracode-api-signing>=24.11.0
 Pygments>= 2.9.0
 idna>=3.7

samples/reportingapi_scans_sample.py

@@ -0,0 +1,33 @@
+import time
+import sys
+import json
+import datetime
+from veracode_api_py import Analytics
+
+wait_seconds = 15
+
+print('Generating report...')
+
+theguid = Analytics().create_scans_report(start_date="2025-10-01",application_id="1024496",policy_sandbox="POLICY",scan_type=["Static Analysis"])
+
+print('Checking status for report {}...'.format(theguid))
+thestatus,thescans=Analytics().get(theguid)
+
+while thestatus != 'COMPLETED':
+    print('Waiting {} seconds before we try again...'.format(wait_seconds))
+    time.sleep(wait_seconds)
+    print('Checking status for report {}...'.format(theguid))
+    thestatus,thescans=Analytics().get(theguid)
+
+recordcount = len(thescans)
+
+print('Retrieved {} findings'.format(recordcount))
+
+if recordcount > 0:
+    now = datetime.datetime.now().astimezone()
+    filename = 'report-{}'.format(now)
+    with open('{}.json'.format(filename), 'w') as outfile:
+        json.dump(thescans,outfile)
+        outfile.close()
+
+    print('Wrote {} scans to {}.json'.format(recordcount,filename))

setup.py

@@ -7,15 +7,15 @@
 setup(
   name = 'veracode_api_py',         
   packages = ['veracode_api_py'],   
-  version = '0.9.66',      
+  version = '0.9.67',      
   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 = 'tjarrett@veracode.com',      
   url = 'https://github.com/tjarrettveracode',  
-  download_url = 'https://github.com/veracode/veracode-api-py/archive/v_0966.tar.gz',    
+  download_url = 'https://github.com/veracode/veracode-api-py/archive/v_0967.tar.gz',    
   keywords = ['veracode', 'veracode-api'],   
   install_requires=[            
           'veracode-api-signing'

veracode_api_py/api.py

@@ -60,6 +60,9 @@ def get_build_info(self, app_id, build_id=None, sandbox_id=None):
     def get_detailed_report(self, build_id):
         return XMLAPI().get_detailed_report(build_id)
 
+    def get_detailed_report_pdf(self, build_id):
+        return XMLAPI().get_detailed_report_pdf(build_id)
+
     def set_mitigation_info(self, build_id, flaw_id_list, action, comment):
         return XMLAPI().set_mitigation_info(build_id, flaw_id_list, action, comment)