Skip to content

Bump LCLS version to 2.3.1 and handle new Maven Central endpoints #547

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
mattbsox merged 1 commit into from
Jul 28, 2025
Merged

Bump LCLS version to 2.3.1 and handle new Maven Central endpoints #547

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
130 changes: 105 additions & 25 deletions gulpfile.js
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,12 +1,27 @@
const axios = require("axios");
const gulp = require("gulp");
const download = require("gulp-download2");
const cp = require("child_process");
const { XMLParser } = require('fast-xml-parser');

const fs = require('fs');
const path = require('path');

const { finished } = require('stream');
const { promisify } = require('util');
const finishedAsync = promisify(finished);

const MC_BASE_URL = "https://repo1.maven.org/maven2";
const MC_SNAPSHOT_BASE_URL = "https://central.sonatype.com/repository/maven-snapshots";

const libertyGroupId = "io.openliberty.tools";
const libertyVersion = "2.2.1";
const libertyLemminxArtifactId = "liberty-langserver-lemminx";
const libertyLSArtifactId = "liberty-langserver";
const libertyVersion = "2.3.1";
const jakartaGroupId = "org.eclipse.lsp4jakarta";
const jakartaVersion = "0.2.3";
var releaseLevel = "releases"; //"snapshots"; //snapshots or releases
var lclsReleaseLevel = "releases"; //snapshots or releases
var jakartaReleaseLevel = "releases";

const libertyLemminxName = "liberty-langserver-lemminx-" + libertyVersion + "-jar-with-dependencies.jar";
const libertyLemminxDir = "../liberty-language-server/lemminx-liberty";
Expand Down Expand Up @@ -53,35 +68,28 @@ gulp.task("buildJakartaLs", (done) => {
done();
});

