Get extension theme

.gitignore

@@ -1,3 +1,10 @@
+# Build artifacts
+build
+extensions
+
+# Local environment variables
+.env
+
 # Rojo
 /*.rbxl*
 /*.rbxm*

.justfile

@@ -1,27 +1,36 @@
 #!/usr/bin/env just --justfile
 
+set dotenv-load
+
 project_name := "rbxtheme"
 plugins_dir := if os_family() == "unix" {
 	"$HOME/Documents/Roblox/Plugins"
 } else {
 	"$LOCALAPPDATA/Roblox/Plugins"
 }
 plugin_filename := project_name + ".rbxm"
-plugin_path := plugins_dir / plugin_filename
+plugin_source := "src"
+plugin_output := plugins_dir / plugin_filename
 tmpdir := `mktemp -d`
 
 default:
   @just --list
 
 clean:
-	rm -rf {{plugin_path}}
+	rm -rf {{ plugin_output }}
 
 lint:
-	selene src/
-	stylua --check src/
+	selene {{ plugin_source }}
+	stylua --check {{ plugin_source }}
 
 _build target watch:
-	./bin/build.py --target {{target}} --output {{ plugin_path }} {{ if watch == "true"  { "--watch" } else { "" } }}
+	mkdir -p {{ parent_directory(plugin_output) }}
+	./bin/build.py --target {{target}} --output {{ plugin_output }} {{ if watch == "true"  { "--watch" } else { "" } }}
+
+init:
+	foreman install
+	lune --setup
+	just wally-install
 
 wally-install:
 	wally install
@@ -41,9 +50,12 @@ test: clean
     rojo build tests.project.json -o {{tmpdir / "tests.rbxl"}}
     run-in-roblox --place {{tmpdir / "tests.rbxl"}} --script tests/init.server.lua
 
+serve:
+	docker compose up
+
 analyze:
   curl -s -o "{{tmpdir}}/globalTypes.d.lua" -O https://raw.githubusercontent.com/JohnnyMorganz/luau-lsp/master/scripts/globalTypes.d.lua
 
   rojo sourcemap tests.project.json -o "{{tmpdir}}/sourcemap.json"
 
-  luau-lsp analyze --sourcemap="{{tmpdir}}/sourcemap.json" --defs="{{tmpdir}}/globalTypes.d.lua" --defs=testez.d.lua --ignore=**/_Index/** src/
+  luau-lsp analyze --sourcemap="{{tmpdir}}/sourcemap.json" --defs="{{tmpdir}}/globalTypes.d.lua" --defs=testez.d.lua --ignore=**/_Index/** {{ plugin_source }}

.vscode/extensions.json

@@ -0,0 +1,9 @@
+{
+  "recommendations": [
+    "JohnnyMorganz.luau-lsp",
+    "EditorConfig.EditorConfig",
+    "JohnnyMorganz.stylua",
+    "Kampfkarren.selene-vscode",
+    "skellock.just"
+  ]
+}

.vscode/settings.json

@@ -2,5 +2,12 @@
   "luau-lsp.sourcemap.rojoProjectFile": "tests.project.json",
   "luau-lsp.types.definitionFiles": [
     "testez.d.lua"
-  ]
-}
+  ],
+  "luau-lsp.require.mode": "relativeToFile",
+  "luau-lsp.require.directoryAliases": {
+    "@lune/": "~/.lune/.typedefs/0.7.11/"
+  },
+  "files.associations": {
+    "*.luau": "lua"
+  }
+}

Dockerfile

@@ -0,0 +1,31 @@
+# syntax=docker/dockerfile:1
+
+FROM ubuntu:24.04
+
+LABEL description="Image for running the Lune server"
+
+EXPOSE 8080
+
+ARG LUNE_VERSION
+
+RUN apt-get update
+RUN apt-get install -y \
+	build-essential \
+	curl \
+	unzip
+
+COPY ./server /server
+WORKDIR /server
+
+# HACK: Need to install a forked Lune that binds servers to 0.0.0.0
+RUN curl https://sh.rustup.rs -sSf | sh -s -- -y
+ENV PATH="/root/.cargo/bin:${PATH}"
+RUN apt-get install -y git gcc
+RUN git clone --single-branch --branch docker-server-binding https://github.com/ghostnaps/lune
+RUN cargo build --release --manifest-path lune/Cargo.toml
+CMD [ "./lune/target/release/lune", "server.luau" ]
+
+# RUN curl -LJO https://github.com/lune-org/lune/releases/download/v${LUNE_VERSION}/lune-${LUNE_VERSION}-linux-aarch64.zip
+# RUN unzip *.zip
+
+# CMD [ "./lune", "server.luau" ]

default.project.json

@@ -6,4 +6,4 @@
     },
     "$path": "src"
   }
-}
+}

dev.project.json

@@ -1,9 +1,6 @@
 {
   "name": "rbxtheme",
   "tree": {
-    "Packages": {
-      "$path": "Packages"
-    },
-    "$path": "src"
+    "$path": "default.project.json"
   }
-}
+}

docker-compose.yml

@@ -0,0 +1,10 @@
+version: "2"
+services:
+  lune-server:
+    container_name: lune-server
+    build:
+      dockerfile: Dockerfile
+      args:
+        - LUNE_VERSION=0.7.11
+    ports:
+      - "8080:8080"

foreman.toml

@@ -1,5 +1,6 @@
 [tools]
 luau-lsp = { source = "JohnnyMorganz/luau-lsp", version = "1.x" }
+lune = { source = "lune-org/lune", version = "0.7.11" }
 rojo = { source = "rojo-rbx/rojo", version = "7.2.1" }
 run-in-roblox = { source = "rojo-rbx/run-in-roblox", version = "0.3.0" }
 selene = { source = "kampfkarren/selene", version = "0.25.0" }

selene-requires.yml

@@ -0,0 +1,7 @@
+base: roblox
+name: selene_defs
+globals:
+  # override Roblox require style with string requires
+  require:
+    args:
+    - type: string

selene.toml

@@ -1,4 +1,4 @@
-std = "roblox+testez"
+std = "selene-requires+testez"
 
 [lints]
 global_usage = "allow"

server/fetch.luau

@@ -0,0 +1,10 @@
+local net = require("@lune/net")
+local logging = require("./logging")
+
+local function fetch(payload)
+	local method = if payload.method then payload.method else "GET"
+	logging.debug(`{method} {payload.url}`)
+	return net.request(payload)
+end
+
+return fetch

server/fetchExtension.lua

@@ -0,0 +1,49 @@
+local process = require("@lune/process")
+local fs = require("@lune/fs")
+local fetch = require("./fetch")
+
+local EXTENSIONS_DIR = "extensions"
+
+local function createExtensionDownloadUrl(
+	publisherName: string,
+	extensionName: string,
+	extensionVersion: string
+): string
+	return `https://{publisherName}.gallery.vsassets.io/_apis/public/gallery/publisher/{publisherName}/extension/`
+		.. `{extensionName}/{extensionVersion}/assetbyname/Microsoft.VisualStudio.Services.VSIXPackage`
+end
+
+local function fetchExtension(publisherName: string, extensionName: string, extensionVersion: string): string?
+	if not fs.isDir(EXTENSIONS_DIR) then
+		fs.writeDir(EXTENSIONS_DIR)
+	end
+
+	local extensionPath = `{EXTENSIONS_DIR}/{publisherName}-{extensionName}-{extensionVersion}`
+
+	if fs.isDir(extensionPath) then
+		return extensionPath
+	else
+		local res = fetch({
+			method = "GET",
+			url = createExtensionDownloadUrl(publisherName, extensionName, extensionVersion),
+		})
+
+		if res.ok then
+			local zipPath = `{extensionPath}.zip`
+
+			fs.writeFile(zipPath, res.body)
+
+			res = process.spawn("unzip", { zipPath, "-d", extensionPath })
+
+			fs.removeFile(zipPath)
+
+			if res.ok then
+				return extensionPath
+			end
+		end
+
+		return nil
+	end
+end
+
+return fetchExtension

server/logging.lua

@@ -0,0 +1,56 @@
+local process = require("@lune/process")
+local stdio = require("@lune/stdio")
+
+type LogLevel = "info" | "warning" | "error" | "debug"
+
+local LOG_LEVEL: string? = if process.env.LOG_LEVEL then process.env.LOG_LEVEL:lower() else "info"
+
+local LOG_LEVEL_ORDER = {
+	"info",
+	"warning",
+	"debug",
+	"error",
+}
+
+local function canLog(logLevelToCheck: LogLevel): boolean
+	local maxPriority = table.find(LOG_LEVEL_ORDER, LOG_LEVEL)
+	local priorityToCheck = table.find(LOG_LEVEL_ORDER, logLevelToCheck)
+
+	if maxPriority and priorityToCheck then
+		return priorityToCheck <= maxPriority
+	else
+		return false
+	end
+end
+
+local logging = {}
+
+function logging.info(...)
+	if canLog("info") then
+		print(`[info]`, ...)
+	end
+end
+
+function logging.warn(...)
+	if canLog("warning") then
+		stdio.write(stdio.color("yellow"))
+		print(`[warn]`, ...)
+		stdio.write(stdio.color("reset"))
+	end
+end
+
+function logging.err(...)
+	if canLog("error") then
+		stdio.write(stdio.color("red"))
+		print(`[err]`, ...)
+		stdio.write(stdio.color("reset"))
+	end
+end
+
+function logging.debug(...)
+	if canLog("debug") then
+		print(`[debug]`, ...)
+	end
+end
+
+return logging