feat: support specifying github release tag (#29)

Author: dlipicar

README.md

@@ -115,6 +115,7 @@ Display detailed information about a specific package.
 |--------|-------------|
 | `--modules-dir <path>` | Set core modules installation directory |
 | `--ui-plugins-dir <path>` | Set UI plugins installation directory |
+| `--release <tag>` | GitHub release tag to use (default: `latest`) |
 | `--json` | Output results in JSON format |
 | `-h, --help` | Show help message |
 | `-v, --version` | Show version information |
@@ -142,6 +143,12 @@ lgpm info waku-module
 
 # Install to a custom directory
 lgpm --modules-dir /path/to/modules install waku-module
+
+# Install from a specific release instead of "latest"
+lgpm --release v2.1.0 install waku-module
+
+# List packages available in a specific release
+lgpm --release v2.1.0 list --json
 ```
 
 ## Dependencies

cmd/main.cpp

@@ -253,6 +253,7 @@ void printHelp() {
     out << "Options:" << Qt::endl;
     out << "  --modules-dir <path>    Set core modules directory" << Qt::endl;
     out << "  --ui-plugins-dir <path> Set UI plugins directory" << Qt::endl;
+    out << "  --release <tag>         GitHub release tag to use (default: latest)" << Qt::endl;
     out << "  --category <cat>        Filter by category (for list command)" << Qt::endl;
     out << "  --installed             Show only installed packages (for list command)" << Qt::endl;
     out << "  --file <path>           Install from a local LGX file (for install command)" << Qt::endl;
@@ -278,6 +279,7 @@ int main(int argc, char *argv[]) {
     QCommandLineOption installedOption("installed", "Show only installed packages");
     QCommandLineOption jsonOption("json", "Output in JSON format");
     QCommandLineOption fileOption("file", "Install from a local LGX file path", "path");
+    QCommandLineOption releaseOption("release", "GitHub release tag to use (default: latest)", "tag", "latest");
 
     parser.addOption(helpOption);
     parser.addOption(versionOption);
@@ -287,6 +289,7 @@ int main(int argc, char *argv[]) {
     parser.addOption(installedOption);
     parser.addOption(jsonOption);
     parser.addOption(fileOption);
+    parser.addOption(releaseOption);
     parser.addPositionalArgument("command", "Command to run");
     parser.addPositionalArgument("args", "Command arguments", "[args...]");
 
@@ -321,6 +324,10 @@ int main(int argc, char *argv[]) {
     if (parser.isSet(uiPluginsDirOption)) {
         pm.setUiPluginsDirectory(parser.value(uiPluginsDirOption));
     }
+
+    if (parser.isSet(releaseOption)) {
+        pm.setRelease(parser.value(releaseOption));
+    }
 
     if (command == "search") {
         return cmdSearch(pm, positionalArgs, jsonOutput);

src/lib/package_manager_lib.cpp

@@ -14,7 +14,7 @@
 #include <algorithm>
 #include "lgx.h"
 
-static const QString MODULES_DOWNLOAD_BASE_URL = QStringLiteral("https://github.com/logos-co/logos-modules/releases/latest/download");
+static const QString MODULES_REPO_BASE = QStringLiteral("https://github.com/logos-co/logos-modules/releases");
 
 // Returns true if version string `a` is >= `b`, comparing dot-separated numeric segments.
 static bool versionGreaterOrEqual(const QString& a, const QString& b)
@@ -33,6 +33,7 @@ static bool versionGreaterOrEqual(const QString& a, const QString& b)
 
 PackageManagerLib::PackageManagerLib(QObject* parent)
     : QObject(parent)
+    , m_releaseTag(QStringLiteral("latest"))
     , m_networkManager(nullptr)
     , m_isInstalling(false)
 {
@@ -57,6 +58,20 @@ void PackageManagerLib::setUiPluginsDirectory(const QString& uiPluginsDirectory)
     qDebug() << "Set UI plugins directory to:" << m_uiPluginsDirectory;
 }
 
+void PackageManagerLib::setRelease(const QString& releaseTag)
+{
+    m_releaseTag = releaseTag.isEmpty() ? QStringLiteral("latest") : releaseTag;
+    qDebug() << "Set release tag to:" << m_releaseTag;
+}
+
+QString PackageManagerLib::downloadBaseUrl() const
+{
+    if (m_releaseTag == "latest") {
+        return MODULES_REPO_BASE + "/latest/download";
+    }
+    return MODULES_REPO_BASE + "/download/" + m_releaseTag;
+}
+
 QString PackageManagerLib::installPluginFile(const QString& pluginPath, QString& errorMsg, bool skipIfNotNewerVersion)
 {
     qDebug() << "PackageManagerLib: Installing plugin file:" << pluginPath;
@@ -407,7 +422,7 @@ bool PackageManagerLib::installPackage(const QString& packageName)
     }
 
     // Download the LGX package file
-    QString downloadUrl = QString("%1/%2").arg(MODULES_DOWNLOAD_BASE_URL, packageFile);
+    QString downloadUrl = QString("%1/%2").arg(downloadBaseUrl(), packageFile);
     QString destinationPath = QDir(tempDir).filePath(packageFile);
 
     qDebug() << "Downloading package file:" << packageFile;
@@ -503,7 +518,7 @@ void PackageManagerLib::startAsyncPackageListFetch()
         return;
     }
 
-    QString urlString = QString("%1/list.json").arg(MODULES_DOWNLOAD_BASE_URL);
+    QString urlString = QString("%1/list.json").arg(downloadBaseUrl());
     QUrl url(urlString);
     QNetworkRequest request(url);
 
@@ -602,7 +617,7 @@ void PackageManagerLib::startNextFileDownload()
     }
 
     QString fileName = m_asyncState.filesToDownload[m_asyncState.currentDownloadIndex];
-    QString downloadUrl = QString("%1/%2").arg(MODULES_DOWNLOAD_BASE_URL, fileName);
+    QString downloadUrl = QString("%1/%2").arg(downloadBaseUrl(), fileName);
 
     qDebug() << "Async: Downloading package file:" << fileName;
 
@@ -714,7 +729,7 @@ QJsonArray PackageManagerLib::fetchPackageListFromOnline()
         return packagesArray;
     }
 
-    QString urlString = QString("%1/list.json").arg(MODULES_DOWNLOAD_BASE_URL);
+    QString urlString = QString("%1/list.json").arg(downloadBaseUrl());
     QUrl url(urlString);
     QNetworkRequest request(url);
 

src/lib/package_manager_lib.h

@@ -22,6 +22,10 @@ class PackageManagerLib : public QObject
     QString pluginsDirectory() const { return m_pluginsDirectory; }
     QString uiPluginsDirectory() const { return m_uiPluginsDirectory; }
 
+    // Release tag (defaults to "latest")
+    void setRelease(const QString& releaseTag);
+    QString release() const { return m_releaseTag; }
+
     QString installPluginFile(const QString& pluginPath, QString& errorMsg, bool skipIfNotNewerVersion = false);
 
     QJsonArray getPackages();
@@ -62,6 +66,7 @@ private slots:
 private:
     QString m_pluginsDirectory;
     QString m_uiPluginsDirectory;
+    QString m_releaseTag;
     QNetworkAccessManager* m_networkManager;
 
     struct AsyncInstallState {
@@ -78,6 +83,8 @@ private slots:
     bool m_isInstalling;
     QQueue<QStringList> m_requestQueue;
 
+    QString downloadBaseUrl() const;
+
     void startAsyncPackageListFetch();
     void startNextFileDownload();
     void finishAsyncInstallation(bool success, const QString& error);

src/package_manager_plugin.cpp

@@ -153,3 +153,7 @@ void PackageManagerPlugin::setPluginsDirectory(const QString& pluginsDirectory)
 void PackageManagerPlugin::setUiPluginsDirectory(const QString& uiPluginsDirectory) {
     m_lib->setUiPluginsDirectory(uiPluginsDirectory);
 }
+
+void PackageManagerPlugin::setRelease(const QString& releaseTag) {
+    m_lib->setRelease(releaseTag);
+}

src/package_manager_plugin.h

@@ -27,6 +27,7 @@ class PackageManagerPlugin : public QObject, public PackageManagerInterface
     Q_INVOKABLE QStringList resolveDependencies(const QStringList& packageNames);
     Q_INVOKABLE void setPluginsDirectory(const QString& pluginsDirectory);
     Q_INVOKABLE void setUiPluginsDirectory(const QString& uiPluginsDirectory);
+    Q_INVOKABLE void setRelease(const QString& releaseTag);
     Q_INVOKABLE bool installPackage(const QString& packageName, const QString& pluginsDirectory);
     Q_INVOKABLE bool installPackages(const QStringList& packageNames, const QString& pluginsDirectory);
     Q_INVOKABLE void installPackageAsync(const QString& packageName, const QString& pluginsDirectory);