/********************************************************************************
 * Copyright (c) 2025-2026 ZF Friedrichshafen AG
 *
 * This program and the accompanying materials are made available under the 
 * terms of the Apache License Version 2.0 which is available at
 * https://www.apache.org/licenses/LICENSE-2.0
 *
 * SPDX-License-Identifier: Apache-2.0
 *
 * Contributors:
 *   Erik Verhoeven - initial API and implementation
 ********************************************************************************/

#include "environment.h"

#include <string_view>

#include "../../global/cmdlnparser/cmdlnparser.cpp"

CSdvPackagerEnvironment::CSdvPackagerEnvironment() :
    m_cmdln(static_cast<uint32_t>(CCommandLine::EParseFlags::no_assignment_character))
{}

CSdvPackagerEnvironment::CSdvPackagerEnvironment(const std::vector<std::string>& rvecArgs) :
    m_cmdln(static_cast<uint32_t>(CCommandLine::EParseFlags::no_assignment_character))
{
    // Create a classic argument array
    std::vector<const char*> vecArgPtrs;
    for (const std::string& rssArg : rvecArgs)
        vecArgPtrs.push_back(rssArg.c_str());

    // Call the constructor
    *this = CSdvPackagerEnvironment(vecArgPtrs.size(), &vecArgPtrs.front());
}

bool CSdvPackagerEnvironment::Help() const
{
    return m_bHelp;
}

