(openai): DataBackupToS3Action

[swerner]

Uploads files to an AWS S3 bucket for backup purposes, ensuring data persistence and security.

[augmentations-ai]

This looks like a useful action! To ensure it works as expected and to facilitate manual testing, could you provide an example of how to use this action and detailed steps to verify it? Consider the following:

1. Setup: Describe any necessary AWS setup (e.g., creating an S3 bucket) and environment variables (AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY).
2. Example Usage: Provide a code snippet demonstrating how to instantiate and call DataBackupToS3Action with different parameters, including the optional ones.
3. Verification Steps:
   • Explain how to create a test file that the action will upload.
   • Describe how to check the S3 bucket to confirm that the file was uploaded correctly, including the object key.
   • Detail how to verify the logging output to confirm successful upload or to check for errors.
4. Error Handling: Explain how to force specific error conditions (e.g., invalid credentials, non-existent bucket) and how to verify that the action correctly catches and logs the errors.

For example, the steps could look like:

# Setup:
1. Create an S3 bucket named 'test-bucket' in the us-east-1 region.
2. Configure your AWS credentials either via environment variables or an IAM role.

# Example Usage:

```ruby
# Create a test file
File.write('test_file.txt', 'This is a test file.')

# Instantiate the action
action = DataBackupToS3Action.new(bucket_name: 'test-bucket', file_path: 'test_file.txt')

# Call the action
action.call

Verification Steps:

1. Go to the AWS S3 console and check the 'test-bucket' bucket. You should find 'test_file.txt' there.
2. Check the logs to see if the file has been successfully uploaded, there should be a message similar to Successfully uploaded test_file.txt to test-bucket/test_file.txt.

Providing these details would greatly help reviewers and anyone manually testing this action.