// Copyright CERN and copyright holders of ALICE O2. This software is

// distributed under the terms of the GNU General Public License v3 (GPL

// Version 3), copied verbatim in the file "COPYING".

//

// See http://alice-o2.web.cern.ch/license for full licensing information.

//

// In applying this license CERN does not waive the privileges and immunities

// granted to it by virtue of its status as an Intergovernmental Organization

// or submit itself to any jurisdiction.

#ifndef O2_FRAMEWORK_DRIVERCLIENT_H_

#define O2_FRAMEWORK_DRIVERCLIENT_H_

#include "Framework/ServiceHandle.h"

#include <string>

#include <functional>

namespace o2::framework

{

/// A service API to communicate with the driver

class DriverClient

{

public:

constexpr static ServiceKind service_kind = ServiceKind::Global;

/// Report some message to the Driver

/// @a msg the message to be sent.

/// @a size size of the message to be sent.

/// @a flush whether the message should be flushed immediately,

/// if possible.

virtual void tell(char const* msg, size_t s, bool flush = true) = 0;

void tell(std::string_view const& msg, bool flush = true)

{

tell(msg.data(), msg.size(), flush);

};

/// Act on some @a event notified by the driver

virtual void observe(const char* event, std::function<void(char const*)> callback) = 0;

/// Flush all pending events (if connected)

virtual void flushPending() = 0;

};

} // namespace o2::framework

#endif // O2_FRAMEWORK_DRIVERCLIENT_H_