JANA/Services/JWiringService.h

0001 // Copyright 2024, Jefferson Science Associates, LLC.
0002 // Subject to the terms in the LICENSE file found in the top-level directory.
0003 // Created by Nathan Brei
0004
0005 #pragma once
0006 #include <JANA/JService.h>
0007 #include <toml.hpp>
0008 #include <string>
0009 #include <map>
0010 #include <vector>
0011 #include <memory>
0012
0013 namespace jana::services {
0014
0015
0016 class JWiringService : public JService {
0017
0018 public:
0019     struct Wiring {
0020         std::string plugin_name;
0021         std::string type_name;
0022         std::string prefix;
0023         JEventLevel level = JEventLevel::None;
0024         std::vector<std::string> input_names;
0025         std::vector<JEventLevel> input_levels;
0026         std::vector<std::string> output_names;
0027         std::vector<JEventLevel> output_levels;
0028         std::map<std::string, std::string> configs;
0029     };
0030
0031 private:
0032     Parameter<std::string> m_wirings_input_file {this, "jana:wiring_file", "",
0033         "Path to TOML file containing wiring definitions"};
0034
0035     Parameter<bool> m_strict_inheritance {this, "jana:wiring_strictness", true,
0036         "Allow multiple definitions inside wiring files"};
0037
0038     std::vector<std::unique_ptr<Wiring>> m_wirings;
0039     std::map<std::string, Wiring*> m_wirings_from_prefix;
0040     std::map<std::pair<std::string,std::string>, std::vector<Wiring*>> m_wirings_from_type_and_plugin_names;
0041     std::vector<Wiring*> m_no_wirings;
0042     std::map<std::string, std::string> m_shared_parameters;
0043
0044 public:
0045     void Init() override;
0046
0047     void AddWirings(std::vector<std::unique_ptr<Wiring>>& wirings, const std::string& source);
0048     void AddWirings(const toml::table& table, const std::string& source);
0049     void AddWiringFile(const std::string& filename);
0050
0051     void AddSharedParameters(const toml::table& table, const std::string& source);
0052     const std::map<std::string, std::string>& GetSharedParameters() const;
0053
0054     const Wiring*
0055     GetWiring(const std::string& prefix) const;
0056
0057     const std::vector<Wiring*>&
0058     GetWirings(const std::string& plugin_name, const std::string& type_name) const;
0059
0060     const std::vector<std::unique_ptr<Wiring>>&
0061     GetWirings() const { return m_wirings; }
0062
0063     static void Overlay(Wiring& above, const Wiring& below);
0064 };
0065
0066 } // namespace jana::services
0067