Everest/README.md

61 lines
3.8 KiB
Markdown
Raw Normal View History

2018-04-23 11:49:36 +00:00
![everestheader](https://user-images.githubusercontent.com/23148259/39124644-c886b47a-4719-11e8-953c-f079b3edb664.png)
2018-01-30 06:49:00 +00:00
2018-04-23 11:49:36 +00:00
Everest _(formerly **RESTaurant**)_ is an upcoming native REST client written in JavaFX.
2018-01-30 06:49:00 +00:00
2018-04-23 11:49:36 +00:00
![default](https://user-images.githubusercontent.com/23148259/39123684-2f7df138-4716-11e8-8ff8-589a1cc47834.PNG)
2018-04-23 11:33:54 +00:00
_Everest running on Windows 10._
# Why Everest?
- Unlike other REST clients like Postman and Insomnia, Everest is a **native** application written in Java. Thus, it is significantly
**lighter on resources and more responsive** than the Electron-based options. The goal with Everest is to provide pretty much the same
2018-01-30 06:49:00 +00:00
level of functionality as the formerly mentioned options, but in a lighter, native but equally slick package. It is a big and slightly arrogant bet,
but then I don't think anyone other than me would use this! So heck, at least I'll learnt a lot. _Not bad for a Comp Sci student, eh?_
- In all of my projects, design is of paramount importance. And Everest is no exception.
With a **gorgeous, flat design and a neutral color scheme**, Everest is a pleasure to look at and to work with.
2018-01-30 06:49:00 +00:00
_I want you to want to use it!_
- Everest is powered by **Jersey**, the robust and powerful Java library to build and consume RESTful web services.
2018-01-30 06:49:00 +00:00
2018-04-23 11:33:54 +00:00
![get](https://user-images.githubusercontent.com/23148259/39123790-8a828b34-4716-11e8-8913-62a6356dd36e.PNG)
_Making a GET request with Everest._
2018-01-30 06:49:00 +00:00
# Planned features
- Ability to make requests with the common HTTP methods. _(duh)_
- **Syntax highlighting**: I had tried using [RichTextFX](https://github.com/FXMisc/RichTextFX) for my text editor,
[Ballad](https://github.com/RohitAwate/Ballad), and failed. And I really don't wish to embed an
online editor like Ace into Everest. So, for the time being, I'm gonna use JavaFX's inbuilt TextArea which doesn't offer syntax highlighting.
2018-02-13 09:33:32 +00:00
- **History tab**, for quickly looking at your request history. 🕒
2018-01-30 06:49:00 +00:00
- **API Authentication**: This is of course a primary feature of any REST client, but currently, not something I've done or used before.
So I will need some time to learn this stuff.
- Theming support with JavaFX CSS. 🌈
- **Multi-tab layout** to unleash your internal REST wizard!
_That's all the core stuff that I can think of at the moment. Will keep updating this as we go._
## Not-so-certain features
- Suggestions as you type in the address field.
- Postman has this really cool feature wherein it can create a **mock server**. Maybe do that.
2018-04-23 11:33:54 +00:00
![error](https://user-images.githubusercontent.com/23148259/39123851-d52d250e-4716-11e8-9c52-800fd708dc2b.PNG)
2018-01-30 06:49:00 +00:00
# Features currently live
2018-02-19 07:48:13 +00:00
- GET, POST, PUT and DELETE requests.
- Adding request headers, query parameters and the request body (raw, octet-stream, URL-encoded or form-data)
2018-01-30 06:49:00 +00:00
- Response details (HTTP status code, response time, response size)
2018-02-19 07:48:13 +00:00
- **Custom themes!** Changing themes needs a manual edit to the settings.json file. This will be properly integrated into a Settings menu later.
- **Multi-tab layout**. I'm battling with JavaFX to allow me to add a simple '+' button for adding a new tab. So far, not successful. However, you can use the Ctrl+T keyboard shortcut.
- **History tab!** All the requests you ever made are now shown to the left of the app.
- Everest now maintains its state between sessions so you don't lose your work.
2018-01-30 06:49:00 +00:00
2018-04-23 11:33:54 +00:00
![search](https://user-images.githubusercontent.com/23148259/39123910-19ddeb8e-4717-11e8-9827-84ad53c5f16f.PNG)
2018-01-30 06:49:00 +00:00
2018-04-23 11:33:54 +00:00
_Everest's search feature in action._
2018-01-30 06:49:00 +00:00
2018-04-23 11:33:54 +00:00
# Releases
2018-04-23 11:49:36 +00:00
An alpha release is available via Releases. A couple of things to note:
2018-04-23 11:33:54 +00:00
- API authentication is not available.
- The BugReporter currently only generates a bug report but doesn't send it to us. Kindly use GitHub Issues for issue submission.
2018-01-30 06:49:00 +00:00
Aaaand, that's it!
I don't think anyone will make it down here. But if you did, you're awesome and thanks! _Cheers!_