arnmatch 2026.2.1__tar.gz → 2026.2.2__tar.gz

{arnmatch-2026.2.1 → arnmatch-2026.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: arnmatch
-Version: 2026.2.1
+Version: 2026.2.2
 Summary: Parse AWS ARNs into structured data (2000+ resource types)
 Author-email: Andrey Gubarev <andrey@andreygubarev.com>
 License-Expression: Apache-2.0
@@ -78,6 +78,10 @@ result.resource_id            # "my-function"
 result.resource_name          # "my-function"
 result.cloudformation_resource  # "AWS::Lambda::Function"
 result.aws_sdk_service        # "lambda"
+
+# Get a boto3 client for the service
+client = result.client()
+client.get_function(FunctionName=result.resource_name)
 ```
 
 ## API Reference
@@ -112,6 +116,12 @@ Properties:
 | `resource_name` | Resource name (prefers attributes ending in `Name`, falls back to `resource_id`) |
 | `aws_sdk_services` | List of boto3 client names (e.g., `['elb', 'elbv2']` for elasticloadbalancing) |
 
+Methods:
+
+| Method | Description |
+|--------|-------------|
+| `client(session=None)` | Returns a boto3 client for the resource's service. Pass an optional `boto3.Session` or uses default. Raises `ValueError` if no SDK mapping exists. |
+
 ### `ARNError`
 
 Exception raised when ARN parsing fails. Inherits from `ValueError`.

{arnmatch-2026.2.1 → arnmatch-2026.2.2}/README.md

@@ -68,6 +68,10 @@ result.resource_id            # "my-function"
 result.resource_name          # "my-function"
 result.cloudformation_resource  # "AWS::Lambda::Function"
 result.aws_sdk_service        # "lambda"
+
+# Get a boto3 client for the service
+client = result.client()
+client.get_function(FunctionName=result.resource_name)
 ```
 
 ## API Reference
@@ -102,6 +106,12 @@ Properties:
 | `resource_name` | Resource name (prefers attributes ending in `Name`, falls back to `resource_id`) |
 | `aws_sdk_services` | List of boto3 client names (e.g., `['elb', 'elbv2']` for elasticloadbalancing) |
 
+Methods:
+
+| Method | Description |
+|--------|-------------|
+| `client(session=None)` | Returns a boto3 client for the resource's service. Pass an optional `boto3.Session` or uses default. Raises `ValueError` if no SDK mapping exists. |
+
 ### `ARNError`
 
 Exception raised when ARN parsing fails. Inherits from `ValueError`.

{arnmatch-2026.2.1 → arnmatch-2026.2.2}/pyproject.toml

@@ -22,6 +22,7 @@ path = "src/arnmatch/__init__.py"
 
 [dependency-groups]
 dev = [
+    "boto3>=1.42.41",
     "pytest>=9.0.2",
     "ruff>=0.14.14",
 ]

{arnmatch-2026.2.1 → arnmatch-2026.2.2}/src/arnmatch/__init__.py

@@ -1,6 +1,6 @@
 """ARN pattern matching using regex patterns."""
 
-__version__ = "2026.2.1"
+__version__ = "2026.2.2"
 
 import sys
 from dataclasses import dataclass
@@ -90,6 +90,28 @@ class ARN:
         """
         return AWS_SDK_SERVICES.get(self.aws_service, [])
 
+    def client(self, session: "boto3.Session | None" = None):  # noqa: F821
+        """Return a boto3 client for this resource's service.
+
+        Args:
+            session: Optional boto3 Session. If None, creates a new session.
+
+        Returns:
+            boto3 client for the service.
+
+        Raises:
+            ValueError: If no SDK service mapping exists for this ARN's service.
+        """
+        if self.aws_sdk_service is None:
+            raise ValueError(f"No SDK service mapping for service '{self.aws_service}'")
+
+        import boto3
+
+        if session is None:
+            session = boto3.Session()
+
+        return session.client(self.aws_sdk_service)
+
 
 def arnmatch(arn: str) -> ARN:
     """Match ARN against patterns.

{arnmatch-2026.2.1 → arnmatch-2026.2.2}/tests/test_arnmatch.py

@@ -1,5 +1,8 @@
 """Tests for ARN pattern matching."""
 
+import boto3
+import pytest
+
 from arnmatch import arnmatch
 
 
@@ -452,3 +455,30 @@ def test_wafv2():
     assert result.attributes["Scope"] == "regional"
     assert result.attributes["Name"] == "webacl-production-acl"
     assert result.attributes["Id"] == "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee"
+
+
+class TestClient:
+    """Tests for ARN.client() method."""
+
+    def test_client_returns_correct_service(self):
+        """Test client() returns a client for the correct service."""
+        result = arnmatch(
+            "arn:aws:lambda:us-east-1:012345678901:function:my-function"
+        )
+        client = result.client()
+        assert client.meta.service_model.service_name == "lambda"
+
+    def test_client_uses_provided_session(self):
+        """Test client() uses the provided session."""
+        session = boto3.Session()
+        result = arnmatch("arn:aws:s3:::my-bucket")
+        client = result.client(session=session)
+        assert client.meta.service_model.service_name == "s3"
+
+    def test_client_raises_when_no_sdk_mapping(self):
+        """Test client() raises ValueError when no SDK service mapping exists."""
+        # 'a4b' (Alexa for Business) has no SDK mapping
+        result = arnmatch("arn:aws:a4b:us-east-1:012345678901:address-book/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee")
+
+        with pytest.raises(ValueError, match="No SDK service mapping"):
+            result.client()

{arnmatch-2026.2.1 → arnmatch-2026.2.2}/uv.lock

@@ -8,6 +8,7 @@ source = { editable = "." }
 
 [package.dev-dependencies]
 dev = [
+    { name = "boto3" },
     { name = "pytest" },
     { name = "ruff" },
 ]
@@ -16,10 +17,39 @@ dev = [
 
 [package.metadata.requires-dev]
 dev = [
+    { name = "boto3", specifier = ">=1.42.41" },
     { name = "pytest", specifier = ">=9.0.2" },
     { name = "ruff", specifier = ">=0.14.14" },
 ]
 
+[[package]]
+name = "boto3"
+version = "1.42.41"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "botocore" },
+    { name = "jmespath" },
+    { name = "s3transfer" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/85/b0/f2a371146877b4d60cd2a6f51c440503cbf77a73c85347ad282eebe90269/boto3-1.42.41.tar.gz", hash = "sha256:86dd2bc577e33da5cd9f10e21b22cdda01a24f83f31ca1bb5ac1f5f8b8e9e67e", size = 112806, upload-time = "2026-02-03T20:38:58.004Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/7b/e8/e671b9aed3e8f6bb5f85aed7fd9dd4e79074798b2a14391fab6b6da04ff7/boto3-1.42.41-py3-none-any.whl", hash = "sha256:32470b1d32208e03b47cf6ce4a7adb337b8a1730aaefb97c336cfd4e2be2577f", size = 140602, upload-time = "2026-02-03T20:38:56.352Z" },
+]
+
+[[package]]
+name = "botocore"
+version = "1.42.41"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "jmespath" },
+    { name = "python-dateutil" },
+    { name = "urllib3" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/27/1d/5fd43319250a5a484bcbde334da2e2297956cdae40de8eb0808759538a7c/botocore-1.42.41.tar.gz", hash = "sha256:0698967741d873d819134bea1ffe9c35decc00c741f49a42885dbd7ad8198fbc", size = 14923189, upload-time = "2026-02-03T20:38:47.957Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/e4/84/df765c7942f52eab12540ef1880b9489d45b364b777fad522fa84435ed11/botocore-1.42.41-py3-none-any.whl", hash = "sha256:567530f7d4da668af891c1259fb80c01578ab8d9f1098127cc250451a46fb54f", size = 14597792, upload-time = "2026-02-03T20:38:45.058Z" },
+]
+
 [[package]]
 name = "colorama"
 version = "0.4.6"
