ctrl+shift+p filters: :st2 :st3 :win :osx :linux
Browse

Lua​Complete

A Sublime Text 3 plugin for the lua-complete engine

Details

Installs

  • Total 4K
  • Win 3K
  • Mac 692
  • Linux 603
Mar 29 Mar 28 Mar 27 Mar 26 Mar 25 Mar 24 Mar 23 Mar 22 Mar 21 Mar 20 Mar 19 Mar 18 Mar 17 Mar 16 Mar 15 Mar 14 Mar 13 Mar 12 Mar 11 Mar 10 Mar 9 Mar 8 Mar 7 Mar 6 Mar 5 Mar 4 Mar 3 Mar 2 Mar 1 Feb 29 Feb 28 Feb 27 Feb 26 Feb 25 Feb 24 Feb 23 Feb 22 Feb 21 Feb 20 Feb 19 Feb 18 Feb 17 Feb 16 Feb 15 Feb 14 Feb 13
Windows 0 1 0 1 0 1 0 0 2 0 0 1 0 1 1 1 0 0 2 1 3 1 0 2 0 0 1 1 0 1 0 0 1 1 1 1 3 0 0 0 0 0 0 0 0 2
Mac 0 0 0 0 0 0 0 0 0 0 2 2 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0
Linux 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 1 0 0 1 0 1 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 1 0 0 0 0

Readme

Source
raw.​githubusercontent.​com

Deprecated: LuaComplete for Sublime Text 3

LuaComplete is no longer being worked on. There are numerous other lua code completion tools out there (with actual language-server support!)

Alternatives to take a look at: * https://github.com/sumneko/lua-language-server * https://github.com/EmmyLua/EmmyLua-LanguageServer

Original README below

LuaComplete is an ST3 plugin that does auto-completing of Lua code. It uses the lua-complete engine for auto-completion and makes your Lua development a lot easier! Image of LuaComplete in Action

Installation

  1. Install lua-complete

  2. Install the plugin. Currently, you can only install it manually:

    cd /Users/[user]/Library/Application Support/Sublime Text 3/Packages/
    git clone https://github.com/FourierTransformer/LuaComplete-Sublime LuaComplete
    

    I'm working on a few more things before getting it in Package Control.

  3. That's about it! LuaComplete will start up the server and send code automatically via the client. There are a few settings that can be tweaked, as referenced below.

Settings

The default settings should work out of the box, but they can be modified via the Preferences menu or from the Command Palette (Ctrl+Shift+P and type LuaComplete). Make any changes in the User settings. You will likely need to restart Sublime Text after changing settings. Here are the default settings:

{
    // Path to the directory containing lua-complete executables
    // if installed everywhere, just "lua-complete" should be fine
    "path": "lua-complete",

    // Port to use for the lua-complete client and server
    "port": 24548,

    // enable/disable toggle. it is enabled by default 
    // set it to false to turn off LuaComplete
    // and restart Sublime Text for it to take effect
    // "enabled": true,
    // NOTE: it can also be enabled/disabled via the command palette 
    // but will only stick until the next Sublime Text reboot

    // additional include location
    // by default lua-complete will search lua's regular 
    // installed module paths (packages.path)
    // 
    // The LuaComplete plugin will send the currently
    // open folder in the sublime text view for analysis
    // 
    // Additional include locations can be specified in a
    // semi-colon delimited list below (be sure to comment out the line below)
    // "additional_includes": "/my/random/file/path;/another/path"
}

Features and Shortcomings

  • It will only auto-complete things in tables - which includes most lua modules!
  • It can only determine function parameters for Lua functions (it currently doesn't know if a parameter is optional or not).
  • It should work with project-level files (by searching through the folder open in sublime text or folder the file resides in)
  • In the future, it should include function parameters for the built-in lua functions. However, it is not possible to determine function parameters for other C functions - without hard-coding them in.

Comparison between Lua and C functions

The LuaComplete plugin will show the difference between when it can fill in function parameters (for Lua functions) and when it can't (for C functions). Take a look at the example below:

Lua Function

The Lua function parameters get auto-completed and in the Sublime Text auto-complete hover - the function is described as function ():

Image of LuaComplete completing lua function parameters

C Function

The C functions parameters don't get auto-completed and the function is described as function: Image of LuaComplete completing lua function parameters

Troubleshooting

If you see the error message “The lua-complete client failed to return” in the bottom right, try running the “LuaComplete: Clear Auto-complete Cache (Restart Server)” from the command palette. This will restart the server, and hopefully the client will be able to reconnect.

Questions and Contributing

Feel free to open a Github issue with any questions/issues/features that you have! Also, check out CONTRIBUTING.md if you want to help!

Licenses

LuaComplete is released under the MIT License