void CSdvPackagerEnvironment::ShowHelp() const
{
    size_t nArgumentGroup = 0;
    std::stringstream sstreamText;

    // Show default information:
    sstreamText << "Component installation package utility. This utility can be used to pack, install and uninstall "
                   "SDV component installations on the current machine."
                << std::endl
                << std::endl;

    constexpr std::string_view svCollectModules = "Provide one or more files to add to the installation on the command line. "
        "Wildcards (**, *, ?) are supported, allowing multiple files and directories to be added automatically. Regular "
        "expressions can also be used when prefixing the paths with \"regex:\". If a specific target location (relative to the "
        "installation directory) is required, this can be added by \"=<directory>\".\n\n"
        "Examples:\n"
        "    *.sdv          - This will pack all SDV files from the input directory.\n"
        "    **/*.*         - This will pack all files from all directories.\n"
        "    abc.sdv=mysub  - This will pack \"abc.sdv\" into target \"mysub\".\n"
        "    regex:[^/].sdv - This will pack all SDV files from the input directory.\n\n"
        "REMARKS: To create updatable components, use the '--set_version' option to set a version.\n";
    constexpr std::string_view svCollectConfigFiles = "Provide one or more configuration files to merge into installed "
        "configuration files. Wildcards (**, *, ?) are supported, allowing multiple files and directories to be added "
        "automatically. Regular expressions can also be used when prefixing the paths with \"regex:\".\n\n"
        "Examples:\n"
        "    *.toml          - This will use all TOML files from the input directory.\n"
        "    **/*.*          - This will use all files from all directories.\n"
        "    abc.toml        - This will use \"abc.toml\".\n"
        "    regex:[^/].toml - This will use all TOML files from the input directory.\n";
    constexpr std::string_view svConfiguration = "The configuration uses an optional string following the option to define what to "
        "configure. The string is separated by the '+' separator followed by a list of components (separated by a comma ',' or a "
        "'+') to include in the configuration. If a component should be instantiated using a specific name, this can be achieved "
        "by adding the assignment character '='. For example to update a local configuration ('--local' option) use:\n\n"
        "    --config_fileabc.toml+my_component1,my_component2,my_component2=test21\n\n"
        "and for a server configuration:\n\n"
        "    --user_config+my_component1+my_component2+my_component2=test21\n\n"
        "If the configuration file is not existing, it will be created automatically.\n\n"
        "To provide component specific parameters, there are two options available. The first option would be to assign parameters "
        "directly to a component instance by providing the parameter at the command line. Hereby the instance name of the "
        "component is the assigned name of the component (if any was assigned) or the default name if known or the component class "
        "name if one instance is available. The value assignment to the parameter is optional. If the value is omitted, a default "
        "value is assigned. Here are two examples:\n\n"
        "    --parametersmy_component1:param1=10,param2=20,groupA.param3=string value\n"
        "    --parameterstest21:param5=,groupB.param6=60\n\n"
        "The second option would be to specify a parameter file containing the parameters for the object instances. The parameter "
        "file is a TOML file containing all the parameters for several components. Each component is present as a table containing "
        "the instance name of the component (the assigned name, if there is any, or the default name or the class name). "
        "Underneath the table header the parameters follow in a \"parameter_name = value\" format. Parameter names must follow the "
        "TOML rules for keys. If they contain special characters, they need to be quoted. Furthermore, the names must follow the "
        "grouping format of the component, whereas any group is either specified as additional TOML table, or is preceded in the "
        "key name (the parameter name) and separated by a dot. An example for the command line to assign a configuration to the "
        "one or more component instances is as follow:\n"
        "    --param_fileMyComponentParams.toml\n"
        "And an example file could be like this:\n\n"
        "    # Parameters for my_component1\n"
        "    [my_component1]\n"
        "    param1 = 10\n"
        "    param2 = 20\n"
        "    [my_component1.groupA]     # Example with additional table for the GroupA parameters\n"
        "    param3 = \"string value\"\n\n"
        "    # Parameters for test21 (instance of my_component2)\n"
        "    [test21]\n"
        "    param5=50\n"
        "    groupB.param6=60           # Grouping using inline table for GroupB parameters\n\n"
        "REMARKS: Utilities cannot be added to the configuration.\n\n"
        "REMARKS: For server based user configuration, the configuration cannot contain devices, basic services and system "
        "objects.\n";

    // Show information based on the command.
    switch (m_eOperatingMode)
    {
    case EOperatingMode::pack:
        nArgumentGroup = 1;
        sstreamText << "PACK command usage:" << std::endl
                    << "    sdv_package PACK <name> <files> [options]" << std::endl
                    << std::endl;
        sstreamText << svCollectModules;
        break;
    case EOperatingMode::install:
        nArgumentGroup = 2;
        sstreamText << "INSTALL command usage:" << std::endl << "    sdv_package INSTALL <package> [options]" << std::endl <<
            std::endl;
        sstreamText << "Install an installation package and update the configuration if applicable." << std::endl << std::endl <<
            svConfiguration << std::endl << "REMARKS: The server based installation use sdv_packager can only take place when the "
            "system is offline. Use \"sdv_control\" to install on a running server instance (limited installation possible) or "
            "to shutdown and restart the server."<< std::endl;
        break;
    case EOperatingMode::direct_install:
        nArgumentGroup = 3;
        sstreamText << "DIRECT_INSTALL command usage:" << std::endl << "    sdv_package DIRECT_INSTALL <name> <files> [options]" <<
            std::endl << std::endl;
        sstreamText << svCollectModules << std::endl << svConfiguration << std::endl << "REMARKS: The server based installation "
            "can only take place when the system is offline. Use \"sdv_control\" to install on a running server instance (limited "
            "installation possible) or to shutdown and restart the server." << std::endl;
        break;
    case EOperatingMode::configure:
        nArgumentGroup = 4;
        sstreamText << "CONFIGURE command usage:" << std::endl << "    sdv_package CONFIGURE <config_files> [options]" <<
            std::endl << std::endl;
        sstreamText << svCollectConfigFiles << std::endl << "REMARKS: The server based configuration can only take place when the "
            "system is offline. Use \"sdv_control\" to shutdown and restart the server." << std::endl;
        break;
    case EOperatingMode::uninstall:
        nArgumentGroup = 5;
        sstreamText << "UNINSTALL command usage:" << std::endl << "    sdv_package UNINSTALL <name> <files> [options]" <<
            std::endl << std::endl;
        sstreamText << "Uninstall a previously installed package with the supplied name. Update the configuration files where "
            "applicable." << std::endl << std::endl << "REMARKS: The server based unistallation can only take place when the "
            "system is offline. Use \"sdv_control\" to install on a running server instance (limited un-installation possible) or "
            "to shutdown and restart the server." << std::endl;
        break;
    case EOperatingMode::verify:
        nArgumentGroup = 6;
        sstreamText << "VERIFY command usage:" << std::endl << "    sdv_package VERIFY <package> [options]" << std::endl <<
            std::endl;
        sstreamText << "Verify the package for corruption and/or tampering." << std::endl;
        break;
    case EOperatingMode::show:
        nArgumentGroup = 7;
        sstreamText << "SHOW command usage:" << std::endl << "    sdv_package SHOW [ALL|INFO|MODULES|COMPONENTS] <package> "
            "[options]" << std::endl << std::endl;
        sstreamText << "Show package information. The following information can be selected (multiple selections are "
            "possible):" << std::endl << "    ALL            Show all information about the package content." << std::endl <<
            "    INFO           Show package information." << std::endl <<
            "    MODULES        Show the modules contained in the package." << std::endl <<
            "    COMPONENTS     Show the components contained in the package." << std::endl;
        break;
    default:
        sstreamText << "Usage: sdv_package <command> [options]" << std::endl << std::endl;
        sstreamText << "The following commands are available:" << std::endl <<
            "    PACK               Create an installation package." << std::endl <<
            "    INSTALL            Install an installation package." << std::endl <<
            "    DIRECT_INSTALL     Install the components directly." << std::endl <<
            "    CONFIGURE          Configure the target system." << std::endl <<
            "    UNINSTALL          Uninstall a previously installed installation package." << std::endl <<
            "    VERIFY             Verify the integrity of the installation package." << std::endl <<
            "    SHOW               Show information about the installation package." << std::endl << std::endl <<
            "For information about the options of each command, provide the '--help' option following the command." << std::endl;
        break;
    }

    m_cmdln.PrintHelp(std::cout, sstreamText.str(), nArgumentGroup);
}

