{"id":38971611,"url":"https://github.com/subranag/mockaroo","last_synced_at":"2026-01-17T16:39:20.076Z","repository":{"id":57569696,"uuid":"236667525","full_name":"subranag/mockaroo","owner":"subranag","description":"Mock-A-🦘 (mock-aa-roo) a comprehensive HTTP/HTTPS interface mocking tool for all your development and testing needs! ","archived":false,"fork":false,"pushed_at":"2021-03-01T06:13:44.000Z","size":121,"stargazers_count":22,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2024-06-20T06:37:49.066Z","etag":null,"topics":["developer-tools","integration-testing","interface-definitions","productivity","testing-tools"],"latest_commit_sha":null,"homepage":"","language":"Go","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/subranag.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-01-28T05:47:19.000Z","updated_at":"2024-02-04T08:48:10.000Z","dependencies_parsed_at":"2022-09-26T19:00:44.104Z","dependency_job_id":null,"html_url":"https://github.com/subranag/mockaroo","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/subranag/mockaroo","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/subranag%2Fmockaroo","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/subranag%2Fmockaroo/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/subranag%2Fmockaroo/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/subranag%2Fmockaroo/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/subranag","download_url":"https://codeload.github.com/subranag/mockaroo/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/subranag%2Fmockaroo/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28511868,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-17T13:38:16.342Z","status":"ssl_error","status_checked_at":"2026-01-17T13:37:44.060Z","response_time":85,"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":["developer-tools","integration-testing","interface-definitions","productivity","testing-tools"],"created_at":"2026-01-17T16:39:19.964Z","updated_at":"2026-01-17T16:39:20.053Z","avatar_url":"https://github.com/subranag.png","language":"Go","readme":"# Mock-a-(roo)🦘\ncomprehensive HTTP/HTTPS interface mocking tool for all your development and testing needs! \n- supports complex request matching (path/query/headers/verb)\n- mock response can be fully templated; with request body/query/header params in template context\n- config language is *hashicorp HCL*, **human readable with single line and multiline comments**, perfect for documenting your interface\n- mock complex HTTP API and send the mockaroo file to client developer for testing; communicate intent clearly; document your API\n- run integration tests locally with ease\n- add delays to mock real world response times\n- full support for *generating fake data* using https://github.com/brianvoe/gofakeit\n- support for HTTPS in case you need it\n\n## Getting Started: Mock HTTP Server in under a minute\n- Step 1: download mockaroo latest binary [here](https://github.com/subranag/mockaroo/releases) for your target platform and rename the file to `mockaroo` you wil have to do `chmod +x mockaroo` for darwin and linux\n- Step 2: add this content to a file `mock.hcl`\n```hcl\nserver {\n    listen_addr = \"localhost:5000\"\n    mock \"hello_world\" {\n        request {\n            path = \"/hello/{userName}\"\n            verb = \"GET\"\n        }\n        response {\n            body = \u003c\u003cEOF\n            hello world {{.PathVariable \"userName\"}}\n            EOF\n        }\n    }\n}\n```\n- Step 3: start the mockaroo server from your terminal\n```\nmockaroo -conf ./mock.hcl\n```\n- Step 4: curl away \n```\ncurl \"http://localhost:5000/hello/buddy\"\n```\nThat's it; read the [complete documentation](https://github.com/subranag/mockaroo/blob/master/DOCS.md) for all the features available for complex mocking\n\n## Why ?\nThere are several reasons why I always felt the need for something like mockaroo in my local dev box, these are some of them\n- I am experimenting with a new API and want to send a *live working version* with use-cases to my teammates, simply publish a mock file\n- I am a UX developer who wants to get started on UI work and wants to communicate *my API needs* to the back end developer, with clear documentation\n- I wand to publish API documentation that is \"ALIVE\" simply download mock file and code to it \n- Publish integration test contract that can be run and verified locally in the dev box\n- Test my client code against exhaustive fake data that almost looks real \n- I want to test my service locally but *the service I am using does not run locally*\n- I can check-in my mock HCL file with code so that other developers can contribute to the use cases and enhance the tests\n\n... and many more, if any of these reasons resonate with you then mockaroo might be a good fit for you \n\n## Show me the goods \nJust to show that mockaroo is a great fit for mocking needs I have created a samples folder https://github.com/subranag/mockaroo/tree/master/sample which contains several detailed examples I will keep adding to the list in the future, please check it out\n\n## Acknowledgments\nThis project would have not been possible without these two awesome projects \n- **Gorilla Mux** : awesome router and route matching library https://github.com/gorilla/mux\n- **Gofakeit**    : awesome library in golang to create fake data https://github.com/brianvoe/gofakeit\n- **Hashicorp Config Language**: really awesome config language which is the basis of terraform https://github.com/hashicorp/hcl\n\n## Documentation \ndetailed documentation is available [here](https://github.com/subranag/mockaroo/blob/master/DOCS.md), the [sample](https://github.com/subranag/mockaroo/tree/master/sample) folder contains som really cool examples from top service providers","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsubranag%2Fmockaroo","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsubranag%2Fmockaroo","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsubranag%2Fmockaroo/lists"}