|
1 | 1 | # Req - Test APIs with Terminal Velocity |
2 | 2 |
|
3 | | -[](https://github.com/maniac-en/req/actions/workflows/go.yml)  |
| 3 | +[](https://github.com/maniac-en/req/actions/workflows/go.yml) |
| 4 | + |
| 5 | + |
| 6 | +## About |
| 7 | + |
| 8 | +`req` is a lightweight, terminal-based API client built for the |
| 9 | +[Boot.dev Hackathon 2025](https://github.com/maniac-en/req?tab=License-1-ov-file). |
| 10 | +It features a fast and minimal text user interface and lets you create, send, |
| 11 | +and inspect HTTP requests interactively from the command line. It is ideal for |
| 12 | +testing APIs without leaving your terminal. |
| 13 | + |
| 14 | +Read more about `req` over here - |
| 15 | +[Announcement Blog](https://maniac-en.github.io/req/) |
| 16 | + |
| 17 | +## Installation |
| 18 | + |
| 19 | +### You can install `req` using `go install`: |
| 20 | + |
| 21 | +To install a specific release |
| 22 | + |
| 23 | +``` |
| 24 | +go install github.com/maniac-en/req@v0.1.0 |
| 25 | +``` |
| 26 | + |
| 27 | +Replace `v0.1.0` with the version you want. |
| 28 | + |
| 29 | +### Requirements |
| 30 | + |
| 31 | +- Go version 1.24.4 |
| 32 | + |
| 33 | +## Usage |
| 34 | + |
| 35 | +After installing `req`, you can run it using this command. |
| 36 | + |
| 37 | +``` |
| 38 | +req |
| 39 | +``` |
| 40 | + |
| 41 | +## Libraries Used |
| 42 | + |
| 43 | +### Terminal UI (by Charm.sh) |
| 44 | + |
| 45 | +- [bubbletea](https://github.com/charmbracelet/bubbletea) — A powerful, fun TUI |
| 46 | + framework for Go |
| 47 | +- [bubbles](https://github.com/charmbracelet/bubbles) — Pre-built components for |
| 48 | + TUI apps |
| 49 | +- [lipgloss](https://github.com/charmbracelet/lipgloss) — Terminal style/layout |
| 50 | + DSL |
| 51 | + |
| 52 | +## License |
| 53 | + |
| 54 | +This project is licensed under the |
| 55 | +[MIT License](https://github.com/maniac-en/req?tab=License-1-ov-file). |
| 56 | + |
| 57 | +``` |
| 58 | +1. Mudassir Bilal (mailto:mughalmudassir966@gmail.com) |
| 59 | +2. Shivam Mehta (mailto:sm.cse17@gmail.com) |
| 60 | +3. Yash Ranjan (mailto:yash.ranjan25@gmail.com) |
| 61 | +
|
| 62 | +MIT License |
| 63 | +
|
| 64 | +Copyright (c) 2025 Mudassir Bilal, Shivam Mehta, Yash Ranjan |
| 65 | +
|
| 66 | +Permission is hereby granted, free of charge, to any person obtaining a copy of |
| 67 | +this software and associated documentation files (the "Software"), to deal in |
| 68 | +the Software without restriction, including without limitation the rights to |
| 69 | +use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of |
| 70 | +the Software, and to permit persons to whom the Software is furnished to do so, |
| 71 | +subject to the following conditions: |
| 72 | +
|
| 73 | +The above copyright notice and this permission notice shall be included in all |
| 74 | +copies or substantial portions of the Software. |
| 75 | +
|
| 76 | +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR |
| 77 | +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS |
| 78 | +FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR |
| 79 | +COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER |
| 80 | +IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN |
| 81 | +CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. |
| 82 | +``` |
0 commit comments