aws-radar 0.1.0__tar.gz

aws_radar-0.1.0/CHANGELOG.md

@@ -0,0 +1,11 @@
+# Changelog
+
+## [0.1.0] - 2026-04-20
+### Added
+- `aws-radar inventory` — scan EC2, RDS, Lambda, ECS, EKS, ElastiCache, DynamoDB, S3, OpenSearch, SQS, SNS, ALB
+- `aws-radar diagram` — generate draw.io XML from inventory CSV
+- `aws-radar run` — one-shot inventory + diagram
+- AWS SSO support via `--profile`
+- IAM role assumption via `--role-arn`
+- Multi-region support via `--all-regions`
+- AccountID column in all CSV output

aws_radar-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Your Name
+
+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.

aws_radar-0.1.0/MANIFEST.in

@@ -0,0 +1,5 @@
+include LICENSE
+include README.md
+include CHANGELOG.md
+recursive-include src *.py
+recursive-include tests *.py

aws_radar-0.1.0/PKG-INFO

@@ -0,0 +1,116 @@
+Metadata-Version: 2.4
+Name: aws-radar
+Version: 0.1.0
+Summary: AWS resource inventory scanner and draw.io architecture diagram generator
+Author-email: Your Name <you@example.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/yourname/aws-radar
+Project-URL: Repository, https://github.com/yourname/aws-radar
+Project-URL: Issues, https://github.com/yourname/aws-radar/issues
+Keywords: aws,cloud,inventory,architecture,drawio,diagrams
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: System Administrators
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: System :: Systems Administration
+Classifier: Topic :: Utilities
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: boto3>=1.34.0
+Requires-Dist: rich>=13.0.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest-cov; extra == "dev"
+Requires-Dist: moto[dynamodb,ec2,elbv2,lambda,rds,s3,sns,sqs]>=5.0; extra == "dev"
+Requires-Dist: build; extra == "dev"
+Requires-Dist: twine; extra == "dev"
+Dynamic: license-file
+
+# aws-radar
+
+**AWS resource inventory scanner + draw.io architecture diagram generator.**
+
+Scans your AWS account(s) via SSO or IAM credentials and produces:
+- A CSV inventory of every running resource
+- A `.drawio` file you can open in [diagrams.net](https://app.diagrams.net/) — with AWS icons, region containers, and service connections auto-wired
+
+## Supported services
+
+EC2 · RDS / Aurora · Lambda · ECS · EKS · ElastiCache · DynamoDB · S3 · OpenSearch · SQS · SNS · ALB / NLB
+
+## Installation
+
+```bash
+pip install aws-radar
+```
+
+## Quick start
+
+```bash
+# One-shot: inventory + diagram
+aws-radar run --profile my-sso-profile --all-regions --output architecture.drawio
+
+# Or step by step:
+aws-radar inventory --profile my-sso-profile --all-regions --export inventory.csv
+aws-radar diagram   --input inventory.csv --output architecture.drawio
+```
+
+Then open `architecture.drawio` at [app.diagrams.net](https://app.diagrams.net/).
+
+## AWS SSO usage
+
+```bash
+# Configure SSO once
+aws configure sso
+
+# Login before each session
+aws sso login --profile my-profile
+
+# Run
+aws-radar run --profile my-profile --all-regions
+```
+
+## Multi-account
+
+```bash
+for profile in prod staging dev; do
+  aws sso login --profile $profile
+  aws-radar run --profile $profile --csv ${profile}.csv --output ${profile}.drawio
+done
+```
+
+## Python API
+
+```python
+import boto3
+from aws_radar.inventory import run_inventory
+from aws_radar.drawio import build_drawio
+
+session = boto3.Session(profile_name="my-profile")
+rows = run_inventory(["us-east-1", "eu-west-1"], session, account_id="123456789012")
+
+mxfile = build_drawio(rows, account_id="123456789012")
+```
+
+## Required IAM permissions
+
+Attach the AWS-managed **`ReadOnlyAccess`** policy, or grant these specific actions:
+
+```
+ec2:Describe* · rds:Describe* · lambda:ListFunctions
+ecs:List*/Describe* · eks:List*/Describe*
+elasticache:Describe* · dynamodb:ListTables/DescribeTable
+s3:ListAllMyBuckets · opensearch:List*/Describe*
+sqs:ListQueues · sns:ListTopics
+elasticloadbalancing:DescribeLoadBalancers
+sts:GetCallerIdentity
+```
+
+## License
+
+MIT

aws_radar-0.1.0/README.md

@@ -0,0 +1,83 @@
+# aws-radar
+
+**AWS resource inventory scanner + draw.io architecture diagram generator.**
+
+Scans your AWS account(s) via SSO or IAM credentials and produces:
+- A CSV inventory of every running resource
+- A `.drawio` file you can open in [diagrams.net](https://app.diagrams.net/) — with AWS icons, region containers, and service connections auto-wired
+
+## Supported services
+
+EC2 · RDS / Aurora · Lambda · ECS · EKS · ElastiCache · DynamoDB · S3 · OpenSearch · SQS · SNS · ALB / NLB
+
+## Installation
+
+```bash
+pip install aws-radar
+```
+
+## Quick start
+
+```bash
+# One-shot: inventory + diagram
+aws-radar run --profile my-sso-profile --all-regions --output architecture.drawio
+
+# Or step by step:
+aws-radar inventory --profile my-sso-profile --all-regions --export inventory.csv
+aws-radar diagram   --input inventory.csv --output architecture.drawio
+```
+
+Then open `architecture.drawio` at [app.diagrams.net](https://app.diagrams.net/).
+
+## AWS SSO usage
+
+```bash
+# Configure SSO once
+aws configure sso
+
+# Login before each session
+aws sso login --profile my-profile
+
+# Run
+aws-radar run --profile my-profile --all-regions
+```
+
+## Multi-account
+
+```bash
+for profile in prod staging dev; do
+  aws sso login --profile $profile
+  aws-radar run --profile $profile --csv ${profile}.csv --output ${profile}.drawio
+done
+```
+
+## Python API
+
+```python
+import boto3
+from aws_radar.inventory import run_inventory
+from aws_radar.drawio import build_drawio
+
+session = boto3.Session(profile_name="my-profile")
+rows = run_inventory(["us-east-1", "eu-west-1"], session, account_id="123456789012")
+
+mxfile = build_drawio(rows, account_id="123456789012")
+```
+
+## Required IAM permissions
+
+Attach the AWS-managed **`ReadOnlyAccess`** policy, or grant these specific actions:
+
+```
+ec2:Describe* · rds:Describe* · lambda:ListFunctions
+ecs:List*/Describe* · eks:List*/Describe*
+elasticache:Describe* · dynamodb:ListTables/DescribeTable
+s3:ListAllMyBuckets · opensearch:List*/Describe*
+sqs:ListQueues · sns:ListTopics
+elasticloadbalancing:DescribeLoadBalancers
+sts:GetCallerIdentity
+```
+
+## License
+
+MIT

aws_radar-0.1.0/pyproject.toml

@@ -0,0 +1,62 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "aws-radar"
+version = "0.1.0"
+description = "AWS resource inventory scanner and draw.io architecture diagram generator"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.9"
+authors = [
+  { name = "Your Name", email = "you@example.com" }
+]
+keywords = ["aws", "cloud", "inventory", "architecture", "drawio", "diagrams"]
+classifiers = [
+  "Development Status :: 3 - Alpha",
+  "Intended Audience :: Developers",
+  "Intended Audience :: System Administrators",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.9",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Topic :: System :: Systems Administration",
+  "Topic :: Utilities",
+]
+dependencies = [
+  "boto3>=1.34.0",
+  "rich>=13.0.0",
+]
+
+[project.optional-dependencies]
+dev = [
+  "pytest>=7.0",
+  "pytest-cov",
+  "moto[ec2,rds,lambda,s3,dynamodb,sqs,sns,elbv2]>=5.0",
+  "build",
+  "twine",
+]
+
+[project.urls]
+Homepage   = "https://github.com/yourname/aws-radar"
+Repository = "https://github.com/yourname/aws-radar"
+Issues     = "https://github.com/yourname/aws-radar/issues"
+
+[project.scripts]
+aws-radar = "aws_radar.__main__:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-dir]
+"" = "src"
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+addopts   = "-v --tb=short"
+
+[tool.coverage.run]
+source = ["aws_radar"]
+omit   = ["tests/*"]

aws_radar-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

aws_radar-0.1.0/src/aws_radar/__init__.py

@@ -0,0 +1,10 @@
+"""
+aws-radar — AWS resource inventory & draw.io architecture diagram generator.
+
+Quick start:
+    from aws_radar.inventory import run_inventory
+    from aws_radar.drawio import build_drawio
+"""
+
+__version__ = "0.1.0"
+__author__ = "Your Name"

aws_radar-0.1.0/src/aws_radar/__main__.py

@@ -0,0 +1,92 @@
+"""
+Entry point for:
+    python -m aws_radar
+    aws-radar      (after pip install)
+"""
+
+import argparse
+import sys
+
+
+def main():
+    parser = argparse.ArgumentParser(
+        prog="aws-radar",
+        description="AWS resource inventory & draw.io architecture diagram generator",
+    )
+    sub = parser.add_subparsers(dest="command", required=True)
+
+    # ── inventory sub-command ──
+    inv = sub.add_parser("inventory", help="Scan AWS account and list all resources")
+    inv.add_argument("--region",      default=None,  help="AWS region (default: boto3 default)")
+    inv.add_argument("--profile",     default=None,  help="AWS SSO/named profile")
+    inv.add_argument("--role-arn",    default=None,  help="IAM role ARN to assume")
+    inv.add_argument("--all-regions", action="store_true", help="Scan all enabled regions")
+    inv.add_argument("--export",      metavar="FILE.csv", help="Export results to CSV")
+
+    # ── diagram sub-command ──
+    dia = sub.add_parser("diagram", help="Generate draw.io diagram from inventory CSV")
+    dia.add_argument("--input",  required=True,          help="CSV produced by 'inventory'")
+    dia.add_argument("--output", default="architecture.drawio", help="Output .drawio file")
+
+    # ── all-in-one sub-command ──
+    run = sub.add_parser("run", help="Inventory + diagram in one shot")
+    run.add_argument("--region",      default=None)
+    run.add_argument("--profile",     default=None)
+    run.add_argument("--role-arn",    default=None)
+    run.add_argument("--all-regions", action="store_true")
+    run.add_argument("--csv",    default="inventory.csv",      help="Intermediate CSV path")
+    run.add_argument("--output", default="architecture.drawio", help="Output .drawio file")
+
+    args = parser.parse_args()
+
+    if args.command == "inventory":
+        from aws_radar.inventory import main as inv_main
+        sys.argv = _rebuild_argv("inventory", args)
+        inv_main()
+
+    elif args.command == "diagram":
+        from aws_radar.drawio import main as dia_main
+        sys.argv = _rebuild_argv("diagram", args)
+        dia_main()
+
+    elif args.command == "run":
+        import csv as _csv
+        from aws_radar.inventory import main as inv_main
+        from aws_radar.drawio import main as dia_main
+
+        # Step 1 — inventory
+        print("── Step 1/2: Running inventory ──")
+        inv_args = ["aws-radar"]
+        if args.profile:     inv_args += ["--profile", args.profile]
+        if args.role_arn:    inv_args += ["--role-arn", args.role_arn]
+        if args.region:      inv_args += ["--region", args.region]
+        if args.all_regions: inv_args += ["--all-regions"]
+        inv_args += ["--export", args.csv]
+        sys.argv = inv_args
+        inv_main()
+
+        # Step 2 — diagram
+        print("\n── Step 2/2: Generating diagram ──")
+        sys.argv = ["aws-radar", "--input", args.csv, "--output", args.output]
+        dia_main()
+
+        print(f"\n✓ Done! Open {args.output} at https://app.diagrams.net/")
+
+
+def _rebuild_argv(cmd, args):
+    argv = ["aws-radar"]
+    d = vars(args)
+    for k, v in d.items():
+        if k == "command":
+            continue
+        flag = "--" + k.replace("_", "-")
+        if isinstance(v, bool):
+            if v:
+                argv.append(flag)
+        elif v is not None:
+            argv += [flag, str(v)]
+    return argv
+
+
+if __name__ == "__main__":
+    main()