@@ -50,6 +80,15 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/cb/b1/3846dd7f199d53cb17f49cba7e651e9ce294d8497c8c150530ed11865bb8/iniconfig-2.3.0-py3-none-any.whl", hash = "sha256:f631c04d2c48c52b84d0d0549c99ff3859c98df65b3101406327ecc7d53fbf12", size = 7484, upload-time = "2025-10-18T21:55:41.639Z" },
 ]
 
+[[package]]
+name = "jmespath"
+version = "1.1.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/d3/59/322338183ecda247fb5d1763a6cbe46eff7222eaeebafd9fa65d4bf5cb11/jmespath-1.1.0.tar.gz", hash = "sha256:472c87d80f36026ae83c6ddd0f1d05d4e510134ed462851fd5f754c8c3cbb88d", size = 27377, upload-time = "2026-01-22T16:35:26.279Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/14/2f/967ba146e6d58cf6a652da73885f52fc68001525b4197effc174321d70b4/jmespath-1.1.0-py3-none-any.whl", hash = "sha256:a5663118de4908c91729bea0acadca56526eb2698e83de10cd116ae0f4e97c64", size = 20419, upload-time = "2026-01-22T16:35:24.919Z" },
+]
+
 [[package]]
 name = "packaging"
 version = "26.0"
