{"id":26756928,"url":"https://github.com/ams003010/chimera","last_synced_at":"2025-04-15T03:52:00.489Z","repository":{"id":284331018,"uuid":"953544889","full_name":"AMS003010/Chimera","owner":"AMS003010","description":"Chimera is a fast ⚡ Rust-based JSON server 🦀 with sorting, filtering, and simulated latency—perfect for rapid API prototyping!","archived":false,"fork":false,"pushed_at":"2025-04-10T17:52:14.000Z","size":583,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-15T03:51:56.746Z","etag":null,"topics":["actix-web","api-rest","clap-rs","cli","json-server","mockapi","rust"],"latest_commit_sha":null,"homepage":"https://ams003010.github.io/Chimera/","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/AMS003010.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}},"created_at":"2025-03-23T16:02:55.000Z","updated_at":"2025-04-10T17:52:18.000Z","dependencies_parsed_at":null,"dependency_job_id":"ede7a3bd-9235-48bb-9680-e7c78e68cf22","html_url":"https://github.com/AMS003010/Chimera","commit_stats":null,"previous_names":["ams003010/chimera"],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AMS003010%2FChimera","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AMS003010%2FChimera/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AMS003010%2FChimera/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AMS003010%2FChimera/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AMS003010","download_url":"https://codeload.github.com/AMS003010/Chimera/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249003954,"owners_count":21196794,"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":["actix-web","api-rest","clap-rs","cli","json-server","mockapi","rust"],"created_at":"2025-03-28T15:21:56.213Z","updated_at":"2025-04-15T03:52:00.483Z","avatar_url":"https://github.com/AMS003010.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Chimera - A Fast ⚡ \u0026 Powerful JSON Server built with Rust 🦀\n\n## 🔱 Introduction\n\nChimera is a blazing-fast, configurable JSON server built with Rust and Actix-web. It allows you to serve JSON files as APIs with sorting, pagination, simulated latency, and route-based retrieval. Ideal for prototyping, mock APIs, or rapid development.\n\n## 🚀 Features\n\n- **📂 Serve JSON as an API** – Load any JSON file and serve it as structured API endpoints.\n- **📌 Route-based Data Retrieval** – Fetch data by route and ID.\n- **📊 Sorting Support** – Sort entries dynamically based on attributes.\n- **📑 Pagination Support** – Limit the number of records per request.\n- **🐌 Simulated Latency** – Mimic real-world API delays for better testing.\n- **⚡ Ultra-Fast Performance** – Leveraging Rust and Actix-web for speed and efficiency.\n- **🛠️ Easy Configuration** – Set up ports, file paths, latency, sorting, and pagination via CLI.\n\n## 📦 Installation\n\n### On Windows\n\nOn Powershell (Run as Administer)\n```\nInvoke-WebRequest -Uri \"https://github.com/AMS003010/Chimera/releases/download/v0.2.0/chimera-windows.exe\" -OutFile \"chimera.exe\"\n```\n\nOn Powershell (non-privileged)\n```\n.\\chimera.exe --path data.json\n```\n\n### On Linux and Mac\n\n```\ncurl -sL $(curl -s https://api.github.com/repos/AMS003010/chimera/releases/latest | jq -r '.assets[] | select(.name | test(\"chimera.*\")) | .browser_download_url') -o chimera\nchmod 777 chimera\n./chimera --path data.json\n```\n\n## 🏗️ Usage\n\n### Start the Server\n\n```sh\n./chimera --path data.json\n```\n\n### Available Options\n\n| Flag             | Description                                      |\n|-----------------|--------------------------------------------------|\n| `--path \u003cfile\u003e`  | Path to the JSON file (Required)               |\n| `--port \u003cport\u003e`  | Specify the server port (Default: 8080)        |\n| `--latency \u003cms\u003e` | Simulated latency in milliseconds (Optional)   |\n| `--sort \u003croute\u003e \u003casc / desc\u003e \u003cattribute\u003e` | Sort route data dynamically |\n| `--page \u003cnum\u003e`   | Paginate GET responses (Default: 0 - No Limit) |\n\n## 📡 API Endpoints\n\n| Method   | Endpoint        | Description                      |\n| -------- | --------------- | -------------------------------- |\n| `GET`    | `/ping`         | Health check (`Pong 🏓`)         |\n| `GET`    | `/{route}`      | Retrieve all data under a route  |\n| `GET`    | `/{route}/{id}` | Retrieve a specific record by ID |\n| `POST`   | `/{route}`      | Add a record under a route       |\n| `DELETE` | `/{route}`      | Delete all records under a route |\n| `DELETE` | `/{route}/{id}` | Delete a specific record by ID   |\n\n## 📜 Example JSON File (`data.json`)\n\n```json\n{\n  \"users\": [\n    { \"id\": 1, \"name\": \"Alice\", \"age\": 25 },\n    { \"id\": 2, \"name\": \"Bob\", \"age\": 30 }\n  ],\n  \"posts\": [\n    { \"id\": 1, \"title\": \"Rust is amazing!\" }\n  ]\n}\n```\n\n## 🌟 Why Chimera?\n\n- **Lightweight \u0026 Fast** – Runs efficiently with minimal resource usage.\n- **Highly Configurable** – Tailor it to your needs with CLI flags.\n- **Built for Developers** – Ideal for testing, prototyping, and mock API creation.\n\n## 📜 License\n\nChimera is licensed under the MIT License.\n\n---\n\n## 👨‍💻 Maintainers\nThis project is maintained by [@AMS003010](https://github.com/AMS003010).\n\n---\n\n## 📜 License\nThis project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.\n\n---\n\n## 💡 Contributing\nContributions are welcome! Feel free to open an issue or submit a pull request.\n\n---\n\n## 📩 Contact\nFor any queries or issues, feel free to reach out via GitHub Issues.\n\nHappy Coding! 🚀\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fams003010%2Fchimera","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fams003010%2Fchimera","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fams003010%2Fchimera/lists"}