Julien-cpsn/ATACPublic

NotificationsYou must be signed in to change notification settings
Fork121
Star3.3k

A simple API client (postman like) in your terminal

License

MIT license

3.3k stars 121 forks Branches Tags Activity

Star

Notifications

You must be signed in to change notification settings

Branches Tags

Folders and files

Name		Name	Last commit message	Last commit date
Latest commit History 472 Commits
.cargo		.cargo
.github		.github
example_resources		example_resources
gifs		gifs
src		src
.dockerignore		.dockerignore
.gitignore		.gitignore
.typos.toml		.typos.toml
Cargo.lock		Cargo.lock
Cargo.toml		Cargo.toml
Dockerfile		Dockerfile
LICENSE		LICENSE
README.md		README.md

Repository files navigation

ATAC ⚔📩

Description

ATAC isArguably aTerminalAPIClient.It is based on well-known clients such as Postman, Insomnia, or even Bruno,but inside your terminal without any specific graphical environment needed.

The philosophy of ATAC is to be free, account-less, and offline for now and forever.

How to install

Install with cargo

Important

First, make sure your rust version is at least 1.82

Simply use:

cargo install atac --locked

Install from Arch

You can usepacman to install:

pacman -S atac

Install with Homebrew

Simply use:

brew install atac

Install with Scoop

Simply use:

scoop install atac

Install from Fedora copr

Simply use:

dnf coprenable joxcat/atacdnf install atac

Docker package

Pull the image fromhttps://hub.docker.com/r/juliencaposiena/atac

Binary

The binaries from the latest release can be foundhere

Important

Remember to run it from a terminal.For example, you can add the binary into your PATH.You won't be able to run it like other graphical applications since it needs CLI arguments.

Tip

Note formacOS users. After downloading the binary you may need to run the commandsudo xattr -rd com.apple.quarantine ~/bin/atac (modify to reflect the path whereatac is located).

Compile by yourself

Important

First, make sure your rust version is at least 1.82

Simply clone the repository and use:

cargo runcargo run -- -h

Tip

Build the latest release

cargo build --release

Features

Current

Features	ATAC	Postman	Insomnia
Manage collections & requests	✅	✅	✅
HTTP Client	✅	✅	✅
Methods	✅	✅	✅
- GET	✅	✅	✅
- POST	✅	✅	✅
- PUT	✅	✅	✅
- PATCH	✅	✅	✅
- DELETE	✅	✅	✅
- OPTIONS	✅	✅	✅
- HEAD	✅	✅	✅
- TRACE	✅	❌	❌
- CONNECT	✅	❌	❌
Authentication	Partial	✅	✅
- Basic auth	✅	✅	✅
- Bearer token	✅	✅	✅
- JWT, Digest, OAuth1-2, AWS	❌ 🔜	✅	✅
Headers	✅	✅	✅
Body	✅	✅	✅
- Multipart form	✅	✅	✅
- URL Encoded form	✅	✅	✅
- File	✅	✅	✅
- Plain text	✅	✅	✅
- JSON, XML, HTML, Javascript	✅	✅	✅
Full response	✅	✅	✅
- Status code	✅	✅	✅
- Cookies	✅	✅	✅
- Headers	✅	✅	✅
- Duration	✅	✅	✅
Scripting	✅	Partial	❌
- Pre-request script	✅	❌	❌
- Post-request script	✅	✅	❌
Asynchronous requests	✅	✅	✅
Per-request settings	✅	✅	✅
- Use proxy	✅	✅	✅
- Allow redirects	✅	✅	✅
- Store cookies	✅	✅	✅
Export to other languages (HTTP, cURL, PHP Guzzle, NodeJS Axios, Rust Reqwest)	✅	✅	❌
WebSocket Client	✅	✅	✅
Message	✅	✅	✅
- Text	✅	✅	✅
- Binary	✅	❌	❌
- Ping	✅	❌	❌
- Pong	✅	❌	❌
- Close	✅	❌	❌
GraphQL	❌ 🔜	✅	✅
gRPC	❌ 🔜	✅	✅
MQTT	❌ 🔜	✅	❌
Free	✅	Depends	Depends
Lightweight, fast and efficient	✅	❌	❌
Data storage	Your own committable, readable, versioned and retro-compatible files (JSON or YAML)	Tied to your account	Tied to your account
Offline	✅	❌	❌
Real-time collaboration	❌ (not planned)	✅	✅
Full command line usage	✅	Partial	❌
Environment files and variables	✅ (committable, readable and versioned)	✅	✅
View options	✅	✅	✅
Global configuration file	✅	✅	✅
- HTTP/HTTPS Proxy	✅	✅	✅
- Disable CORS	✅	❌	❌
- Toggle syntax highlighting	✅	❌	❌
Import from other file formats	✅	✅	✅
- Postman v2.1.0 and Postman environment import	✅	✅	✅ / ❌
- OpenAPI import	✅ (AI generated, prone to bugs)	✅	✅
- cURL import	✅	✅	✅
Themes	✅	✅	✅
Remappable key bindings	✅	✅	✅

