From 7b91a1bbc6427eee6652c7c102debd4eeebdd003 Mon Sep 17 00:00:00 2001
From: Muhammad Atif Ali <me@matifali.dev>
Date: Fri, 22 Sep 2023 18:01:19 +0300
Subject: [PATCH] add a template module and boilerplate

---
 .sample/README.md |  65 +++++++++++++++++++++++++++++
 .sample/main.tf   | 101 ++++++++++++++++++++++++++++++++++++++++++++++
 .sample/run.sh    |  17 ++++++++
 new.sh            |  28 +++++++++++++
 4 files changed, 211 insertions(+)
 create mode 100644 .sample/README.md
 create mode 100644 .sample/main.tf
 create mode 100644 .sample/run.sh

diff --git a/.sample/README.md b/.sample/README.md
new file mode 100644
index 0000000..638a162
--- /dev/null
+++ b/.sample/README.md
@@ -0,0 +1,65 @@
+---
+display_name: MODULE_NAME
+description: Describe what this module does
+icon: ../.icons/<A_RELEVANT_ICON>.svg
+maintainer_github: GITHUB_USERNAME
+verified: false
+tags: [community]
+---
+
+# MODULE_NAME
+
+<-- Describes what this module does -->
+
+```hcl
+module "MODULE_NAME" {
+    source = "https://registry.coder.com/modules/MODULE_NAME"
+}
+```
+
+<-- Add a screencast or screenshot here -->
+
+## Examples
+
+### Example 1
+
+Install the Dracula theme from [OpenVSX](https://open-vsx.org/):
+
+```hcl
+module "MODULE_NAME" {
+    source = "https://registry.coder.com/modules/MODULE_NAME"
+    agent_id = coder_agent.example.id
+    extensions = [
+        "dracula-theme.theme-dracula"
+    ]
+}
+```
+
+Enter the `<author>.<name>` into the extensions array and code-server will automatically install on start.
+
+### Example 2
+
+Configure VS Code's [settings.json](https://code.visualstudio.com/docs/getstarted/settings#_settingsjson) file:
+
+```hcl
+module "MODULE_NAME" {
+    source = "https://registry.coder.com/modules/MODULE_NAME"
+    agent_id = coder_agent.example.id
+    extensions = [ "dracula-theme.theme-dracula" ]
+    settings = {
+        "workbench.colorTheme" = "Dracula"
+    }
+}
+```
+
+### Example 3
+
+Just run code-server in the background, don't fetch it from GitHub:
+
+```hcl
+module "MODULE_NAME" {
+    source = "https://registry.coder.com/modules/MODULE_NAME"
+    agent_id = coder_agent.example.id
+    offline = true
+}
+```
diff --git a/.sample/main.tf b/.sample/main.tf
new file mode 100644
index 0000000..5dcaf01
--- /dev/null
+++ b/.sample/main.tf
@@ -0,0 +1,101 @@
+terraform {
+  required_version = ">= 1.0"
+
+  required_providers {
+    coder = {
+      source  = "coder/coder"
+      version = ">= 0.12"
+    }
+  }
+}
+
+locals {
+  # A built-in icon like "/icon/code.svg" or a full URL of icon
+  icon_url = "https://raw.githubusercontent.com/coder/coder/main/site/static/icon/code.svg"
+  # a map of all possible values
+  options = {
+    "Option 1" = {
+      "name"  = "Option 1",
+      "value" = "1"
+      "icon"  = "/emojis/1.png"
+    }
+    "Option 2" = {
+      "name"  = "Option 2",
+      "value" = "2"
+      "icon"  = "/emojis/2.png"
+    }
+  }
+}
+
+# Add required variables for your modules and remove any unneeded variables
+variable "agent_id" {
+  type        = string
+  description = "The ID of a Coder agent."
+}
+
+variable "log_path" {
+  type        = string
+  description = "The path to log MODULE_NAME to."
+  default     = "/tmp/MODULE_NAME.log"
+}
+
+variable "port" {
+  type        = number
+  description = "The port to run MODULE_NAME on."
+  default     = 19999
+}
+
+variable "mutable" {
+  type        = bool
+  description = "Whether the parameter is mutable."
+  default     = true
+}
+# Add other variables here
+
+
+resource "coder_script" "MODULE_NAME" {
+  agent_id     = var.agent_id
+  display_name = "MODULE_NAME"
+  icon         = local.icon_url
+  script = templatefile("${path.module}/run.sh", {
+    LOG_PATH : var.log_path,
+  })
+  run_on_start = true
+  run_on_stopt = false
+}
+
+resource "coder_app" "MODULE_NAME" {
+  agent_id     = var.agent_id
+  slug         = "MODULE_NAME"
+  display_name = "MODULE_NAME"
+  url          = "http://localhost:${var.port}"
+  icon         = loocal.icon_url
+  subdomain    = false
+  share        = "owner"
+
+  # Remove if the app does not have a healthcheck endpoint
+  healthcheck {
+    url       = "http://localhost:${var.port}/healthz"
+    interval  = 5
+    threshold = 6
+  }
+}
+
+data "coder_parameter" "MODULE_NAME" {
+  type         = "list(string)"
+  name         = "MODULE_NAME"
+  display_name = "MODULE_NAME"
+  icon         = local.icon_url
+  mutable      = var.mutable
+  default      = local.options["Option 1"]["value"]
+
+  dynamic "option" {
+    for_each = local.options
+    content {
+      icon  = option.value.icon
+      name  = option.value.name
+      value = option.value.value
+    }
+  }
+}
+
diff --git a/.sample/run.sh b/.sample/run.sh
new file mode 100644
index 0000000..88af7ad
--- /dev/null
+++ b/.sample/run.sh
@@ -0,0 +1,17 @@
+#!/usr/bin/env sh
+
+echo "Instalalting ${MODULE_NAME}..."
+# Add code here
+# Use varibles from the templatefile function in main.tf
+# e.g. LOG_PATH, PORT, etc.
+
+echo "Installation comlete!"
+
+echo "Starting ${MODULE_NAME}..."
+# Start the app in here
+# 1. Use & to run it in background
+# 2. redirct stdout and stderr to log files
+
+./app >${LOG_PATH} 2>&1 &
+
+echo "Sample app started!"
diff --git a/new.sh b/new.sh
index 0617957..2a3e3fb 100644
--- a/new.sh
+++ b/new.sh
@@ -1 +1,29 @@
 #!/usr/bin/env sh
+
+# This scripts creates a new sample moduledir with requried files
+# Run it like : ./new.sh my-module
+
+MODULE_NAME=$1
+# Check if module name is provided
+if [ -z "$MODULE_NAME" ]; then
+    echo "Usage: ./new.sh <module_name>"
+    exit 1
+fi
+
+# Create module directory and exist if it alredy exists
+if [ -d "$MODULE_NAME" ]; then
+    echo "Module with name $MODULE_NAME already exists"
+    echo "Please choose a different name"
+    exit 1
+fi
+mkdir -p "${MODULE_NAME}"
+
+# Copy required files from the sample module
+cp -r .sample/* "${MODULE_NAME}"
+# Update main.tf with module name
+sed -i "s/MODULE_NAME/${MODULE_NAME}/g" main.tf
+# Update README.md with module name
+sed -i "s/MODULE_NAME/${MODULE_NAME}/g" README.md
+
+# Change to module directory
+cd "${MODULE_NAME}"