RequestsLibrary is a Robot Framework test library that uses the Requests HTTP client.
Install robotframework-requests via pip
pip install -U robotframework-requestsHere is a sample test case.
| Settings | ||||
| Library | Collections | |||
| Library | RequestsLibrary | |||
| Test Cases | ||||
| Get Requests | ||||
| Create Session | github | http://api.github.com | ||
| Create Session | http://www.google.com | |||
| ${resp}= | Get | / | ||
| Should Be Equal As Strings | ${resp.status_code} | 200 | ||
| ${resp}= | Get | github | /users/bulkan | |
| Should Be Equal As Strings | ${resp.status_code} | 200 | ||
| Dictionary Should Contain Value | ${resp.json()} | Bulkan Savun Evcimen |
RequestsLibrary, tries to follow the same API as requests. In the above example we load in the RequestsLibrary using the Library keyword.
To be able to distinguish HTTP requests to different hosts and for ease of creation of test cases, you need to create a Session. Internally
this will create a request.Session object. The Create Session keyword accepts two arguments;
* _alias_ to identify the session later
* _root url_ to the server
HTTP verbs are mapped keywords which accept two arguments.
* _alias_ identifying the Session we created earlier.
* _URI_ to send the request to.
Above we create two Sessions one to the github api and the other to google. Creating sessions dont send any requests.
After we create a Session we can send any of the following Get, Post, Put, Delete, Head requests. In the above example we send a GET request
to the session with the alias google and check the HTTP response code. Then send a another GET request but this time to the session with
the alias github and pass in a uri. In this case it is /users/bulkan which will return a JSON string. RequestsLibrary returned object provides
a method to get the content as a JSON object format called json().
For more examples see the tests folder which contains testcase files that is used to test the keywords in this library againts httpbin.org.
For individual keyword documentation see the following;
http://bulkan.github.io/robotframework-requests/
Send your questions to the Robot Framework Users Group