Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

instruction to run with newman added #50

Open
wants to merge 9 commits into
base: develop
Choose a base branch
from

Conversation

soham4abc
Copy link

Signed-off-by: Soham Banerjee sohambanerjee4abc@hotmail.com
Fixes #26

Signed-off-by: Soham Banerjee <sohambanerjee4abc@hotmail.com>
@soham4abc
Copy link
Author

PTAL @coditva @elit-altum

@soham4abc
Copy link
Author

@coditva does this need any changes?

@elit-altum
Copy link
Contributor

@coditva This is more of a dev-centric usage provided and not about usage of the package. Should we move it to a new CONTRIBUTORS.md ?
cc @soham4abc

@coditva
Copy link
Member

coditva commented Nov 13, 2021

@elit-altum I agree, lets move it there and add a link to it in readme.

@the-rdt
Copy link

the-rdt commented Nov 13, 2021

@elit-altum I agree, lets move it there and add a link to it in readme.

That's actually great.

I had a suggestion w.r.t reporter.
The reporter, as of now isn't published to npm.
Instructions to install the reporter locally using npm pack as in Create custom reporter should be included too.
(I had to struggle a lot setting up the reporter)

README.md Outdated
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.

README.md Outdated Show resolved Hide resolved
README.md Outdated
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

soham4abc and others added 3 commits November 13, 2021 21:20
Co-authored-by: RISHABH D TIWARI <rdtiwari.official@gmail.com>
@soham4abc
Copy link
Author

Please do have a look @the-rdt @coditva

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

Choose a reason for hiding this comment

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

I'm no expert on npm link but I think some modifications are required here.

Give a sec to review this please @coditva .

Copy link
Member

Choose a reason for hiding this comment

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

You're right. The npm link needs to be executed in the newman-dashboard/reporter directory.

@the-rdt
Copy link

the-rdt commented Nov 14, 2021

The provided information looks good.

But any information regarding what has to be done with frontend folder is missing.
Any documentation on npm run dev:client would be good.
This is the command I'm facing issues with right now.

@soham4abc
Copy link
Author

The provided information looks good.

But any information regarding what has to be done with frontend folder is missing. Any documentation on npm run dev:client would be good. This is the command I'm facing issues with right now.

Will the proper documentation be provided to me?
@coditva what you say?

Copy link
Member

@coditva coditva left a comment

Choose a reason for hiding this comment

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

Thanks for sending in the PR! 🚀

One note: I think we can flesh out more details in this file. Currently, we've added a lot of stuff related to git but we should try to add more information about building and running this package.

CONTRIBUTING.md Outdated Show resolved Hide resolved
CONTRIBUTING.md Outdated Show resolved Hide resolved
CONTRIBUTING.md Outdated Show resolved Hide resolved
CONTRIBUTING.md Outdated Show resolved Hide resolved
CONTRIBUTING.md Outdated Show resolved Hide resolved

newman run -r dashboard collection.json
```

Copy link
Member

Choose a reason for hiding this comment

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

We also need to add a section on running and writing tests

Copy link
Author

Choose a reason for hiding this comment

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

please provide me what needs to be written here

```
cd /path/to/newman
npm link
npm link newman-reporter-dashboard
Copy link
Member

Choose a reason for hiding this comment

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

You're right. The npm link needs to be executed in the newman-dashboard/reporter directory.

CONTRIBUTING.md Outdated Show resolved Hide resolved
CONTRIBUTING.md Outdated Show resolved Hide resolved
CONTRIBUTING.md Outdated Show resolved Hide resolved
soham4abc and others added 4 commits November 15, 2021 19:22
Co-authored-by: Utkarsh Maheshwari <coditva@gmail.com>
Co-authored-by: Utkarsh Maheshwari <coditva@gmail.com>
Co-authored-by: Utkarsh Maheshwari <coditva@gmail.com>
@soham4abc
Copy link
Author

Now @coditva provide me with all the additional sub-parts I need to mention in the docs. And do let me know any more changes are required or not. Thanks!

@soham4abc
Copy link
Author

Now @coditva provide me with all the additional sub-parts I need to mention in the docs. And do let me know any more changes are required or not. Thanks!

PTAL @coditva


**Step 2:** Clone the forked repository to your local machine with
```
git clone https://github.com/postmanlabs/newman-dashboard
Copy link
Contributor

Choose a reason for hiding this comment

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

@soham4abc can you just check if https cloning of git repositories is across git versions or specific to some?

Copy link
Author

Choose a reason for hiding this comment

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

https cloning causes problems in Git versions older than 1.7.10.
Should I add some more documentation to update git to latest version?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Document instructions for how to run with Newman
4 participants