{"id":17469430,"url":"https://github.com/anshulrgoyal/bust","last_synced_at":"2025-06-26T02:04:20.771Z","repository":{"id":112600883,"uuid":"253107528","full_name":"anshulrgoyal/bust","owner":"anshulrgoyal","description":"Load Testing tool.","archived":false,"fork":false,"pushed_at":"2022-08-19T20:49:52.000Z","size":69,"stargazers_count":4,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-05-05T16:02:22.243Z","etag":null,"topics":["benchmark-framework","cli","http","https","rust","server","tool"],"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/anshulrgoyal.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","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":"2020-04-04T22:06:44.000Z","updated_at":"2022-08-19T20:49:55.000Z","dependencies_parsed_at":"2023-03-13T13:25:38.234Z","dependency_job_id":null,"html_url":"https://github.com/anshulrgoyal/bust","commit_stats":null,"previous_names":[],"tags_count":8,"template":false,"template_full_name":null,"purl":"pkg:github/anshulrgoyal/bust","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/anshulrgoyal%2Fbust","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/anshulrgoyal%2Fbust/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/anshulrgoyal%2Fbust/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/anshulrgoyal%2Fbust/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/anshulrgoyal","download_url":"https://codeload.github.com/anshulrgoyal/bust/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/anshulrgoyal%2Fbust/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261984651,"owners_count":23240303,"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":["benchmark-framework","cli","http","https","rust","server","tool"],"created_at":"2024-10-18T15:32:04.832Z","updated_at":"2025-06-26T02:04:20.744Z","avatar_url":"https://github.com/anshulrgoyal.png","language":"Rust","readme":"![Rust](https://github.com/anshulrgoyal/bust/workflows/Rust/badge.svg)\n\n# bust\nIt is a simple server bench marking tool it is not a scientific tool for bench marking it provide a very crude idea of the load management capability of your server.\n\n# Highlights\n- It support both **HTTP** and **HTTPS** .\n- Custom method can be added to request using `-M` option .\n- Any header can be added to request using `-H` option and repeation is allowed .\n- File upload is also supported throught `-f` flag with mutlipart/formdata content-type header.\n- Body can be passed to supported type of request using `-d` flag .\n- Number of concurrent request is required. Can be passed with `-c` option.\n- Total number of request should also be passed using `-n` flag.\n- Auth details can be passed using `-a` option.\n\n```\nUsage: bust \u003curl\u003e [-a \u003cauth\u003e] [-C \u003ccookies\u003e] [-M \u003cmethod\u003e] -c \u003cconcurrency\u003e -n \u003ctotal-request\u003e [-H \u003cheaders\u003e] [-f \u003cfile\u003e] [-d \u003cdata\u003e]\n\nA tool for Stress Testing\n\nOptions:\n  -a, --auth        pass username  and password in form of username:password\n  -C, --cookies     provide cookie for the request\n  -M, --method      custom http method\n  -c, --concurrency concurrency the number of concurrent request\n  -n, --total-request\n                    total number of request made\n  -H, --headers     custom header for request\n  -f, --file        file path to upload the file\n  -d, --data        data to be sent in request\n  --help            display usage information\n\n```\n\n## Add Header to Request\nAdding a header is simple as adding just a option with format of `\u003cheader_name\u003e=\u003cheader_value\u003e` for example `content-type=application/json` . We can add any number of headers.\n\n```bash\n\n$ bust -n 20 -c 5 https://www.google.com -H auth=\u003cauth-token\u003e -H user-agent=\u003cuser-agent-name\u003e\n\n``` \n\n## Add Custom Method for Request\nAdding custom method is done by using `-M` option. All the **HTTP** method are supported. Eg. _POST_ , _PUT_ etc.\n\n```bash\n\n$ bust -n 20 -c 5 https://www.google.com -M POST -H auth=\u003cauth-token\u003e -H user-agent=\u003cuser-agent-name\u003e\n\n``` \n\n## Add file for upload\nUpload file with request using multipart/formdata header. Eg. `-f \u003cfield-name\u003e=\u003cfile-path\u003e` .\n\n```bash\n\n$ bust -n 20 -c 5 https://www.google.com -M POST -f image=./path/to/file\n\n``` \nwhere `image` is field-name and `./path/to/file` is path of file.\n\n## Adding Body to request\nBody is passed using `-d` in form of string. Eg . -d \\{\\\"name\\\":\\\"bust\\\"\\}\n\n```bash\n\n$ bust -n 20 -c 5 https://www.google.com -M POST -H content-type=application/json -d \\{\\\"name\\\":\\\"bust\\\"\\}\n\n``` \n\n## Adding Cookies to request\nAdding cookie is simple using `-C` option which is repeatable. Syntax `-C \u003ccookie\u003e` .\n\n```bash\n\n$ bust -n 20 -c 5 https://www.google.com -M POST -C auth=76rtitutuit\n\n``` ","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fanshulrgoyal%2Fbust","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fanshulrgoyal%2Fbust","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fanshulrgoyal%2Fbust/lists"}