{"id":15695653,"url":"https://github.com/prongbang/postman-runner","last_synced_at":"2025-05-08T21:27:22.075Z","repository":{"id":183398451,"uuid":"670074021","full_name":"prongbang/postman-runner","owner":"prongbang","description":"Run multiple Postman collections with a single command.","archived":false,"fork":false,"pushed_at":"2024-09-25T07:11:43.000Z","size":260,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2024-10-10T19:07:43.622Z","etag":null,"topics":["newman","newman-multiple-collections","postman","postman-runner","report-summary-generator"],"latest_commit_sha":null,"homepage":"","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/prongbang.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2023-07-24T08:34:19.000Z","updated_at":"2024-09-25T07:11:46.000Z","dependencies_parsed_at":"2024-01-02T05:27:27.844Z","dependency_job_id":"5f3f08d6-6a6b-4624-b45a-536a4021a555","html_url":"https://github.com/prongbang/postman-runner","commit_stats":null,"previous_names":["prongbang/postman-runner"],"tags_count":8,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/prongbang%2Fpostman-runner","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/prongbang%2Fpostman-runner/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/prongbang%2Fpostman-runner/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/prongbang%2Fpostman-runner/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/prongbang","download_url":"https://codeload.github.com/prongbang/postman-runner/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":221248569,"owners_count":16784759,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["newman","newman-multiple-collections","postman","postman-runner","report-summary-generator"],"created_at":"2024-10-03T19:03:00.043Z","updated_at":"2025-05-08T21:27:22.068Z","avatar_url":"https://github.com/prongbang.png","language":"Rust","funding_links":["https://www.buymeacoffee.com/prongbang"],"categories":[],"sub_categories":[],"readme":"# postman-runner ⚡️\n\n[![Rust](https://img.shields.io/badge/Rust-1.70+-orange.svg)](https://www.rust-lang.org)\n[![Platform](https://img.shields.io/badge/platform-Linux%20%7C%20macOS%20%7C%20Windows-blue.svg)](https://github.com/prongbang/postman-runner)\n[![Homebrew](https://img.shields.io/badge/Homebrew-available-green.svg)](https://brew.sh)\n[![License](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)\n\n\u003e Run multiple Postman collections with a single command. Automate your API testing workflow efficiently.\n\n![postman-runner preview](screenshots/preview.png)\n\n## ✨ Features\n\n- 🚀 **Multiple Collections** - Run multiple Postman collections in one go\n- 📊 **Beautiful Reports** - Generate HTML reports with various styles\n- ⚙️ **Flexible Configuration** - Easily configure through YAML files\n- 🎯 **Selective Execution** - Run specific collections by name\n- 🔄 **Sync Mode** - Run collections synchronously for local testing\n- 📝 **Detailed Logging** - Comprehensive logs for debugging\n- 🛡️ **Insecure Mode** - Support for self-signed certificates\n\n## 🚀 Quick Start\n\n1. Install postman-runner\n2. Create a `config.yml` file\n3. Run your collections!\n\n```shell\n# Run all collections\npostman-runner --config config.yml\n\n# Run specific collection\npostman-runner --config config.yml --name collection-1\n\n# Run in sync mode\npostman-runner --sync\n```\n\n## 📦 Installation\n\n### Via Homebrew (Recommended)\n\n```shell\nbrew update\nbrew tap prongbang/homebrew-formulae\nbrew install postman-runner\n```\n\n### Via Cargo\n\n```shell\ncargo install postman-runner --git https://github.com/prongbang/postman-runner.git\n```\n\n### From Source\n\n```shell\n# Install Rust if you haven't already\ncurl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh\n\n# Clone and build\ngit clone https://github.com/prongbang/postman-runner.git\ncd postman-runner\ncargo build --release\n```\n\n## ⚙️ Configuration\n\nCreate a `config.yml` file in your project:\n\n```yaml\nreport:\n  name: Weather Report\n  filename: reporter/weather-report.html\n  reporter: html\nlogger: true\ncommands:\n  - name: newman\n    standalone: true\n    command: newman -v\n  - name: collection-1\n    collection: local\n    command: newman run xxxx -e xxxx\n  - name: collection-2\n    skipped: true\n    insecure: true\n    command: newman run xxxx -e xxxx\n```\n\n### Configuration Options\n\n| Option | Description |\n|--------|-------------|\n| `name` | Unique identifier for each command |\n| `collection: local` | Run the collection locally |\n| `skipped: true` | Skip this collection during execution |\n| `standalone: true` | Run the command independently |\n| `insecure: true` | Allow insecure SSL certificates |\n\n## 📊 Report Generation\n\n### Prerequisites\n\nInstall Newman and desired reporters:\n\n```shell\n# Install Newman\nbrew install newman\n\n# Install HTML reporters\nnpm install -g newman-reporter-html\nnpm install -g newman-reporter-htmlextra\n```\n\n### Available Reporters\n\n- **html** - Basic HTML report\n- **htmlextra** - Enhanced HTML report with additional features\n\n### Report Structure\n\n```\nproject/\n├── config.yml\n└── reporter/\n    ├── get-weather-1.html\n    ├── get-weather-2.html\n    ├── get-weather-3.html\n    └── weather-report.html\n```\n\n## 💻 Command Line Usage\n\n### Commands\n\n```shell\n# Show help\npostman-runner --help\n\n# Run with custom config\npostman-runner --config custom-config.yml\n\n# Run specific collection\npostman-runner --config config.yml --name collection-1\n\n# Run in sync mode (local)\npostman-runner --sync\n\n# Enable verbose logging\npostman-runner --config config.yml --verbose\n```\n\n### Options\n\n| Option | Short | Description |\n|--------|-------|-------------|\n| `--config` | `-c` | Specify configuration file |\n| `--name` | `-n` | Run specific collection by name |\n| `--sync` | `-s` | Run collections synchronously |\n| `--verbose` | `-v` | Enable verbose logging |\n| `--help` | `-h` | Show help information |\n\n## 🌟 Use Cases\n\n- **API Testing** - Automate API testing across multiple collections\n- **CI/CD Integration** - Integrate with your CI/CD pipeline\n- **Regression Testing** - Run automated regression tests\n- **Environment Testing** - Test APIs across different environments\n- **Performance Testing** - Measure API performance\n- **Integration Testing** - Test API integrations\n\n## 🔍 Best Practices\n\n1. **Organize Collections** - Group related APIs in collections\n2. **Use Environment Variables** - Store sensitive data in environment files\n3. **Regular Execution** - Schedule regular test runs\n4. **Monitor Reports** - Review reports for failures\n5. **Version Control** - Keep config files in version control\n\n## 🤝 Contributing\n\nContributions are welcome! Please feel free to submit issues and pull requests.\n\n## 📄 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## 🔗 Links\n\n- [Documentation](https://github.com/prongbang/postman-runner/wiki)\n- [Issue Tracker](https://github.com/prongbang/postman-runner/issues)\n- [Newman Documentation](https://learning.postman.com/docs/running-collections/using-newman-cli/command-line-integration-with-newman/)\n\n## 💖 Support the Project\n\nIf you find this package helpful, please consider supporting it:\n\n[![\"Buy Me A Coffee\"](https://www.buymeacoffee.com/assets/img/custom_images/orange_img.png)](https://www.buymeacoffee.com/prongbang)\n\n## 🙏 Acknowledgments\n\n- Built with Rust 🦀\n- IDE Support by [RustRover](https://www.jetbrains.com/rust/)\n\n![RustRover](https://resources.jetbrains.com/help/img/idea/2024.3/RustRover_icon.svg)\n\n---\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fprongbang%2Fpostman-runner","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fprongbang%2Fpostman-runner","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fprongbang%2Fpostman-runner/lists"}