arnmatch 0.1.0__py3-none-any.whl → 0.3.1__py3-none-any.whl

arnmatch/__init__.py

@@ -1,6 +1,6 @@
 """ARN pattern matching using regex patterns."""
 
-__version__ = "0.1.0"
+__version__ = "0.3.1"
 
 import sys
 from dataclasses import dataclass
@@ -12,23 +12,23 @@ from .arn_patterns import ARN_PATTERNS
 STANDARD_GROUPS = {"Partition", "Region", "Account"}
 
 
-class ARNMatchError(ValueError):
-    """Raised when ARN cannot be matched."""
+class ARNError(ValueError):
+    """Raised when ARN cannot be parsed or matched."""
 
     pass
 
 
 @dataclass(frozen=True)
-class ARNMatch:
-    """Result of matching an ARN against patterns."""
+class ARN:
+    """Parsed ARN with structured data and captured groups."""
 
-    partition: str
-    service: str
-    region: str
-    account: str
+    aws_partition: str
+    aws_service: str
+    aws_region: str
+    aws_account: str
     resource_type: str  # canonical type (from AWS docs)
-    resource_type_aliases: list[str]  # all known names including Resource Explorer
-    groups: dict[str, str]
+    resource_types: list[str]  # all known names including Resource Explorer
+    attributes: dict[str, str]
 
     @cached_property
     def resource_id(self) -> str:
@@ -39,7 +39,7 @@ class ARNMatch:
         2. Group ending with 'Name' as fallback
         3. Last non-standard group
         """
-        resource_groups = list(self.groups.items())
+        resource_groups = list(self.attributes.items())
         resource_groups = [(k, v) for k, v in resource_groups if k not in STANDARD_GROUPS]
 
         # Look for *Id (from end)
@@ -66,7 +66,7 @@ class ARNMatch:
         1. Group ending with 'Name' (FunctionName, BucketName, StackName)
         2. Falls back to resource_id
         """
-        resource_groups = list(self.groups.items())
+        resource_groups = list(self.attributes.items())
         resource_groups = [(k, v) for k, v in resource_groups if k not in STANDARD_GROUPS]
 
         # Look for *Name (from end)
@@ -78,7 +78,7 @@ class ARNMatch:
         return self.resource_id
 
 
-def arnmatch(arn: str) -> ARNMatch:
+def arnmatch(arn: str) -> ARN:
     """Match ARN against patterns.
 
     Returns ARNMatch with all captured groups.
@@ -88,27 +88,27 @@ def arnmatch(arn: str) -> ARNMatch:
     """
     parts = arn.split(":", 5)
     if len(parts) != 6 or parts[0] != "arn":
-        raise ARNMatchError(f"Invalid ARN format: {arn}")
+        raise ARNError(f"Invalid ARN format: {arn}")
 
     _, partition, service, region, account, _ = parts
 
     if service not in ARN_PATTERNS:
-        raise ARNMatchError(f"Unknown service: {service}")
+        raise ARNError(f"Unknown service: {service}")
 
     for regex, type_names in ARN_PATTERNS[service]:
         match = regex.match(arn)
         if match:
