conduit 0.6.0
Modern C++23 header-only event-dispatching / event-transport library
Loading...
Searching...
No Matches
transport.hpp
Go to the documentation of this file.
1#pragma once
2
5
6#include <conduit/bus.hpp>
11#include <conduit/transport.hpp>
12
13#include <chrono>
14#include <cstdint>
15#include <memory>
16#include <optional>
17#include <string>
18
19namespace conduit::redis {
20
23public:
24 using conduit::TransportError::TransportError;
25};
26
28enum class Format : std::uint8_t { Json, Cbor };
29
30struct TlsConfig {
31 std::string ca_file;
32 std::optional<std::string> cert_file;
33 std::optional<std::string> key_file;
34 bool verify_peer = true;
35};
36
37struct Config {
38 std::string url; // "tcp://host:6379" or "tls://host:6380"
39 std::optional<std::string> username; // ACL user (Redis 6+)
40 std::optional<std::string> password;
41 std::optional<int> db; // SELECT after AUTH; default 0
42 std::optional<TlsConfig> tls;
43
44 std::chrono::seconds connect_timeout{10};
45
50 std::string channel = "conduit:envelope";
51
54};
55
67public:
68 explicit Transport(Config config, std::shared_ptr<EventRegistry> registry = {});
69
70 Transport(const Transport&) = delete;
71 Transport& operator=(const Transport&) = delete;
72 Transport(Transport&&) = delete;
74
75 ~Transport() override;
76
77 [[nodiscard]] TransportScope scope() const noexcept override {
79 }
80
81 void attach_with_sink(Bus& bus, InboundSink sink) override;
82 void detach() noexcept override;
83
84 void dispatch(const EventEnvelopeView& v) override;
85 void flush() override;
86
87 [[nodiscard]] bool is_connected() const noexcept;
88
89private:
90 struct Impl;
91 std::unique_ptr<Impl> impl_;
92};
93
94} // namespace conduit::redis
Bus — owns transports, middleware, listeners; dispatches envelopes.
Definition bus.hpp:58
Polymorphic envelope cell.
Definition envelope.hpp:62
Operational/runtime failure inside a transport adapter (connect, subscribe, publish,...
Definition exception.hpp:48
Definition transport.hpp:30
Bus * bus() const noexcept
Definition transport.hpp:68
Operational/runtime failure inside the Redis transport adapter.
Definition transport.hpp:22
Redis pub/sub pipe — one instance binds to a single channel and carries traffic in both directions: o...
Definition transport.hpp:66
void detach() noexcept override
Transport(Config config, std::shared_ptr< EventRegistry > registry={})
void dispatch(const EventEnvelopeView &v) override
Transport & operator=(const Transport &)=delete
bool is_connected() const noexcept
Transport(const Transport &)=delete
Transport(Transport &&)=delete
TransportScope scope() const noexcept override
Definition transport.hpp:77
Transport & operator=(Transport &&)=delete
void attach_with_sink(Bus &bus, InboundSink sink) override
Attach to a bus using a caller-supplied inbound sink.
EventEnvelope — a parcel cell carrying conduit's envelope metadata plus a polymorphic payload cell.
Root exception hierarchy for the conduit library.
Transport interface and the local/remote scope enum used for flag-based filtering.
Listener / Subscription / Subscriber primitives.
Definition transport.hpp:19
Format
Wire format used for encoded envelopes.
Definition transport.hpp:28
std::function< void(const EventEnvelopeView &)> InboundSink
Callable installed on a Transport at attach time that receives inbound envelopes the transport pulled...
Definition transport.hpp:28
TransportScope
Distinguishes in-process transports from off-machine ones.
Definition transport.hpp:21
Thin EventRegistry wrapper around parcel::ParcelRegistry, plus envelope encode/decode helpers for JSO...
Definition transport.hpp:37
std::string url
Definition transport.hpp:38
std::chrono::seconds connect_timeout
Definition transport.hpp:44
std::string channel
Channel this transport binds to (PUBLISH and SUBSCRIBE both target it).
Definition transport.hpp:50
std::optional< int > db
Definition transport.hpp:41
std::optional< std::string > username
Definition transport.hpp:39
std::optional< std::string > password
Definition transport.hpp:40
std::optional< TlsConfig > tls
Definition transport.hpp:42
Format format
Wire format used for both outbound publishes and inbound decoding.
Definition transport.hpp:53
Definition transport.hpp:30
std::optional< std::string > key_file
Definition transport.hpp:33
std::optional< std::string > cert_file
Definition transport.hpp:32
std::string ca_file
Definition transport.hpp:31
bool verify_peer
Definition transport.hpp:34