{"id":37787717,"url":"https://github.com/lunjon/blast","last_synced_at":"2026-01-16T15:13:53.846Z","repository":{"id":118783582,"uuid":"537182196","full_name":"lunjon/blast","owner":"lunjon","description":"Load testing framework for HTTP APIs, powered by Elixir.","archived":false,"fork":false,"pushed_at":"2025-11-26T21:38:50.000Z","size":2151,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-11-29T17:12:55.095Z","etag":null,"topics":["elixir","load-testing"],"latest_commit_sha":null,"homepage":"","language":"Elixir","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/lunjon.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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2022-09-15T19:42:51.000Z","updated_at":"2025-11-26T21:39:03.000Z","dependencies_parsed_at":"2024-01-23T21:41:14.425Z","dependency_job_id":"bf9527a1-bf2b-4aef-9681-183afa76ebcd","html_url":"https://github.com/lunjon/blast","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/lunjon/blast","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lunjon%2Fblast","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lunjon%2Fblast/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lunjon%2Fblast/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lunjon%2Fblast/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/lunjon","download_url":"https://codeload.github.com/lunjon/blast/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lunjon%2Fblast/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28479406,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-16T11:59:17.896Z","status":"ssl_error","status_checked_at":"2026-01-16T11:55:55.838Z","response_time":107,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["elixir","load-testing"],"created_at":"2026-01-16T15:13:53.741Z","updated_at":"2026-01-16T15:13:53.821Z","avatar_url":"https://github.com/lunjon.png","language":"Elixir","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Blast\n\nLoad test framework, written in Elixir, that targets HTTP APIs.\n\n## Running and installation\n\nYou will need to install Elixir v1.18+ in order to run blast.\n\n#### escript\nBuild the escript using `just build`, then use the artifact like so:\n```sh\n./blast -h\n```\n\n#### nix\nWith nix installed you can run:\n\n```sh\nnix run . -- -h\n```\n\nor\n\n```sh\nnix develop\njust build\n./blast -h # escript\n```\n\nIf you're using nix with flake support you can also install it:\n```sh\nnix profile add .\n```\n\nWhen started a simple web interface is started on [localhost:4000](http://localhost:4000).\nHowever, to be able to start `blast` you need to configure it.\n\n## Configuration\n\nThe configuration is done through an Elixir module in a file you specify.\nA minimal example looks something like this:\n\n```elixir\ndefmodule Blast do\n  # The module must always include this.\n  use Blastfile\n\n  # This is the first required function.\n  # It must return a valid URL to be used as the base for the requests.\n  def base_url() do\n    \"https://myapi.example\"\n  end\n\n  # This is the second required function.\n  # It must return a non-empty list of maps that specifies the requests to send.\n  def requests() do\n    [\n      %{\n        method: \"get\",\n        path: \"/resource\" # all paths are relative to the base URL.\n      }\n    ]\n  end\nend\n```\n\n\u003e [!NOTE]\n\u003e Don't know Elixir? Don't worry! The syntax is very simple.\n\n\nBy default blast will look for a `blast.ex[s]` file in the current working directory,\nbut you can specify a location with the `-b/--blastfile` option.\n\n### Options\n\nHere a small breakdown of the most important options that you need\nin order to run blast. The module, and sometimes function definitions\nwill be omitted for brewity.\n\n#### Base URL\nAll requests are specified by atleast method and path, where path is relative to the base URL:\n```elixir\ndef base_url() do\n  \"http://myapi.cool\"\nend\n```\n\n#### Method and path\nRequests are given by the `requests()` function:\n```elixir\ndef requests() do\n  [\n    %{method: \"get\", path: \"/resource/path\"},\n    %{method: \"get\", path: \"/testing?fail=true\"},\n  ]\nend\n```\n\nThe `%{}` syntax is a _map_ in Elixir, and each request requires atleast:\n- `method`: HTTP method, lower case or upper case.\n- `path`: Relative path of the request URL.\n\n\n#### Headers\nHTTP Headers can be specified per request using the `headers` key:\n```elixir\n%{\n  method: \"get\",\n  path: \"/testing\",\n  headers: [\n    # These are called tuples.\n    {\"name1\", \"value1\"},\n    {\"name2\", \"value2\"},\n  ]\n}\n```\n\n#### Default headers\nHTTP Headers to include for every request can be specified with the `default_headers()` function:\n```elixir\n# This should return a list of two-element tuples.\ndef default_headers() do\n  [\n    # These are called tuples\n    {\"name1\", \"value1\"},\n    {\"name2\", \"value2\"},\n  ]\nend\n```\n\nFor a full specification of the blast module see the [docs](./docs/blast.md).\n\n## Development\n\nI recommend using the nix flake, like so:\n\n```sh\nnix develop   # It takes a while the first time\nmix deps.get  # Fetch dependencies\niex -S mix    # Start the application in IEx\n```\n\nNote that when running `iex -S mix`:\n- Starts the server as well\n- Using `recompile` inside iex will recompile and restart the application\n- The `./examples/basic.ex` is loaded as the blastfile\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flunjon%2Fblast","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flunjon%2Fblast","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flunjon%2Fblast/lists"}