Skip to main content

Handy REST API client on your terminal

Project description

Handy REST API client on your terminal

PyPI version Build Status asciicast

Get started with an interactive demo

NOTE: This demo requires supported version of python and virtualenv to be installed

curl -L https://raw.githubusercontent.com/rapidstack/RESTEasyCLI/master/tools/demo.sh -o demo.sh
chmod +x demo.sh
./demo.sh

Installation

# Install it globally
sudo pip install -U resteasycli

# OR

# Install it locally
pip install -U --user resteasycli

Usage

Help menu

recli help

Initialize workspace

mkdir myworkspace
cd myworkspace
recli init
# Few template files should be generated namely: auth.yml  headers.yml  saved.yml  sites.yml

Do CRUD requests

recli get testing/t
recli post testing/t --kwargs title=abcd userId=10
recli put testing/t/1 --kwargs title=abcd
recli patch testing/t1 --kwargs title=xyz
recli delete testing/t/1

Special formatting of data

List

recli list testing/t

Show

recli show testing/t/1

Save a request for later use

recli get testing/t/1 -s my_request

# Request will be saved in saved.yml as "my_request"

Do or redo a saved request

# Without formatting
recli do remind_shopping
# Same as
recli redo remind_shopping

# With formatting
recli dolst remind_shopping -m GET -k
# Same as
recli redo-list remind_shopping --method GET --kwargs

Most importantly fake a request

recli redo-show remind_shopping -m GET -k --fake

# It can be used with -s to save the request for later use without doing it

recli redo-show remind_shopping -m GET -k --fake -s get_todos

TODO list

Check the great TODO list on project board

Contribution guide

This is a new born project and has lots of scope for improvements.

If you feel that you can help with any of above TODO list or if you have a totally unique idea, feel free to jump right in.

Here are some tips to start contributing to this project right away.

  • Instead of directly creating pull requests, create a issue first to check it’s relevence and save efforts. However,

  • If you find a bug, feel free to directly create pull requests by forking master branch

  • Awesome if commit messages and pull request description are clear and concise

  • One of it’s depedency RESTEasy has a gitter channel for any doubt or discussion related to this project or RESTEasy

  • Use pipenv to install/update dependencies

  • Do not modify README.rst file. It’s auto generated using m2r (Installed as a dev dependency). While updating README.md file, use plugin for auto TOC update.

  • Run ./tools/before_push.sh before pushing. It will take care of house keeping stuffs like generating README.rst, checking if VERSOIN info is updated correctly in all files etc.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

RESTEasyCLI-0.3.8.tar.gz (16.8 kB view details)

Uploaded Source

Built Distributions

RESTEasyCLI-0.3.8-py3.5.egg (25.2 kB view details)

Uploaded Source

RESTEasyCLI-0.3.8-py3-none-any.whl (25.0 kB view details)

Uploaded Python 3

File details

Details for the file RESTEasyCLI-0.3.8.tar.gz.

File metadata

  • Download URL: RESTEasyCLI-0.3.8.tar.gz
  • Upload date:
  • Size: 16.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.12.1 pkginfo/1.4.2 requests/2.20.0 setuptools/40.6.3 requests-toolbelt/0.8.0 tqdm/4.28.1 CPython/3.5.3

File hashes

Hashes for RESTEasyCLI-0.3.8.tar.gz
Algorithm Hash digest
SHA256 c9e194b0113013b6d8095ffd1ea74da949bbefcf681ff783084105bbac86f0da
MD5 6264907bb0d25fb3dc0ea39465798b06
BLAKE2b-256 c0803db2e5c1f9cdd4dcc508e8c916082093a117171e171afddf4e1e71bf358c

See more details on using hashes here.

Provenance

File details

Details for the file RESTEasyCLI-0.3.8-py3.5.egg.

File metadata

  • Download URL: RESTEasyCLI-0.3.8-py3.5.egg
  • Upload date:
  • Size: 25.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.12.1 pkginfo/1.4.2 requests/2.20.0 setuptools/40.6.3 requests-toolbelt/0.8.0 tqdm/4.28.1 CPython/3.5.3

File hashes

Hashes for RESTEasyCLI-0.3.8-py3.5.egg
Algorithm Hash digest
SHA256 8499348861b7eb7115cac8a06d6b1227fce6a5ab5fc28838c29c10d72d4511f3
MD5 546ddf7c21e8aeafb359960b9fa5ac77
BLAKE2b-256 17f136edb02624cdefd6753ba64358c79426c0fb1753632e3e6dadf9330ad3af

See more details on using hashes here.

Provenance

File details

Details for the file RESTEasyCLI-0.3.8-py3-none-any.whl.

File metadata

  • Download URL: RESTEasyCLI-0.3.8-py3-none-any.whl
  • Upload date:
  • Size: 25.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.12.1 pkginfo/1.4.2 requests/2.20.0 setuptools/40.6.3 requests-toolbelt/0.8.0 tqdm/4.28.1 CPython/3.5.3

File hashes

Hashes for RESTEasyCLI-0.3.8-py3-none-any.whl
Algorithm Hash digest
SHA256 869957e9eee774ea011a1e9ad630807d77907b96bc31e48e8ebb3d359305d91a
MD5 d982763bac4f48a5fc60a38405951639
BLAKE2b-256 5214279c0e4f02bb8631bc1b9f8fdbcbd422db2e9767732b3f8fcdf28ac3c954

See more details on using hashes here.

Provenance

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page