Function FL_TEST_FILE

tests/fl/channels/bus_traits.cpp:22–170

#include "test.h"

FL_TEST_FILE(FL_FILEPATH) {

using namespace fl;

// Compile-time invariants — these enforce the design at the type system level.
// Failure to compile these is a Phase 1 regression.

FL_STATIC_ASSERT(static_cast<fl::u8>(fl::Bus::AUTO) == 0,
                 "Bus::AUTO must be the zero/default sentinel");
FL_STATIC_ASSERT(static_cast<fl::u8>(fl::Bus::RMT) != static_cast<fl::u8>(fl::Bus::PARLIO),
                 "Bus enum values must be distinct");
FL_STATIC_ASSERT(sizeof(fl::Bus) == 1,
                 "Bus underlying type should be u8 to keep ChannelOptions cheap");

// DefaultBus<Chipset> resolves on the host (FL_IS_STUB is set under tests).
FL_STATIC_ASSERT(fl::DefaultBus<fl::ClocklessChipset>::value == fl::Bus::STUB,
                 "Host default clockless bus should be STUB");
FL_STATIC_ASSERT(fl::DefaultBus<fl::SpiChipsetConfig>::value == fl::Bus::STUB,
                 "Host default SPI bus should be STUB");

// Capability traits: BusSupports defaults to false_type for unknown pairs and is
// true_type for the stub clockless specialization.
FL_STATIC_ASSERT(fl::BusSupports<fl::Bus::STUB, fl::ClocklessChipset>::value,
                 "Stub bus must support clockless chipsets");
FL_STATIC_ASSERT(!fl::BusSupports<fl::Bus::STUB, fl::SpiChipsetConfig>::value,
                 "Stub bus does not (yet) support SPI chipsets");
FL_STATIC_ASSERT(!fl::BusSupports<fl::Bus::RMT, fl::SpiChipsetConfig>::value,
                 "Bus values without specializations must default to false_type");

FL_TEST_CASE("BusTraits<Bus::STUB>::instance returns a stable singleton") {
    auto& a = fl::BusTraits<fl::Bus::STUB>::instance();
    auto& b = fl::BusTraits<fl::Bus::STUB>::instance();
    FL_CHECK(&a == &b);
}

FL_TEST_CASE("BusTraits<Bus::STUB>::Driver implements IChannelDriver contract") {
    using Driver = fl::BusTraits<fl::Bus::STUB>::Driver;
    fl::IChannelDriver* iface = &fl::BusTraits<fl::Bus::STUB>::instance();
    FL_REQUIRE(iface != nullptr);
    FL_CHECK(iface->getName() == fl::string::from_literal("STUB"));
    FL_CHECK(iface->getCapabilities().supportsClockless);
    FL_CHECK_FALSE(iface->getCapabilities().supportsSpi);
    // Cast back to concrete type to exercise the alias.
    Driver* concrete = static_cast<Driver*>(iface);
    FL_CHECK(concrete != nullptr);
}

FL_TEST_CASE("BusTraits<Bus::STUB>::instancePtr returns a non-null shared_ptr") {
    auto p = fl::BusTraits<fl::Bus::STUB>::instancePtr();
    FL_REQUIRE(p != nullptr);
    // instance() and *instancePtr() must reference the same object.
    FL_CHECK(p.get() == &fl::BusTraits<fl::Bus::STUB>::instance());
}

FL_TEST_CASE("enableDrivers<Bus::STUB>() registers the stub driver with ChannelManager") {
    // Snapshot driver count before; explicit enableDrivers should add (or
    // replace, if the legacy auto-init already registered) by name.
    auto& mgr = fl::ChannelManager::instance();