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

Installation

pip install resteasycli

# OR

pipenv install 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/todos
recli post testing/todos --kwargs title=abcd userId=10
recli put testing/todos/1 --kwargs title=abcd
recli patch testing/todo1 --kwargs title=xyz
recli delete testing/todos/1

Special formatting of data

List

recli list testing/todos

Show

recli show testing/todos/1

Save a request for later use

recli get testing/todos/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

  • [x] CRUD requests

  • [x] Formatted outputs

  • [x] Save requests feature

  • [x] Refactored sites, headers, authentication methods, saved requests

  • [ ] Design a icon for it and it’s dependency RESTEasy

  • [ ] Add full usage documentation with examples

  • [ ] Add smart auto completions

  • [ ] Fix interactive mode

  • [ ] Code coverage > 90%

  • [ ] Release version 1

  • [ ] Test cases with different environment variables

  • [ ] API server for full end to end test with custom headers, authentication

  • [ ] Add more authentication methods

  • [ ] Add proxy support

  • [ ] Token detection for automatic authentication headers update

  • [ ] Generate and publish API documentation feature

  • [ ] Initialize workspace from generated API documentation

  • [ ] Write a blog post, create a youtube video on it

  • [ ] Postman compatibility

…[add more goals](https://github.com/rapidstack/RESTEasyCLI/issues/new)

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 get started with 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

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.2.3.tar.gz (13.6 kB view details)

Uploaded Source

Built Distribution

RESTEasyCLI-0.2.3-py3-none-any.whl (18.9 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: RESTEasyCLI-0.2.3.tar.gz
  • Upload date:
  • Size: 13.6 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.2.3.tar.gz
Algorithm Hash digest
SHA256 9846b2fb5fc68fd9934d2abe522b7598fcda6fc3401bea4e22311a9cf9951380
MD5 754e0bb8e7c4782def603e399133a6cd
BLAKE2b-256 fd5871f637e8e156a553a899464f26bb90124cfff1b95d1cf93ee32d951fdb8a

See more details on using hashes here.

Provenance

File details

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

File metadata

  • Download URL: RESTEasyCLI-0.2.3-py3-none-any.whl
  • Upload date:
  • Size: 18.9 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.2.3-py3-none-any.whl
Algorithm Hash digest
SHA256 8881b83c2c956ae084ba31a5d646967840093b66289e7caa69fef33a85df8a3f
MD5 b688853bba3f5246b8c7049d50229ebb
BLAKE2b-256 e8a3069cd3a85ee35856f3b5fa9123cf4108e5a27168ae8be5ae7c9e64453577

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