algocline-engine 0.46.1

algocline Lua execution engine — VM, session, bridge
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51

-- vendored from evalframe v0.4.0 (~/.algocline/packages/evalframe/swarm/env.lua)
-- DO NOT EDIT here — upstream sync via manual copy
--[[
  swarm/env.lua — Environment declaration

  Declares the evaluation scenario context.
  evalframe uses `name` for identification; `context` holds
  domain-specific data consumed by the runner.

  Usage:
    local sw = require("evalframe.swarm")

    local env = sw.env "troubleshooting" {
      scenario = "memory_leak",
      services = { "user-service", "db-service" },
    }
    -- env.name    == "troubleshooting"
    -- env.context == { scenario = "memory_leak", services = { ... } }
]]

local M = {}

local ENV_TAG = {}

function M.build(name)
  if type(name) ~= "string" then
    error(string.format("sw.env: name must be string, got %s", type(name)), 2)
  end

  return function(spec)
    if type(spec) ~= "table" then
      error(string.format("sw.env '%s': spec must be a table", name), 2)
    end

    -- Defensive copy to prevent caller mutation.
    local context = {}
    for k, v in pairs(spec) do context[k] = v end

    return {
      _tag    = ENV_TAG,
      name    = name,
      context = context,
    }
  end
end

function M.is_env(v)
  return type(v) == "table" and v._tag == ENV_TAG
end

return M