Handy REST API client on your terminal
Project description
Handy REST API client on your terminal
Installation
pip install resteasycli
# OR
pipenv install resteasycli
Usage
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
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
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
Algorithm | Hash digest | |
---|---|---|
SHA256 | 9846b2fb5fc68fd9934d2abe522b7598fcda6fc3401bea4e22311a9cf9951380 |
|
MD5 | 754e0bb8e7c4782def603e399133a6cd |
|
BLAKE2b-256 | fd5871f637e8e156a553a899464f26bb90124cfff1b95d1cf93ee32d951fdb8a |
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
Algorithm | Hash digest | |
---|---|---|
SHA256 | 8881b83c2c956ae084ba31a5d646967840093b66289e7caa69fef33a85df8a3f |
|
MD5 | b688853bba3f5246b8c7049d50229ebb |
|
BLAKE2b-256 | e8a3069cd3a85ee35856f3b5fa9123cf4108e5a27168ae8be5ae7c9e64453577 |