feat: add mock JACK test target and unit tests for carla host

This commit is contained in:
Loic Coenen
2026-05-17 10:18:58 +00:00
parent e6e0a47749
commit d28e1f45f5
7 changed files with 247 additions and 105 deletions

View File

@@ -77,19 +77,30 @@ $(TEST_CARLA_OBJ): tests/test_carla_host.c src/carla_host.h
$(TEST_CARLA_BIN): $(TEST_CARLA_OBJ) $(CARLA_OBJ)
$(CC) $(CFLAGS) -o $@ $^ $(CARLA_LIB) -ljack
# --- Mock JACK test ---
TEST_CARLA_MOCK_BIN = test_carla_host_mock
CARLA_MOCK_OBJ = src/carla_host_mock.o
$(CARLA_MOCK_OBJ): src/carla_host.c src/carla_host.h
$(CC) -Wall -Wextra -std=c11 -Isrc $(CARLA_INC) -DTESTING -DMOCK_JACK -c -o $@ $<
$(TEST_CARLA_MOCK_BIN): tests/test_carla_host_mock.c $(CARLA_MOCK_OBJ)
$(CC) $(CFLAGS) $(CARLA_INC) -DTESTING -DMOCK_JACK -o $@ $^ $(CARLA_LIB) -ljack
# --- Integration test (requires TESTING symbol) ---
$(TEST_INTEGRATION_BIN): tests/test_integration.c $(CARLA_TEST_OBJ)
$(CC) $(CFLAGS) $(CARLA_INC) -DTESTING -o $@ $^ $(CARLA_LIB) -ljack
test: looper-client test_status_parse $(TEST_PLUGINS_BIN) $(TEST_CLIENT_BIN) $(TEST_CARLA_BIN) $(TEST_CLIENT_CMD_BIN) $(TEST_INTEGRATION_BIN)
test: looper-client test_status_parse $(TEST_PLUGINS_BIN) $(TEST_CLIENT_BIN) $(TEST_CARLA_BIN) $(TEST_CLIENT_CMD_BIN) $(TEST_INTEGRATION_BIN) $(TEST_CARLA_MOCK_BIN)
./test_status_parse
./$(TEST_PLUGINS_BIN)
./$(TEST_CLIENT_BIN)
./$(TEST_CARLA_BIN)
./$(TEST_CLIENT_CMD_BIN)
./$(TEST_INTEGRATION_BIN)
./$(TEST_CARLA_MOCK_BIN)
.PHONY: all test clean
clean:
rm -f looper-client test_status_parse $(TEST_PLUGINS_BIN) $(TEST_CLIENT_BIN) $(TEST_CARLA_BIN) $(TEST_CLIENT_CMD_BIN) $(TEST_INTEGRATION_BIN) *.o tests/*.o src/*.o
rm -f looper-client test_status_parse $(TEST_PLUGINS_BIN) $(TEST_CLIENT_BIN) $(TEST_CARLA_BIN) $(TEST_CLIENT_CMD_BIN) $(TEST_INTEGRATION_BIN) $(TEST_CARLA_MOCK_BIN) *.o tests/*.o src/*.o

View File

@@ -1,13 +1,38 @@
#include <CarlaHost.h>
#include <CarlaBackend.h>
#include <jack/jack.h>
#include <string.h>
#include "carla_host.h"
#ifdef MOCK_JACK
/* Mock JACK functions always succeed */
/* Provide a dummy type so we can have a nonNULL pointer */
typedef void jack_client_t;
static int mock_jack_connect(const char *from, const char *to) {
(void)from; (void)to;
return 0;
}
static int mock_jack_disconnect(const char *from, const char *to) {
(void)from; (void)to;
return 0;
}
/* Provide a fake jack_client pointer that is nonNULL */
#define jack_client ((jack_client_t*)1)
/* Real jack_connect/jack_disconnect take 3 arguments (client, a, b).
We ignore the client and forward to the mock 2arg functions. */
#define jack_connect(client, a, b) ((void)(client), mock_jack_connect(a, b))
#define jack_disconnect(client, a, b) ((void)(client), mock_jack_disconnect(a, b))
#else
#include <jack/jack.h>
#endif
#define MAX_PLUGINS 256
static CarlaHostHandle handle = NULL;
#ifdef MOCK_JACK
/* jack_client is defined via macro above (nonNULL) */
#else
static jack_client_t *jack_client = NULL; // private JACK client for port connections
#endif
static int carla_pids[MAX_PLUGINS];
static int plugin_count = 0;
@@ -25,16 +50,20 @@ static int conn_count = 0;
int carla_init_jack(void) {
if (handle != NULL) return 0;
#ifndef MOCK_JACK
// 1) Open our own JACK client (for port connections)
jack_status_t status;
jack_client = jack_client_open("looper-connector", JackNoStartServer, &status);
// It's okay if jack_client is NULL; we still try Carla
#endif
// 2) Create the Carla host handle
handle = carla_standalone_host_init();
if (!handle) {
#ifndef MOCK_JACK
if (jack_client) jack_client_close(jack_client);
jack_client = NULL;
#endif
return -1;
}
@@ -42,8 +71,10 @@ int carla_init_jack(void) {
if (!carla_engine_init(handle, "JACK", "looper-client")) {
carla_engine_close(handle);
handle = NULL;
#ifndef MOCK_JACK
if (jack_client) jack_client_close(jack_client);
jack_client = NULL;
#endif
return -1;
}
return 0;
@@ -54,10 +85,12 @@ void carla_cleanup_jack(void) {
carla_engine_close(handle);
handle = NULL;
}
#ifndef MOCK_JACK
if (jack_client) {
jack_client_close(jack_client);
jack_client = NULL;
}
#endif
plugin_count = 0;
}

View File

@@ -0,0 +1,92 @@
#include "carla_host.h"
#include <stdio.h>
static int tests_passed = 0;
static int tests_failed = 0;
#define ASSERT_EQ(expected, actual, msg) do { \
if ((expected) != (actual)) { \
fprintf(stderr, "FAIL: %s (expected %d, got %d)\n", msg, (int)(expected), (int)(actual)); \
tests_failed++; \
} else { \
printf("PASS: %s\n", msg); \
tests_passed++; \
} \
} while(0)
#define ASSERT_TRUE(expr, msg) do { \
if (!(expr)) { \
fprintf(stderr, "FAIL: %s\n", msg); \
tests_failed++; \
} else { \
printf("PASS: %s\n", msg); \
tests_passed++; \
} \
} while(0)
static void test_init_cleanup(void)
{
// When compiled with MOCK_JACK, carla_init_jack should succeed
int ret = carla_init_jack();
ASSERT_EQ(0, ret, "carla_init_jack() returns 0 under MOCK_JACK");
CarlaHostHandle h = carla_get_handle();
ASSERT_TRUE(h != NULL, "carla_get_handle() is nonNULL after init");
carla_cleanup_jack();
}
static void test_load_unload(void)
{
int ret = carla_init_jack();
ASSERT_EQ(0, ret, "carla_init_jack() returns 0");
int id;
ret = carla_load("libmock_plugin.so", "mock_plugin", &id);
// Under mock, carla_load will try to call carla_add_plugin which may fail
// because no real Carla engine. The mock only mocks JACK, not Carla.
// We accept either success or failure the test just verifies no crash.
if (ret == 0) {
ASSERT_TRUE(id >= 0, "id is nonnegative after load");
ret = carla_unload(id);
ASSERT_EQ(0, ret, "carla_unload returns 0");
} else {
printf(" SKIP: carla_load failed, presumably no Carla engine available\n");
}
carla_cleanup_jack();
}
static void test_connect_disconnect(void)
{
int ret = carla_init_jack();
ASSERT_EQ(0, ret, "carla_init_jack() returns 0");
int id = 0;
// Use carla_test_add_connection to simulate a connection
ret = carla_test_add_connection(id, "test:out", "looper:in");
ASSERT_EQ(0, ret, "carla_test_add_connection returns 0");
ASSERT_EQ(1, carla_test_connection_count(), "connection count is 1 after add");
// carla_disconnect_plugin should clear all connections for id 0
ret = carla_disconnect_plugin(0);
ASSERT_EQ(0, ret, "carla_disconnect_plugin returns 0");
ASSERT_EQ(0, carla_test_connection_count(), "connection count is 0 after disconnect_plugin");
carla_cleanup_jack();
}
static void test_set_bypass(void)
{
int ret = carla_init_jack();
ASSERT_EQ(0, ret, "carla_init_jack() returns 0");
// bypass should not crash even with no plugin loaded
carla_set_bypass(0, true);
printf("PASS: carla_set_bypass(0, true) did not crash\n");
tests_passed++;
carla_cleanup_jack();
}
int main(void)
{
printf("=== Carla host mock integration tests ===\n");
test_init_cleanup();
test_load_unload();
test_connect_disconnect();
test_set_bypass();
printf("\nResults: %d passed, %d failed\n", tests_passed, tests_failed);
return tests_failed > 0 ? 1 : 0;
}