Metadata-Version: 2.1
Name: py-asoc
Version: 0.3.0
Summary: Description
Home-page: https://github.com/mumblepins/py-asoc/
License: MIT
Author: Daniel Sullivan
Author-email: daniel.j.sullivan@state.mn.us
Requires-Python: >=3.8,<4.0
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Provides-Extra: badges
Requires-Dist: certifi
Requires-Dist: click (>=8.1.3,<9.0.0)
Requires-Dist: cloup
Requires-Dist: javascript ; extra == "badges"
Requires-Dist: python-dateutil
Requires-Dist: pytz
Requires-Dist: urllib3
Project-URL: Documentation, https://mumblepins.github.io/py-asoc/
Project-URL: Repository, https://github.com/mumblepins/py-asoc/
Description-Content-Type: text/markdown

# Appscan on Cloud Python API

Generated initially from Appscan on Cloud (
ASOC) [swagger spec](https://cloud.appscan.com/swagger/index.html), added various functionality and
CLI interface.

## CLI

### Install

#### Requirements

-   ASOC CLI on the path
    -   https://help.hcltechsw.com/appscan/ASoC/src_utility_install.html
-   Node.js >= 14 if you want the ability to generate badges
    -   https://nodejs.org/en/download
    -   Also, prefer to pre-install badge-maker: `npm install badge-maker`

```shell
pip install py-asoc

# or for badges
pip install py-asoc[badges]
```

### Run

```
Usage: asoc [OPTIONS] COMMAND1 [ARGS]... [COMMAND2 [ARGS]...]...

Options:
  -a, --app_id TEXT      ASOC App ID  [required]
  -k, --key_id TEXT      ASOC Key ID  [required]
  -s, --key_secret TEXT  ASOC Key Secret  [required]
  -n, --scan_name TEXT   Scan Name  [default: main]
  -h, --help             Show this message and exit.

Commands:
  num-issues-badge
  scan
  status-badge
  upload-external
  wait
```

#### scan

creates an IRX package and uploads it to ASOC, then either creates a new scan or starts an existing
one.

#### upload-external

Uploads any json files in the givven directory to ASOC as external issues.

#### wait

waits for the scan to finish.

#### status-badge

generates a badge for the application risk level

#### num-issues-badge

generates a badge for the number of unresolved issues for the application