void CSdvPackagerEnvironment::ReportInfo() const
{
    // Do not report anything
    if (m_bSilent) return;

    // Dependable on the verbose and the silent settings, select the output stream for information.
    std::stringstream sstreamDummy;
    std::ostream& rstreamVerbose = !m_bHelp && m_bVerbose ? std::cout : sstreamDummy;
    std::ostream& rstreamNormal = m_bHelp || m_bSilent ? sstreamDummy : std::cout;

    // Assign additional paths and report information...
    switch (m_eOperatingMode)
    {
    case EOperatingMode::pack:
        if (m_bCreateManifestOnly)
            rstreamNormal << "Creating an installation manifest..." << std::endl;
        else
            rstreamNormal << "Creating an installation package..." << std::endl;
        rstreamVerbose << "Source location: " << m_pathSourceLocation.generic_u8string() << std::endl;
        rstreamVerbose << "Output location: " << m_pathOutputLocation.generic_u8string() << std::endl;
        rstreamVerbose << "Installation name: " << m_ssInstallName << std::endl;
        rstreamVerbose << "Product name: " << m_ssProductName << std::endl;
        rstreamVerbose << "Package description: " << m_ssDescription << std::endl;
        rstreamVerbose << "Author: " << m_ssAuthor << std::endl;
        rstreamVerbose << "Address: " << m_ssAddress << std::endl;
        rstreamVerbose << "Copyright: " << m_ssCopyrights << std::endl;
        rstreamVerbose << "Version: " << m_ssPackageVersion << std::endl;
        rstreamVerbose << "Keep directory structure: " << (m_bKeepStructure ? "true" : "false") << std::endl;
        break;
    case EOperatingMode::install:
        rstreamNormal << "Installing a package..." << std::endl;
        if (m_bCreateManifestOnly)
            rstreamVerbose << "No file copy, creating manifest only..." << std::endl;
        if (m_bLocal)
            rstreamVerbose << "Local installation..." << std::endl;
        else
            rstreamVerbose << "Instance ID: " << m_uiInstanceID << std::endl;
        rstreamVerbose << "Target base location: " << m_pathTargetLocation.generic_u8string() << std::endl;
        rstreamVerbose << "Installation root location: " << m_pathRootLocation.generic_u8string() << std::endl;
        rstreamVerbose << "Install location: " << m_pathInstallLocation.generic_u8string() << std::endl;
        rstreamVerbose << "Update: " << (m_bUpdate ? "true" : "false") << std::endl;
        rstreamVerbose << "Overwrite: " << (m_bOverwrite ? "true" : "false") << std::endl;
        if (m_bLocal)
        {
            if (!m_pathConfigLocal.empty())
            {
                bool bInitial = true;
                for (const auto& rpathConfigDir : m_vecLocalConfigDirs)
                {
                    if (bInitial)
                        rstreamVerbose << "Config location: ";
                    else
                        rstreamVerbose << "                 ";
                    bInitial = false;
                    rstreamVerbose << rpathConfigDir.generic_u8string() << std::endl;
                }
                rstreamVerbose << "Config file: " << m_pathConfigLocal.generic_u8string() << std::endl;
            }
        }
        else
        {
            bool bInitial = true;
            for (const auto& rprComponent : m_vecUserConfigComponents)
            {
                if (bInitial)
                    rstreamVerbose << "User config components: ";
                else
                    rstreamVerbose << "                        ";
                bInitial = false;
                rstreamVerbose << rprComponent.first << std::endl;
            }
            bInitial = true;
            for (const auto& rprComponent : m_vecPlatformConfigComponents)
            {
                if (bInitial)
                    rstreamVerbose << "Platform config components: ";
                else
                    rstreamVerbose << "                            ";
                bInitial = false;
                rstreamVerbose << rprComponent.first << std::endl;
            }
            bInitial = true;
            for (const auto& rprComponent : m_vecVehIfcConfigComponents)
            {
                if (bInitial)
                    rstreamVerbose << "Vehicle interface config components: ";
                else
                    rstreamVerbose << "                                     ";
                bInitial = false;
                rstreamVerbose << rprComponent.first << std::endl;
            }
            bInitial = true;
            for (const auto& rprComponent : m_vecVehAbstrConfigComponents)
            {
                if (bInitial)
                    rstreamVerbose << "Vehicle abstraction config components: ";
                else
                    rstreamVerbose << "                                       ";
                bInitial = false;
                rstreamVerbose << rprComponent.first << std::endl;
            }
        }
        break;
    case EOperatingMode::direct_install:
        rstreamNormal << "Direct installation of modules..." << std::endl;
        rstreamVerbose << "Source location: " << m_pathSourceLocation.generic_u8string() << std::endl;
        if (m_bLocal)
            rstreamVerbose << "Local installation..." << std::endl;
        else
            std::cout << "Instance ID: " << m_uiInstanceID << std::endl;
        rstreamVerbose << "Target base location: " << m_pathTargetLocation.generic_u8string() << std::endl;
        rstreamVerbose << "Installation root location: " << m_pathRootLocation.generic_u8string() << std::endl;
        rstreamVerbose << "Install location: " << m_pathInstallLocation.generic_u8string() << std::endl;
        rstreamVerbose << "Installation name: " << m_ssInstallName << std::endl;
        rstreamVerbose << "Product name: " << m_ssProductName << std::endl;
        rstreamVerbose << "Package description: " << m_ssDescription << std::endl;
        rstreamVerbose << "Author: " << m_ssAuthor << std::endl;
        rstreamVerbose << "Address: " << m_ssAddress << std::endl;
        rstreamVerbose << "Copyright: " << m_ssCopyrights << std::endl;
        rstreamVerbose << "Version: " << m_ssPackageVersion << std::endl;
        rstreamVerbose << "Keep directory structure: " << (m_bKeepStructure ? "true" : "false") << std::endl;
        rstreamVerbose << "Update: " << (m_bUpdate ? "true" : "false") << std::endl;
        rstreamVerbose << "Overwrite: " << (m_bOverwrite ? "true" : "false") << std::endl;
        if (!m_pathPackage.empty())
            rstreamVerbose << "Package: " << m_pathPackage.generic_u8string() << std::endl;
        if (m_bLocal)
        {
            if (!m_pathConfigLocal.empty())
            {
                bool bInitial = true;
                for (const auto& rpathConfigDir : m_vecLocalConfigDirs)
                {
                    if (bInitial)
                        rstreamVerbose << "Config location: ";
                    else
                        rstreamVerbose << "                 ";
                    bInitial = false;
                    rstreamVerbose << rpathConfigDir.generic_u8string() << std::endl;
                }
                rstreamVerbose << "Config file: " << m_pathConfigLocal.generic_u8string() << std::endl;
            }
        }
        else
        {
            bool bInitial = true;
            for (const auto& rprComponent : m_vecUserConfigComponents)
            {
                if (bInitial)
                    rstreamVerbose << "User config components: ";
                else
                    rstreamVerbose << "                        ";
                bInitial = false;
                rstreamVerbose << rprComponent.first << std::endl;
            }
            bInitial = true;
            for (const auto& rprComponent : m_vecPlatformConfigComponents)
            {
                if (bInitial)
                    rstreamVerbose << "Platform config components: ";
                else
                    rstreamVerbose << "                            ";
                bInitial = false;
                rstreamVerbose << rprComponent.first << std::endl;
            }
            bInitial = true;
            for (const auto& rprComponent : m_vecVehIfcConfigComponents)
            {
                if (bInitial)
                    rstreamVerbose << "Vehicle interface config components: ";
                else
                    rstreamVerbose << "                                     ";
                bInitial = false;
                rstreamVerbose << rprComponent.first << std::endl;
            }
            bInitial = true;
            for (const auto& rprComponent : m_vecVehAbstrConfigComponents)
            {
                if (bInitial)
                    rstreamVerbose << "Vehicle abstraction config components: ";
                else
                    rstreamVerbose << "                                       ";
                bInitial = false;
                rstreamVerbose << rprComponent.first << std::endl;
            }
        }
        break;
    case EOperatingMode::uninstall:
        rstreamNormal << "Uninstall installation..." << std::endl;
        rstreamVerbose << "Target base location: " << m_pathTargetLocation.generic_u8string() << std::endl;
        rstreamVerbose << "Installation root location: " << m_pathRootLocation.generic_u8string() << std::endl;
        rstreamVerbose << "Install location: " << m_pathInstallLocation.generic_u8string() << std::endl;
        rstreamVerbose << "Installation name: " << m_ssInstallName << std::endl;
        if (m_bLocal)
        {
            bool bInitial = true;
            for (const auto& rpathConfigDir : m_vecLocalConfigDirs)
            {
                if (bInitial)
                    rstreamVerbose << "Config location: ";
                else
                    rstreamVerbose << "                 ";
                bInitial = false;
                rstreamVerbose << rpathConfigDir.generic_u8string() << std::endl;
            }
        }
        break;
    case EOperatingMode::verify:
        rstreamNormal << "Verify package integrity..." << std::endl;
        if (!m_pathPackage.empty())
            rstreamVerbose << "Package: " << m_pathPackage.generic_u8string() << std::endl;
        break;
    case EOperatingMode::show:
        rstreamNormal << "Show package information..." << std::endl;
        rstreamVerbose << "Information: ";
        if (m_uiShowFlags & static_cast<uint32_t>(EShowMask::info))
            rstreamVerbose << "package ";
        if (m_uiShowFlags & static_cast<uint32_t>(EShowMask::modules))
            rstreamVerbose << "modules ";
        if (m_uiShowFlags & static_cast<uint32_t>(EShowMask::components))
            rstreamVerbose << "components";
        rstreamVerbose << std::endl;
        rstreamVerbose << "Output: ";
        if (m_uiShowFlags & static_cast<uint32_t>(EShowMask::console))
            rstreamVerbose << "console ";
        if (m_uiShowFlags & static_cast<uint32_t>(EShowMask::xml))
            rstreamVerbose << "xml ";
        if (m_uiShowFlags & static_cast<uint32_t>(EShowMask::json))
            rstreamVerbose << "json";
        rstreamVerbose << std::endl;
        if (!m_pathPackage.empty())
            rstreamVerbose << "Package: " << m_pathPackage.generic_u8string() << std::endl;
        break;
    default:
        rstreamNormal << "Nothing to do..." << std::endl;
        break;
    }
}

