Skip to main content

depwarden-cli

DepWarden CLI — scan your pip, Poetry, or Pipenv project for supply-chain vulnerabilities.

PyPI License: MIT Website

Quick start

pip install depwarden-cli

APP_API_URL=https://depwarden.in \
APP_API_KEY=DEMO \
depwarden

Use DEMO as the API key for three free full-fidelity scans. Get a permanent key at depwarden.in.

Installation

pip install depwarden-cli

Zero dependencies beyond the Python standard library — nothing else lands in your environment.

Usage

depwarden [options]

The CLI auto-detects your lockfile (requirements.txt, poetry.lock, Pipfile.lock), in that order.

Options

Flag Default Description
--api-url <url> APP_API_URL env DepWarden server base URL
--api-key <key> APP_API_KEY env API key (dw_live_… or DEMO)
--formats <list> html Comma-separated report formats: html,pdf,xlsx,csv
--report-types <list> risk-summary Report types to download
--out <dir> depwarden-reports Directory to write downloaded reports
--fail-on-error <bool> true Fail the process when gate result is fail
--manifest-file <path> (auto-detect) Path to a specific lockfile
--project <name> conformance-fixture Project name sent to the API
--timeout <seconds> 30 Per-request timeout
--retries <n> 3 Max retries on transient network errors
--cache-dir <dir> .depwarden-cache Offline verdict cache directory
--cache-grace <hours> 24 How long a cached verdict stays valid when offline
--verify-signature false Verify the returned verdict's signature server-side
--verbose / -v false Verbose retry and detection output

Environment variables

Variable Description
APP_API_URL Base URL of your DepWarden instance
APP_API_KEY API key — use DEMO for free evaluation

HTTP_PROXY / HTTPS_PROXY / NO_PROXY are honoured automatically (standard urllib behaviour) — no extra configuration needed behind a corporate proxy.

Exit codes

Code Meaning
0 Clean scan, or gate failed with --fail-on-error false
1 Gate result is fail (build should fail)
2 Configuration / IO / network error with no cached verdict
3 Invalid or revoked API key
4 Quota exceeded or demo allowance exhausted

GitHub Actions

- name: DepWarden SCA scan
  env:
    APP_API_URL: https://depwarden.in
    APP_API_KEY: ${{ secrets.APP_API_KEY }}
  run: |
    pip install depwarden-cli
    depwarden --formats html --out reports

Download reports

depwarden --formats html,pdf,xlsx --out ./security-reports

Offline mode

The CLI caches the last successful verdict in .depwarden-cache/. If the server is unreachable, it falls back to the cached result for up to 24 hours (configurable via --cache-grace).

💸 Enjoying this? Your wallet has feelings too.

The free tier is real — no account, no credit card, no sighing. But if you've been meaning to set up proper build gating, PDF reports your manager can pretend to read, and an audit trail for the one time a log4shell happens on your watch…

Upgrade at depwarden.in/pricing →

Plans start at a price that's genuinely less than your last debugging session cost in lost time. Use DEMO as your API key for three full-fidelity test drives before committing.

License

MIT — see LICENSE.

Metadata

Release files for depwarden-cli 1.0.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for depwarden-cli 1.0.0
File Size Uploaded
depwarden_cli-1.0.0.tar.gz 10.6 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for depwarden-cli 1.0.0
File Interpreter ABI Platform
depwarden_cli-1.0.0-py3-none-any.whl Python 3 none any Details

Total release size: 21.2 kB

Release files / depwarden_cli-1.0.0.tar.gz

Download URL depwarden_cli-1.0.0.tar.gz
Size 10.6 kB
Tags Source
SHA-256 checksum
How to use checksums
ca8cf30f8ae68014063b993cf98b7b4eace2d3b3fcff56fe60b388fb8d608e4b
BLAKE2b-256 checksum
How to use checksums
022c14bdf102bafc65736af1c6b68563704b75d3de8fbb5edf7bfd8187bf3a73
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.4

Release files / depwarden_cli-1.0.0-py3-none-any.whl

Download URL depwarden_cli-1.0.0-py3-none-any.whl
Size 10.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
a6e195ee4aec7e1b474ab4dd8d3db118994424f474ca9c2ff9c4d801c9c90624
BLAKE2b-256 checksum
How to use checksums
45a3fd4a645a20d8ac7116067a86c3161ac91a0fa45f943c96682ba9927198a7
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.4

Release history Release notifications | RSS feed

1.1.0

2 release files

This release

1.0.0 This release

2 release files

0.0.1

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page