Declarative assertions for AWS

Related tags

Third-party APIs Wrappers aws python3 pytest pytest-plugin boto3
Overview

AWSsert

GitHub Workflow Status PyPI PyPI - Python Version Code style: black

AWSsert is a Python library providing declarative assertions about AWS resources to your tests.

Installation

Use the package manager pip to install AWSsert.

pip install awssert

Usage

Installing the package will make AWSserts extra assertions available to all of your tests. Assertions are attached directly to boto3 resource objects, allowing you to write clean and declarative tests:

import boto3

def test_bucket_contains_object():
   bucket = boto3.resource("s3").Bucket("foo")
   assert bucket.should_not.contain("bar")
   bucket.put_object(Key="bar", Body=b"123")
   assert bucket.should.contain("bar")

AWSsert also works in tandem with moto, enabling the same level of clarity to be applied on mock infrastructure:

import boto3
from moto import mock_s3

@mock_s3
def test_mock_bucket_contains_object():
   bucket = boto3.resource("s3").Bucket("foo")
   assert bucket.should_not.contain("bar")
   bucket.put_object(Key="bar", Body=b"123")
   assert bucket.should.contain("bar")

Progress

AWS Service Resource Object AWSsert Supported
CloudFormation Event ❌
Stack ❌
StackResource ❌
StackResourceSummary ❌
CloudWatch Alarm ❌
Metric ❌
DynamoDB Table ✅
EC2 ClassicAddress ❌
DhcpOptions ❌
Image ❌
Instance ❌
InternetGateway ❌
KeyPair ❌
KeyPairInfo ❌
NetworkAcl ❌
NetworkInterface ❌
NetworkInterfaceAssociation ❌
PlacementGroup ❌
Route ❌
RouteTable ❌
RouteTableAssociation ❌
SecurityGroup ❌
Snapshot ❌
Subnet ❌
Tag ❌
Volume ❌
Vpc ❌
VpcPeeringConnection ❌
VpcAddress ❌
Glacier Account ❌
Archive ❌
Job ❌
MultipartUpload ❌
Notification ❌
Vault ❌
IAM AccessKey ❌
AccessKeyPair ❌
AccountPasswordPolicy ❌
AccountSummary ❌
AssumeRolePolicy ❌
CurrentUser ❌
Group ✅
GroupPolicy ❌
InstanceProfile ❌
LoginProfile ❌
MfaDevice ❌
Policy ✅
PolicyVersion ❌
Role ✅
RolePolicy ❌
SamlProvider ❌
ServerCertificate ❌
SigningCertificate ❌
User ✅
UserPolicy ❌
VirtualMfaDevice ❌
OpsWorks Layer ❌
Stack ❌
StackSummary ❌
S3 Bucket ✅
BucketAcl ❌
BucketCors ❌
BucketLifecycle ❌
BucketLifecycleConfiguration ❌
BucketLogging ❌
BucketNotification ❌
BucketPolicy ❌
BucketRequestPayment ❌
BucketTagging ❌
BucketVersioning ❌
BucketWebsite ❌
MultipartUpload ❌
MultipartUploadPart ❌
Object ❌
ObjectAcl ❌
ObjectSummary ❌
ObjectVersion ❌
SNS PlatformApplication ❌
PlatformEndpoint ❌
Subscription ❌
Topic ✅
SQS Message ❌
Queue ❌

Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

A full contribution guide and code of conduct are supplied with the repository. In essence, update the unit tests and changelog, and treat fellow users with respect!

License

Apache Software License 2.0

You might also like...
Python + AWS Lambda Hands OnPython + AWS Lambda Hands On
Python + AWS Lambda Hands OnPython + AWS Lambda Hands On

Python + AWS Lambda Hands On Python Criada em 1990, por Guido Van Rossum. "Bala de prata" (quase). Muito utilizado em: Automatizações - Selenium, Beau

Marcelo Ortiz de Santana 8 Sep 9, 2022
Unauthenticated enumeration of services, roles, and users in an AWS account or in every AWS account in existence.

Quiet Riot 🎶 C'mon, Feel The Noise 🎶 An enumeration tool for scalable, unauthenticated validation of AWS principals; including AWS Acccount IDs, roo

Wes Ladd 89 Jan 5, 2023
AWS Blog post code for running feature-extraction on images using AWS Batch and Cloud Development Kit (CDK).

Batch processing with AWS Batch and CDK Welcome This repository demostrates provisioning the necessary infrastructure for running a job on AWS Batch u

AWS Samples 7 Oct 18, 2022
Aws-lambda-requests-wrapper - Request/Response wrapper for AWS Lambda with API Gateway

AWS Lambda Requests Wrapper Request/Response wrapper for AWS Lambda with API Gat

null 1 May 20, 2022
AWS-serverless-starter - AWS Lambda serverless stack via Serverless framework
AWS-serverless-starter - AWS Lambda serverless stack via Serverless framework

Serverless app via AWS Lambda, ApiGateway and Serverless framework Configuration

Bəxtiyar 3 Feb 2, 2022
Aws-cidr-finder - A Python CLI tool for finding unused CIDR blocks in AWS VPCs

aws-cidr-finder Overview An Example Installation Configuration Contributing Over

