curlz

[](https://www.gnu.org/licenses/gpl-3.0) [](https://github.com/curlz-rs/curlz/actions?query=branch%3Amain+workflow%3ABuild+) [](https://crates.io/crates/curlz) [](https://deps.rs/repo/github/curlz-rs/curlz)

a curl wrapper with placeholder, bookmark and environment powers just like postman but for the terminal

Features

• ☑️ .env files
• ☑️ .yaml env files
• ☑️ placeholder evaluation, with the minijinja template engine
  • in urls
  • in http headers (-H | --header arguments)
  • in every other passed curl parameter
• ☑️ save request as a bookmark, containing
  • curl arguments
  • http headers
  • http method
  • placeholders
• ☑️ pass all arguments after -- to curl, that makes drop-in-replacement possible
• ☑️ execute a bookmarked request
• ☑️ special placeholder variables that would interact with the user
  • ☑️ prompting for a password as `{{ prompt_password() }} sh curlz -- -u "{{ username }}:{{ prompt_password() }}" https://api.github.com/user

TODOs

• [] evaluate placeholders at the beginning of an url
• [] special placeholder for developers, like jwt_token or mfa_token
  • example: {{ jwt_token(signin_key, signin_secret) }}, where signin_key and signin_secret are first looked up at the environment file as variable or else taken then as given. curlz -H "Authorization: Bearer {{ jwt_token(signin_key, signin_secret) }}" -X POST https://api.github.com/user/repos -d '{ "name": "{{ repo_name }}" }'
• [] prompting for interactive input with a label as {{ prompt_for("Username") }} or {{ prompt_for("Birthdate") }} sh curlz -- -u "{{ prompt_for("Username") }}:{{ prompt_password() }}" https://api.github.com/user

Example #1

In this example we're going to download a pre-configured .gitignore for a given language from GitHub via curl

• curl https://api.github.com/gitignore/templates/Rust
• the same with curlz: curlz r https://api.github.com/gitignore/templates/Rust
• parametrization: curlz r 'https://api.github.com/gitignore/templates/{{ lang | title }}'
• bookmarking: sh curlz r --define lang=Rust --bookmark 'https://api.github.com/gitignore/templates/{{ lang | title }}' Saving this request as a bookmark: Please enter a bookmark name: /gitignore Request bookmarked as: /gitignore`
• Finally, we can keep using the bookmark from now on: curlz r /gitignore