//https://oss.sonatype.org/service/local/artifact/maven/content?r=snapshots&g=io.openliberty.tools&a=liberty-langserver-lemminx&c=jar-with-dependencies&v=1.0-SNAPSHOT
//https://oss.sonatype.org/service/local/artifact/maven/content?r=snapshots&g=io.openliberty.tools&a=liberty-langserver&c=jar-with-dependencies&v=1.0-SNAPSHOT
const sonatypeURL = "https://oss.sonatype.org/service/local/artifact/maven/content";
const releaseLevelString = "?r=" + releaseLevel;
const libertyGroupIdString = "&g=" + libertyGroupId;
const libertyVersionString = "&v=" + libertyVersion;
const classifierString = "&c=jar-with-dependencies";
gulp.task("downloadLibertyLSJars", async function() {
var libertyLemminxURL;
var libertyLSURL;

const libertyLemminxURL = sonatypeURL + releaseLevelString + libertyGroupIdString + "&a=liberty-langserver-lemminx" + classifierString + libertyVersionString;
const libertyLSURL = sonatypeURL + releaseLevelString + libertyGroupIdString + "&a=liberty-langserver" + classifierString + libertyVersionString;
if (lclsReleaseLevel === "snapshots") {
libertyLemminxURL = await generateSnapshotJarURL(libertyGroupId, libertyLemminxArtifactId, libertyVersion, "jar-with-dependencies");
libertyLSURL = await generateSnapshotJarURL(libertyGroupId, libertyLSArtifactId, libertyVersion, "jar-with-dependencies");
} else {
libertyLemminxURL = getMavenCentralJarURL(libertyGroupId, libertyLemminxArtifactId, libertyVersion, "jar-with-dependencies");
libertyLSURL = getMavenCentralJarURL(libertyGroupId, libertyLSArtifactId, libertyVersion, "jar-with-dependencies");
}

gulp.task("downloadLibertyLSJars", (done) => {
download({
url: libertyLemminxURL,
file: libertyLemminxName,
})
.pipe(gulp.dest("./jars", { encoding: false}));
download({
url: libertyLSURL,
file: libertyLSName,
})
.pipe(gulp.dest("./jars", { encoding: false}));
done();
await Promise.all([
downloadJar(libertyLemminxURL, libertyLemminxName, "./jars"),
downloadJar(libertyLSURL, libertyLSName, "./jars")
]);
});

//https://repo.eclipse.org/service/local/artifact/maven/content?r=snapshots&g=org.eclipse.lsp4jakarta&a=org.eclipse.lsp4jakarta.jdt.core&v=0.0.1-SNAPSHOT
//https://repo.eclipse.org/service/local/artifact/maven/content?r=snapshots&g=org.eclipse.lsp4jakarta&a=org.eclipse.lsp4jakarta.ls&c=jar-with-dependencies&v=0.0.1-SNAPSHOT
const eclipseRepoURL = "https://repo.eclipse.org/service/local/artifact/maven/content";
const jakartaReleaseLevelString = "?r=" + releaseLevel;
const jakartaReleaseLevelString = "?r=" + jakartaReleaseLevel;
const jakartaGroupIdString = "&g=" + jakartaGroupId;
const jakartaVersionString = "&v=" + jakartaVersion;
const jakartaClassifierString = "&c=jar-with-dependencies";
Expand All @@ -95,7 +103,7 @@ gulp.task("downloadLSP4JakartaJars", (done) => {
file: jakartaJdtName,
})
.pipe(gulp.dest("./jars", { encoding: false}));
download({
download({
url: jakartaLSURL,
file: jakartaLSName,
})
Expand All @@ -110,3 +118,75 @@ function mvnw() {
function isWin() {
return /^win/.test(process.platform);
}

// Handle jar download through axios, gulp download failed with 403 on Maven Central snapshot repo
async function downloadJar(url, fileName, destDir) {
const response = await axios.get(url, {
headers: {
'User-Agent': 'Mozilla/5.0 (Node.js downloader)',
'Accept': `*/*`
},
responseType: 'stream'
});

console.log(`Downloading ${url}`);
const fullPath = path.join(destDir, fileName);
const writer = fs.createWriteStream(fullPath);
response.data.pipe(writer);
await finishedAsync(writer);
console.log(`Downloaded ${fileName}`);
}

// Generate Maven Central artifact URL for specified GAV coordinates
// Example: https://repo1.maven.org/maven2/io/openliberty/tools/liberty-langserver/2.3.1/liberty-langserver-2.3.1-jar-with-dependencies.jar
function getMavenCentralJarURL (groupId, artifactId, version, classifier) {
const classifierString = classifier ? `-${classifier}` : '';
const mavenCentralJarURL = `${MC_BASE_URL}/${groupId.replace(/\./g, '/')}/${artifactId}/${version}/${artifactId}-${version}${classifierString}.jar`;
return mavenCentralJarURL;
}

// No API provided to retrieve snapshot artifacts hosted on https://central.sonatype.com/repository/maven-snapshots
// Can access maven-metadata.xml using GAV coordinates for artifacts
// Will parse retrieved maven-metadata.xml for full artifact version, including timestamp
// Example: https://central.sonatype.com/repository/maven-snapshots/io/openliberty/tools/liberty-langserver/2.3.1-SNAPSHOT/maven-metadata.xml -> 2.3.1-20250714.163135-2
async function resolveSnapshotVersionFromMetadata (groupId, artifactId, snapshotVersion, classifier) {
// Generate maven-metadata.xml URL
const metadataURL = `${MC_SNAPSHOT_BASE_URL}/${groupId.replace(/\./g, '/')}/${artifactId}/${snapshotVersion}/maven-metadata.xml`;
console.log(`Fetching maven-metadata.xml: ${metadataURL}`);

// Fetch and parse maven-metadata.xml
const response = await axios.get(metadataURL);
// console.log(response.data);
const parser = new XMLParser();
const parsedXML = parser.parse(response.data);

// Get all <snapshotVersion> entries
const versions = parsedXML?.metadata?.versioning?.snapshotVersions.snapshotVersion || [];

const targetClassifier = classifier || null;

// Filter entries, only list jar files, match classifier if provided
const snapshotVersionEntry = versions.find(v => {
const extensionMatch = v.extension === 'jar';
const classifierValue = v.classifier || null;

return extensionMatch && classifierValue === targetClassifier;
});

if (!snapshotVersionEntry) {
throw new Error(`No snapshot JAR found matching parameters: ${groupId}:${artifactId}:${classifier || '(no classifier)'}:${snapshotVersion}`);
}

console.log(`Resolved full snapshot version for ${artifactId}: ${snapshotVersionEntry.value}`);
return snapshotVersionEntry.value;
}

// Generate Maven Central artifact URL for a SNAPSHOT dependency with provided GAV coordinates
// LCLS 2.3.1-SNAPSHOT jar-with-dependencies: <MC_SNAPSHOT_BASE_URL>/io/openliberty/tools/liberty-langserver/2.3.1-SNAPSHOT/liberty-langserver-2.3.1-20250714.163135-2-jar-with-dependencies.jar
async function generateSnapshotJarURL (groupId, artifactId, snapshotVersion, classifier) {
const snapshotJarVersion = await resolveSnapshotVersionFromMetadata(groupId, artifactId, snapshotVersion, classifier);
const classifierString = classifier ? `-${classifier}` : ''; //Format classifier for URL if defined
const snapshotJarURL = `${MC_SNAPSHOT_BASE_URL}/${groupId.replace(/\./g, '/')}/${artifactId}/${snapshotVersion}/${artifactId}-${snapshotJarVersion}${classifierString}.jar`;
console.log(`${groupId}:${artifactId}:${snapshotVersion}:${classifier} URL: ${snapshotJarURL}`);
return snapshotJarURL;
}
Loading
Loading