I'm going to explore integration with other formats in the future. Right now there's experimental (incomplete) support for importing from OpenAPI v3. I'd like to add Postman and Insomnia collection importing too. Some kind of integration with Hurl could be very nice too, but would likely come further down the line.
pesch3 104 days ago [-]
Please, allow using flat file http messages.
IntelliJ has a great build in http client that's using HTTP message files and otherwise has a similar feature set. But having to launch intellij every time is a real PITA.
dotancohen 103 days ago [-]
I was going to post almost this exact comment. When I've got an Intellij IDE already open, it's the best tool for this job - and that's saying a lot as we've been developing HTTP clients for decades. But I often find myself banging out a curl command with too many -H clauses if nothing Jetbrains is already running.
For those who haven't used the Jetbrains HTTP client recently: maybe two or three years ago it was completely replaced and has been improved continuously since. Give it a try.
sprobertson 104 days ago [-]
This is great, I could see myself using it daily. The only hindrance I've found so far is navigating large responses. Would be cool to have some way to collapse chunks of JSON (a la https://github.com/antonmedv/fx), or even just more vim key navigation, like G/gg, %, {/}, and search.
nsdarren 104 days ago [-]
I agree that could be improved! The extra Vim keys you suggested should be simple enough to add.
sandreas 103 days ago [-]
Maybe have a look at jless, a terminal json viewer with folding support.
kbd 104 days ago [-]
After never being happy with Postman or Insomnia and defaulting to 'curlie' for http requests, Posting is the first http gui that I'm actually sticking with. I have a terminal tab with it open all the time and it somehow manages to be more efficient than "up arrow+enter" (since you can just hit enter).
Thanks for improving my workflow, Darren!
nsdarren 104 days ago [-]
Thanks for your kind words!
yoavm 104 days ago [-]
this looks really great! since insomnia started requiring an account I never really settled on anything else.
the one thing that worries me is compatibility - I echo the voices asking for hurl support. it kinda sucks that each of these programs invents its own format.
it would also be great to be able to run these requests as part of a CI pipeline, without opening the TUI. supporting a format like hurl would add this ability automatically, because the same files could be used by other clients.
p.s. upon trying it out the first things i missed is "how do I create a new collection?" and "how do I exit?". it felt that both should have been a command in the command plate. in the end if created the collection manually as a folder and exited using Ctrl+C, but I'm still not sure if that was the intended way.
nsdarren 104 days ago [-]
Thanks for the feedback! It is actually intended that you create the collection yourself first, but I should perhaps make that clearer.
Hiding how to quit the app was just another attempt to win over the Vim crowd!
(Yes ctrl+c is the intended way, it’s in the docs now and I’ll add it to the app footer)
timvdalen 104 days ago [-]
I've switched to the built-in HTTP client in Jetbrains IDEs. The experience is a _little_ worse for one-off requests, but it's a lot nicer for things you do more often, and very easy to version control and include in a project.
halfmatthalfcat 104 days ago [-]
Give Bruno a look
saila 104 days ago [-]
This is awesome. Here are a couple bits of feedback:
- It took me a while to find the Metadata tab to edit a request's name, I guess because I don't think of the name and description as metadata (even if in a technical sense they are, relative to the request config). My inclination would be to make this the first tab and rename it to Info.
- I somehow managed to save two requests into the same file with no warning/confirmation from the UI.
- When using the up/down arrows to navigate between requests in a collection, I found it counterintuitive to have to hit Enter to actually select the request.
nsdarren 104 days ago [-]
Great feedback, thank you. I agree “Info” is probably clearer.
There are a couple of UX sharp edges to clear up for sure - a bit more validation, confirmations, etc to be added.
tusharsadhwani 104 days ago [-]
This is already the best API testing client that I have found. It's lightweight, it's snappy, it's intuitive, and it can run on a VPS out of the box over an SSH connection, no proxying needed.
nsdarren 104 days ago [-]
Thank you very much! It's definitely not feature complete yet - but I hope it can be a solid competitor in the space.
leetrout 104 days ago [-]
This looks pretty cool! I have yet to find something to pull me away from the Rest Client extension for VS code. I will give this a try and see how it shakes out but at a glance on my phone I am not seeing support for variables.
Kudos to you man. I also had the same idea of developing a similar TUI tool because I'm getting tired of Electron apps for this. Now I can use yours with a peace of mind.
BTW, have you looked at Bruno before deciding to develop yourself?
nsdarren 104 days ago [-]
Thank you!
I had a look at the Bruno website for the first time a few weeks ago, although I haven't tried it for myself yet. I'm definitely inspired by and agree with a lot of the principles behind Bruno: local first, developer friendly, readable/Git-friendly collections and so on.
I think I share a lot of the same motivations as Bruno's creator - I feel the landscape of HTTP API testing clients may actually have regressed in recent years from a developer's perspective, as the companies behind Postman/Insomnia etc. figure out how to monetise them.
kbd 104 days ago [-]
Textual trending to a new de-facto basis for cross-platform gui apps is a HUGE improvement from every new app being js and Electron!
Not to mention replacing heavy Java gui apps as well! The myriad DB guis for whatever historical reason have mostly been slow heavy, and paid, Java apps.
I'd actually written a thing that integrated cli db tools(eg [1]) with kitty[2] and visidata to show a query editor and then results underneath in a kitty split pane. Now I've been using Harlequin[3] in my terminal. So nice to have these apps be fast programs that live in a terminal tab instead of their own bloated poorly-keyboard-driven Electron apps.
This is great and feels very smooth to use. I really like the UX of it.
Great including themes, but for light mode it's only one. Does Posting/Textual support no theming falling back on the configured terminal that runs it?
nsdarren 104 days ago [-]
You'll be able to add custom themes pretty soon. Hopefully within the next couple of weeks.
There's no fallback to the ANSI theme of the terminal as it breaks a lot of Textual's features.
There is a PR open at the moment relating to detecting the terminal background colour I believe, so in the future we could probably use that to choose a reasonable fallback.
erksa 104 days ago [-]
Great, appreciate it!
Really like it, so will try it out in my toolkit for a while! Thanks for the great work you have been doing and sharing with the community.
eigenvalue 104 days ago [-]
Looks cool. Would be really nice if you could automatically generate the yaml files from an openapi.json file like the kind that are automatically generated by FastAPI.
nsdarren 103 days ago [-]
There's an experimental OpenAPI import function.
sibeliuss 104 days ago [-]
This thing is cool. How did you do the visual terminal layout?
Does it support OAuth2 authentication/ token acquisition? I’d love to not have to put my access token / secret key into Postman. Happy to be a tester.
nsdarren 103 days ago [-]
It doesn't support OAuth2 yet, but I do plan to add more auth schemes in the future.
CodeWriter23 103 days ago [-]
I’ll keep my eye on your progress. Thanks.
connordavenport 104 days ago [-]
This is fantastic, I love the jump mode navigation. Will be using this for the foreseeable future. Thanks for making it.
flufluflufluffy 104 days ago [-]
I’m going to use this from now on simply because of how much more fun it is xD
edit: omg I didn’t even notice the vim keybinds I’m sold
zorrn 104 days ago [-]
Does anyone know which terminal emulator is used in all the examples? Looks very good!
nsdarren 104 days ago [-]
It’s iTerm 2
zorrn 93 days ago [-]
Thanks
goalonetwo 104 days ago [-]
Am I the only one that hates what the internet became?
All HTTP APIs that are all made to interact with JSON.
bartvk 104 days ago [-]
Well as soon as it gets interesting, JSON goes out of the window. No firmware engineer would send me JSON over HTTP, for example.
joseangel_sc 104 days ago [-]
what would you suggest?
dlvhdr 104 days ago [-]
This is amazing
tills13 104 days ago [-]
We've strayed so far from God
rochak 104 days ago [-]
Everything looks great except for it being written in Python. I’ll work on developing something similar with Go.
timetraveller26 104 days ago [-]
You dropped an /s I hope
lylejantzi3rd 104 days ago [-]
Am I the only one who prefers to use nodejs and fetch for this these days? Especially since I need it to work in Windows (and no, I can't install WSL).
billowycoat 104 days ago [-]
If you prefer writing JavaScript, the more power you, but I suspect Posting works on Windows. Textual, the library Posting is built on top of certainly does.
For those who haven't used the Jetbrains HTTP client recently: maybe two or three years ago it was completely replaced and has been improved continuously since. Give it a try.
Thanks for improving my workflow, Darren!
the one thing that worries me is compatibility - I echo the voices asking for hurl support. it kinda sucks that each of these programs invents its own format.
it would also be great to be able to run these requests as part of a CI pipeline, without opening the TUI. supporting a format like hurl would add this ability automatically, because the same files could be used by other clients.
p.s. upon trying it out the first things i missed is "how do I create a new collection?" and "how do I exit?". it felt that both should have been a command in the command plate. in the end if created the collection manually as a folder and exited using Ctrl+C, but I'm still not sure if that was the intended way.
Hiding how to quit the app was just another attempt to win over the Vim crowd!
(Yes ctrl+c is the intended way, it’s in the docs now and I’ll add it to the app footer)
- It took me a while to find the Metadata tab to edit a request's name, I guess because I don't think of the name and description as metadata (even if in a technical sense they are, relative to the request config). My inclination would be to make this the first tab and rename it to Info.
- I somehow managed to save two requests into the same file with no warning/confirmation from the UI.
- When using the up/down arrows to navigate between requests in a collection, I found it counterintuitive to have to hit Enter to actually select the request.
There are a couple of UX sharp edges to clear up for sure - a bit more validation, confirmations, etc to be added.
https://marketplace.visualstudio.com/items?itemName=humao.re...
Curious if it works in VSCODE terminal, did you try it?
I developed Just-API (https://github.com/kiranz/just-api) with YAMLs for automation testing of APIs.
BTW, have you looked at Bruno before deciding to develop yourself?
I had a look at the Bruno website for the first time a few weeks ago, although I haven't tried it for myself yet. I'm definitely inspired by and agree with a lot of the principles behind Bruno: local first, developer friendly, readable/Git-friendly collections and so on.
I think I share a lot of the same motivations as Bruno's creator - I feel the landscape of HTTP API testing clients may actually have regressed in recent years from a developer's perspective, as the companies behind Postman/Insomnia etc. figure out how to monetise them.
Not to mention replacing heavy Java gui apps as well! The myriad DB guis for whatever historical reason have mostly been slow heavy, and paid, Java apps.
I'd actually written a thing that integrated cli db tools(eg [1]) with kitty[2] and visidata to show a query editor and then results underneath in a kitty split pane. Now I've been using Harlequin[3] in my terminal. So nice to have these apps be fast programs that live in a terminal tab instead of their own bloated poorly-keyboard-driven Electron apps.
[1] https://github.com/kbd/setup/blob/main/HOME/.config/litecli/...
[2] https://github.com/kbd/setup/blob/main/HOME/bin/kw
[3] https://github.com/tconbeer/harlequin/
Great including themes, but for light mode it's only one. Does Posting/Textual support no theming falling back on the configured terminal that runs it?
There's no fallback to the ANSI theme of the terminal as it breaks a lot of Textual's features.
There is a PR open at the moment relating to detecting the terminal background colour I believe, so in the future we could probably use that to choose a reasonable fallback.
Really like it, so will try it out in my toolkit for a while! Thanks for the great work you have been doing and sharing with the community.
edit: omg I didn’t even notice the vim keybinds I’m sold
All HTTP APIs that are all made to interact with JSON.