File: README.md

package info (click to toggle)
aws-crt-python 0.16.8%2Bdfsg-1
  • links: PTS, VCS
  • area: main
  • in suites: bookworm
  • size: 78,328 kB
  • sloc: ansic: 330,743; python: 18,949; makefile: 6,271; sh: 3,712; asm: 754; cpp: 699; ruby: 208; java: 77; perl: 73; javascript: 46; xml: 11
file content (47 lines) | stat: -rw-r--r-- 1,927 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
# Helper script to setup your S3 structure to run the tests for aws-c-s3

To use this script, you must have AWS credentials with permission to create and delete buckets.

To create the S3 buckets and objects that tests will use:

``` sh
pip3 install boto3
python3 test_helper.py init
```

To clean up the S3 buckets created

``` sh
python3 test_helper.py clean
```

## Actions

### `init` action

- Create `aws-c-s3-test-bucket` in us-west-2
- Add the lifecyle to automatic clean up the `upload/` after one day
- Upload files:
  - `pre-existing-10MB-aes256-c` [SSE-C](https://docs.aws.amazon.com/AmazonS3/latest/userguide/ServerSideEncryptionCustomerKeys.html#sse-c-highlights) encrypted fille
  - `pre-existing-10MB-aes256` [SSE-S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/specifying-s3-encryption.html) encrypted fille
  - `pre-existing-10MB-kms` [SSE-KMS](https://docs.aws.amazon.com/AmazonS3/latest/userguide/UsingKMSEncryption.html) encrypted fille
  - `pre-existing-10MB`
  - `pre-existing-1MB`
  - `pre-existing-empty`
- Create `aws-c-s3-test-bucket-public` in us-west-2
- Upload files:
  - `pre-existing-1MB` 1MB file with public read access.

### `clean` action

- Delete the `aws-c-s3-test-bucket` and `aws-c-s3-test-bucket-public` and every object inside them

## Notes

- The MRAP tests are not included in this script, and it's disabled by default. To run those tests, you will need to create a MRAP access point with the buckets have `pre-existing-1MB` in it. Then update `g_test_mrap_endpoint` to the uri of the MRAP endpoint and build with `-DENABLE_MRAP_TESTS=true`.
- To run tests in tests/s3_mock_server_tests.c, initialize the mock S3 server first from [here](./../mock_s3_server/). And build your cmake project with `-ENABLE_MOCK_SERVER_TESTS=true`

## TODO

- Automatic the mrap creation
- Instead of hard-coded path, bucket and region, use the helper to set env-var and pick up from tests.