bool CSdvPackagerEnvironment::Silent() const
{
    return m_bSilent;
}

bool CSdvPackagerEnvironment::Verbose() const
{
    return m_bVerbose;
}

bool CSdvPackagerEnvironment::Version() const
{
    return m_bVersion;
}

bool CSdvPackagerEnvironment::CreateManifestOnly() const
{
    return m_bCreateManifestOnly;
}

CSdvPackagerEnvironment::EOperatingMode CSdvPackagerEnvironment::OperatingMode() const
{
    return m_eOperatingMode;
}

bool CSdvPackagerEnvironment::KeepStructure() const
{
    return m_bKeepStructure;
}

const std::vector<CSdvPackagerEnvironment::SModule>& CSdvPackagerEnvironment::ModuleList() const
{
    return m_vecModules;
}

const std::vector<std::string>& CSdvPackagerEnvironment::ConfigFileList() const
{
    return m_vecConfigFiles;
}

const std::filesystem::path& CSdvPackagerEnvironment::PackagePath() const
{
    return m_pathPackage;
}

const std::filesystem::path& CSdvPackagerEnvironment::SourceLocation() const
{
    return m_pathSourceLocation;
}

const std::filesystem::path& CSdvPackagerEnvironment::OutputLocation() const
{
    return m_pathOutputLocation;
}

