clear-skies-aws 1.10.1__py3-none-any.whl → 2.0.1__py3-none-any.whl

{clear_skies_aws-1.10.1.dist-info → clear_skies_aws-2.0.1.dist-info}/METADATA

@@ -1,46 +1,48 @@
-Metadata-Version: 2.3
+Metadata-Version: 2.4
 Name: clear-skies-aws
-Version: 1.10.1
+Version: 2.0.1
 Summary: clearskies bindings for working in AWS
-License: MIT
-Author: Conor Mancone
-Author-email: cmancone@gmail.com
-Requires-Python: >=3.10,<4.0
+Project-URL: Repository, https://github.com/clearskies-py/clearskies-aws
+Project-URL: Issues, https://github.com/clearskies-py/clearskies-aws/issues
+Project-URL: Changelog, https://github.com/clearskies-py/clearskies-aws/blob/main/CHANGELOG.md
+Project-URL: Documentation, https://clearskies.info/modules/clearskies-aws/
+Author: tnijboer
+Author-email: Conor Mancone <cmancone@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
+Requires-Python: <4.0,>=3.11
+Requires-Dist: boto3<2.0.0,>=1.26.148
+Requires-Dist: clear-skies<3.0.0,>=2.0.2
+Requires-Dist: types-boto3[dynamodb,sns,sqs]<2.0.0,>=1.38.13
 Provides-Extra: akeyless
+Requires-Dist: akeyless-cloud-id<0.5.0,>=0.2.3; extra == 'akeyless'
+Requires-Dist: akeyless<6.0.0,>=5.0.0; extra == 'akeyless'
 Provides-Extra: ses
-Requires-Dist: akeyless (>=4.0.0,<5.0.0) ; extra == "akeyless"
-Requires-Dist: akeyless-cloud-id (>=0.2.3,<0.3.0) ; extra == "akeyless"
-Requires-Dist: boto3 (>=1.26.148,<2.0.0)
-Requires-Dist: clear-skies (>=1.14.4,<2.0.0)
-Requires-Dist: jinja2 (>=3.1.2,<4.0.0) ; extra == "ses"
-Requires-Dist: types-boto3[dynamodb,sns,sqs] (>=1.38.13,<2.0.0)
-Project-URL: Repository, https://github.com/cmancone/clearskies-aws
+Requires-Dist: jinja2<4.0.0,>=3.1.2; extra == 'ses'
 Description-Content-Type: text/markdown
 
 # clearskies-aws
 
 clearskies bindings for working in AWS, which means additional:
 
- - backends (DynamoDB, SQS)
- - Secret/environment integrations (parameter store/secret manager)
- - DB connectivity via IAM auth
- - Contexts (ALB, HTTP API Gateway, Rest API Gateway, direct Lambda invocation, lambda+SQS)
+- backends (DynamoDB, SQS)
+- Secret/environment integrations (parameter store/secret manager)
+- DB connectivity via IAM auth
+- Contexts (ALB, HTTP API Gateway, Rest API Gateway, direct Lambda invocation, lambda+SQS)
 
-# Installation, Documentation, and Usage
+## Installation, Documentation, and Usage
 
 To install:
 
-```
+```shell
 pip3 install clear-skies-aws
 ```
 
-# Usage
+## Usage
 
 Anytime you use a context from `clearskies-aws`, the default dependencies are adjust to:
 
@@ -49,17 +51,17 @@ Anytime you use a context from `clearskies-aws`, the default dependencies are ad
 
 In both cases you must provide the AWS region for your resources, which you do by setting the `AWS_REGION` environment variable (either in an actual environment variable or in your `.env` file).
 
-## Paramter Store
+### Parameter Store
 
 To use the SSM parameter store you just inject the `secrets` variable into your callables:
 
-```
+```python
 import clearskies_aws
 
 def parameter_store_demo(secrets):
     return secrets.get('/path/to/parameter')
 
-execute_demo_in_elb = clearskies_aws.contexts.lambda_elb(parameter_store_demo)
+execute_demo_in_elb = clearskies_aws.contexts.lambda_alb(parameter_store_demo)
 
 def lambda_handler(event, context):
     return execute_demo_in_elb(event, context)
@@ -67,14 +69,14 @@ def lambda_handler(event, context):
 
 Also, per default behavior, clearskies can fetch things from your secret manager if specified in your environment/.env file.  For instance, if your database password is stored in parameter store, then you can reference it from your `.env` file with a standard cursor backend:
 
-```
+```env
 db_host = "path-to-aws.rds"
 db_username = "sql_username"
 db_password = "secret://path/to/password/in/parameter/store"
 db_database = "sql_database_name"
 ```
 
