ConfigurationDescriptions.h

Go to the documentation of this file.

#ifndef FWCore_ParameterSet_ConfigurationDescriptions_h
#define FWCore_ParameterSet_ConfigurationDescriptions_h
// -*- C++ -*-
//
// Package:     ParameterSet
// Class  :     ConfigurationDescriptions
//
//
// Original Author:  W. David Dagenhart
//         Created:  17 December 2008
//
 
#include "FWCore/ParameterSet/interface/ParameterSetDescription.h"
 
#include <vector>
#include <set>
#include <string>
#include <utility>
#include <iosfwd>
 
namespace edm {
 
  class ConfigurationDescriptions {
  public:
    typedef std::vector<std::pair<std::string, ParameterSetDescription> >::iterator iterator;
 
    //NOTE: This does not take ownership of the PreValidatorBase instance so
    // this instance must remain valid for as long as the ConfigurationDescriptions
    // is being modified
    ConfigurationDescriptions(std::string const& baseType, std::string const& pluginName);
 
    ~ConfigurationDescriptions();
 
    // ---------------------------------------------------------
    // These functions are used by module developers to create
    // a description for a module.
    // ---------------------------------------------------------
 
    std::string const& comment() const { return comment_; }
    void setComment(std::string const& value);
    void setComment(char const* value);
 
    void add(std::string const& label, ParameterSetDescription const& psetDescription);
    void add(char const* label, ParameterSetDescription const& psetDescription);
    void addWithDefaultLabel(ParameterSetDescription const& psetDescription);
 
    void addDefault(ParameterSetDescription const& psetDescription);
 
    ParameterSetDescription* defaultDescription();
    iterator begin();
    iterator end();
 
    // ---------------------------------------------------------
    // These functions use the information in the descriptions
    // ---------------------------------------------------------
 
    void validate(ParameterSet& pset, std::string const& moduleLabel) const;
 
    void writeCfis(std::set<std::string>& usedCfiFileNames) const;
 
    void print(std::ostream& os,
               std::string const& moduleLabel,
               bool brief,
               bool printOnlyLabels,
               size_t lineWidth,
               int indentation,
               int iPlugin) const;
 
    // ---------------------------------------------------------
 
  private:
    class DescriptionCounter {
    public:
      int iPlugin;
      int iSelectedModule;
      int iModule;
    };
 
    static void writeCfiForLabel(std::pair<std::string, ParameterSetDescription> const& labelAndDesc,
                                 std::string const& baseType,
                                 std::string const& pluginName,
                                 std::set<std::string>& usedCfiFileNames);
 
    void printForLabel(std::pair<std::string, ParameterSetDescription> const& labelAndDesc,
                       std::ostream& os,
                       std::string const& moduleLabel,
                       bool brief,
                       bool printOnlyLabels,
                       size_t lineWidth,
                       int indentationn,
                       DescriptionCounter& counter) const;
 
    void printForLabel(std::ostream& os,
                       std::string const& label,
                       ParameterSetDescription const& description,
                       std::string const& moduleLabel,
                       bool brief,
                       bool printOnlyLabels,
                       size_t lineWidth,
                       int indentationn,
                       DescriptionCounter& counter) const;
 
    std::string baseType_;
    std::string pluginName_;
 
    std::vector<std::pair<std::string, ParameterSetDescription> > descriptions_;
 
    ParameterSetDescription defaultDesc_;
 
    std::string comment_;
    bool defaultDescDefined_;
  };
}  // namespace edm
 
#endif