robotframework-httpctrl is a library for Robot Framework that provides HTTP/HTTPS client and HTTP server services
Project description
HttpCtrl library for Robot Framework
RobotFramework-HttpCtrl is a library for Robot Framework that provides HTTP/HTTPS client and HTTP (IPv4 and IPv6) server services to make REST API testing easy.
License: The 3-Clause BSD License
Documentation: https://annoviko.github.io/robotframework-httpctrl/
Dependencies
Python version: >=3.8
Installation
Installation using pip3 tool:
$ pip3 install robotframework-httpctrl
Brief Overview of the Library Content
HttpCtrl contains following general libraries:
HttpCtrl.Client - provides API to work with HTTP/HTTPS client [link client documentation].
HttpCtrl.Server - provides API to work with HTTP server [link server documentation].
HttpCtrl.Json - provides API to work Json messages [link json documentation].
HttpCtrl.Logging - provides API to configure the logging system that is used by HttpCtrl library [link logging documentation].
Examples
Send GET request to obtain origin IP address and check that is not empty:
*** Settings ***
Library HttpCtrl.Client
Library HttpCtrl.Json
*** Test Cases ***
Get Origin Address
Initialize Client www.httpbin.org
Send HTTP Request GET /ip
${response status}= Get Response Status
${response body}= Get Response Body
${response body}= Decode Bytes To String ${response body} UTF-8
${expected status}= Convert To Integer 200
Should Be Equal ${response status} ${expected status}
${origin}= Get Json Value From String ${response body} origin
Should Not Be Empty ${origin}
In this example HTTP client sends POST request to HTTP server. HTTP server receives it and checks incoming request for correctness.
*** Settings ***
Library String
Library HttpCtrl.Client
Library HttpCtrl.Server
Test Setup Initialize HTTP Client And Server
Test Teardown Terminate HTTP Server
*** Test Cases ***
Receive And Reply To POST
${request body}= Set Variable { "message": "Hello!" }
Send HTTP Request Async POST /post ${request body}
Wait For Request
Reply By 200
${method}= Get Request Method
${url}= Get Request Url
${body}= Get Request Body
${body}= Decode Bytes To String ${body} UTF-8
Should Be Equal ${method} POST
Should Be Equal ${url} /post
Should Be Equal ${body} ${request body}
*** Keywords ***
Initialize HTTP Client And Server
Initialize Client 127.0.0.1 8000
Start Server 127.0.0.1 8000
Terminate HTTP Server
Stop Server
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
Hashes for robotframework-httpctrl-0.3.1.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 12aea9007bfd906ba457d89b895476daba1be35a59b68d12271f95504a6a2679 |
|
MD5 | 7455ae98504fd9c83a6de4e7f4e8b8f5 |
|
BLAKE2b-256 | 1347228d969fec339ca5386dbb68e872039374c6fec60e8dfb74998d2a208942 |