Cooper Walbrun 18 Jul 31, 2022
AWS CloudSaga - Simulate security events in AWS

AWS CloudSaga - Simulate security events in AWS AWS CloudSaga is for customers to test security controls and alerts within their Amazon Web Services (

Amazon Web Services - Labs 325 Dec 1, 2022
AWS SDK for Python

Boto3 - The AWS SDK for Python Boto3 is the Amazon Web Services (AWS) Software Development Kit (SDK) for Python, which allows Python developers to wri

the boto project 7.8k Jan 8, 2023
AWS DeepRacer Free Student Workshop: Run faster by using your custom waypoints

AWS DeepRacer Free Student Workshop: Run faster by using your custom waypoints Reward Function Template for waypoints def reward_function(params):

Yuen Cheuk Lam 88 Nov 27, 2022
Comments
  • Enhancement/1

    Enhancement/1

    Fixes issue #1 by replacing the fixture with a pytest hook which sets up the assertions before each test. Flake8 config has been updated to check for F811 and F401 again

    opened by TSNoble 1
  • Improve compatibility with Moto

    Improve compatibility with Moto

    Currently, AWSsert only supports usage with moto fixtures, which must come before the awssert fixture in a test. Moto decorators are commonly used, therefore it would be worth investigating how AWSsert could work with them

    enhancement 
    opened by TSNoble 1
  • Enhancement/40 38 41

    Enhancement/40 38 41

    Fixes #40 and fixes #38 and fixes #41 by removing restrictions on valid prefixes, splitting the prefix decorator into positive and negative decorators, and only creating routing for prefixes relevant to an assertion class

    opened by TSNoble 0
  • Add suffixes to assertions

    Add suffixes to assertions

    One example might be a within(time) suffix which adds retry functionality to an assertion. A suffix decorator could be added to indicate which assertions work with which suffixes

    e.g. assert bucket.should.contain("foo").within(2, "minutes")

    opened by TSNoble 0
Owner
A collection of open source repositories created by @TSNoble
null
GitHub
AHA is an incident management & communication framework to provide real-time alert customers when there are active AWS event(s). For customers with AWS Organizations, customers can get aggregated active account level events of all the accounts in the Organization. Customers not using AWS Organizations still benefit alerting at the account level.

Table of Contents Introduction Architecture Configuring an Endpoint Creating a Amazon Chime Webhook URL Creating a Slack Webhook URL Creating a Micros

AWS Samples 215 Dec 23, 2022
Automated AWS account hardening with AWS Control Tower and AWS Step Functions

Automate activities in Control Tower provisioned AWS accounts Table of contents Introduction Architecture Prerequisites Tools and services Usage Clean

AWS Samples 20 Dec 7, 2022
Implement backup and recovery with AWS Backup across your AWS Organizations using a CI/CD pipeline (AWS CodePipeline).

Backup and Recovery with AWS Backup This repository provides you with a management and deployment solution for implementing Backup and Recovery with A

AWS Samples 8 Nov 22, 2022
Automatically compile an AWS Service Control Policy that ONLY allows AWS services that are compliant with your preferred compliance frameworks.

aws-allowlister Automatically compile an AWS Service Control Policy that ONLY allows AWS services that are compliant with your preferred compliance fr

Salesforce 189 Dec 8, 2022
SSH-Restricted deploys an SSH compliance rule (AWS Config) with auto-remediation via AWS Lambda if SSH access is public.

SSH-Restricted SSH-Restricted deploys an SSH compliance rule with auto-remediation via AWS Lambda if SSH access is public. SSH-Auto-Restricted checks

Adrian Hornsby 30 Nov 8, 2022
AWS Auto Inventory allows you to quickly and easily generate inventory reports of your AWS resources.

Photo by Denny Müller on Unsplash AWS Automated Inventory ( aws-auto-inventory ) Automates creation of detailed inventories from AWS resources. Table

AWS Samples 123 Dec 26, 2022
A suite of utilities for AWS Lambda Functions that makes tracing with AWS X-Ray, structured logging and creating custom metrics asynchronously easier

A suite of utilities for AWS Lambda Functions that makes tracing with AWS X-Ray, structured logging and creating custom metrics asynchronously easier

Amazon Web Services - Labs 1.9k Jan 7, 2023
aws-lambda-scheduler lets you call any existing AWS Lambda Function you have in a future time.

aws-lambda-scheduler aws-lambda-scheduler lets you call any existing AWS Lambda Function you have in the future. This functionality is achieved by dyn

Oğuzhan Yılmaz 57 Dec 17, 2022
Project template for using aws-cdk, Chalice and React in concert, including RDS Postgresql and AWS Cognito

What is This? This repository is an opinonated project template for using aws-cdk, Chalice and React in concert. Where aws-cdk and Chalice are in Pyth

Rasmus Jones 4 Nov 7, 2022
POC de uma AWS lambda que executa a consulta de preços de criptomoedas, e é implantada na AWS usando Github actions.

Cryptocurrency Prices Overview Instalação Repositório Configuração CI/CD Roadmap Testes Overview A ideia deste projeto é aplicar o conteúdo estudado s

Gustavo Santos 3 Aug 31, 2022