ToolHandler.h

Go to the documentation of this file.

// Copyright (c) 2002-present, OpenMS Inc. -- EKU Tuebingen, ETH Zurich, and FU Berlin
// SPDX-License-Identifier: BSD-3-Clause
//
// --------------------------------------------------------------------------
// $Maintainer: Chris Bielow $
// $Authors: Chris Bielow $
// --------------------------------------------------------------------------
 
#pragma once
 
#include <OpenMS/DATASTRUCTURES/ToolDescription.h>
#include <OpenMS/DATASTRUCTURES/String.h>
 
#include <map>
 
#include <QtCore/qcontainerfwd.h> // for QStringList
 
 
namespace OpenMS
{
  /*
    internal details & discussion:
 
    We could create the list of TOPP tools from a set of files in /share
    instead of hard coding them here.
    Advantage: - no recompile if new tool is added (but the new tool will necessitate that anyway)
               - quickly changing a tool's category (e.g. from PreProcessing to Quantitation) and thus its place in TOPPAS
                   even users could rearrange tools themselves...
    Disadvantage:
               - when to library loads, we'd need to parse all the files. Making our start-up time even longer...
               - when files are broken/missing, we will have a hard time initializing the lib
  */
 
  typedef std::map<String, Internal::ToolDescription> ToolListType;
 
  class OPENMS_DLLAPI ToolHandler
  {
public:
 
    static ToolListType getTOPPToolList(const bool includeGenericWrapper = false);
 
    static StringList getTypes(const String& toolname);
 
    static String getCategory(const String& toolname);
 
    static String getExternalToolsPath();
 
    static String getInternalToolsPath();
 
private:
 
    static Internal::ToolDescription getExternalTools_();
    static QStringList getExternalToolConfigFiles_();
    static void loadExternalToolConfig_();
    static Internal::ToolDescription tools_external_;
    static bool tools_external_loaded_;
 
    static std::vector<Internal::ToolDescription> getInternalTools_();
    static QStringList getInternalToolConfigFiles_();
    static void loadInternalToolConfig_();
    static std::vector<Internal::ToolDescription> tools_internal_;
    static bool tools_internal_loaded_;
  };
 
} // namespace OpenMS