TODO v1.0.0

To add
- Individual request documentation in the TUI (markdown)
- Insomnia import
To improve
- Editing cookies
- Request body syntax highlighting
- Manage multipart Content-type header (auto-generated for now)seanmonstar/reqwest#2259

TODO v2.0.0

To add
- Maybe GraphQL requests
- Maybe MQTT requests
- Maybe gRPC requests
To improve
- Auto-completion on env file variables

Ideas (will think about it later)

Base URL property and authorization on collections
VScode plugin to see and send requests

Documentation

Here is the documentation:https://atac.julien-cpsn.com/

If you think something is missing, please contribute!

Others

Vim key-bindings

You can read more about it here:https://github.com/Julien-cpsn/ATAC/releases/tag/v0.14.0

NeoVim integration

Thanks to@NachoNievaG you can have an ATAC floating window inside your nvimhttps://github.com/NachoNievaG/atac.nvim

Themes

You can read more about it here:https://github.com/Julien-cpsn/ATAC/releases/tag/v0.18.0

Technical precisions

Tested on

Console Host
- Windows 11 (Pro)
- WSL2 Debian 12
- Windows 10 (Pro)
- Windows 8.1 (N)
Ubuntu Desktop Terminal
- Ubuntu 23.04 64-bit
- Ubuntu 17.10
- Pop!_OS 20.04
(Arch, Manjaro) KDE Konsole
(Arch, NixOS) Kitty
Linux Mint
(OpenSuse) Alacritty
(Chrome OS) Crostini
Apple
- macOS Monterey 12.7.1 (Intel-Chip)
- macOS Sonama 14.4 (M1 Max, Apple Silicon-Chip)

(List fromhere)

Dependencies

Category / Library	Version	Comment
Request
reqwest	0.12.23	Send requests
reqwest-middleware	0.4.2	Wrapper around reqwest to allow for client middleware chains
reqwest-websocket	0.5.1	Wrapper around reqwest to handle web-socket requests
TUI
ratatui	0.29.0	Terminal UI framework
crokey	1.1.2	Used to parse, use key bindings files and some utilities
tui-big-text	0.7.1	Display big texts. Only used for displaying ATAC in the homepage.
tui-tree-widget	0.23.1	Display tree-like lists. Used for displaying the collections.
tui-textarea	0.7.0	Text area that handle a lot of features. Used for editing request body.
throbber-widgets-tui	0.8.0	Display loading UI elements. Used when request is pending.
ratatui-image	8.0.1	Display response images.
image	0.25.8	Decode images.
Main functionalities
syntect	5.3.0	Syntax highlighting
serde	1.0.219	Serialize & Deserialize application data into files
jsonxf	1.1.1	Pretty print JSON
toml	0.9.5	Serialize & Deserialize application config files
boa_engine	0.20.0	Create Javascript runtimes. Used for pre and post request scripts
parse_postman_collection	0.2.3	Deserialize Postman collection files
curl-parser	0.6.0	Parse cURL request files
openapiv3	2.2.0	Parse OpenAPI spec files
clap	4.5	Command Line Argument Parser
directories	6.0.0	Use system files
arboard	3.6.1	Copy response body to clipboard
Async
tokio	1.47.1	Handle asynchronous requests
parking_lot	0.12.4	Smaller, faster and more flexible implementation of RwLock and Mutex. Used everywhere.
Utils
strum	0.27.2	Enum facilities
lazy_static	1.5.0	Allows for more flexible constants. Mainly used for accessing CLI arguments everywhere
nestify	0.3.3	Used to nest struct definitions
walkdir	2.5.0	Recursively retrieve files
snailquote	0.3.1	Unescape string
indexmap	2.11.0	Ordered hashmap. Used in environments to preserve files' values order
rayon	1.11.0	Allows the usage of multiple threads in for loops
thiserror	2.0.16	Create custom errors
anyhow	1.0.99	Result that can contain any error
clap-verbosity-flag	3.0.4	Add verbosity flag to the CLI
clap_complete	4.5	Generate completion file
clap_mangen	0.2	Generate man pages
regex	1.11.2	Regex. Using for parsing requests URL
chrono	0.4.41	Time utils
uuid	1.18.0	UUID generator
base64	0.22.1	Decode base64 strings
textwrap	0.16.2	Wrap text to max length
Tracing
tracing	0.1.41	Log events
tracing-subscriber	0.3.20	Utilities for implementing and composing tracing subscribers
tracing-log	0.2.0	Log crate compatibility for tracing
reqwest-tracing	0.5.8	Opentracing middleware implementation for reqwest-middleware

Binary size

The binary file size goes from ~5 MB to ~15 MB depending on the platform. I try to keep it as small as possible, unfortunately for me, I bundle a Javascript runtime.