Skip to content
Open
Changes from 2 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
40 changes: 40 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,6 +14,46 @@ Newman Dashboard aims to provide a real-time WebUI dashboard which can let you c

This project was built during [Google Summer of Code 2021](https://summerofcode.withgoogle.com/projects/#5547391014404096) ☀️ with [Postman](https://github.com/postmanlabs) 🚀


## Usage

This package is both a reporter and a standalone package. The standalone package takes care of launching the dashboard, while the reporter connects to the newman run.

A. For installation:

```
npm install -g newman-dashboard
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We should remove this because we've not published the package. See #51

Copy link

@the-rdt the-rdt Nov 13, 2021

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actually source code for reporter is already there.
All we have to do is execute just one more command before this.

npm pack reporter
This will generate a .tgz file, in my case it was newman-reporter-dashboard-0.0.1.tgz
then we can use
npm i -g newman-reporter-dashboard-0.0.1.tgz to install the package.

@soham4abc are you still working on this? Or should I create an issue for creating a new CONTRIBUTORS.md file and work on this?

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I am working on this give me some time

```

B. Launch the dashboard on `localhost:5001`

```
newman-dashboard
```

You can also choose to daemonize the dashboard using the `--daemonize` flag.

The dashboard frontend would now be visible on `http://localhost:5001/`

C. Connect a newman run to the dashboard

```
newman run collection.json -r dashboard
```
This will connect the run to the dashboard and you would be able to view its status on the frontend.

D. Run file with Newman

```
npm link
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think to issue npm link command, you should be in the reporter directory inside newman-dashboard,

cd path/to/newman-dashboard/reporter should be included before npm link command here.

cd /path/to/newman
npm link newman-reporter-dashboard

bin/newman.js run -r dashboard collection.json
```



## Environment setup

A. Install all dependencies
Expand Down