-## Secret Manager
+### Secret Manager
 
 If desired, you can swap out the parameter store integration for secret manager.  Just remember that you can configure parameter store to fetch secrets from secret manager, so you might be best off doing that and sticking with the default parameter store integration.  Still, if you want to use secret manager, you just configure it in your application or context:
 
@@ -93,7 +95,7 @@ def lambda_handler(event, context):
     return execute_demo_in_elb(event, context)
 ```
 
-## Contexts
+### Contexts
 
 clearskies_aws adds the following contexts:
 
@@ -105,7 +107,7 @@ clearskies_aws adds the following contexts:
 | `clearskies_aws.contexts.lambda_inocation`                  | Lambdas invoked directly          |
 | `clearskies_aws.contexts.lambda_sqs_standard_partial_batch` | Lambdas attached to an SQS queue  |
 
-### Lambdas+SQS
+#### Lambdas+SQS
 
 Here's a simple example of using the Lambda+SQS context:
 
@@ -125,7 +127,7 @@ See [the AWS docs](https://docs.aws.amazon.com/lambda/latest/dg/with-sqs.html).
 
 Note that, unlike other contexts, the Lambda+SQS context really only works with a simple callable.  Routing and other handlers don't make much sense here.  Keep in mind that, before invoking the Lambda, AWS may batch up records together in arbitrary ways.  The context will take care of this and will invoke your callable once **for each record in the AWS event** - not once for the event.  `request_data` will be populated with the actual message for the event.  In addition, it assumes that a JSON message was sent to the queue, so `request_data` will be an object/list/etc, rather than a string.  This is intended to be used with [partial batching](https://docs.aws.amazon.com/lambda/latest/dg/with-sqs.html#services-sqs-batchfailurereporting).  Therefore, if your function raises an error, the context will catch it, return a failure response for the cooresponding message, and then continue processing any other messages in the batch.
 
-## SQS Backend
+### SQS Backend
 
 To use the SQS backend just declare it for your model, set the table name to return the queue url, and execute a "create" operation to send data to the queue.  Note that the SQS backend is write-only: you can "create" records (resulting in a message being sent to the queue), but you can't read data back out.  The way the queue system in SQS works is just too different than a standard database for that to make sense in the context of a clearskies model.
 
@@ -164,7 +166,7 @@ if __name__ == '__main__':
     cli()
 ```
 
-## IAM DB Auth
+### IAM DB Auth
 
 For non-serverless RDS databases, AWS supports login via IAM.  You have to provide a few additional details in your environment to make this work:
 
@@ -195,7 +197,6 @@ def lambda_handler(event, context):
 
 Of course normally you wouldn't want to interact with it directly.  Adding `IAMDBAuth` to your `additional_configs` and setting up the necessary environemnt variables will be sufficient that any models that use the `cursor_backend` will connect via IAM DB Auth, rather than using hard-coded passwords.
 
-## IAM DB Auth with SSM Bastion
+### IAM DB Auth with SSM Bastion
 
 Coming shortly
-

clear_skies_aws-2.0.1.dist-info/RECORD

@@ -0,0 +1,4 @@
+clear_skies_aws-2.0.1.dist-info/METADATA,sha256=RuKqjsvTbdZc56XVM2UD6IZnSySbVkWA5SaFkxpbps4,8972
+clear_skies_aws-2.0.1.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+clear_skies_aws-2.0.1.dist-info/licenses/LICENSE,sha256=MkEX8JF8kZxdyBpTTcB0YTd-xZpWnHvbRlw-pQh8u58,1069
+clear_skies_aws-2.0.1.dist-info/RECORD,,

