1cd9b93a22
- point to main Calamares site in the 'part of' headers instead of to github (this is the "this file is part of Calamares" opening line for most files). - remove boilerplate from all source files, CMake modules and completions, this is the 3-paragraph summary of the GPL-3.0-or-later, which has a meaning entirely covered by the SPDX tag.
98 lines
2.5 KiB
C++
98 lines
2.5 KiB
C++
/* === This file is part of Calamares - <https://calamares.io> ===
|
|
*
|
|
* SPDX-FileCopyrightText: 2014-2015 Teo Mrnjavac <teo@kde.org>
|
|
* SPDX-FileCopyrightText: 2018-2019 Adriaan de Groot <groot@kde.org>
|
|
* SPDX-License-Identifier: GPL-3.0-or-later
|
|
*
|
|
* Calamares is Free Software: see the License-Identifier above.
|
|
*
|
|
*
|
|
*/
|
|
#ifndef MODULESYSTEM_INSTANCEKEY_H
|
|
#define MODULESYSTEM_INSTANCEKEY_H
|
|
|
|
#include <QDebug>
|
|
#include <QList>
|
|
#include <QPair>
|
|
#include <QString>
|
|
|
|
namespace Calamares
|
|
{
|
|
namespace ModuleSystem
|
|
{
|
|
|
|
/** @brief A module instance's key (`module@id`)
|
|
*
|
|
* A module instance is identified by both the module's name
|
|
* (a Calamares module, e.g. `users`) and an instance id.
|
|
* Usually, the instance id is the same as the module name
|
|
* and the whole module instance key is `users@users`, but
|
|
* it is possible to use the same module more than once
|
|
* and then you distinguish those module instances by their
|
|
* secondary id (e.g. `users@one`).
|
|
*
|
|
* This is supported by the *instances* configuration entry
|
|
* in `settings.conf`.
|
|
*/
|
|
class InstanceKey : public QPair< QString, QString >
|
|
{
|
|
public:
|
|
/// @brief Create an instance key from explicit module and id.
|
|
InstanceKey( const QString& module, const QString& id )
|
|
: QPair( module, id )
|
|
{
|
|
if ( second.isEmpty() )
|
|
{
|
|
second = first;
|
|
}
|
|
validate();
|
|
}
|
|
|
|
/// @brief Create unusual, invalid instance key
|
|
InstanceKey()
|
|
: QPair( QString(), QString() )
|
|
{
|
|
}
|
|
|
|
/// @brief A valid module has both name and id
|
|
bool isValid() const { return !first.isEmpty() && !second.isEmpty(); }
|
|
|
|
/// @brief A custom module has a non-default id
|
|
bool isCustom() const { return first != second; }
|
|
|
|
QString module() const { return first; }
|
|
QString id() const { return second; }
|
|
|
|
/// @brief Create instance key from stringified version
|
|
static InstanceKey fromString( const QString& s );
|
|
|
|
QString toString() const
|
|
{
|
|
if ( isValid() )
|
|
{
|
|
return first + '@' + second;
|
|
}
|
|
return QString();
|
|
}
|
|
|
|
private:
|
|
/** @brief Check validity and reset module and id if needed. */
|
|
void validate()
|
|
{
|
|
if ( first.contains( '@' ) || second.contains( '@' ) )
|
|
{
|
|
first = QString();
|
|
second = QString();
|
|
}
|
|
}
|
|
};
|
|
|
|
using InstanceKeyList = QList< InstanceKey >;
|
|
|
|
QDebug& operator<<( QDebug& s, const Calamares::ModuleSystem::InstanceKey& i );
|
|
|
|
} // namespace ModuleSystem
|
|
} // namespace Calamares
|
|
|
|
#endif
|