galaxy-language-server 0.14.1

A language server for Galaxy (https://galaxyproject.org) tool wrappers

Galaxy Language Server

Language Server implementation written in Python (pygls) to assist in the development of Galaxy tool wrappers.

Dependencies

• pygls: generic implementation of the Language Server Protocol in Python.
• lxml: Python library for processing XML files.
• anytree: Python library with an easy to use tree structure.
• galaxy-tool-util: the Galaxy tool utilities for Python.

Getting Started

Check the Getting Started section in the contributing docs.

How to manually run the server

Usually, the client will be in charge of running the server when it is needed, but, in case you want to run it manually for some reason, you can use the following commands:

In any case, it is recommended to create a Python virtual environment first (assuming you are using Python3.8+):

# Create a virtual environment and activate it
python -m venv myenv
source ./myenv/bin/activate

Option 1: Installing from PyPi

# Install the language server and its dependencies
pip install galaxy-language-server

Option 2: Building from source

# Clone the repo
git clone https://github.com/galaxyproject/galaxy-language-server.git

# Go to the server directory
cd galaxy-language-server/server

# Install the dependencies
python -m pip install -r ./requirements.txt

Run the server

# Run the server with the default parameters
python -m galaxyls

By default, the server uses IO pipes to communicate with the client. If you want to use TCP, you can pass additional parameters, for example:

python -m galaxyls --tcp --host=127.0.0.1 --port=2087

To check if everything went ok, you can look at the content of the server log file (galaxy-language-server.log) that should contain the following lines:

INFO:pygls.server:Starting server on 127.0.0.1:2087
INFO:pygls.server:Shutting down the server
INFO:pygls.server:Closing the event loop.

Galaxy Language Server Changelog

[0.14.1] - 2025-08-26

Changed

• Update server dependencies to include new linting (#283).

[0.14.0] - 2025-04-12

Added

• Add command to upgrade tests to comply with profile 24.2 validation (#278).

[0.13.3] - 2025-03-15

Fixed

• Ensure pip and setuptools are upgraded when creating the virtual environment (#275).

[0.13.2] - 2025-03-10

Fixed

• Move xrefs block to comply with planemo lint ordering (#269).

Changed

• Update server dependencies to include new linting (#272).

[0.13.1] - 2024-11-18

Fixed

• Reduce false positives when detecting tool wrapper documents (#267).

[0.13.0] - 2024-09-30

Added

• Add commands Insert param reference and Insert param output filter (#264).

Changed

• Update server dependencies + improve development experience (#257).

[0.12.1] - 2024-05-18

Changed

• Update internal dependencies to support new Galaxy (24.0.2) XSD definitions.

[0.12.0] - 2023-10-14

Added

• Document Symbol provider (#247).

[0.11.0] - 2023-08-30

Fixed

• Fix macros detection condition (#239).

Added

• Support for links to navigate to test-data files (#231).

Changed

• Improve attribute with enum auto-completion (#241).
• Remove dead link (#238).

[0.10.2] - 2023-03-12

Fixed

• Fix parameters and models conversion between client and server (#224).

[0.10.1] - 2023-03-04

Fixed

• Config loading issue resulting in unhandled exception with new configuration models (#220).

[0.10.0] - 2023-02-25

Changed

• Update pygls to version 1.0.1. This enables Python 3.11 support and other features (#216).

[0.9.0] - 2022-10-20

Added

• New setting to silently install the language server (#210).

Changed

• Code quality: fix e2e tests for linting (#211).

[0.8.0] - 2022-10-02

Added

• Full Galaxy tool linting integration (#204).

Changed

• Code quality: refactor validation system (#205).

• Code quality: setup isort (#203).

[0.7.1] - 2022-01-31

Fixed

• Check valid document extension before checking contents when validating documents (#189).

[0.7.0] - 2022-01-29

Added

• New custom command to discover tests in a single tool file to support the new Testing API in the client (#183).

Changed

• Update pygls dependency and fix how custom commands are registered (#179).

Fixed

• An error creating Code Actions to extract macros when selecting a text range in some situations (#178).

[0.6.1] - 2021-09-26

Changed

• Revert pygls version to 0.11.1. This should temporarily fix an issue that prevents using any custom command in the language server (#172).

[0.6.0] - 2021-09-12

Added

• Code Action language feature to be able to extract macros out of valid blocks of XML (#165).

[0.5.3] - 2021-07-09

Fixed

• An error when generating tests from inputs that contained boolean values different than true or false like True or False (#156).

[0.5.2] - 2021-06-08

Fixed

• Line offset mismatch between diagnostic line and expanded document (#150).

[0.5.1] - 2021-06-03

Fixed

• Clear diagnostics when the document is not valid (#143).

• Fix empty document validation (#144).

[0.5.0] - 2021-05-13

Added

• New feature to navigate to (or peek) macro and token definitions, open referenced macro files directly from the <import> tag and preview token values on hover (#127).

• A custom command to generate the expanded version of a tool document (#128).

• Existing macro names are now suggested when manually invoking IntelliSense with Ctrl+Space (#132).

• Support for dynamic token parameter attributes in <expand> elements (#133).

Changed

• Updated main dependencies to latests versions, specially pygls=0.10.3 which introduced some backward incompatible changes (#126).

Fixed

• When manually invoking IntelliSense with Ctrl+Space in the middle of a tag or attribute the auto-completion was suggesting wrong values (#129).

• Auto-closing tags when writing / or > was broken in previous versions (#137).

[0.4.0] - 2021-02-15

Added

• A custom command for tests discovery that provides information about the test definitions of all the opened tool documents in the virtual workspace (#110).

• A custom command to reorder <param> attributes according to the IUC Style Guidelines (#104).

Fixed

• Unexpected errors when generating code were failing silently without providing feedback to the user. Now an error notification will be displayed to the user (#113).

• Elements inside macros were not correctly associated with their XSD definition (#111).

• An bug in the search algorithm when analyzing the tool input trees with nested conditional sharing the same 'when' value. This was causing the code generation commands to fail (#109).

[0.3.2] - 2021-01-24

Fixed

• The server was ignoring tool wrappers with syntax errors instead of reporting those syntax errors (#100).

[0.3.1] - 2021-01-09

Fixed

• The autocompletion of tags and attributes was leaking into the CDATA sections (#86).

• Weird behavior of the autoclosing tag feature (#86).

• When using a custom command to auto-generate the <command> or the <tests> sections (with a tool document containing macros), the insert position inside the document for the code snippets was offset (#83).

[0.3.0] - 2021-01-01

Added

• A custom command to auto-generate the <command> section with boilerplate Cheetah template based on the current inputs and outputs defined in the tool (#77).
• A custom command to auto-generate <test> cases based on the current inputs and outputs defined in the tool (#73).

Fixed

• Avoid processing unknown XML documents (aka not tool wrappers) (#75).
• Broken XML parsing when more than one comment block was present in the document (#70).

[0.2.1] - 2020-11-22

Fixed

• The documentation displayed when hovering an element now shows the correct documentation instead of No documentation available (#64).

[0.2.0] - 2020-11-13

Added

• Client settings to control completion features (#56).

Changed

• The XML parser has been replaced with a better implementation (#55).

[0.1.2] - 2020-10-25

Removed

• Removed unused function XsdTree.find_node_by_name().

[0.1.1] - 2020-10-24

Added

• Support autocompletion for <expand> element.

Changed

• Updated dependencies to latest versions.

Fixed

• Fix error when hovering <expand> elements or it's atributes (#41).

[0.1.0] - 2020-10-14

Added

• Basic tag and attribute auto-completion.
• Auto-close tags feature.
• XML tool validation when opening and saving file.
• Basic validation of macros.
• Auto-formatting document when saving file.
• Display tag and attribute documentation when hovering.