testlib

Documentation

Overview

Package testlib contains utility methods to include in unit tests to deal with topology common tasks, liek fake tablets and action loops.

Index

• type FakeTablet
  • func NewFakeTablet(t *testing.T, wr *wrangler.Wrangler, cell string, uid uint32, ...) *FakeTablet
  • func (ft *FakeTablet) StartActionLoop(t *testing.T, wr *wrangler.Wrangler)
  • func (ft *FakeTablet) StopActionLoop(t *testing.T)
• type TabletOption
  • func TabletKeyspaceShard(t *testing.T, keyspace, shard string) TabletOption
  • func TabletParent(parent topo.TabletAlias) TabletOption

Types

type FakeTablet

type FakeTablet struct {
	// Tablet and FakeMysqlDaemon are populated at NewFakeTablet time.
	Tablet          *topo.Tablet
	FakeMysqlDaemon *mysqlctl.FakeMysqlDaemon

	// Agent and Listener are created when we start the event loop for
	// the tablet, and closed / cleared when we stop it.
	Agent    *tabletmanager.ActionAgent
	Listener net.Listener
}

FakeTablet keeps track of a fake tablet in memory. It has: - a Tablet record (used for creating the tablet, kept for user's information) - a FakeMysqlDaemon (used by the fake event loop) - a 'done' channel (used to terminate the fake event loop)

func NewFakeTablet

func NewFakeTablet(t *testing.T, wr *wrangler.Wrangler, cell string, uid uint32, tabletType topo.TabletType, options ...TabletOption) *FakeTablet

CreateTestTablet creates the test tablet in the topology. 'uid' has to be between 0 and 99. All the tablet info will be derived from that. Look at the implementation if you need values. Use TabletOption implementations if you need to change values at creation.

func (*FakeTablet) StartActionLoop

func (ft *FakeTablet) StartActionLoop(t *testing.T, wr *wrangler.Wrangler)

StartActionLoop will start the action loop for a fake tablet, using ft.FakeMysqlDaemon as the backing mysqld.

func (*FakeTablet) StopActionLoop

func (ft *FakeTablet) StopActionLoop(t *testing.T)

StopActionLoop will stop the Action Loop for the given FakeTablet

type TabletOption

type TabletOption func(tablet *topo.Tablet)

TabletOption is an interface for changing tablet parameters. It's a way to pass multiple parameters to NewFakeTablet without making it too cumbersome.

func TabletKeyspaceShard

func TabletKeyspaceShard(t *testing.T, keyspace, shard string) TabletOption

TabletKeyspaceShard is the option to set the tablet keyspace and shard

func TabletParent

func TabletParent(parent topo.TabletAlias) TabletOption

TabletParent is the tablet option to set the parent alias