-            return ARNMatch(
-                partition=partition,
-                service=service,
-                region=region,
-                account=account,
+            return ARN(
+                aws_partition=partition,
+                aws_service=service,
+                aws_region=region,
+                aws_account=account,
                 resource_type=type_names[0],  # canonical
-                resource_type_aliases=type_names,  # all known names
-                groups=match.groupdict(),
+                resource_types=type_names,  # all known names
+                attributes=match.groupdict(),
             )
 
-    raise ARNMatchError(f"No pattern matched ARN: {arn}")
+    raise ARNError(f"No pattern matched ARN: {arn}")
 
 
 def main() -> None:
@@ -120,12 +120,12 @@ def main() -> None:
     arn = sys.argv[1]
     try:
         result = arnmatch(arn)
-        print(f"service: {result.service}")
-        print(f"region: {result.region}")
-        print(f"account: {result.account}")
+        print(f"aws_service: {result.aws_service}")
+        print(f"aws_region: {result.aws_region}")
+        print(f"aws_account: {result.aws_account}")
         print(f"resource_type: {result.resource_type}")
         print(f"resource_id: {result.resource_id}")
         print(f"resource_name: {result.resource_name}")
-    except ARNMatchError as e:
+    except ARNError as e:
         print(f"Error: {e}", file=sys.stderr)
         sys.exit(1)

arnmatch-0.3.1.dist-info/METADATA

@@ -0,0 +1,108 @@
+Metadata-Version: 2.4
+Name: arnmatch
+Version: 0.3.1
+Summary: Parse AWS ARNs into structured data
+Author-email: Andrey Gubarev <andrey@andreygubarev.com>
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+
+# arnmatch
+
+Parse AWS ARNs into structured data.
+
+![Python 3.10+](https://img.shields.io/badge/python-3.10%2B-blue)
+
+## Features
+
+- Zero runtime dependencies
+- 300+ AWS services, 2000+ resource types supported
+- Patterns auto-generated from AWS official documentation
+- CLI and library interface
+- Extracts resource type, ID, and name with smart heuristics
+
+## Installation
+
+```bash
+pip install arnmatch
+```
+
+## Quick Start
+
+### CLI
+
+```bash
+$ uvx arnmatch "arn:aws:lambda:us-east-1:123456789012:function:my-function"
+aws_service: lambda
+aws_region: us-east-1
+aws_account: 123456789012
+resource_type: function
+resource_id: my-function
+resource_name: my-function
+```
+
+### Library
+
+```python
+from arnmatch import arnmatch
+
+arn = "arn:aws:lambda:us-east-1:123456789012:function:my-function"
+result = arnmatch(arn)
+
+print(result.aws_service)    # lambda
+print(result.aws_region)     # us-east-1
+print(result.aws_account)    # 123456789012
+print(result.resource_type)  # function
+print(result.resource_id)    # my-function
+print(result.resource_name)  # my-function
+print(result.attributes)     # {'Partition': 'aws', 'Region': 'us-east-1', ...}
+```
+
+## API Reference
+
+### `arnmatch(arn: str) -> ARN`
+
+Parse an ARN string and return structured data.
+
+Raises `ARNError` if the ARN format is invalid or no pattern matches.
+
+### `ARN`
+
+Dataclass with parsed ARN components:
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `aws_partition` | `str` | AWS partition (aws, aws-cn, aws-us-gov) |
+| `aws_service` | `str` | AWS service name |
+| `aws_region` | `str` | AWS region (may be empty for global resources) |
+| `aws_account` | `str` | AWS account ID |
+| `resource_type` | `str` | Canonical resource type from AWS docs |
+| `resource_types` | `list[str]` | All known names for this resource type |
+| `attributes` | `dict[str, str]` | All captured attributes from the pattern |
+
+Properties:
+
+| Property | Description |
+|----------|-------------|
+| `resource_id` | Resource identifier (prefers groups ending in `Id`, falls back to `Name`, then last group) |
+| `resource_name` | Resource name (prefers groups ending in `Name`, falls back to `resource_id`) |
+
+### `ARNError`
+
+Exception raised when ARN parsing fails. Inherits from `ValueError`.
+
+## Development
+
+Prerequisites: [uv](https://github.com/astral-sh/uv)
+
+```bash
+make lint       # Run ruff linter
+make build      # Build wheel and tarball
+make publish    # Build and upload to PyPI
+make clean      # Remove build artifacts
+```
+
+Regenerate patterns from AWS docs:
+
+```bash
+cd codegen && uv run codegen.py
+```

arnmatch-0.3.1.dist-info/RECORD

@@ -0,0 +1,6 @@
+arnmatch/__init__.py,sha256=0wjjGQPi3iz4yhfQOyuPPECSEIwTY7dbVDIJE-EANSU,3926
+arnmatch/arn_patterns.py,sha256=_1ZzNbqTrHWrdMMQAvpu78cdrNmsLaFSpae3auPA7cI,351568
+arnmatch-0.3.1.dist-info/METADATA,sha256=G-8engLIim1QdU1uw45dxATlFOIuT-Y3iAPZpjyIPdY,2790
+arnmatch-0.3.1.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+arnmatch-0.3.1.dist-info/entry_points.txt,sha256=k4tR_yh3Rodi-BfwVhc_6TktgYhE7BfMy6s0Zzq6EFk,43
+arnmatch-0.3.1.dist-info/RECORD,,

arnmatch-0.1.0.dist-info/METADATA

@@ -1,6 +0,0 @@
-Metadata-Version: 2.4
-Name: arnmatch
-Version: 0.1.0
-Summary: AWS ARN Matcher - parses and returns information about AWS ARNs
-Author-email: Andrey Gubarev <andrey@andreygubarev.com>
-Requires-Python: >=3.10

arnmatch-0.1.0.dist-info/RECORD

@@ -1,6 +0,0 @@
-arnmatch/__init__.py,sha256=9vV1dvwFOBkDktGOpwqeGR1Ele4IcEC246jbZEykL2Y,3889
-arnmatch/arn_patterns.py,sha256=_1ZzNbqTrHWrdMMQAvpu78cdrNmsLaFSpae3auPA7cI,351568
-arnmatch-0.1.0.dist-info/METADATA,sha256=-yenV5wvn8MVv7OXaSlQCo1wjDSfRAKCkQdgpAo88Kg,205
-arnmatch-0.1.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-arnmatch-0.1.0.dist-info/entry_points.txt,sha256=k4tR_yh3Rodi-BfwVhc_6TktgYhE7BfMy6s0Zzq6EFk,43
-arnmatch-0.1.0.dist-info/RECORD,,