This is kind of a big PR, but I hope you'll find it worth your while.

This introduces basic AST parsing on the basis of the grammar you wrote. I made a duplicate grammar that

• suppresses all the whitespace and comments
• distinguish control flow (conditionals, loops, function/macro declarations) from regular command invocations
• adds block-level expectation parsing (opening a function implies there must be an endfunction somewhere)
• adds semantic actions to generate AST nodes

The cool thing about the expectation parsing (using the - instead of +) is that it can get you get an exception if you forget to close a block, which can be easily converted into a diagnostic!

Adds TEXT_DOCUMENT_DID_OPEN/_SAVE features to the language server, which parses the file into an AST and generates diagnostics for single list file only. If the AST parsing was successful, it gets traversed by a bunch of diagnostic-generating visitors much in the style of python's AST module (i.e. if the visitor has a visit_<ASTNode-type-name> method matching the type of the node being visited, that function gets called).

I've only added the following diagnostics, whose logic may or may not be flawed at this point:

• break() or continue() not enclosed in a loop
• return() in a macro (suggest replacement with message(FATAL_ERROR ...))
• redundant assignment: set(asdf ${asdf}) (Yeah, I got bit by this recently :grimacing:)
• duplicate branch in if/elseif
• all-uppercase commands (suggest lowercase)
• directory-based api (suggest replacement with target-based api)

Naturally, these are all up for discussion or omission. They're kind of a starter list, since I bet there's a bunch more helpful diagnostics that could be implemented. But maybe we should decide on the general structure for them first, hence this PR.

I also messed around a little in the rest of the files. Fixed a few misspellings and added documentation in some places when I was first trying to find my way around the code.

Update pygls to version 0.11.2 and change the version requirement to '^0.11' this removes a conflict with jedi-language-server which requires pygls>=0.11.1,<0.12.0.

This commit also bumps the cmake-language-server version to 0.1.3.

Update pygls to version 0.12 to remove a conflict with jedi-language-server which requires pygls "^0.12" and set the minimum python version to py37 (as required by pygls 0.12).

This commit also bumps the cmake-language-server version to 0.1.36

I just noticed that there doesn't seem to be much/any documentation on the formatter's options/args, and was wondering if it's configurable, and/or what the defaults even are?

As an aside, do you have any thoughts on splitting the formatter into its own package? I'm just saying this because I noticed that this LSP actually conflicts (same binary name cmake-format) with https://github.com/cheshirekow/cmake_format which seems to possibly be a more fleshed out formatter.

Given the following cmake file: https://github.com/llvm/llvm-project/blob/master/libc/src/stdio/CMakeLists.txt

If I hover over add_entrypoint_object, I see the following exception:

cmake: ERROR:pygls.protocol:Failed to handle request 2 textDocument/hover Object(position=Object(character=7, line=0), textDocument=Object(uri='file:///home/raoul/Documents/Programming/llvm-project/libc/src/stdio/CMakeLists.txt'))
:: --> cmake textDocument/hover(2): {'position': {'character': 7, 'line': 0}, 'textDocument': {'uri': 'file:///home/raoul/Documents/Programming/llvm-project/libc/src/stdio/CMakeLists.txt'}}
cmake: Traceback (most recent call last):
:: <~~ cmake 2: {'message': "AttributeError: 'NoneType' object has no attribute 'get_command_doc'", 'code': -32602, 'data': '{\'traceback\': [\'  File "/home/raoul/.config/sublime-text-3/Cache/LSP-cmake/lib/python3.8/site-packages/pygls/protocol.py", line 317, in _handle_request\\n    self._execute_request(msg_id, handler, params)\\n\', \'  File "/home/raoul/.config/sublime-text-3/Cache/LSP-cmake/lib/python3.8/site-packages/pygls/protocol.py", line 242, in _execute_request\\n    self._send_response(msg_id, handler(params))\\n\', \'  File "/home/raoul/.config/sublime-text-3/Cache/LSP-cmake/lib/python3.8/site-packages/cmake_language_server/server.py", line 142, in hover\\n    doc = c(word[0])\\n\', \'  File "/home/raoul/.config/sublime-text-3/Cache/LSP-cmake/lib/python3.8/site-packages/cmake_language_server/server.py", line 136, in <lambda>\\n    lambda x: self._api.get_command_doc(x.lower()),\\n\']}'}
cmake:   File "/home/raoul/.config/sublime-text-3/Cache/LSP-cmake/lib/python3.8/site-packages/pygls/protocol.py", line 317, in _handle_request
cmake:     self._execute_request(msg_id, handler, params)
cmake:   File "/home/raoul/.config/sublime-text-3/Cache/LSP-cmake/lib/python3.8/site-packages/pygls/protocol.py", line 242, in _execute_request
cmake:     self._send_response(msg_id, handler(params))
cmake:   File "/home/raoul/.config/sublime-text-3/Cache/LSP-cmake/lib/python3.8/site-packages/cmake_language_server/server.py", line 142, in hover
cmake:     doc = c(word[0])
cmake:   File "/home/raoul/.config/sublime-text-3/Cache/LSP-cmake/lib/python3.8/site-packages/cmake_language_server/server.py", line 136, in <lambda>
cmake:     lambda x: self._api.get_command_doc(x.lower()),
cmake: AttributeError: 'NoneType' object has no attribute 'get_command_doc'

