v2.6: Add errors.ALL

CHANGELOG.md

@@ -2,6 +2,9 @@
 
 `aws-error-utils` uses [monotonic versioning](blog.appliedcompscilab.com/monotonic_versioning_manifesto/).
 
+## v2.6
+* Add `errors.ALL` to match all `ClientError`s.
+
 ## v2.5
 * Fix type annotations.
 

README.md

@@ -36,6 +36,8 @@ s3 = boto3.client('s3')
 try:
     s3.get_object(Bucket='my-bucket', Key='example')
 except errors.NoSuchBucket as error:
+# or
+# except catch_aws_error('NoSuchBucket') as error:
     print(error.message)
     # error handling
 ```
@@ -115,6 +117,8 @@ except (errors.NoSuchBucket, errors.NoSuchKey) as error:
     # error handling
 ```
 
+You can catch all `ClientError`s with `errors.ALL`.
+
 You can only use this style for error codes that work as Python property names.
 For error codes like EC2's `InvalidInstanceID.NotFound`, you have to use `catch_aws_error()` (see below).
 

aws_error_utils/aws_error_utils.py

@@ -20,7 +20,7 @@
 operation_name = e.operation_name
 """
 
-__version__ = "2.5.0"  # update here and pyproject.toml
+__version__ = "2.6.0"  # update here and pyproject.toml
 
 __all__ = [
     "AWSErrorInfo",
@@ -187,6 +187,8 @@ def __getattr__(self, name) -> Type[BaseException]:
                     self.__name__, name
                 )
             )
+        if name in ["ALL", "ALL_CODES"]:
+            name = ALL_CODES
         return catch_aws_error(name)
 
 

pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "aws-error-utils"
-version = "2.5.0" # update here and aws_error_utils.py
+version = "2.6.0" # update here and aws_error_utils.py
 description = "Error-handling functions for boto3/botocore"
 authors = ["Ben Kehoe"]
 license = "Apache-2.0"

test_aws_error_utils.py

@@ -189,6 +189,22 @@ def test_errors():
     with pytest.raises(RuntimeError):
         errors()
 
+    try:
+        raise error
+    except errors.ALL as e:
+        pass
+    except Exception:
+        assert False
+
+    class OtherError(Exception):
+        pass
+
+    try:
+        raise OtherError("test")
+    except errors.ALL as e:
+        assert False
+    except OtherError:
+        assert True
 
 def test_make_aws_error():
     args = {