tagls is a language server based on gtags.

daquexian

Last update: Dec 1, 2022

Related tags

Miscellaneous tagls

Overview

tagls

tagls is a language server based on gtags.

Why I wrote it?

Almost all modern editors have great support to LSP, but language servers based on semantic are not always reliable (for example, in dynamic languages like Python).

On the other hand, the good old gtags has more comprehensive (sometimes verbose, though) result, but it is not the first class citizen of modern editors and is usually poorly supported.

A language server based on gtags can give you the best of both worlds.

Usage

Install tagls by pip3 install tagls and register it in your code editor. For example, in coc.nvim:

  "languageserver": {
    "tagls": {
      "command": "python3",
      "args": ["-m", "tagls"],
      "filetypes": [
        "c",
        "cpp",
        "python"
      ],
      "initializationOptions": {},
      "settings": {}
    }
  }

Supported

initialize (Auto create/update gtags tag files when opening a project in the editor)
textDocument/didSave (auto update gtags tag files when a file is updated)
textDocument/definition
textDocument/references
textDocument.documentSymbol
workspace/symbol

Todo

Per-feature configuration (e.g. disable every feature but 'textDocument/references')

NORETURN is an esoteric programming language, based around the idea of not going back

NORETURN NORETURN is an esoteric programming language, based around the idea of not going back Concept Program coded in noreturn runs over one array,

1 Dec 15, 2021

A very terrible python-based programming language that uses folders instead of text files

PYFolders by Lewis L. Foster PYFolders is a very terrible python-based programming language that uses folders instead of regular text files. In this r

5 Jan 8, 2022

Morth - Stack Based Programming Language

Morth WARNING! THIS LANGUAGE IS A WORKING PROGRESS. THIS IS JUST A HOBBY PROJECT

2 Mar 5, 2022

A simple assembly- and brainfuck-inspired stack-based language

asm-stackfuck A simple assembly- and brainfuck-inspired stack-based language. The language has a few goals: Be stack-based Look like assembly Have a s

1 Feb 6, 2022

Binary++ is an esoteric programming language based on* binary

Binary++ is an esoteric programming language based on* binary. * It's meant to be based on binary, but you can write Binary++ code using different mea

3 Feb 18, 2022

A brainfuck-based game oriented language written in python.

GF.py STILL WIP Gamefuck.py is a programming language based off brainfuck. It is oriented towards game development, and as such has many commands spec

1 Feb 23, 2022

Run-Your-Own Firefox Sync Server

Run-Your-Own Firefox Sync Server This is an all-in-one package for running a self-hosted Firefox Sync server. It bundles the "tokenserver" project for

1.7k Dec 30, 2022

YunoHost is an operating system aiming to simplify as much as possible the administration of a server.

YunoHost is an operating system aiming to simplify as much as possible the administration of a server. This repository corresponds to the core code, written mostly in Python and Bash.

1.5k Jan 9, 2023

A simple service that allows you to run commands on the server using text

Server Text A simple flask service that allows you to run commands on the server/computer over sms. Think of it as a shell where you run commands over

49 Nov 9, 2021

Comments

add an Emacs lsp-mode usage example

Hi daquexian,

This pull request contains my experience in using tagls as a language server in Emacs (specifically, with Emacs lsp-mode). When I tried, I found that lsp-mode does not send initializationOptions if :initialization-options is not specified when registering the language server. In this case, tagls got None as params.initialization_options and raised ValueError and server initialization failed.

So I replace the raise with an empty dict when client does not provide initializationOptions, so that default values are used, and the initialization proceed. Do you think it is OK?

Also, a configuration example for Emacs lsp-mode is added to README.md (tested in my environment, Emacs 28.1, lsp-mode 480f804c1). I may also take some responsibility to maintain this part later, if you will :)

Fan

P.S. I was looking for a tag-based lsp server then I found tagls which suits my need well. So thanks for this project, sincerely <3

opened by Raphus-cucullatus 1