vfox-jdtls

vfox / mise plugin for installing Eclipse JDT Language Server (jdtls).

Prerequisites

• Java 21+ on PATH
• Python 3 on PATH (used by the jdtls launcher script)

Usage with mise

# Install a specific version
mise use vfox:tinnet/vfox-jdtls@1.57.0

# List available versions
mise ls-remote vfox:tinnet/vfox-jdtls

# Verify installation
mise which jdtls
jdtls --help

Usage with vfox

# Add the plugin
vfox add --source https://github.com/tinnet/vfox-jdtls/releases/download/manifest/manifest.json jdtls

# Install a version
vfox install jdtls@1.57.0
vfox use jdtls@1.57.0

Environment variables

Variable	Value
JDTLS_HOME	SDK installation directory
PATH	$JDTLS_HOME/bin is prepended

How it works

Eclipse publishes jdtls tarballs with build timestamps in the filename (e.g., jdt-language-server-1.57.0-202602261110.tar.gz). This plugin resolves the timestamp by scraping the milestones directory at install time.

Development

# Run unit tests (Zero-dependency Lua runner)
mise run test

# Format Lua source code
mise run format
# or
mise run fmt

Testing

This project uses a lightweight, zero-dependency testing suite located in the spec/ directory. We avoid external frameworks like Busted or LuaUnit to ensure the development environment remains portable and easy to set up without requiring luarocks or complex Homebrew builds.

Publishing

Push a tag matching vX.Y.Z to trigger CI that packages and publishes the plugin.

Changelog

See CHANGELOG.md for release history.