{clear_skies_aws-1.10.1.dist-info → clear_skies_aws-2.0.1.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: poetry-core 2.1.2
+Generator: hatchling 1.27.0
 Root-Is-Purelib: true
 Tag: py3-none-any

clear_skies_aws-2.0.1.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025, Tom Nijboer
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

clear_skies_aws-1.10.1.dist-info/LICENSE

@@ -1,7 +0,0 @@
-Copyright 2021 Conor Mancone
-
-Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

clear_skies_aws-1.10.1.dist-info/RECORD

@@ -1,71 +0,0 @@
-clearskies_aws/__init__.py,sha256=BZKL4SIyxx4MXpyP5hmwsMo2oJatyv5c2wjJOPzKBQ4,134
-clearskies_aws/actions/__init__.py,sha256=w_IWJg4UHV9Opv69zheH7ZHj1BnCzYLlm2JhFvHQCf8,2998
-clearskies_aws/actions/action_aws.py,sha256=zBXsvhBDDm2dAU4MVlub84Ld1YNZ6ey8_zf4OeTe8go,4254
-clearskies_aws/actions/assume_role.py,sha256=tZHKMTQaImj_EAWormFZdIPkR_db7yBwOJxYaUyuGdA,4085
-clearskies_aws/actions/assume_role_test.py,sha256=AoXWRtApRZz_oPDj6QhT0ERmYjKOHOXLNet-MgbbeB8,2451
-clearskies_aws/actions/ses.py,sha256=xJ0NEFPP-8kARPGjDv1yf_bhAiaIIM1mDzMxY22GE5E,7925
-clearskies_aws/actions/ses_test.py,sha256=lyNbqI46Ld_ZUKtWLgSwwfSOFksQ39H4hzPS3eTx7nk,3076
-clearskies_aws/actions/sns.py,sha256=00E-eCQuq3Ygscyia928K8jX8rhDZrl5kyasM0st_uI,2288
-clearskies_aws/actions/sns_test.py,sha256=iqlaZOA-0YHPOu52-XqpCIAgAv1JZodDdlm4YYYhj8U,2306
-clearskies_aws/actions/sqs.py,sha256=i-QyyFy-ImivXk-m-Bn9Mh5BF5qODthUyZAQVRsb8vs,3392
-clearskies_aws/actions/sqs_test.py,sha256=aazVN-bY6E17Pu3hDwLldj6YPirbqXjM6LfYFomUVmQ,4040
-clearskies_aws/actions/step_function.py,sha256=wiDgGdOWdY0zVoClDsX08YFZqTR0bK3ydpyj0Qa7w_s,2599
-clearskies_aws/actions/step_function_test.py,sha256=0gRYLDVRt2R-Cv-5Pr2ui4Gbp8rg9nPhQY4ERALg6qU,3837
-clearskies_aws/backends/__init__.py,sha256=t98x6QNF2bvKzVI_owS4L3eG5JNVtsLS9c2fBw8uh9s,379
-clearskies_aws/backends/dynamo_db_backend.py,sha256=i-Na3McQDbyCYmQewBPKgbWEd3A3pf2wfmLs6FsRJ48,29487
-clearskies_aws/backends/dynamo_db_backend_test.py,sha256=wtymsOEVzO9y7_Whu9cCRyioRTmSimbLmRQSt3J4cik,13106
-clearskies_aws/backends/dynamo_db_condition_parser.py,sha256=v-DO4ijdjiHwBsSDF3dUgqQw5twCcG-5NA1aq7kUYQ0,13239
-clearskies_aws/backends/dynamo_db_condition_parser_test.py,sha256=n7snumB8GxyMBVlj-HL7JrsNj-ZJ91c5gdik0UNM5Ag,12664
-clearskies_aws/backends/dynamo_db_parti_ql_backend.py,sha256=pVd_N7XFf9PcTAm6rhMxih_sj9Ix6RkRj3LwmFy_Mr4,48544
-clearskies_aws/backends/dynamo_db_parti_ql_backend_test.py,sha256=7gH-RDh7JeaiEGLXsOB512SLmOp0hjdtWQ1cMmexvDM,23649
-clearskies_aws/backends/sqs_backend.py,sha256=hT1JCvCMU76Q4Ir7OeX8U8eAMLIu1_tMwGgaN9rpsPk,2726
-clearskies_aws/backends/sqs_backend_test.py,sha256=iCuHVVqZIR_PDGUUMZIkpir8yyJy3dcPR00AWR2N25U,1138
-clearskies_aws/contexts/__init__.py,sha256=YjwRaSoAqC-nmo3aFB8rzyuiHSP9mi77FVM-8RF0hRE,472
-clearskies_aws/contexts/cli.py,sha256=11Giwl10ydackFo0clpTnHZP-HTmJnvtpbhxJf74jDA,506
-clearskies_aws/contexts/cli_websocket_mock.py,sha256=W5Ujp9UIz4QG2A33OTpozFLihF5SaN2uUhwf17-qj3g,1085
-clearskies_aws/contexts/lambda_api_gateway.py,sha256=zYO_g4K87XYlQeZLYwF7_mzYbZCUzaZYaelpfcfeuTw,1002
-clearskies_aws/contexts/lambda_api_gateway_web_socket.py,sha256=5vTe8uWgHzQ11aToBeRHoFymYufUsTXBLC6sE6zUt9Q,1067
-clearskies_aws/contexts/lambda_elb.py,sha256=R4tyuRPjuTHNgmyzDqxy-VNePsIdXRH-mUMyWEOMky4,952
-clearskies_aws/contexts/lambda_http_gateway.py,sha256=9gmlTTPkxrtLmOQa7uUojCk9tFGg5kJGDB7GiAXx-bQ,1009
-clearskies_aws/contexts/lambda_invocation.py,sha256=U_S3cuY3G1_7ktzGiFTiO2LUnqauqvEDfKKEhYdPtpg,1336
-clearskies_aws/contexts/lambda_sns.py,sha256=crIo3S78N8xfthZsv0l5ooNlpF21ETjoWmHe1WCGQ4w,1364
-clearskies_aws/contexts/lambda_sqs_standard_partial_batch.py,sha256=iypcI4BpxV4IHcKKUWDxK3HuGyaYiP5YPwpFAm4auCw,1801
-clearskies_aws/contexts/lambda_sqs_standard_partial_batch_test.py,sha256=SkEIV_cgxCi-1zC3WXsRNyG6bCt7LB_6CWpxvB8QPxo,1855
-clearskies_aws/contexts/wsgi.py,sha256=wmHnDIfcrQN0I547uE2mlHHQtOLOpLfpbKpBJkw5puY,510
-clearskies_aws/di/__init__.py,sha256=KLq6G-CKR-Vdk9LZe5TijW_U-McJlrp1QuIXqmyAL-A,56
-clearskies_aws/di/standard_dependencies.py,sha256=TRST5BxxPQpWJyvXnAwCRJWYRDXC7qM05X3ffYI7EXc,2023
-clearskies_aws/handlers/__init__.py,sha256=E2x04QGy5dfaDIB5Xu8IRWwgypIrgGEZibijtKWe8jM,112
-clearskies_aws/handlers/secrets_manager_rotation.py,sha256=KV4XWKar4gT0Xu0eM_D75ECzYkjXxjeZtkOopPRG9rc,7471
-clearskies_aws/handlers/simple_body_routing.py,sha256=FGdeDY8nZIGfCOn0oOHi6EOP1h4xXcBP3W9fH0NuBlc,1449
-clearskies_aws/input_outputs/__init__.py,sha256=Tf8kWN95nwUbvlVaboYT06ICtSuZd0MPPzwWhO5iQGs,385
-clearskies_aws/input_outputs/cli_websocket_mock.py,sha256=J3PDYnFxOzqYhmlxWFcobbb4McKpsGduIBq6jdSAx5Y,434
-clearskies_aws/input_outputs/lambda_api_gateway.py,sha256=Xi9IdT0u20IMbaIJMBtF2wmsNLCDvmEUVoYB9IRqV00,3479
-clearskies_aws/input_outputs/lambda_api_gateway_test.py,sha256=B4tUxTqnAEeV0D0VRMu0HyphOJKNij-LtFd2ERcnKI8,2979
-clearskies_aws/input_outputs/lambda_api_gateway_web_socket.py,sha256=kG2fys9X7TailvlOBzIMItuSI8rlvDbBD4AXtI091hM,308
-clearskies_aws/input_outputs/lambda_elb.py,sha256=b675h0DxTGo9YscXN4mwzRGzP3hNSie4iPRKOg3kKPI,750
-clearskies_aws/input_outputs/lambda_http_gateway.py,sha256=YQk7GlQWtQjDiKWhX5jvXc3un1eq2sm1v_jl6iseNoQ,692
-clearskies_aws/input_outputs/lambda_invocation.py,sha256=yF3rYJ-r0YYzlh--33fGE-I-pzyhQxDmDo1TUQxCu00,1122
-clearskies_aws/input_outputs/lambda_sns.py,sha256=0m1dfVCSEftcovGAEWhU9ig4txX9duLkTXbdtjIzSAw,2055
-clearskies_aws/input_outputs/lambda_sqs_standard.py,sha256=RjsOqzyUovTuO3Nb9CSiWnVaHHxJiPmvOmuQbmpIW38,1974
-clearskies_aws/mocks/__init__.py,sha256=mn764gINN667tYoJfnsM6HjAAhCsO_kZ6E-fUwdLY50,22
-clearskies_aws/mocks/actions/__init__.py,sha256=to1r8B365Et2PRVfUWWnJGt7Hdr8vwwQuNyZvTSTP6g,152
-clearskies_aws/mocks/actions/ses.py,sha256=sCCNk_WdnQbINOzg8E31xyoeoEuUQeX-RwPbJ9ueNik,937
-clearskies_aws/mocks/actions/sns.py,sha256=eFnLf-ZIDCL0b62uKDBbPSYXZs1Mc3kRaGv_gPt-8rA,658
-clearskies_aws/mocks/actions/sqs.py,sha256=7cwGX7XUhzfGzDJYso2UkUBhMaugvxEqeNKbh9hOark,662
-clearskies_aws/mocks/actions/step_function.py,sha256=1JbdsVwPea1wmNnTnlgeWzGaQNBAkJl-2-Y5PG3uORI,888
-clearskies_aws/secrets/__init__.py,sha256=MF-e-9FTfnJ64UdZAmYiOxqOl1vSxvWA-FlFFv05CKE,326
-clearskies_aws/secrets/additional_configs/__init__.py,sha256=ejLAqwFTP6Xc5aXJAUpBhK1xUtmLzEmexHBuOOmgNBc,1919
-clearskies_aws/secrets/additional_configs/iam_db_auth.py,sha256=K6eLjo_D0uSxtCfqTAqGshDi3uz_iF-T0sDSJLyoTew,1082
-clearskies_aws/secrets/additional_configs/iam_db_auth_with_ssm.py,sha256=hzvR_WBwSoLcMdGXwhqkvKMKmjXzhZgimPWfm2MWSZQ,3467
-clearskies_aws/secrets/additional_configs/mysql_connection_dynamic_producer_via_ssh_cert_bastion.py,sha256=L2-E8Tm6BDHV-yJJ_M_Lo72jNY7uBaTp8SPrRuekcUE,3776
-clearskies_aws/secrets/additional_configs/mysql_connection_dynamic_producer_via_ssm_bastion.py,sha256=Llvg8uQW8J-qndAlDDtg9TY_Tvu2h9tUzchxxUtaRik,6444
-clearskies_aws/secrets/akeyless_with_ssm_cache.py,sha256=4_ep7P2SXei3hNbLrMhUSmr14GTzK69hkzjIYYU-dA4,1443
-clearskies_aws/secrets/parameter_store.py,sha256=lxBlp_9d2-vVjGNfl5859XzZCcLVMMrZtlJG8lKGVPA,1810
-clearskies_aws/secrets/parameter_store_test.py,sha256=35fTNau4tq_D4elMwyyByIiLesnmn05QhC_X1FVQXsM,763
-clearskies_aws/secrets/secrets_manager.py,sha256=jlpfAFC23EeSpm50L8B-yrXg4IROQq-M_90zzXDp_ak,3056
-clearskies_aws/secrets/secrets_manager_test.py,sha256=__YSe-YRbbE1S1SBvZZFQd3brIX5DPX2_wE9MI_Ezx0,788
-clearskies_aws/web_socket_connection_model.py,sha256=d_Au_Pu7YXBfc7_lbuI7zz4MZ8ZOOwGM0oooppEofcI,1776
-clear_skies_aws-1.10.1.dist-info/LICENSE,sha256=3Ehd0g3YOpCj8sqj0Xjq5qbOtjjgk9qzhhD9YjRQgOA,1053
-clear_skies_aws-1.10.1.dist-info/METADATA,sha256=f3IkhGylUcnIZSITx8j56rD5LJWTEks69c5FTZjGqfI,8784
-clear_skies_aws-1.10.1.dist-info/WHEEL,sha256=fGIA9gx4Qxk2KDKeNJCbOEwSrmLtjWCwzBz351GyrPQ,88
-clear_skies_aws-1.10.1.dist-info/RECORD,,

clearskies_aws/__init__.py

@@ -1,2 +0,0 @@
-from . import actions, backends, contexts, handlers, mocks, secrets
-from .web_socket_connection_model import WebSocketConnectionModel

clearskies_aws/actions/__init__.py

@@ -1,108 +0,0 @@
-import clearskies
-
-from typing import Optional, Callable, Union
-
-from .assume_role import AssumeRole
-from .ses import SES
-from .sns import SNS
-from .sqs import SQS
-from .step_function import StepFunction
-def ses(
-    sender,
-    to=None,
-    cc=None,
-    bcc=None,
-    subject=None,
-    message=None,
-    subject_template=None,
-    message_template=None,
-    subject_template_file=None,
-    message_template_file=None,
-    assume_role=None,
-    dependencies_for_template=None,
-    when=None,
-):
-    return clearskies.BindingConfig(
-        SES,
-        sender,
-        to=to,
-        cc=cc,
-        bcc=bcc,
-        subject=subject,
-        subject_template=subject_template,
-        subject_template_file=subject_template_file,
-        message=message,
-        message_template=message_template,
-        message_template_file=message_template_file,
-        assume_role=assume_role,
-        dependencies_for_template=dependencies_for_template,
-        when=when,
-    )
-def sns(
-    topic=None,
-    topic_environment_key=None,
-    topic_callable=None,
-    message_callable=None,
-    when=None,
-):
-    return clearskies.BindingConfig(
-        SNS,
-        topic=topic,
-        topic_environment_key=topic_environment_key,
-        topic_callable=topic_callable,
-        message_callable=message_callable,
-        when=when,
-    )
-def sqs(
-    queue_url: str = '',
-    queue_url_environment_key: str = '',
-    queue_url_callable: Callable = '',
-    message_callable: Callable = None,
-    when: Callable = None,
-    assume_role=None,
-    message_group_id: Optional[Union[Callable, str]]=None,
-):
-    return clearskies.BindingConfig(
-        SQS,
-        queue_url=queue_url,
-        queue_url_environment_key=queue_url_environment_key,
-        queue_url_callable=queue_url_callable,
-        message_callable=message_callable,
-        when=when,
-        assume_role=assume_role,
-        message_group_id=message_group_id,
-    )
-def step_function(
-    arn: str = "",
-    arn_environment_key: str = "",
-    arn_callable: Optional[Callable] = None,
-    message_callable: Optional[Callable] = None,
-    when: Optional[Callable] = None,
-    assume_role: Optional[AssumeRole] = None,
-    column_to_store_execution_arn: Optional[str] = None,
-):
-    return clearskies.BindingConfig(
-        StepFunction,
-        arn=arn,
-        arn_environment_key=arn_environment_key,
-        arn_callable=arn_callable,
-        message_callable=message_callable,
-        when=when,
-        assume_role=assume_role,
-        column_to_store_execution_arn=column_to_store_execution_arn,
-    )
-def assume_role(
-    role_arn: str,
-    external_id: str = "",
-    role_session_name: str = "",
-    duration: int = 3600,
-    source: Optional[AssumeRole] = None,
-):
-    return AssumeRole(
-        role_arn,
-        external_id=external_id,
-        role_session_name=role_session_name,
-        duration=duration,
-        source=source,
-    )
-__all__ = [assume_role, AssumeRole, ses, SES, sns, SNS, step_function, StepFunction, sqs, SQS]

clearskies_aws/actions/action_aws.py

@@ -1,118 +0,0 @@
-import boto3
-import json
-import logging
-
-from abc import ABC
-from boto3 import client
-from botocore.exceptions import ClientError
-from clearskies.environment import Environment
-from clearskies.models import Models
-from clearskies.functional import string
-from collections import OrderedDict
-from typing import Callable, Optional
-
-from ..di import StandardDependencies
-from .assume_role import AssumeRole
-class ActionAws(ABC):
-
-    _logging = logging.getLogger(__name__)
-    _client: Optional[boto3.client] = None
-    _name: Optional[str] = None
-
-    def __init__(self, environment: Environment, boto3: boto3, di: StandardDependencies) -> None:
-        """Setup action."""
-        self.environment = environment
-        self.boto3 = boto3
-        self.di = di
-
-    def configure(
-        self,
-        message_callable: Optional[Callable] = None,
-        when: Optional[Callable] = None,
-        assume_role: Optional[AssumeRole] = None,
-    ) -> None:
-        """Configues the Action."""
-        self.when = when
-        self.message_callable = message_callable
-        self.assume_role = assume_role
-
-        if self.message_callable and not callable(self.message_callable):
-            raise ValueError(
-                "'message_callable' should be a callable that returns the message for the queue, but a callable was not passed."
-            )
-
-        if when and not callable(when):
-            raise ValueError("'when' must be a callable but something else was found")
-
-        if not self._name:
-            raise ValueError(f"Name of client not set.")
-
-        if not self.environment.get('AWS_REGION', True) and not self.environment.get('AWS_DEFAULT_REGION', True):
-            raise ValueError("You must set either the AWS_REGION or AWS_DEFAULT_REGION environment variable when using AWS actions")
-
-    def __call__(self, model: Models) -> None:
-        """Send a notification as configured."""
-        if self.when and not self.di.call_function(self.when, model=model):
-            return
-
-        try:
-            client = self._getClient()
-            self._execute_action(client, model)
-        except ClientError as e:
-            self._logging.exception(f"Failed to retrieve client for {self._name}")
-            raise e
-
-    def _getClient(self, region=None) -> boto3.client:
-        """Retrieve the boto3 client."""
-        can_cache = not region
-        if self._client and can_cache:
-            return self._client
-
-        if self.assume_role:
-            boto3 = self.assume_role(self.boto3)
-        else:
-            boto3 = self.boto3
-
-        if not region:
-            region = self.default_region()
-        if region:
-            client = boto3.client(self._name, region_name=region)
-        else:
-            client = boto3.client(self._name)
-
-        if can_cache:
-            self._client = client
-        return client
-
-    def default_region(self):
-        region = self.environment.get('AWS_REGION', silent=True)
-        if region:
-            return region
-        region = self.environment.get('DEFAULT_AWS_REGION', silent=True)
-        if region:
-            return region
-        return None
-
-    def _execute_action(self, client: boto3.client, model: Models) -> None:
-        """Run the action."""
-        pass
-
-    def get_message_body(self, model: Models) -> str:
-        """Retrieve the message for the action."""
-        if self.message_callable:
-            result = self.di.call_function(self.message_callable, model=model)
-            if isinstance(result, dict) or isinstance(result, list):
-                return json.dumps(result, default=string.datetime_to_iso)
-            if not isinstance(result, str):
-                raise TypeError(
-                    f"The return value from the message callable for the {__name__} action must be a string, dictionary, or list. I received a "
-                    + f"{type(result)} after calling '{self.message_callable.__name__}'"
-                )
-            return result
-
-        model_data = OrderedDict()
-        for (column_name, column) in model.columns().items():
-            if not column.is_readable:
-                continue
-            model_data.update(column.to_json(model))
-        return json.dumps(model_data, default=string.datetime_to_iso)

clearskies_aws/actions/assume_role.py

@@ -1,102 +0,0 @@
-from __future__ import annotations
-from types import ModuleType
-from typing import Optional
-class AssumeRole:
-    """
-    Used by the various actions if you need to assume a role before making an AWS call.
-
-    Note that, in all cases, this class and the actions assume that you already have AWS credentials
-    properly configured/findable by boto3 in the standard way.  If you just have static IAM credentials
-    that you are trying to use... well, you can do that with some undocumented hackery, but that's not
-    really the goal for any of these classes.
-
-    Example:
-        Here's a basic usage example with an SQS action on a model trigger::
-
-            class User(clearskies.Model):
-                def __init__(self, memory_backend, columns):
-                    super().__init__(memory_backend, columns)
-                def columns_configuration(self):
-                    return OrderedDict([
-                        clearskies.column_types.string(
-                            'name',
-                            on_change=[
-                                clearskies_aws.actions.sqs(
-                                    queue_url='https://queue.url.example.aws.com',
-                                    assume_role=clearskies_aws.actions.assume_role(
-                                        role_arn='arn:aws:iam:role/name',
-                                        external_id='12345',
-                                    )
-                                )
-                            ],
-                        ),
-                    ])
-
-    Example:
-        Here's a more complicated example with a double-assumme-role to show how to combine them::
-
-            first_assume_role = clearskies_aws.actions.assume_role(
-                role_arn='arn:aws:123456789012:iam:role/name',
-                external_id='12345',
-            )
-            final_assume_role = clearskies_aws.actions.assume_role(
-                role_arn='arn:aws:210987654321:iam:role/name-2',
-                external_id='54321',
-                source=first_assume_role,
-            )
-            class User(clearskies.Model):
-                def __init__(self, memory_backend, columns):
-                    super().__init__(memory_backend, columns)
-                def columns_configuration(self):
-                    return OrderedDict([
-                        clearskies.column_types.string(
-                            'name',
-                            on_change=[clearskies_aws.actions.sqs(
-                                queue_url='https://queue.url.example.aws.com',
-                                assume_role=final_assume_role,
-                            )],
-                        ),
-                    ])
-
-    """
-    role_arn = ""
-    external_id = ""
-    role_session_name = ""
-    duration = 3600
-    source: Optional[AssumeRole] = None
-
-    def __init__(
-        self,
-        role_arn: str,
-        external_id: str = "",
-        role_session_name: str = "",
-        duration: int = 3600,
-        source: Optional[AssumeRole] = None
-    ):
-        """Assume a role."""
-        self.role_arn = role_arn
-        self.external_id = external_id
-        self.role_session_name = role_session_name
-        self.duration = duration
-        self.source = source
-
-    def __call__(self, boto3: ModuleType) -> ModuleType:
-        # chaining!
-        if self.source:
-            boto3 = self.source(boto3)
-
-        calling_params = {
-            "RoleArn": self.role_arn,
-            "RoleSessionName": self.role_session_name if self.role_session_name else "clearkies-aws",
-            "DurationSeconds": self.duration,
-        }
-        if self.external_id:
-            calling_params['ExternalId'] = self.external_id
-        credentials = boto3.client("sts").assume_role(**calling_params)["Credentials"]
-
-        # now let's make a new session using those
-        return boto3.Session(
-            aws_access_key_id=credentials["AccessKeyId"],
-            aws_secret_access_key=credentials["SecretAccessKey"],
-            aws_session_token=credentials["SessionToken"],
-        )