const std::filesystem::path& CSdvPackagerEnvironment::TargetLocation() const
{
    return m_pathTargetLocation;
}

const std::filesystem::path& CSdvPackagerEnvironment::RootLocation() const
{
    return m_pathRootLocation;
}

const std::filesystem::path& CSdvPackagerEnvironment::InstallLocation() const
{
    return m_pathInstallLocation;
}

bool CSdvPackagerEnvironment::Local() const
{
    return m_bLocal;
}

uint32_t CSdvPackagerEnvironment::InstanceID() const
{
    return m_uiInstanceID;
}

bool CSdvPackagerEnvironment::Update() const
{
    return m_bUpdate;
}

bool CSdvPackagerEnvironment::Overwrite() const
{
    return m_bOverwrite;
}

const std::filesystem::path& CSdvPackagerEnvironment::LocalConfigFile(CComponentVector& rvecComponents) const
{
    rvecComponents = m_vecConfigLocalComponents;
    return m_pathConfigLocal;
}

const std::vector<std::filesystem::path>& CSdvPackagerEnvironment::LocalConfigLocations() const
{
    return m_vecLocalConfigDirs;
}

bool CSdvPackagerEnvironment::InsertIntoUserConfig(CComponentVector& rvecComponents) const
{
    rvecComponents = m_vecUserConfigComponents;
    return m_bInsertIntoUserConfig;
}

bool CSdvPackagerEnvironment::InsertIntoPlatformConfig(CComponentVector& rvecComponents) const
{
    rvecComponents = m_vecPlatformConfigComponents;
    return m_bInsertIntoPlatformConfig;
}

bool CSdvPackagerEnvironment::InsertIntoVehicleInterfaceConfig(CComponentVector& rvecComponents) const
{
    rvecComponents = m_vecVehIfcConfigComponents;
    return m_bInsertIntoVehIfcConfig;
}

bool CSdvPackagerEnvironment::InsertIntoVehicleAbstractionConfig(CComponentVector& rvecComponents) const
{
    rvecComponents = m_vecVehAbstrConfigComponents;
    return m_bInsertIntoVehAbstrConfig;
}

const TParameterVector& CSdvPackagerEnvironment::ObjectParameters(const std::string& rssObjectInstance) const
{
    static TParameterVector vecEmpty;
    auto itParameters = m_mapParameters.find(rssObjectInstance);
    if (itParameters == m_mapParameters.end()) return vecEmpty;
    return itParameters->second;
}

const std::string& CSdvPackagerEnvironment::InstallName() const
{
    return m_ssInstallName;
}

const std::string& CSdvPackagerEnvironment::ProductName() const
{
    return m_ssProductName;
}

const std::string& CSdvPackagerEnvironment::Description() const
{
    return m_ssDescription;
}

const std::string& CSdvPackagerEnvironment::Author() const
{
    return m_ssAuthor;
}

const std::string& CSdvPackagerEnvironment::Address() const
{
    return m_ssAddress;
}

const std::string& CSdvPackagerEnvironment::Copyrights() const
{
    return m_ssCopyrights;
}

const std::string& CSdvPackagerEnvironment::PackageVersion() const
{
    return m_ssPackageVersion;
}

uint32_t CSdvPackagerEnvironment::ShowFlags() const
{
    return m_uiShowFlags;
}

bool CSdvPackagerEnvironment::CheckShowFlag(EShowMask eMask) const
{
    return (m_uiShowFlags & static_cast<uint32_t>(eMask)) == static_cast<uint32_t>(eMask);
}

int CSdvPackagerEnvironment::Error() const
{
    return m_nError;
}

const std::string& CSdvPackagerEnvironment::ArgError() const
{
    return m_ssArgError;
}

void CSdvPackagerEnvironment::SplitConfigString(const std::string& rssInput, std::filesystem::path& rpath,
    std::vector<std::pair<std::string, std::string>>& rvecComponents)
{
    size_t nPos = rssInput.find('+');
    rpath = std::filesystem::u8path(rssInput.substr(0, nPos));
    while (nPos != std::string::npos)
    {
        size_t nNextPos = rssInput.find_first_of("+,", nPos + 1);
        std::string ss = rssInput.substr(nPos + 1, nNextPos - nPos - 1);
        if (!ss.empty())
        {
            // Check for an assignment.
            size_t nAssignment = ss.find_first_of('=');
            std::string ssClassName = ss.substr(0, nAssignment);
            std::string ssName;
            if (nAssignment != std::string::npos)
                ssName = ss.substr(nAssignment + 1);
            if (!ssClassName.empty())
                rvecComponents.push_back(std::make_pair(std::move(ssClassName), std::move(ssName)));
        }
        nPos = nNextPos;
    }
}

