newman-script-helper

Files (1)

• SKILL.md

SKILL.md (first lines)

# Newman Script Generator

Generate complete, ready-to-run Newman CLI commands tailored to the user's collection, environment, and reporting needs.

## What Newman Is

Newman is Postman's official CLI collection runner. It lets you run Postman collections from the terminal, CI pipelines, and scripts.

Install: `npm install -g newman`
Optional HTML reporter: `npm install -g newman-reporter-htmlextra`

---

## Core Command Structure

```
newman run <collection> [options]
```

`<collection>` can be:
- A local file path: `./my-collection.json`
- A Postman API URL: `https://api.getpostman.com/collections/<id>?apikey=<key>`
- A public share link

---

## Key Flags Reference

### Input / Source
| Flag | Description |
|------|-------------|
| `-e, --environment <path>` | Postman environment file (.json) |
| `-g, --globals <path>` | Postman globals file (.json) |
| `-d, --iteration-data <path>` | CSV or JSON data file for iterations |
| `--folder <name>` | Run only a specific folder by name |

### Execution Control
| Flag | Description |
|------|-------------|
| `-n, --iteration-count <n>` | Number of iterations to run |
| `--timeout <ms>` | Overall run timeout in milliseconds |
| `--timeout-request <ms>` | Per-request timeout in milliseconds |
| `--timeout-script <ms>` | Per-script timeout in milliseconds |
| `--delay-request <ms>` | Delay between requests (ms) |
| `--bail` | Stop run on first test failure |
| `--ignore-redirects` | Don't follow HTTP redirects |
| `-k, --insecure` | Disable SSL certificate verification |

### Reporters
| Flag | Description |
|------|-------------|
| `-r cli` | Default terminal output |
| `-r json` | JSON results file |
| `-r junit` | JUnit XML (for CI systems) |
| `-r htmlextra` | Rich HTML report (requires separate install) |
| `--reporter-json-export <path>` | Output path for JSON report |
| `--reporter-junit-export <path>` | Output path for JUnit XML |
| `--reporter-htmlextra-export <path>` | Output path for HTML report |
| `--reporter-htmlextra-title <title>` | Title for HTML report |

### Environment Variables (inline override)
```
--env-var "KEY=value"
--global-var "KEY=value"
```

---

## Common Patterns

### Basic run with environment
```bash
newman run collection.json -e environment.json
```

### Run with HTML + JUnit reports (CI-friendly)
```bash
newman run collection.json \
  -e environment.json \
  -r cli,junit,htmlextra \
  --reporter-junit-export results/junit.xml \
  --reporter-htmlextra-export results/report.html \
  --reporter-htmlextra-title "API Test Results"
```

### Data-driven run (CSV iterations)
```bash
newman run collection.json \
  -e environment.json \
  -d test-data.csv \
  -n 5
```

### Run a single folder only
```bash
newman run collection.json \
  -e environment.json \
  --folder "Auth Tests"
```

### Fail fast + timeout
```bash
newman run collection.json \
  -e environment.json \
  --bail \
  --timeout-request 5000
```

### Run from Postman API (no local file)
```bash
newman run "https://api.getpostman.com/collections/COLLECTION_ID?apikey=$POSTMAN_API_KEY" \
  -e environment.json
```

---

## How to Generate Commands

When the user asks for a Newman command:

From LambdaTest/agent-skills, MIT.

More from LambdaTest/agent-skills