Class ScriptLoader

Lua script loader with include support

Index

Constructors

Methods

addPathMapping clearCache interpolate load loadCommand loadScripts parseScript resolvePath

Constructors

constructor

new ScriptLoader(): ScriptLoader
Returns ScriptLoader
- Defined in commands/script-loader.ts:96

Methods

addPathMapping

addPathMapping(name: string, mappedPath: string): void
Add a script path mapping. Allows includes of the form "/utils.lua" where includes is a user defined path
Parameters
- name: string
  the name of the mapping. Note: do not include angle brackets
- mappedPath: string
  if a relative path is passed, it's relative to the caller of this function. Mapped paths are also accepted, e.g. "~/server/scripts/lua" or "/includes"
Returns void
- Defined in commands/script-loader.ts:110

clearCache

clearCache(): void
Clears the command cache

Returns void
- Defined in commands/script-loader.ts:463

interpolate

interpolate(file: ScriptMetadata, processed?: Set<string>): string
Construct the final version of a file by interpolating its includes in dependency order.
Parameters
- file: ScriptMetadata
  the file whose content we want to construct
- Optionalprocessed: Set<string>
  a cache to keep track of which includes have already been processed
Returns string
- Defined in commands/script-loader.ts:333

load

load(
    client: RedisClient,
    pathname: string,
    cache?: Map<string, ScriptMetadata>,
): Promise<void>
Attach all lua scripts in a given directory to a client instance
Parameters
- client: RedisClient
  redis client to attach script to
- pathname: string
  the path to the directory containing the scripts
- Optionalcache: Map<string, ScriptMetadata>
Returns Promise<void>
- Defined in commands/script-loader.ts:435

loadCommand

loadCommand(
filename: string,
cache?: Map<string, ScriptMetadata>,
): Promise<Command>
Parameters
- filename: string
- Optionalcache: Map<string, ScriptMetadata>
Returns Promise<Command>
- Defined in commands/script-loader.ts:356

loadScripts

loadScripts(
dir?: string,
cache?: Map<string, ScriptMetadata>,
): Promise<Command[]>
Load redis lua scripts. The name of the script must have the following format:

cmdName-numKeys.lua

cmdName must be in camel case format.

For example: moveToFinish-3.lua
Parameters
- Optionaldir: string
- Optionalcache: Map<string, ScriptMetadata>
Returns Promise<Command[]>
- Defined in commands/script-loader.ts:390

parseScript

parseScript(
    filename: string,
    content: string,
    cache?: Map<string, ScriptMetadata>,
): Promise<ScriptMetadata>
Parse a (top-level) lua script
Parameters
- filename: string
  the full path to the script
- content: string
  the content of the script
- Optionalcache: Map<string, ScriptMetadata>
  cache
Returns Promise<ScriptMetadata>
- Defined in commands/script-loader.ts:305

resolvePath

resolvePath(scriptName: string, stack?: string[]): string
Resolve the script path considering path mappings
Parameters
- scriptName: string
  the name of the script
- stack: string[] = []
  the include stack, for nicer errors
Returns string
- Defined in commands/script-loader.ts:134