{"id":25144169,"url":"https://github.com/darkstarbdx/crashwave","last_synced_at":"2025-04-03T05:41:15.302Z","repository":{"id":270427345,"uuid":"910349657","full_name":"darkstarbdx/CrashWave","owner":"darkstarbdx","description":"CrashWave is a powerful Python-based load testing tool designed to simulate high traffic on websites or web applications.","archived":false,"fork":false,"pushed_at":"2024-12-31T05:07:23.000Z","size":19,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-08T19:39:13.315Z","etag":null,"topics":["cybersecurity","ddos","ddos-tool","dos","ethical-hacking","http-requests","load-testing","multi-threading","performance-testing"],"latest_commit_sha":null,"homepage":"","language":"Python","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/darkstarbdx.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,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-12-31T03:41:25.000Z","updated_at":"2024-12-31T05:07:26.000Z","dependencies_parsed_at":"2024-12-31T04:34:00.150Z","dependency_job_id":"f0f09262-7b2c-4d1e-92ec-af93765c8d1e","html_url":"https://github.com/darkstarbdx/CrashWave","commit_stats":null,"previous_names":["darkstarbdx/crashwave"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/darkstarbdx%2FCrashWave","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/darkstarbdx%2FCrashWave/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/darkstarbdx%2FCrashWave/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/darkstarbdx%2FCrashWave/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/darkstarbdx","download_url":"https://codeload.github.com/darkstarbdx/CrashWave/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246944384,"owners_count":20858773,"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":["cybersecurity","ddos","ddos-tool","dos","ethical-hacking","http-requests","load-testing","multi-threading","performance-testing"],"created_at":"2025-02-08T19:38:03.235Z","updated_at":"2025-04-03T05:41:15.276Z","avatar_url":"https://github.com/darkstarbdx.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# **CrashWave** 🌊\n\n**CrashWave** is a powerful Python-based load testing tool designed to simulate high traffic on websites or web applications. With its **Rich UI**, **adaptive load testing modes**, and **detailed reporting**, **CrashWave** helps developers and DevOps engineers test the performance, scalability, and resilience of their systems under heavy load. Whether you’re testing a single endpoint or a complex web application, **CrashWave** provides the tools you need to ensure your system can handle real-world traffic.\n\n---\n\n## **Features** ✨\n- **Rich UI**: Beautiful and interactive terminal interface powered by the `rich` library.\n- **Load Test Modes**:\n  - **Constant**: Sends requests at a constant rate.\n  - **Burst**: Sends requests in bursts to simulate sudden traffic spikes.\n  - **Ramp**: Gradually increases the request rate over time.\n  - **Random**: Sends requests with random delays for realistic traffic simulation.\n- **Multi-Threaded**: Sends concurrent requests using a dynamic thread pool.\n- **Randomized User Agents**: Simulates real users with a large pool of user agent strings.\n- **Retry Mechanism**: Automatically retries failed requests.\n- **Adaptive Behavior**: Adjusts request delays and retries based on server responses.\n- **Detailed Reporting**: Provides success rates, average response times, and error summaries.\n- **Real-Time Progress**: Displays progress using a `tqdm` progress bar.\n\n---\n\n## **Warning** ⚠️\n**CrashWave is intended for ethical and authorized use only.**  \n- **Permission**: Always obtain explicit permission before testing any website or application.  \n- **Legal Compliance**: Unauthorized use of this tool may violate laws and regulations.  \n- **Responsibility**: The user assumes full responsibility for any consequences of using this tool.  \n\n---\n\n## **Disclaimer** 🤖\nThis tool was developed with the assistance of **AI (Artificial Intelligence)**. While it has been thoroughly tested, please use it at your own risk and ensure it aligns with your ethical and legal standards.\n\n---\n\n## **Installation** 🛠️\n1. Clone the repository:\n   ```bash\n   git clone https://github.com/darkstarbdx/CrashWave.git\n   cd CrashWave\n   ```\n2. Install the required dependencies:\n   ```bash\n   pip3 install -r requirements.txt\n   ```\n\n---\n\n## **Requirements** 📦\nThe required Python packages are listed in `requirements.txt`:\n```plaintext\nrequests==2.31.0\nrich==13.4.2\n```\n\nInstall them using:\n```bash\npip3 install -r requirements.txt\n```\n\n---\n\n## **Usage** 🚦\nRun the script and provide the required inputs:\n```bash\npython3 CrashWave.py\n```\n\n### **Inputs**:\n- **Target URL**: The URL to test (e.g., `https://example.com`).\n- **Number of Requests**: Total number of requests to send.\n- **Max Threads**: Maximum number of concurrent threads.\n- **HTTP Method**: `GET` or `POST`.\n- **Retries**: Number of retries for failed requests.\n- **Load Test Mode**: Choose from `constant`, `burst`, `ramp`, or `random`.\n- **Request Rate/Delays**: Configure based on the selected mode.\n\n### **Example**:\n```plaintext\n✦ Enter the target URL (e.g., https://example.com): https://example.com\n✦ Enter the number of requests [default: 100]: 100\n✦ Enter the maximum number of concurrent threads [default: 10]: 10\n✦ Enter the HTTP method (GET/POST) [default: GET]: GET\n✦ Enter the number of retries for failed requests [default: 3]: 3\n✦ Enter the load test mode (constant/burst/ramp/random) [default: constant]: constant\n✦ Enter the request rate (requests per second) [default: 10]: 10\n```\n\n---\n\n## **Load Test Modes** 🔥\n- **Constant**: Sends requests at a fixed rate (e.g., 10 requests per second).\n- **Burst**: Sends a large number of requests in a short period to simulate traffic spikes.\n- **Ramp**: Gradually increases the request rate over time to test system scalability.\n- **Random**: Sends requests with random delays for more realistic traffic simulation.\n\n---\n\n## **Output** 📊\nThe tool provides a detailed summary of the load test, including:\n- Total requests\n- Successful requests\n- Failed requests\n- Average response time\n- Total time\n- Requests per second\n- Error summary (if any)\n\n---\n\n## **Example Output** 📄\n```plaintext\nTest Results:\n● Target URL: https://example.com\n● Total Requests: 100\n● Successful Requests: 98\n● Failed Requests: 2\n● Average Response Time: 0.25 seconds\n● Total Time: 6.12 seconds\n● Requests Per Second: 16.34\n\nError Summary:\n● 404: 2 occurrences\n```\n\n---\n\n## **Contributing** 🤝\nContributions are welcome! If you have suggestions, bug reports, or feature requests, please open an issue or submit a pull request.\n\n---\n\n## **License** 📜\nThis project is licensed under the **MIT License**. See the [LICENSE](LICENSE) file for details.\n\n---\n\n## **Credits** 🙏\nThis tool was developed with the assistance of **AI (Artificial Intelligence)**.\n\n---\n\n## **Support** 💬\nIf you have any questions or need help, feel free to open an issue or contact the maintainers.\n✨ Want to get in touch?\n🌟 Join our vibrant Telegram community!\n👉 Click here to connect: [Telegram Group](https://t.me/+mzZ9IrWgXe9jNWNl)\n\n---\n\n**Happy Testing with CrashWave!** 🌊🚀\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdarkstarbdx%2Fcrashwave","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdarkstarbdx%2Fcrashwave","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdarkstarbdx%2Fcrashwave/lists"}