Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/marketsquare/robotframework-aws

Custom Library for Robot Framework to interact with Amazon Cloud Services
https://github.com/marketsquare/robotframework-aws

amazon-web-services aws boto3 cloud python robotframework test-automation

Last synced: 4 days ago
JSON representation

Custom Library for Robot Framework to interact with Amazon Cloud Services

Awesome Lists containing this project

README

        

# robotframework-aws

AWSLibrary is a testing library for Robot Framework that gives you the ability to use many of the AWS services in your
tests. This library directly interacts with [Boto 3](https://boto3.amazonaws.com/v1/documentation/api/latest/index.html).
Boto is the Amazon Web Services (AWS) SDK for Python. It enables Python developers to create, configure, and manage
AWS services.

If there is functionality that should be included in this library please create an issue or feel free to contribute.

![PyPI](https://img.shields.io/pypi/v/robotframework-aws.svg)
![Last Commit](https://img.shields.io/github/last-commit/MarketSquare/robotframework-aws)
![License](https://img.shields.io/pypi/l/robotframework-aws)
![Downloads](https://img.shields.io/pypi/dm/robotframework-aws)
![Total downloads](https://static.pepy.tech/personalized-badge/robotframework-aws?period=total&units=international_system&left_color=lightgrey&right_color=yellow&left_text=Total)

## Keyword Documentation

---------------

This library covers the AWS services listed in the keywords:

[Documentation of keywords](https://raw.githack.com/MarketSquare/robotframework-aws/master/docs/AWSLibrary.html)

[Pypi](https://pypi.org/project/robotframework-aws/)

---------------

### Installation and use

#### Install the package

```sh
pip install robotframework-aws
```

#### Update the package

```sh
pip install robotframework-aws --upgrade
```

#### Creating a Test Case

When creating a test case, start by creating an AWS session for your test and end by deleting it.

```robotframework
*** Settings ***
Library AWSLibrary

*** Variables ***
${REGION} eu-west-1
${BUCKET} some-bucket-name

*** Test Cases ***
Test Case
[Setup] Create Session With Keys ${REGION} %{AWS_USER_NAME} %{AWS_USER_PASS}
S3 Upload File ${BUCKET} new_file.json ${CURDIR}/local_file.json
S3 Key Should Exist ${BUCKET} new_file.json
S3 Key Should Not Exist ${BUCKET} local_file.json
${file_inside_folder} S3 List Objects ${BUCKET} folder_name
Log List ${file_inside_folder}
S3 Download File ${BUCKET} new_file.json ${CURDIR}/new_local_file.json
S3 Delete File ${BUCKET} new_file.json
[Teardown] Delete All Sessions
```

### Attention Contributors

[Contribution guidelines for this project](CONTRIBUTING.md)