testutil

Documentation

Overview

Package testutil provides helpers for starting the kcd daemon in tests.

Package testutil provides a mock KDE Connect peer for integration tests.

Index

• func StartTestDaemon(t *testing.T, cfg *config.Config) (context.CancelFunc, *client.Client)
• type MockPeer
  • func NewMockPeer(t *testing.T, tlsConfig *tls.Config) *MockPeer
  • func (p *MockPeer) Dial(serverAddr string) net.Conn
  • func (p *MockPeer) DialPipe() (peerConn net.Conn, serverConn net.Conn)
  • func (p *MockPeer) ReadPacket(conn net.Conn) (*protocol.Packet, error)
  • func (p *MockPeer) SendPacket(conn net.Conn, pkt *protocol.Packet) error

Functions

func StartTestDaemon

func StartTestDaemon(t *testing.T, cfg *config.Config) (context.CancelFunc, *client.Client)

StartTestDaemon starts a kcd daemon in a goroutine with a cancellable context and waits up to 3 seconds for its IPC socket to be ready. It returns a cancel function (to stop the daemon) and a pre-connected client.

Types

type MockPeer

type MockPeer struct {
	// contains filtered or unexported fields
}

MockPeer simulates a remote KDE Connect device.

func NewMockPeer

func NewMockPeer(t *testing.T, tlsConfig *tls.Config) *MockPeer

NewMockPeer creates a new MockPeer.

func (*MockPeer) Dial

func (p *MockPeer) Dial(serverAddr string) net.Conn

Dial connects to the given TCP address, completes the plaintext identity exchange, then upgrades to TLS as the TLS server (KDE Connect rule: the TCP initiator acts as TLS server).

func (*MockPeer) DialPipe

func (p *MockPeer) DialPipe() (peerConn net.Conn, serverConn net.Conn)

DialPipe creates an in-process net.Pipe pair, performs the identity exchange on the given server-side connection (serverConn), and returns the peer-side conn ready for SendPacket/ReadPacket. The caller is responsible for handling serverConn in a goroutine.

func (*MockPeer) ReadPacket

func (p *MockPeer) ReadPacket(conn net.Conn) (*protocol.Packet, error)

ReadPacket reads one newline-delimited JSON packet from conn.

func (*MockPeer) SendPacket

func (p *MockPeer) SendPacket(conn net.Conn, pkt *protocol.Packet) error

SendPacket writes a packet as newline-delimited JSON on conn.