File indexing completed on 2024-12-08 09:42:56

 /*
     SPDX-FileCopyrightText: 2010 Ryan Rix <ry@n.rix.si>
 
     SPDX-License-Identifier: LGPL-2.0-or-later
 */
 
 #ifndef KPACKAGE_LOADER_H
 #define KPACKAGE_LOADER_H
 
 #include <kpackage/package.h>
 
 #include <kpackage/package_export.h>
 
 namespace KPackage
 {
 class PackageLoaderPrivate;
 
 /**
  * @class PackageLoader kpackage/packageloader.h <KPackage/PackageLoader>
  *
  * This is an abstract base class which defines an interface to which the package
  * loading logic can communicate with a parent application. The plugin loader
  * must be set before any plugins are loaded, otherwise (for safety reasons), the
  * default PackageLoader implementation will be used. The reimplemented version should
  * not do more than simply returning a loaded plugin. It should not init() it, and it should not
  * hang on to it.
  *
  * @author Ryan Rix <ry@n.rix.si>
  **/
 class KPACKAGE_EXPORT PackageLoader
 {
 public:
     /**
      * Load a Package plugin.
      *
      * @param packageFormat the format of the package to load
      * @param packagePath the package name: the path of the package relative to the
      *        packageFormat root path. If not specified it will have to be set manually
      *        with Package::setPath() by the caller.
      *
      * @return a Package object matching name, or an invalid package on failure
      **/
     Package loadPackage(const QString &packageFormat, const QString &packagePath = QString());
 
     /**
      * List all available packages of a certain type
      *
      * @param packageFormat the format of the packages to list
      * @param packageRoot the root folder where the packages are installed.
      *          If not specified the default from the packageformat will be taken.
      *
      * @return metadata for all the matching packages
      */
     QList<KPluginMetaData> listPackages(const QString &packageFormat, const QString &packageRoot = QString());
 
     /**
      * List package of a certain type that match a certain filter function
      *
      * @param packageFormat the format of the packages to list
      * @param packageRoot the root folder where the packages are installed.
      *          If not specified the default from the packageformat will be taken.
      * @param filter a filter function that will be called on each package:
      *          will return true for the matching ones
      *
      * @return metadata for all the matching packages
      * @since 5.10
      */
     QList<KPluginMetaData> findPackages(const QString &packageFormat,
                                         const QString &packageRoot = QString(),
                                         std::function<bool(const KPluginMetaData &)> filter = std::function<bool(const KPluginMetaData &)>());
 
     /**
      * Loads a PackageStructure for a given format. The structure can then be used as
      * paramenter for a Package instance constructor
      *
      * @note The returned pointer is managed by KPackage, and should never be deleted
      *
      * @param packageFormat the package format, such as "KPackage/GenericQML"
      * @return the structure instance (ownership retained by KPackage)
      */
     KPackage::PackageStructure *loadPackageStructure(const QString &packageFormat);
 
     /**
      * Adds a new known package structure that can be used by the functions to load packages such
      * as loadPackage, findPackages etc
      * @param packageFormat the package format, such as "KPackage/GenericQML"
      * @param structure the package structure we want to be able to load packages from
      * @since 5.10
      */
     void addKnownPackageStructure(const QString &packageFormat, KPackage::PackageStructure *structure);
 
 #if KPACKAGE_BUILD_DEPRECATED_SINCE(5, 86)
     /**
      * Set the plugin loader which will be queried for all loads.
      *
      * @param loader A subclass of PackageLoader which will be supplied
      * by the application
      * @deprecated Since 5.86, deprecated for lack of usage. Use default package loader instead
      **/
     KPACKAGE_DEPRECATED_VERSION(5, 86, "deprecated for lack of usage. Use default package loader instead")
     static void setPackageLoader(PackageLoader *loader);
 #endif
 
     /**
      * Return the active plugin loader
      **/
     static PackageLoader *self();
 
 protected:
 #if KPACKAGE_BUILD_DEPRECATED_SINCE(5, 86)
     /**
      * A re-implementable method that allows subclasses to override
      * the default behaviour of loadPackage. If the service requested is not recognized,
      * then the implementation should return an empty and invalid Package().
      * This method is called
      * by loadPackage prior to attempting to load a Package using the standard
      * plugin mechanisms.
      *
      * @param packageFormat the format of the package to load
      *
      * @return a Package instance with the proper PackageStructure
      * @deprecated Since 5.86, deprecated for lack of usage. Use default package loading instead
      **/
     KPACKAGE_DEPRECATED_VERSION(5, 86, "deprecated for lack of usage. Use default package loading instead")
     virtual Package internalLoadPackage(const QString &packageFormat);
 #endif
 
     PackageLoader();
     virtual ~PackageLoader();
 
 private:
     friend class Package;
     PackageLoaderPrivate *const d;
     Q_DISABLE_COPY(PackageLoader)
 };
 
 }
 
 Q_DECLARE_METATYPE(KPackage::PackageLoader *)
 
 #endif