Skip to main content

Software security, simplified.

Project description

SOOS Security Analysis: Python Script

Scan your software for vulnerabilities and license issues. Generate SBOMs.

Use SOOS Core SCA to:

  1. Find, fix and monitor known vulnerabilities
  2. Review open source license usage within your project
  3. Track tickets in Jira or GitHub Issues
  4. Generate an SBOM

Supported Languages and Package Managers

Our full list of supported manifest formats can be found here.

Need an Account?

Visit soos.io to create your trial account.

Running the Script

See Script Knowlege Base Documentation

Linux Shell Script Example

See Linux GitHub Gist

Windows CMD Script Example

See Windows Batch File Gist

Script Arguments

Argument Default Description
-h, --help ==SUPPRESS== show this help message and exit
-hf, --helpFormatted False Print the --help command in markdown table format
-m, --mode run_and_wait Mode of operation:
run_and_wait: Run Analysis & Wait ** Default Value,
async_init: Async Init,
async_result: Async Result
For more information about scan modes, visit https://github.com/soos-io/kb-docs/blob/main/SCA/Script.md
-of, --onFailure continue_on_failure On Failure:
fail_the_build: Fail The Build
continue_on_failure: Continue On Failure ** Default Value
-dte, --directoriesToExclude None Listing of directories (relative to ./) to exclude from the search for manifest files.
Example - Correct: bin/start/
Example - Incorrect: ./bin/start/
Example - Incorrect: /bin/start
-fte, --filesToExclude None Listing of files (relative to ./) to exclude from the search for manifest files.
Example - Correct: bin/start/requirements.txt
Example - Incorrect: ./bin/start/requirements.txt
Example - Incorrect: /bin/start/requirements.txt
-wd, --workingDirectory None Absolute path where SOOS may write and read persistent files for the given build.
Example - Correct: /tmp/workspace/
Example - Incorrect: ./bin/start/
Example - Incorrect: tmp/workspace
-armw, --resultMaxWait 300 Maximum seconds to wait for Analysis Result. Default 300.
-arpi, --resultPollingInterval 10 Polling interval (in seconds) for analysis result completion (success/failure).
Min value: 10
-pm, --packageManagers None A list of package managers, delimited by comma, to include when searching for manifest files.
-buri, --baseUri https://api.soos.io/api/ SOOS API URI Path. Default Value: https://api.soos.io/api/
Intended for internal use only.
-scp, --sourceCodePath None Root path to begin recursive search for manifests. Default Value: ./
-pn, --projectName None Project name for tracking results, (this will be the one used inside of the SOOS App)
-cid, --clientId None Client ID, get yours from https://app.soos.io/integrate/sca
-akey, --apiKey None API Key, get yours from https://app.soos.io/integrate/sca
-v, --verbosity INFO Set logging verbosity level value (INFO/DEBUG)
--verbose False Enable verbose logging
-ch, --commitHash None Commit Hash Value
-bn, --branchName None Branch Name
-bruri, --branchUri None Branch URI
-bldver, --buildVersion None Build Version
-blduri, --buildUri None Build URI
-oe, --operatingEnvironment None Operating Environment
-appver, --appVersion None App Version. Intended for internal use only.
-intn, --integrationName None Integration Name (e.g. Provider)
-intt, --integrationType None Integration Type. Intended for internal use only.
-sarif False Upload SARIF Report to GitHub
-gpat False GitHub Personal Authorization Token

Feedback and Support

See SOOS Knowledge Base

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

soos-sca-1.7.5rc2.tar.gz (20.9 kB view hashes)

Uploaded Source

Built Distribution

soos_sca-1.7.5rc2-py3-none-any.whl (19.5 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page