File Structure

Thank you for reading this wiki. I will briefly describe the file construction of this language server.

WIP...

3rd

submodules

bin

binaries, ignored in git

locale

locale files, if you want to support a language, you only need to name the folder with the language id

log

default log path, ignored in git

make

used for build

meta

provide definition files.

subdirectories

3rd

definition files for built-in 3rd library, e.g. love2d, OpenResty.

template

definition template files for built-in library, e.g. io, table
after the language server is started, real definition files will be generated according to your Lua version, language ID and file encoding

Lua {LUA_VERSION} {LANGUAGE_ID} {FILE_ENCODING}

definition files for built-in library, ignored in git

script

code executed by the language server

subdirectories

brave

sub thread workers, provide "read protocol from standard input", "read file content" and "regularly wake up the main thread"

cli

provide --version and --check, see https://github.com/sumneko/lua-language-server/wiki/Command-line

config

core

provide language features

subdirectories

encoder

convert encoding between ansi, utf8 and utf16

glob

lua-glob
Used to resolve abc/*/[1-9].lua

parser

LuaParser
parsing Lua code into an abstract syntax tree

x = 1
y = 1

{
    type   = 'main',
    start  = 0,
    finish = 20000,
    [1] = {
        type   = 'setglobal',
        start  = 0,
        finish = 1,
        range  = 5,
        [1]    = 'x',
        value  = {
            type   = 'integer',
            start  = 4,
            finish = 5,
            [1]    = 1
        },
    },
    [2] = {
        type   = 'setglobal',
        start  = 10000,
        finish = 10001,
        range  = 10005,
        [1]    = 'y',
        value  = {
            type   = 'integer',
            start  = 10004,
            finish = 10005,
            [1]    = 2
        },
    },
}

first line is 0, start is cursor position on the left and finish is cursor position on the right position = row * 10000 + col, therefore, only codes without more than 10000 bytes in a single line are supported

most of the files are obsolete, and only the following files are in use

subdirectories

guide.lua

provide utility functions, for example getVisibleLocals(source, position), getParentFunction(source) and positionToOffset(state, position)

luadoc.lua

parse EmmyLua

test

tools

debugger.lua

provide debugger attach with parameters --develop

main.lua

entry file for language server

test.lua

entry file for testing