bool CSdvPackagerEnvironment::ProcessCommandLine(const std::vector<std::string>& rvecCommands)
{
    // Make upper case string
    auto fnMakeUpper = [](const std::string& rss)
    {
        std::string rssTemp;
        rssTemp.reserve(rss.size());
        for (char c : rss)
            rssTemp += static_cast<char>(std::toupper(c));
        return rssTemp;
    };

    // Process the first command...
    size_t nOptionGroup = 0;
    if (rvecCommands.empty())
    {
        m_eOperatingMode = EOperatingMode::none;
    }
    else if (iequals(rvecCommands[0], "PACK"))
    {
        m_eOperatingMode = EOperatingMode::pack;
        nOptionGroup = 1;
    }
    else if (iequals(rvecCommands[0], "INSTALL"))
    {
        m_eOperatingMode = EOperatingMode::install;
        nOptionGroup = 2;
    }
    else if (iequals(rvecCommands[0], "DIRECT_INSTALL"))
    {
        m_eOperatingMode = EOperatingMode::direct_install;
        nOptionGroup = 3;
    }
    else if (iequals(rvecCommands[0], "CONFIGURE"))
    {
        m_eOperatingMode = EOperatingMode::configure;
        nOptionGroup = 4;
    }
    else if (iequals(rvecCommands[0], "UNINSTALL"))
    {
        m_eOperatingMode = EOperatingMode::uninstall;
        nOptionGroup = 5;
    }
    else if (iequals(rvecCommands[0], "VERIFY"))
    {
        m_eOperatingMode = EOperatingMode::verify;
        nOptionGroup = 6;
    }
    else if (iequals(rvecCommands[0], "SHOW"))
    {
        m_eOperatingMode = EOperatingMode::show;
        nOptionGroup = 7;
    }
    else
    {
        m_nError = CMDLN_ARG_ERR;
        m_ssArgError = "Invalid command \"" + rvecCommands[0] + "\" supplied at the command line.";
        return false;
    }
    size_t nCommandPos = 1; // Start iteration at the second command argument

    // Help requested? Do not continue parsing
    if (m_bHelp)
        return false;

    // Check for silent and verbose flags.
    if (m_bSilent && m_bVerbose)
    {
        m_nError = CMDLN_SILENT_VERBOSE;
        m_ssArgError = CMDLN_SILENT_VERBOSE_MSG;
        return false;
    }

    // Get the installation name
    auto fnGetInstallName = [rvecCommands, &nCommandPos, this]() -> bool
    {
        // Expecting the installation name
        if (nCommandPos >= rvecCommands.size())
        {
            m_nError = CMDLN_INSTALL_NAME_MISSING;
            m_ssArgError = CMDLN_INSTALL_NAME_MISSING_MSG;
            return false;
        }
        m_ssInstallName = rvecCommands[nCommandPos];
        nCommandPos++;
        return true;
    };

    // Get the modules to pack/install
    auto fnGetModules = [rvecCommands, &nCommandPos, this]() -> bool
    {
        // Expecting at least one source
        if (nCommandPos >= rvecCommands.size())
        {
            m_nError = CMDLN_SOURCE_FILE_MISSING;
            m_ssArgError = CMDLN_SOURCE_FILE_MISSING_MSG;
            return false;
        }
        for (;nCommandPos < rvecCommands.size(); nCommandPos++)
        {
            const std::string& rssCommand = rvecCommands[nCommandPos];
            size_t nPos = rssCommand.find('=');
            SModule sModule;
            sModule.ssSearchString = rssCommand.substr(0, nPos);
            if (nPos != std::string::npos)
                sModule.pathRelTarget = std::filesystem::u8path(rssCommand.substr(nPos + 1));
            m_vecModules.push_back(std::move(sModule));
        }
        return true;
    };

    // Get the configuration files to merge into an existing configuration.
    auto fnGetConfigFiles = [rvecCommands, &nCommandPos, this]() -> bool
    {
        // Expecting at least one source
        if (nCommandPos >= rvecCommands.size())
        {
            m_nError = CMDLN_SOURCE_FILE_MISSING;
            m_ssArgError = CMDLN_SOURCE_FILE_MISSING_MSG;
            return false;
        }
        for (;nCommandPos < rvecCommands.size(); nCommandPos++)
            m_vecConfigFiles.push_back(rvecCommands[nCommandPos]);
        return true;
    };

    // Cneck for no more commands
    auto fnCheckForNoMoreCommands = [rvecCommands, &nCommandPos, this]() -> bool
    {
        if (nCommandPos != rvecCommands.size())
        {
            m_nError = CMDLN_TOO_MANY_SOURCE_FILES;
            m_ssArgError = CMDLN_TOO_MANY_SOURCE_FILES_MSG;
            return false;
        }

        return true;
    };

    // Get exactly one installation package
    auto fnGetPackage = [rvecCommands, &nCommandPos, this]() -> bool
    {
        // Expecting exactly one installation package
        if (nCommandPos >= rvecCommands.size())
        {
            m_nError = CMDLN_SOURCE_FILE_MISSING;
            m_ssArgError = CMDLN_SOURCE_FILE_MISSING_MSG;
            return false;
        }
        m_pathPackage = std::filesystem::u8path(rvecCommands[nCommandPos]);
        nCommandPos++;

        // Check for the correct ending and its existence
        if (m_pathPackage.extension() != ".sdv_package" || !std::filesystem::exists(m_pathPackage)
            || !std::filesystem::is_regular_file(m_pathPackage))
        {
            m_nError = CMDLN_SOURCE_FILE_ERROR;
            m_ssArgError = CMDLN_SOURCE_FILE_ERROR_MSG;
            return false;
        }

        // Any commands left... then too many source files were supplied
        if (nCommandPos != rvecCommands.size())
        {
            m_nError = CMDLN_TOO_MANY_SOURCE_FILES;
            m_ssArgError = CMDLN_TOO_MANY_SOURCE_FILES_MSG;
        }

        return true;
    };

    // Check the source location
    auto fnCheckSourceLocation = [this]() -> bool
    {
        // Check for the source location
        if (m_pathSourceLocation.empty())
            m_pathSourceLocation = std::filesystem::current_path();
        if (!std::filesystem::is_directory(m_pathSourceLocation))
        {
            m_nError = CMDLN_SOURCE_LOCATION_ERROR;
            m_ssArgError =
                std::string(CMDLN_SOURCE_LOCATION_ERROR_MSG) + "\n  Source location: " + m_pathSourceLocation.generic_u8string();
            return false;
        }
        return true;
    };

    // Check the output location
    auto fnCheckOutputLocation = [this]() -> bool
    {
        // Check for the output location (and create directory if needed)
        if (m_pathOutputLocation.empty())
            m_pathOutputLocation = std::filesystem::current_path();
        try
        {
            if (!std::filesystem::is_directory(m_pathOutputLocation))
                std::filesystem::create_directories(m_pathOutputLocation);
            if (!std::filesystem::is_directory(m_pathOutputLocation))
            {
                m_nError = CMDLN_OUTPUT_LOCATION_ERROR;
                m_ssArgError = std::string(CMDLN_OUTPUT_LOCATION_ERROR_MSG)
                               + "\n  Output location: " + m_pathOutputLocation.generic_u8string();
                return false;
            }
        }
        catch (const std::filesystem::filesystem_error&)
        {
            m_nError = CMDLN_OUTPUT_LOCATION_ERROR;
            m_ssArgError =
                std::string(CMDLN_OUTPUT_LOCATION_ERROR_MSG) + "\n  Output location: " + m_pathOutputLocation.generic_u8string();
            return false;
        }
        return true;
    };

    // Check the target location
    auto fnCheckTargetLocation = [this]() -> bool
    {
        // Check for the target location (and create directory if needed)
        try
        {
            // If not locally, get the target from the environment variable
            if (!m_bLocal && m_pathTargetLocation.empty())
            {
#ifdef _WIN32
                const wchar_t* szInstallDir = _wgetenv(L"SDV_COMPONENT_INSTALL");
                if (szInstallDir) m_pathTargetLocation = szInstallDir;
#elif defined __unix__
                const char* szInstallDir = getenv("SDV_COMPONENT_INSTALL");
                if (szInstallDir) m_pathTargetLocation = std::filesystem::u8path(szInstallDir);
#else
    #error OS not supported!
#endif
            }

            // Is the directory existing? If not, create the directory
            if (!m_pathTargetLocation.empty() && !std::filesystem::is_directory(m_pathTargetLocation))
                std::filesystem::create_directories(m_pathTargetLocation);

            // The directory should exist; otherwise error.
            if (m_pathTargetLocation.empty() || !std::filesystem::is_directory(m_pathTargetLocation))
            {
                m_nError = CMDLN_TARGET_LOCATION_ERROR;
                m_ssArgError = std::string(CMDLN_TARGET_LOCATION_ERROR_MSG) + "\n  Target location: " +
                    m_pathTargetLocation.generic_u8string();
                return false;
            }

            // Make the directory absolute...
            m_pathTargetLocation = std::filesystem::absolute(m_pathTargetLocation);
        }
        catch (const std::filesystem::filesystem_error&)
        {
            m_nError = CMDLN_TARGET_LOCATION_ERROR;
            m_ssArgError =
                std::string(CMDLN_TARGET_LOCATION_ERROR_MSG) + "\n  Target location: " + m_pathTargetLocation.generic_u8string();
            return false;
        }
        return true;
    };

    // Get product
    auto fnGetProduct = [this]()
    {
        if (m_ssProductName.empty())
            m_ssProductName = m_ssInstallName;
    };

    // Check configuration targets
    auto fnConfigTargets = [this]() -> bool
    {
        if (m_bLocal && (m_bInsertIntoPlatformConfig || m_bInsertIntoUserConfig || m_bInsertIntoVehAbstrConfig ||
        m_bInsertIntoVehIfcConfig))
        {
            m_nError = CMDLN_INCOMPATIBLE_ARGUMENTS;
            m_ssArgError = CMDLN_INCOMPATIBLE_ARGUMENTS_MSG;
            return false;
        }
        if (m_bLocal && m_pathConfigLocal.empty())
        {
            m_nError = CMDLN_MISSING_TARGET;
            m_ssArgError = CMDLN_MISSING_TARGET_MSG;
            return false;
        }
        if (!m_bLocal && !m_pathConfigLocal.empty())
        {
            m_nError = CMDLN_INCOMPATIBLE_ARGUMENTS;
            m_ssArgError = CMDLN_INCOMPATIBLE_ARGUMENTS_MSG;
            return false;
        }
        size_t nCntServerConfigs = 0;
        if (m_bInsertIntoPlatformConfig) ++nCntServerConfigs;
        if (m_bInsertIntoUserConfig) ++nCntServerConfigs;
        if (m_bInsertIntoVehAbstrConfig) ++nCntServerConfigs;
        if (m_bInsertIntoVehIfcConfig) ++nCntServerConfigs;
        if (!m_bLocal && !nCntServerConfigs)
        {
            m_nError = CMDLN_MISSING_TARGET;
            m_ssArgError = CMDLN_MISSING_TARGET_MSG;
            return false;
        }
        if (!m_bLocal && nCntServerConfigs > 1)
        {
            m_nError = CMDLN_TOO_MANY_CONFIG_TARGETS;
            m_ssArgError = CMDLN_TOO_MANY_CONFIG_TARGETS_MSG;
            return false;
        }
        return true;
    };

    // Following the initial command, several additional information must be supplied.
    switch (m_eOperatingMode)
    {
    case EOperatingMode::pack:
        if (!fnGetInstallName()) return false;
        if (!fnGetModules()) return false;
        if (!fnCheckSourceLocation()) return false;
        if (!fnCheckOutputLocation()) return false;
        fnGetProduct();
        if (m_pathOutputLocation.empty())
            m_pathPackage = std::filesystem::u8path(m_ssInstallName + ".sdv_package");
        else
            m_pathPackage = m_pathOutputLocation / std::filesystem::u8path(m_ssInstallName + ".sdv_package");
        break;
    case EOperatingMode::install:
        if (!fnGetPackage()) return false;
        if (!fnCheckForNoMoreCommands()) return false;
        if (!fnCheckTargetLocation()) return false;
        break;
    case EOperatingMode::direct_install:
        if (!fnGetInstallName()) return false;
        if (!fnGetModules()) return false;
        if (!fnCheckSourceLocation()) return false;
        if (!fnCheckTargetLocation()) return false;
        fnGetProduct();
        break;
    case EOperatingMode::configure:
        if (!fnGetConfigFiles()) return false;
        if (!fnConfigTargets()) return false;
        break;
    case EOperatingMode::uninstall:
        if (!fnGetInstallName()) return false;
        if (!fnCheckForNoMoreCommands()) return false;
        if (!fnCheckTargetLocation()) return false;
        break;
    case EOperatingMode::verify:
        if (!fnGetPackage()) return false;
        if (!fnCheckForNoMoreCommands()) return false;
        break;
    case EOperatingMode::show:
        // Expecting one or more show commands followed by one installation package
        while (nCommandPos != rvecCommands.size())
        {
            if (!m_vecModules.empty())
            {
                m_nError = CMDLN_TOO_MANY_SOURCE_FILES;
                m_ssArgError = CMDLN_TOO_MANY_SOURCE_FILES_MSG;
                return false;
            }
            if (iequals(rvecCommands[nCommandPos], "ALL"))
            {
                m_uiShowFlags |= static_cast<uint32_t>(EShowMask::all);
                nCommandPos++;
            }
            else if (iequals(rvecCommands[nCommandPos], "INFO"))
            {
                m_uiShowFlags |= static_cast<uint32_t>(EShowMask::info);
                nCommandPos++;
            }
            else if (iequals(rvecCommands[nCommandPos], "MODULES"))
            {
                m_uiShowFlags |= static_cast<uint32_t>(EShowMask::modules);
                nCommandPos++;
            }
            else if (iequals(rvecCommands[nCommandPos], "COMPONENTS"))
            {
                m_uiShowFlags |= static_cast<uint32_t>(EShowMask::components);
                nCommandPos++;
            }
            else
            {
                // Check whether preceded by at least one command
                if (!(m_uiShowFlags & 0x00ff))
                {
                    m_nError = CMDLN_MISSING_SHOW_COMMAND;
                    m_ssArgError = CMDLN_MISSING_SHOW_COMMAND_MSG;
                    return false;
                }
                if (!fnGetPackage())
                    return false;
            }
        }
        if (m_pathPackage.empty())
        {
            m_nError = CMDLN_SOURCE_FILE_MISSING;
            m_ssArgError = CMDLN_SOURCE_FILE_MISSING_MSG;
            return false;
        }
        break;
    default:
        break;
    }

    // Check for incompatible options
    auto vecIncompatibleOptions = m_cmdln.IncompatibleArguments(nOptionGroup, false);
    if (!vecIncompatibleOptions.empty() && m_eOperatingMode != EOperatingMode::none)
    {
        m_nError = CMDLN_INCOMPATIBLE_ARGUMENTS;
        m_ssArgError = std::string("The option '" + vecIncompatibleOptions[0] + "' cannot be used with the " +
            fnMakeUpper(rvecCommands[0]) + " command.");
        return false;
    }

    // Assign root and installation locations
    m_pathRootLocation = m_pathTargetLocation;
    if (!m_bLocal)
        m_pathRootLocation /= std::to_string(m_uiInstanceID);
    m_pathInstallLocation = m_pathRootLocation;

    return true;
}