added terraform-example

Author: ndbroadbent

.github/workflows/terraform-example.yml

@@ -0,0 +1,27 @@
+name: Terraform Example
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  validate:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Setup Terraform
+        uses: hashicorp/setup-terraform@v3
+        with:
+          terraform_version: 1.7.5
+      - name: Terraform Init (example)
+        run: terraform -chdir=terraform-example init -backend=false
+      - name: Terraform Validate (example)
+        run: terraform -chdir=terraform-example validate
+      - name: Setup TFLint
+        uses: terraform-linters/setup-tflint@v4
+      - name: TFLint (core rules only)
+        run: |
+          tflint --init || true
+          tflint -c terraform-example/.tflint.hcl terraform-example

terraform-example/.terraform/modules/modules.json

@@ -0,0 +1 @@
+{ "Modules": [{ "Key": "", "Source": "", "Dir": "." }] }

terraform-example/.tflint.hcl

@@ -0,0 +1,9 @@
+plugin "terraform" {
+  enabled = true
+}
+
+# Keep linting minimal for example; no cloud plugins required
+rule "terraform_unused_declarations" { enabled = true }
+rule "terraform_comment_syntax" { enabled = true }
+rule "terraform_deprecated_index" { enabled = true }
+

terraform-example/main.tf

@@ -0,0 +1,53 @@
+terraform {
+  required_version = ">= 1.3.0"
+  required_providers {
+    logstruct = {
+      source  = "DocSpring/logstruct"
+      version = ">= 0.0.4"
+    }
+    aws = {
+      source  = "hashicorp/aws"
+      version = ">= 5.0"
+    }
+  }
+}
+
+# Validate allowed events for a canonical source
+data "logstruct_source" "mailer" {
+  source = "mailer"
+}
+
+variable "event" {
+  type = string
+  default = "delivered"
+  validation {
+    condition     = contains(keys(data.logstruct_source.mailer.events), var.event)
+    error_message = "Invalid event for source=mailer"
+  }
+}
+
+# Compile exact CloudWatch pattern (optional; module also compiles internally)
+data "logstruct_pattern" "email" {
+  source = "mailer"
+  event  = var.event
+}
+
+# Example module usage: metric filter
+module "email_delivered_metric" {
+  # Use local relative path for CI/demo; switch to Registry in real usage:
+  # source = "DocSpring/logstruct/aws//modules/metric-filter"
+  source         = "../terraform-aws-logstruct/modules/metric-filter"
+
+  name           = "Email Delivered Count"
+  log_group_name = var.log_group_name
+  log_source     = "mailer"
+  log_event      = var.event
+  namespace      = var.namespace
+}
+
+variable "log_group_name" { type = string }
+variable "namespace" { type = string }
+
+output "compiled_pattern" {
+  value = data.logstruct_pattern.email.pattern
+}