created_at2023-12-13 23:04:18.886357
updated_at2024-04-02 06:38:13.450778
descriptionA language server for htmx with backend languages.
Uros Mrkobrada (uros-5)



HTMX-LSP logo HTMX-LSP logo build status

its so over

## Installation ```console cargo install htmx-lsp2 ``` ## Configuration ```json { "lang": "rust", "template_ext": "jinja", "templates": ["./templates"], "js_tags": ["./frontend"], "backend_tags": ["./backend"] } ``` ## Supported languages Go, Python, JavaScript, TypeScript, Rust ## When to use htmx-lsp or this lsp ? If you are working on small hello world example web app, then you probably don't need this improved version of htmx-lsp. For bigger projects(many templates, many backend routes, few JavaScript modules) you should try this. ## Difference between htmx-lsp and this lsp ### Backend/frontend tags Tags are similar to JSDoc comments. In some sense they act like documentation for htmx part of your application. They are helpful when you arrive at some htmx project. In order to understand codebase you constantly need to browse through files or use global search for every part of project. With tags you can simply use goto definition feature for that attribute and _you are exactly where you need to be_. #### Example ```rust fn example() { // some code ... // part of app that is 'connected' with htmx template // this is tag hx@tag1 // ... } ``` ```html hello world ``` It is also possible to have multiple tags on one element. Some tag is in your Go function, other can be in JavaScript. This improves _locality of behavior_, you don't need to think too much, you just quickly read and act. If you use editor that behind the scenes uses TreeSitter, then you can include one query in `textobjects.scm` that can move your cursor to hx-lsp tag: ```scheme ( (attribute_name) @attr (quoted_attribute_value (attribute_value) @class.inside ) @class.around (#eq? @attr "hx-lsp") ) ``` To have syntax highlighting for tags in your backend language or JavaScript use this query(it's _comment grammar_, `highlights.scm`): ```scheme ("text" @hint (#match? @hint "^(hx@)")) ``` And here is one for template(it's _html grammar_, `highlights.scm`): ```scheme ((attribute_name) @keyword (quoted_attribute_value (attribute_value) @function ) (#eq? @keyword "hx-lsp") ) ``` #### Goto reference There are situations where you tag is used in multiple places in one template or in many templates that are located deep in your directory tree. To avoid messing with global search just call goto reference on tag definition and you can check each htmx-lsp instance. If there is only one reference for tag, then you will be redirected directy to that location. #### Goto definition #### Goto implementation If your editor doesn't support TreeSitter, you can use goto implementation feature for navigating between `htmx-lsp` attributes. When you are deep in some template, searching for `htmx-lsp` attribute can be tedious, so this feature can help use navigating to our target much faster. #### Incremental parsing for TreeSitter One problem with htmx-lsp is that it doesn't use full power of TreeSitter, and that is incremental parsing. Right now for every change inside of template entire file is sent and parsed by TreeSitter. And second problem is that only takes first change that is sent by text editor. So what if you use multiple cursors and you start applying changes for text document ? And what if client only supports incremental synchronization for `didChange` lsp feature ? This forked version of htmx-lsp aims to fix this issues, not just for template part, but also for backend languages. #### VSCode plugin It's still work in progress. Right now it's usable in debug mode.
Commit count: 0

cargo fmt