GetMan is a versatile tool inspired by Postman that simplifies the process of testing and exploring APIs.
Explore the docs »
View Demo
·
Report Bug
·
Request Feature
Table of Contents
GetMan is a Python-based API testing tool inspired by Postman. It simplifies the process of testing and exploring APIs by providing a simple and intuitive functions for making HTTP requests.
Key features of GetMan include:
- Versatile HTTP Client: GetMan supports all common HTTP methods and allows you to customize your requests with headers, query parameters, and body data.
- Queue Management: GetMan allows you to queue your requests and execute them concurrently. This can significantly improve the performance of your program when dealing with a large number of requests.
- Report Generation: GetMan can generate detailed reports of your API requests, including the request URL, method, status code, headers, and response data.
- And Much More...
Whether you're a developer testing your own APIs or a tester exploring third-party APIs, GetMan provides a powerful and flexible tool to help you get the job done.
This project built with the following technologies:
This is an example of how you may give instructions on setting up your project locally. To get a local copy up and running follow these simple example steps.
Before you can use GetMan, you need to have the following software installed on your system:
- Python
Install python from https://www.python.org/
To install the library, you can just run the following command:
- Install library
pip install getman
GetMan is designed to be simple and intuitive to use. Below are some examples of how you can use GetMan to test and explore APIs.
from getman import GetMan
from getman.constant import HttpMethod
from getman.manager.dict import ParamManager
url = "https://example.com"
version = "your-version" # Optional
client = GetMan(base_url=url, version=version)
client.add_cookie("sessionid", "RANDOM SESSION ID")
params = ParamManager()
params["category"] = "tools"
route = client.routes("product")
response = client.perform_request(method=HttpMethod.GET, routes=route, params=params.data)
client.get_report(response)from getman import GetMan
from getman.constant import HttpMethod
from getman.manager.dict import DictManager
url = "https://example.com"
version = "your-version" # Optional
client = GetMan(base_url=url, version=version)
client.add_cookie("sessionid", "RANDOM SESSION ID")
body = DictManager()
body["product_name"] = "getman"
route = client.routes("product")
response = client.perform_request(method=HttpMethod.POST, routes=route, body=body.data)
client.get_report(response)from getman import GetMan
from getman.constant import HttpMethod
from getman.manager.dict import DictManager
from getman.utils.decorators import coroutine
@coroutine # use this to run coroutine
async def main():
url = "https://example.com"
client = GetMan(base_url=url)
body = DictManager()
body["product_name"] = "getman"
route = client.routes("product")
total_request = 100
for i in range(total_request):
await client.perform_request(method=HttpMethod.POST, routes=route, body=body.data, queue=True)
client.execute_queue() # Execute all queued requests concurrentlyFor more examples, please refer to the Documentation_
- Support Mock Server
- Generate Report such as PDF, HTML, etc
- Add Security scan
- Add stress testing
See the open issues for a full list of proposed features ( and known issues).
Getman is an open-source project, and we welcome contributions of all kinds. Whether you want to report a bug, request a feature, or submit a pull request, we appreciate your help! Please refer to the contribution guidelines for more information.
Distributed under the MIT License. See LICENSE for more information.