Metadata-Version: 2.1
Name: questions-three-aws
Version: 3.2.1.0
Summary: Amazon Web Services integrations for Questions Three
Home-page: https://github.com/CyberGRX/questions-three
Author: Mike Duskis
Author-email: mike.duskis@cybergrx.com
License: UNKNOWN
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Software Development :: Testing
Description-Content-Type: text/markdown
Requires-Dist: boto3 (>=1.10.4)
Requires-Dist: docutils (<0.15,>=0.10)
Requires-Dist: expects (>=0.8.0)
Requires-Dist: pyfakefs (>=3.4.3)
Requires-Dist: questions-three
Requires-Dist: twin-sister (>=4.5.1)
Requires-Dist: twine (>=1.9.1)
Requires-Dist: wheel (>=0.30.0)

# Amazon Web Services Integrations for Questions Three

This is an optional package for the [Questions Three testing library](https://pypi.org/project/questions-three/).

## S3 Artifact Saver

As the name implies, the S3 Artifact Saver saves artifacts to an AWS S3 bucket.  It subscribes to `ARTIFACT_CREATED` and `REPORT_CREATED` events and saves everything it sees. Among other things, this will include JUnit XML test reports, HTTP transcripts from the built-in HTTP Client, and screenshots and DOM dumps from the [optional Selenium integrations](https://pypi.org/project/questions-three-selenium).

### Activation

Create (or append) a custom reporters file:

```
echo questions_three_aws.S3ArtifactSaver >> /var/custom_reporters
```

Inform Questions Three about the custom reporters file:

```
export CUSTOM_REPORTERS_FILE=/var/custom_reporters
```

Tell the S3 Artifact Saver which bucket to use:

```
export S3_BUCKET_FOR_ARTIFACTS=spam-eggs-sausage-spam
```

Set appropriate environment variables for AWS:

See [the fine AWS documentation](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-envvars.html).  At a minimum, you will need credentials and a region.


