Ability to return json results when used as python lib (#250)

* Modified 'scan_account_authorization_details' in '/cloudsplaining/command/scan,oy' to return raw json results along with rendered_html report string. Also added a parameter 'return_json_results' to the function to make it backward compatible.
Returning json along can be helpful in programatically analysing results and taking further actions when used as python library.

* Update the typo in return type of scan_account_authorization

* Update README.md

Co-authored-by: Kinnaird McQuade <[email protected]>

Author: mrpool404

README.md

@@ -381,3 +381,4 @@ Try upgrading to the latest version of Cloudsplaining. This error was fixed in v
 * [AWS Privilege Escalation Methods](https://github.com/RhinoSecurityLabs/AWS-IAM-Privilege-Escalation) by [Spencer Gietzen](https://twitter.com/SpenGietz) at Rhino Security Labs
 * [Understanding Access Level Summaries within Policy Summaries](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_understand-policy-summary-access-level-summaries.html)
 * [Leveraging next-generation blockchain-based AI across multiple service meshes to transparently automate multi-cloud IAM wizardry :mage_man:](http://kmcquade.com/rick.html)
+

cloudsplaining/command/scan.py

@@ -137,7 +137,8 @@ def scan_account_authorization_details(
     output_directory: str = os.getcwd(),
     write_data_files: bool = False,
     minimize: bool = False,
-) -> str:  # pragma: no cover
+    return_json_results: bool = False
+) -> Any:  # pragma: no cover
     """
     Given the path to account authorization details files and the exclusions config file, scan all inline and
     managed policies in the account to identify actions that do not leverage resource constraints.
@@ -187,7 +188,14 @@ def scan_account_authorization_details(
         findings_data_filepath = write_results_data_file(results, findings_data_file)
         print(f"Findings data file saved: {findings_data_filepath}")
 
-    return rendered_report
+    if return_json_results:
+        return {
+            "iam_results" : authorization_details.results,
+            "iam_findings" : results,
+            "rendered_report" : rendered_report
+        }
+    else:
+        return rendered_report
 
 
 def get_authorization_files_in_directory(