🏠 RequestsLibrary is a Robot Framework library
aimed to provide HTTP api testing functionalities by wrapping the well known Python Requests Library.
Install stable version
pip install robotframework-requests
🤖 Quick start
*** Settings ***
Library RequestsLibrary
*** Test Cases ***
Quick Get Request Test
${response}= GET https://www.google.com
Quick Get Request With Parameters Test
${response}= GET https://www.google.com/search params=query=ciao expected_status=200
Quick Get A JSON Body Test
${response}= GET https://jsonplaceholder.typicode.com/posts/1
Should Be Equal As Strings 1 ${response.json()}[id]
What's new in 0.9
Sessionless keywords are now available, you can just GET, POST, etc.. no need to create a session anymore!
${resp}= GET https://www.google.com
Status Should Be and Request Should Be Successfull can use the last response, no need to pass the response anymore!
GET https://www.google.com
Status Should Be 200
What's new in 0.8
New keywords structure:
All requests keywords have been rewritten because of many not backward compatible changes
and to allow in the near future requests keywords without a session.
Example Get Request become GET On Session and soon there will be also just GET
when a session is not needed.
Old keywords * Request are now deprecated and will be removed in 1.0.0 version.
Implicit assert on status code:
* On Session keywords automatically fail if an error status code is returned.
expect_status= could be used to specify a status code (201, OK, Bad request)
or any if you want to evaluate the response in any case.
Closer to the original Requests library: New keywords have the same parameter orders and structure as the original. Lot of pre-parsing / encoding has been removed to have a more accurate and unchanged behaviour.
Cleaner project architecture: Main keywords file has been split with a more logic division to allow better and faster maintenance.
🤖 More examples
*** Settings ***
Library Collections
Library RequestsLibrary
Suite Setup Create Session jsonplaceholder https://jsonplaceholder.typicode.com
*** Test Cases ***
Get Request Test
Create Session google http://www.google.com
${resp_google}= GET On Session google / expected_status=200
${resp_json}= GET On Session jsonplaceholder /posts/1
Should Be Equal As Strings ${resp_google.reason} OK
Dictionary Should Contain Value ${resp_json.json()} sunt aut facere repellat provident
Post Request Test
&{data}= Create dictionary title=Robotframework requests body=This is a test! userId=1
${resp}= POST On Session jsonplaceholder /posts json=${data} expected_status=anything
Status Should Be 201 ${resp}
📖 Keywords documentation
Robotframework-requests offers a wide set of keywords which can be found in the Keywords documentation
🔬 Test examples
You can find many test examples inside the atests folder.
🤝 Contributing ✍️
Feel free to contribute and open an issue in order to discuss it. Before doing it take a look at the contribution guidelines.
📢 Get in touch with the community via slack and Users group
Release files for robotframework-requests 0.9.7
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| robotframework-requests-0.9.7.tar.gz | 19.4 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| robotframework_requests-0.9.7-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 40.5 kB
Release files / robotframework-requests-0.9.7.tar.gz
| Download URL | robotframework-requests-0.9.7.tar.gz |
|---|---|
| Size | 19.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
c2a2839813e1dc6b299e7d336314c9982c225c5b7e001ec893dc3555c6a95740
|
|
BLAKE2b-256 checksum How to use checksums |
61e2b17b940985e7b35f53767d908897870fcf4e143a2a7c2da76d152e4abc4c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/5.0.0 CPython/3.12.2
|
Release files / robotframework_requests-0.9.7-py3-none-any.whl
| Download URL | robotframework_requests-0.9.7-py3-none-any.whl |
|---|---|
| Size | 21.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
96315066318778cbcf5523cdb6175f5a0b8fec33275030a20dade3a3d98aeca2
|
|
BLAKE2b-256 checksum How to use checksums |
cd1803ef4d1132f50b55220af5308db91e1cc5481b8b063cac5fafa625b00f64
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/5.0.0 CPython/3.12.2
|
