nessus-launcher 0.1.1

A high-level Rust library for launching Nessus scans with retries, parallelism, and structured logging.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126

# nessus-launcher

[![Crates.io](https://img.shields.io/crates/v/nessus-launcher.svg)](https://crates.io/crates/nessus-launcher)
[![Docs.rs](https://docs.rs/nessus-launcher/badge.svg)](https://docs.rs/nessus-launcher)
![License](https://img.shields.io/badge/license-MIT-blue.svg)
[![CI](https://github.com/alexw216/nessus-launcher/actions/workflows/ci.yml/badge.svg)](https://github.com/alexw216/nessus-launcher/actions)

A production‑grade Rust library and CLI for launching Nessus scans with:

- 🔄 Automatic retry with exponential backoff  
- ⚡ Parallel scan launching  
- 🧩 `.env` configuration  
- 📊 Structured logging (`tracing`)  
- 🧰 Reusable library + CLI binary  
- ❄️ Reproducible builds via Nix flake  

Designed for automation, CI pipelines, and secure operational workflows.

---

## 📦 Installation

### Library (crates.io)

```toml
[dependencies]
nessus-launcher = "0.1"

CLI (GitHub Releases)
cargo install nessus-cli


Quick Start (CLI)
Launch scans explicitly:
nessus-cli --scan 5 --scan 8


Or configure via .env:
NESSUS_HOST=https://nessus.example.com
NESSUS_USERNAME=admin
NESSUS_PASSWORD=secret
DEFAULT_SCAN_IDS=5,8,11


Then simply run:

nessus-cli


Library Example

use nessus_launcher::{NessusClient, NessusConfig, Result};

#[toktokio::main]
async fn main() -> Result<()> {
    let config = NessusConfig::from_env()?;
    let client = NessusClient::new(config)?;
    client.launch_scans_parallel(vec![5, 8]).await?;
    Ok(())
}


Documentation

Full API docs:
https://docs.rs/nessus-launcher (docs.rs in Bing)

Examples:

cargo run --example basic
cargo run --example parallel


Project Structure

nessus-launcher/
├── src/                # Library source code
├── nessus-cli/         # CLI binary crate
├── examples/           # docs.rs examples
├── tests/              # minimal tests
├── scripts/            # build scripts
├── .github/workflows/  # CI pipeline
├── Makefile            # build/run/release automation
└── flake.nix           # reproducible Nix environment


Development

Build
gmake build


Run CLI

gmake run ARGS="--scan 5"


Test

cargo test


Format and lint

cargo fmt
cargo clippy --all-targets -- -D warnings


Nix Development Shell

nix develop
cargo build



License

This project is licensed under the MIT License.
See LICENSE for details.

Acknowledgments

This project provides a clean, modern, async Rust interface for Nessus automation workflows, with a focus on reliability, reproducibility, and operational clarity.