Editor: Sublime Text with LSP plugin cmake-language-server version: 0.1.2

Can cmake-format have support for formatting a file from standard input to standard output? Something like cmake-format --stdin. This would be useful for editor plugins.

Poetry depends on lot of dependencies having nothing common with building packages. That's why poetry-core was created, which has much less dependencies and more focused on building wheels.

Not sure how to proceed.

ERROR: Could not find a version that satisfies the requirement cmake-language-server (from versions: none)
ERROR: No matching distribution found for cmake-language-server

Several LSP plugins, such as nvim-native, vim-lamp (already fixed in https://github.com/hrsh7th/vim-lamp/issues/21) and vim-lsp have no completion with it. Author of vim-lamp said that cmake-language-server provided insertText with null. Could you fix it?

target_precompile_headers

As a side note, do you have any desire to support included packages (that are distributed) that bring in their own vars/functions? Things like FindPackageHandleStandardArgs, FindPackageMessage, or cmake_dependent_option as an example.

Hello,

Thank you for this server,

I have a problem using this LSP server, concerning the textDocument/completion request. It seems the server expect a context parameter while the LSP specification if I am not mistaken has it as optional: From the microsoft website

Request:

method: ‘textDocument/completion’

params: CompletionParams defined as follows:

export interface CompletionParams extends TextDocumentPositionParams, WorkDoneProgressParams, PartialResultParams {
	/**
	 * The completion context. This is only available if the client specifies
	 * to send this using `ClientCapabilities.textDocument.completion.contextSupport === true`
	 */
	context?: CompletionContext;
}

For context, I am trying to make this LSP server works with the kakoune lsp plugin see related issue here.

Hello, When I open a CMakeLists.txt with neovim configured with cmake-language-server, the lsp server exited immediately with errors.

typing :LspLog I get this:

python --version
Python 3.12.0a0

neovim --version
NVIM v0.9.0-dev

system: Ubuntu 22.04

Hello, I'm switch from coc.nvim to neovim builtin Lsp, but I noticed the document hover content is entirely different. Document hover from coc.nvim is as follow: However, when I toggle document hover for the same command (add_executable), I only got:

add_executable(<name> [WIN32] [MACOSX_BUNDLE]
               [EXCLUDE_FROM_ALL]
               [source1] [source2 ...])

In addition, when I toggle document hover for for example find_package, I only got find_package() and nothing else.

I'd like to know what the original behavior should be, and whether the detailed documentation is generated by coc-cmake, or whether I'm not getting the same results on nvim-lsp because of the configuration.

I install cmake-format and config cmake-language-server

  "languageserver": {
    "cmake": {
      "command": "cmake-language-server",
      "filetypes": ["cmake"],
      "rootPatterns": [
        "build/"
      ],
      "initializationOptions": {
        "buildDirectory": "build"
      }
    }
  }

It can't format CMakeLists.txt when I saved it.