@@ -95,6 +134,18 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/3b/ab/b3226f0bd7cdcf710fbede2b3548584366da3b19b5021e74f5bde2a8fa3f/pytest-9.0.2-py3-none-any.whl", hash = "sha256:711ffd45bf766d5264d487b917733b453d917afd2b0ad65223959f59089f875b", size = 374801, upload-time = "2025-12-06T21:30:49.154Z" },
 ]
 
+[[package]]
+name = "python-dateutil"
+version = "2.9.0.post0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "six" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/66/c0/0c8b6ad9f17a802ee498c46e004a0eb49bc148f2fd230864601a86dcf6db/python-dateutil-2.9.0.post0.tar.gz", hash = "sha256:37dd54208da7e1cd875388217d5e00ebd4179249f90fb72437e91a35459a0ad3", size = 342432, upload-time = "2024-03-01T18:36:20.211Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/ec/57/56b9bcc3c9c6a792fcbaf139543cee77261f3651ca9da0c93f5c1221264b/python_dateutil-2.9.0.post0-py2.py3-none-any.whl", hash = "sha256:a8b2bc7bffae282281c8140a97d3aa9c14da0b136dfe83f850eea9a5f7470427", size = 229892, upload-time = "2024-03-01T18:36:18.57Z" },
+]
+
 [[package]]
 name = "ruff"
 version = "0.14.14"
@@ -121,6 +172,27 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/9e/6a/40fee331a52339926a92e17ae748827270b288a35ef4a15c9c8f2ec54715/ruff-0.14.14-py3-none-win_arm64.whl", hash = "sha256:56e6981a98b13a32236a72a8da421d7839221fa308b223b9283312312e5ac76c", size = 10920448, upload-time = "2026-01-22T22:30:15.417Z" },
 ]
 
+[[package]]
+name = "s3transfer"
+version = "0.16.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "botocore" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/05/04/74127fc843314818edfa81b5540e26dd537353b123a4edc563109d8f17dd/s3transfer-0.16.0.tar.gz", hash = "sha256:8e990f13268025792229cd52fa10cb7163744bf56e719e0b9cb925ab79abf920", size = 153827, upload-time = "2025-12-01T02:30:59.114Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/fc/51/727abb13f44c1fcf6d145979e1535a35794db0f6e450a0cb46aa24732fe2/s3transfer-0.16.0-py3-none-any.whl", hash = "sha256:18e25d66fed509e3868dc1572b3f427ff947dd2c56f844a5bf09481ad3f3b2fe", size = 86830, upload-time = "2025-12-01T02:30:57.729Z" },
+]
+
+[[package]]
+name = "six"
+version = "1.17.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/94/e7/b2c673351809dca68a0e064b6af791aa332cf192da575fd474ed7d6f16a2/six-1.17.0.tar.gz", hash = "sha256:ff70335d468e7eb6ec65b95b99d3a2836546063f63acc5171de367e834932a81", size = 34031, upload-time = "2024-12-04T17:35:28.174Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/b7/ce/149a00dd41f10bc29e5921b496af8b574d8413afcd5e30dfa0ed46c2cc5e/six-1.17.0-py2.py3-none-any.whl", hash = "sha256:4721f391ed90541fddacab5acf947aa0d3dc7d27b2e1e8eda2be8970586c3274", size = 11050, upload-time = "2024-12-04T17:35:26.475Z" },
+]
+
 [[package]]
 name = "tomli"
 version = "2.4.0"
@@ -183,3 +255,12 @@ sdist = { url = "https://files.pythonhosted.org/packages/72/94/1a15dd82efb362ac8
 wheels = [
     { url = "https://files.pythonhosted.org/packages/18/67/36e9267722cc04a6b9f15c7f3441c2363321a3ea07da7ae0c0707beb2a9c/typing_extensions-4.15.0-py3-none-any.whl", hash = "sha256:f0fa19c6845758ab08074a0cfa8b7aecb71c999ca73d62883bc25cc018c4e548", size = 44614, upload-time = "2025-08-25T13:49:24.86Z" },
 ]
+
+[[package]]
+name = "urllib3"
+version = "2.6.3"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/c7/24/5f1b3bdffd70275f6661c76461e25f024d5a38a46f04aaca912426a2b1d3/urllib3-2.6.3.tar.gz", hash = "sha256:1b62b6884944a57dbe321509ab94fd4d3b307075e0c2eae991ac71ee15ad38ed", size = 435556, upload-time = "2026-01-07T16:24:43.925Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/39/08/aaaad47bc4e9dc8c725e68f9d04865dbcb2052843ff09c97b08904852d84/urllib3-2.6.3-py3-none-any.whl", hash = "sha256:bf272323e553dfb2e87d9bfd225ca7b0f467b919d7bbd355436d3fd37cb0acd4", size = 131584, upload-time = "2026-01-07T16:24:42.685Z" },
+]