@@@ wip mostly xfail

[mLib] / test / tvec-core.c

/* -*-c-*-
 *
 * Main test vector driver
 *
 * (c) 2023 Straylight/Edgeware
 */

/*----- Licensing notice --------------------------------------------------*
 *
 * This file is part of the mLib utilities library.
 *
 * mLib is free software: you can redistribute it and/or modify it under
 * the terms of the GNU Library General Public License as published by
 * the Free Software Foundation; either version 2 of the License, or (at
 * your option) any later version.
 *
 * mLib is distributed in the hope that it will be useful, but WITHOUT
 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
 * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU Library General Public
 * License for more details.
 *
 * You should have received a copy of the GNU Library General Public
 * License along with mLib.  If not, write to the Free Software
 * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307,
 * USA.
 */

/*----- Header files ------------------------------------------------------*/

#include <assert.h>
#include <ctype.h>
#include <errno.h>
#include <string.h>

#include "alloc.h"
#include "tvec.h"

/*----- Output ------------------------------------------------------------*/

/* --- @tvec_report@, @tvec_report_v@ --- *
 *
 * Arguments:	@struct tvec_state *tv@ = test-vector state
 *		@const char *msg@, @va_list ap@ = error message
 *
 * Returns:	---
 *
 * Use:		Report an message with a given severity.  Messages with level
 *		@TVLEV_ERR@ or higher force a nonzero exit code.
 */

void tvec_report(struct tvec_state *tv, unsigned level, const char *msg, ...)
{
  va_list ap;

  va_start(ap, msg); tvec_report_v(tv, level, msg, &ap); va_end(ap);
}

void tvec_report_v(struct tvec_state *tv, unsigned level,
		   const char *msg, va_list *ap)
{
  tv->output->ops->report(tv->output, level, msg, ap);
  if (level >= TVLEV_ERR) tv->f |= TVSF_ERROR;
}

/* --- @tvec_error@, @tvec_notice@ --- *
 *
 * Arguments:	@struct tvec_state *tv@ = test-vector state
 *		@const char *msg@, @va_list ap@ = error message
 *
 * Returns:	The @tvec_error@ function returns @-1@ as a trivial
 *		convenience; @tvec_notice@ does not return a value.
 *
 * Use:		Report an error or a notice.  Errors are distinct from test
 *		failures, and indicate that a problem was encountered which
 *		compromised the activity of testing.  Notices are important
 *		information which doesn't fit into any other obvious
 *		category.
 */

int tvec_error(struct tvec_state *tv, const char *msg, ...)
{
  va_list ap;

  va_start(ap, msg); tvec_report_v(tv, TVLEV_ERR, msg, &ap); va_end(ap);
  return (-1);
}

void tvec_notice(struct tvec_state *tv, const char *msg, ...)
{
  va_list ap;

  va_start(ap, msg); tvec_report_v(tv, TVLEV_NOTE, msg, &ap); va_end(ap);
}

/*----- Test processing ---------------------------------------------------*/

void tvec_skipgroup(struct tvec_state *tv, const char *excuse, ...)
{
  va_list ap;

  va_start(ap, excuse); tvec_skipgroup_v(tv, excuse, &ap); va_end(ap);
}
void tvec_skipgroup_v(struct tvec_state *tv, const char *excuse, va_list *ap)
{
  if (!(tv->f&TVSF_SKIP)) {
    tv->f |= TVSF_SKIP; tv->grps[TVOUT_SKIP]++;
    tv->output->ops->skipgroup(tv->output, excuse, ap);
  }
}

static void set_outcome(struct tvec_state *tv, unsigned out)
{
  tv->f &= ~(TVSF_ACTIVE | TVSF_OUTMASK);
  tv->f |= out << TVSF_OUTSHIFT;
}

void tvec_skip(struct tvec_state *tv, const char *excuse, ...)
{
  va_list ap;
  va_start(ap, excuse); tvec_skip_v(tv, excuse, &ap); va_end(ap);
}
void tvec_skip_v(struct tvec_state *tv, const char *excuse, va_list *ap)
{
  assert(tv->f&TVSF_ACTIVE);
  set_outcome(tv, TVOUT_SKIP);
  tv->output->ops->skip(tv->output, excuse, ap);
}

void tvec_fail(struct tvec_state *tv, const char *detail, ...)
{
  va_list ap;
  va_start(ap, detail); tvec_fail_v(tv, detail, &ap); va_end(ap);
}
void tvec_fail_v(struct tvec_state *tv, const char *detail, va_list *ap)
{
  assert((tv->f&TVSF_ACTIVE) ||
	 (tv->f&TVSF_OUTMASK) == (TVOUT_LOSE << TVSF_OUTSHIFT));
  set_outcome(tv, TVOUT_LOSE); tv->output->ops->fail(tv->output, detail, ap);
}

void tvec_dumpreg(struct tvec_state *tv,
		  unsigned disp, const union tvec_regval *r,
		  const struct tvec_regdef *rd)
  { tv->output->ops->dumpreg(tv->output, disp, r, rd); }

void tvec_mismatch(struct tvec_state *tv, unsigned f)
{
  const struct tvec_regdef *rd;
  const struct tvec_reg *rin, *rout;

  for (rd = tv->test->regs; rd->name; rd++) {
    if (rd->i >= tv->nrout) {
      if (!(f&TVMF_IN)) continue;
      rin = TVEC_REG(tv, in, rd->i);
      tvec_dumpreg(tv, TVRD_INPUT, rin->f&TVRF_LIVE ? &rin->v : 0, rd);
    } else {
      if (!(f&TVMF_OUT)) continue;
      rin = TVEC_REG(tv, in, rd->i); rout = TVEC_REG(tv, out, rd->i);
      if (!(rin->f&TVRF_LIVE))
	tvec_dumpreg(tv, TVRD_OUTPUT, rout->f&TVRF_LIVE ? &rout->v : 0, rd);
      else if ((rout->f&TVRF_LIVE) && rd->ty->eq(&rin->v, &rout->v, rd))
	tvec_dumpreg(tv, TVRD_MATCH, &rin->v, rd);
      else {
	tvec_dumpreg(tv, TVRD_FOUND, rout->f&TVRF_LIVE ? &rout->v : 0, rd);
	tvec_dumpreg(tv, TVRD_EXPECT, &rin->v, rd);
      }
    }
  }
}

/*----- Parsing -----------------------------------------------------------*/

int tvec_syntax(struct tvec_state *tv, int ch, const char *expect, ...)
{
  va_list ap;

  va_start(ap, expect); tvec_syntax_v(tv, ch, expect, &ap); va_end(ap);
  return (-1);
}
int tvec_syntax_v(struct tvec_state *tv, int ch,
		  const char *expect, va_list *ap)
{
  dstr d = DSTR_INIT;
  char found[8];

  switch (ch) {
    case EOF: strcpy(found, "#eof"); break;
    case '\n': strcpy(found, "#eol"); ungetc(ch, tv->fp); break;
    default:
      if (isprint(ch)) sprintf(found, "`%c'", ch);
      else sprintf(found, "#\\x%02x", ch);
      break;
  }
  dstr_vputf(&d, expect, ap);
  tvec_error(tv, "syntax error: expected %s but found %s", d.buf, found);
  dstr_destroy(&d); return (-1);
}

void tvec_skipspc(struct tvec_state *tv)
{
  int ch;

  for (;;) {
    ch = getc(tv->fp);
    if (ch == EOF) break;
    else if (ch == '\n' || !isspace(ch)) { ungetc(ch, tv->fp); break; }
  }
}

int tvec_flushtoeol(struct tvec_state *tv, unsigned f)
{
  int ch, rc = 0;

  for (;;) {
    ch = getc(tv->fp);
    switch (ch) {
      case '\n': tv->lno++; return (rc);
      case EOF: return (rc);
      case ';': f |= TVFF_ALLOWANY; break;
      default:
	if (!(f&TVFF_ALLOWANY) && !isspace(ch)) {
	  tvec_syntax(tv, ch, "end-of-line");
	  rc = -1; f |= TVFF_ALLOWANY;
	}
	break;
    }
  }
}

int tvec_nexttoken(struct tvec_state *tv)
{
  enum { TAIL, NEWLINE, INDENT, COMMENT };
  int ch;
  unsigned s = TAIL;

  for (;;) {
    ch = getc(tv->fp);
    switch (ch) {
      case EOF:
	return (-1);

      case ';':
	s = COMMENT;
	break;

      case '\n':
	if (s == NEWLINE || s == INDENT) { ungetc(ch, tv->fp); return (-1); }
	else { tv->lno++; s = NEWLINE; }
	break;

      default:
	if (isspace(ch))
	  { if (s == NEWLINE) s = INDENT; }
	else if (s != COMMENT) {
	  ungetc(ch, tv->fp);
	  if (s == NEWLINE) return (-1);
	  else return (0);
	}
	break;
    }
  }
}

int tvec_readword(struct tvec_state *tv, dstr *d, const char *delims,
		  const char *expect, ...)
{
  va_list ap;
  int rc;

  va_start(ap, expect);
  rc = tvec_readword_v(tv, d, delims, expect, &ap);
  va_end(ap);
  return (rc);
}
int tvec_readword_v(struct tvec_state *tv, dstr *d, const char *delims,
		    const char *expect, va_list *ap)
{
  int ch;

  ch = getc(tv->fp);
  if (!ch || ch == '\n' || ch == EOF || ch == ';' ||
      (delims && strchr(delims, ch))) {
    if (expect) return (tvec_syntax(tv, ch, expect, ap));
    else { ungetc(ch, tv->fp); return (-1); }
  }
  if (d->len) DPUTC(d, ' ');
  do {
    DPUTC(d, ch);
    ch = getc(tv->fp);
  } while (ch && ch != EOF && !isspace(ch) &&
	   (!delims || !strchr(delims, ch)));
  DPUTZ(d); if (ch != EOF) ungetc(ch, tv->fp);
  return (0);
}

/*----- Main machinery ----------------------------------------------------*/

struct groupstate {
  void *ctx;
};
#define GROUPSTATE_INIT { 0 }

void tvec_resetoutputs(struct tvec_state *tv)
{
  const struct tvec_regdef *rd;
  struct tvec_reg *r;

  for (rd = tv->test->regs; rd->name; rd++) {
    assert(rd->i < tv->nreg);
    if (rd->i >= tv->nrout) continue;
    r = TVEC_REG(tv, out, rd->i);
    rd->ty->release(&r->v, rd);
    rd->ty->init(&r->v, rd);
    r->f = TVEC_REG(tv, in, rd->i)->f&TVRF_LIVE;
  }
}

void tvec_initregs(struct tvec_state *tv)
{
  const struct tvec_regdef *rd;
  struct tvec_reg *r;

  for (rd = tv->test->regs; rd->name; rd++) {
    assert(rd->i < tv->nreg); r = TVEC_REG(tv, in, rd->i);
    rd->ty->init(&r->v, rd); r->f = 0;
    if (rd->i < tv->nrout)
      { r = TVEC_REG(tv, out, rd->i); rd->ty->init(&r->v, rd); r->f = 0; }
  }
}

void tvec_releaseregs(struct tvec_state *tv)
{
  const struct tvec_regdef *rd;
  struct tvec_reg *r;

  for (rd = tv->test->regs; rd->name; rd++) {
    assert(rd->i < tv->nreg); r = TVEC_REG(tv, in, rd->i);
    rd->ty->release(&r->v, rd); r->f = 0;
    if (rd->i < tv->nrout)
      { r = TVEC_REG(tv, out, rd->i); rd->ty->release(&r->v, rd); r->f = 0; }
  }
}

int tvec_checkregs(struct tvec_state *tv)
{
  const struct tvec_regdef *rd;
  const struct tvec_reg *rin, *rout;

  for (rd = tv->test->regs; rd->name; rd++) {
    if (rd->i >= tv->nrout) continue;
    rin = TVEC_REG(tv, in, rd->i); rout = TVEC_REG(tv, out, rd->i);
    if (!rin->f&TVRF_LIVE) continue;
    if (!(rout->f&TVRF_LIVE) || !rd->ty->eq(&rin->v, &rout->v, rd))
      return (-1);
  }
  return (0);
}

void tvec_check(struct tvec_state *tv, const char *detail, ...)
{
  va_list ap;
  va_start(ap, detail); tvec_check_v(tv, detail, &ap); va_end(ap);
}
void tvec_check_v(struct tvec_state *tv, const char *detail, va_list *ap)
{
  if (tvec_checkregs(tv))
    { tvec_fail_v(tv, detail, ap); tvec_mismatch(tv, TVMF_IN | TVMF_OUT); }
}

static void open_test(struct tvec_state *tv)
{
  if (!(tv->f&TVSF_OPEN)) {
    tv->test_lno = tv->lno;
    tv->f |= TVSF_OPEN; tv->f &= ~TVSF_XFAIL;
  }
}

static void begin_test(struct tvec_state *tv)
{
  tv->f |= TVSF_ACTIVE; tv->f &= ~TVSF_OUTMASK;
  tv->output->ops->btest(tv->output);
}

void tvec_endtest(struct tvec_state *tv)
{
  unsigned out;

  if (!(tv->f&TVSF_ACTIVE)) /* nothing to do */;
  else if (tv->f&TVSF_XFAIL) set_outcome(tv, TVOUT_XFAIL);
  else set_outcome(tv, TVOUT_WIN);
  out = (tv->f&TVSF_OUTMASK) >> TVSF_OUTSHIFT;
  assert(out < TVOUT_LIMIT); tv->curr[out]++;
  tv->output->ops->etest(tv->output, out);
  tv->f &= ~TVSF_OPEN;
}

static void check(struct tvec_state *tv, struct groupstate *g)
{
  const struct tvec_test *t = tv->test;
  const struct tvec_env *env;
  const struct tvec_regdef *rd;

  if (!(tv->f&TVSF_OPEN)) return;

  for (rd = t->regs; rd->name; rd++) {
    if (TVEC_REG(tv, in, rd->i)->f&TVRF_LIVE)
      { if (rd->i < tv->nrout) TVEC_REG(tv, out, rd->i)->f |= TVRF_LIVE; }
    else if (!(rd->f&TVRF_OPT)) {
      tvec_error(tv, "required register `%s' not set in test `%s'",
		 rd->name, t->name);
      goto end;
    }
  }

  if (!(tv->f&TVSF_SKIP)) {
    begin_test(tv);
    env = t->env;
    if (env && env->before) env->before(tv, g->ctx);
    if (!(tv->f&TVSF_ACTIVE))
      /* setup forced a skip */;
    else if (env && env->run)
      env->run(tv, t->fn, g->ctx);
    else {
      t->fn(tv->in, tv->out, g->ctx);
      tvec_check(tv, 0);
    }
    if (env && env->after) env->after(tv, g->ctx);
    tvec_endtest(tv);
  }

end:
  tv->f &= ~TVSF_OPEN; tvec_releaseregs(tv); tvec_initregs(tv);
}

static void begin_test_group(struct tvec_state *tv, struct groupstate *g)
{
  const struct tvec_test *t = tv->test;
  const struct tvec_env *env = t->env;
  unsigned i;

  tv->output->ops->bgroup(tv->output);
  tv->f &= ~TVSF_SKIP;
  tvec_initregs(tv);
  for (i = 0; i < TVOUT_LIMIT; i++) tv->curr[i] = 0;
  if (env && env->ctxsz) g->ctx = xmalloc(env->ctxsz);
  if (env && env->setup) env->setup(tv, env, 0, g->ctx);
}

static void report_group(struct tvec_state *tv)
{
  unsigned i, out, nrun;

  for (i = 0, nrun = 0; i < TVOUT_LIMIT; i++)
    { nrun += tv->curr[i]; tv->all[i] += tv->curr[i]; }

  if (tv->curr[TVOUT_SKIP] == nrun)
    { out = TVOUT_SKIP; tvec_skipgroup(tv, nrun ? 0 : "no tests to run"); }
  else {
    if (tv->curr[TVOUT_LOSE]) out = TVOUT_LOSE;
    else out = TVOUT_WIN;
    tv->grps[out]++; tv->output->ops->egroup(tv->output);
  }
}

static void end_test_group(struct tvec_state *tv, struct groupstate *g)
{
  const struct tvec_test *t = tv->test;
  const struct tvec_env *env;

  if (!t) return;
  if (tv->f&TVSF_OPEN) check(tv, g);
  if (!(tv->f&TVSF_SKIP)) report_group(tv);
  env = t->env; if (env && env->teardown) env->teardown(tv, g->ctx);
  tvec_releaseregs(tv); tv->test = 0; xfree(g->ctx); g->ctx = 0;
}

enum { WIN, XFAIL, NOUT };
static const struct tvec_uassoc outcome_assoc[] = {
  { "success",		WIN },
  { "win",		WIN },
  { "expected-failure",	XFAIL },
  { "xfail",		XFAIL },
  TVEC_ENDENUM
};
static const struct tvec_urange outcome_range = { 0, NOUT - 1 };
static const struct tvec_uenuminfo outcome_enum =
  { "test-outcome", outcome_assoc, &outcome_range };
static const struct tvec_regdef outcome_regdef =
  { "outcome", 0, &tvty_uenum, 0, { &outcome_enum } };

int tvec_read(struct tvec_state *tv, const char *infile, FILE *fp)
{
  dstr d = DSTR_INIT;
  const struct tvec_test *test;
  const struct tvec_env *env;
  const struct tvec_regdef *rd;
  struct tvec_reg *r;
  struct groupstate g = GROUPSTATE_INIT;
  union tvec_regval rv;
  int ch, ret, rc = 0;

  tv->infile = infile; tv->lno = 1; tv->fp = fp;

  for (;;) {
    ch = getc(tv->fp);
    switch (ch) {

      case EOF:
	goto end;

      case '[':
	end_test_group(tv, &g);
	tvec_skipspc(tv);
	DRESET(&d); tvec_readword(tv, &d, "];", "group name");
	tvec_skipspc(tv);
	ch = getc(tv->fp); if (ch != ']') tvec_syntax(tv, ch, "`]'");
	for (test = tv->tests; test->name; test++)
	  if (STRCMP(d.buf, ==, test->name)) goto found_test;
	tvec_error(tv, "unknown test group `%s'", d.buf); goto flush_line;
      found_test:
	tvec_flushtoeol(tv, 0);	tv->test = test; begin_test_group(tv, &g);
	break;

      case '\n':
	tv->lno++;
	if (tv->f&TVSF_OPEN) check(tv, &g);
	break;

      default:
	if (isspace(ch)) {
	  tvec_skipspc(tv);
	  ch = getc(tv->fp);
	  if (ch == EOF) goto end;
	  else if (ch == ';') tvec_flushtoeol(tv, TVFF_ALLOWANY);
	  else if (tvec_flushtoeol(tv, 0)) rc = -1;
	  else check(tv, &g);
	} else if (ch == ';')
	  tvec_flushtoeol(tv, TVFF_ALLOWANY);
	else {
	  ungetc(ch, tv->fp);
	  DRESET(&d);
	  if (tvec_readword(tv, &d, "=:;", "register name")) goto flush_line;
	  tvec_skipspc(tv); ch = getc(tv->fp);
	  if (ch != '=' && ch != ':')
	    { tvec_syntax(tv, ch, "`=' or `:'"); goto flush_line; }
	  tvec_skipspc(tv);
	  if (!tv->test)
	    { tvec_error(tv, "no current test"); goto flush_line; }
	  if (d.buf[0] == '@') {
	    env = tv->test->env;
	    if (STRCMP(d.buf, ==, "@outcome")) {
	      if (tvty_uenum.parse(&rv, &outcome_regdef, tv))
		ret = -1;
	      else {
		if (rv.u == XFAIL) tv->f |= TVSF_XFAIL;
		ret = 1;
	      }
	    } else if (!env || !env->set) ret = 0;
	    else ret = env->set(tv, d.buf, env, g.ctx);
	    if (ret <= 0) {
	      if (!ret)
		tvec_error(tv, "unknown special register `%s'", d.buf);
	      goto flush_line;
	    }
	    open_test(tv);
	  } else {
	    for (rd = tv->test->regs; rd->name; rd++)
	      if (STRCMP(rd->name, ==, d.buf)) goto found_reg;
	    tvec_error(tv, "unknown register `%s' for test `%s'",
		       d.buf, tv->test->name);
	    goto flush_line;
	  found_reg:
	    open_test(tv);
	    tvec_skipspc(tv);
	    r = TVEC_REG(tv, in, rd->i);
	    if (r->f&TVRF_LIVE) {
	      tvec_error(tv, "register `%s' already set", rd->name);
	      goto flush_line;
	    }
	    if (rd->ty->parse(&r->v, rd, tv)) goto flush_line;
	    r->f |= TVRF_LIVE;
	  }
	}
	break;
    }
    continue;

  flush_line:
    tvec_flushtoeol(tv, TVFF_ALLOWANY); rc = -1;
  }
  if (ferror(tv->fp))
    { tvec_error(tv, "error reading input: %s", strerror(errno)); rc = -1; }
end:
  end_test_group(tv, &g);
  tv->infile = 0; tv->fp = 0;
  dstr_destroy(&d);
  return (rc);
}

/*----- Session lifecycle -------------------------------------------------*/

void tvec_begin(struct tvec_state *tv_out,
		const struct tvec_config *config,
		struct tvec_output *o)
{
  unsigned i;

  tv_out->f = 0;

  assert(config->nrout <= config->nreg);
  tv_out->nrout = config->nrout; tv_out->nreg = config->nreg;
  tv_out->regsz = config->regsz;
  tv_out->in = xmalloc(tv_out->nreg*tv_out->regsz);
  tv_out->out = xmalloc(tv_out->nrout*tv_out->regsz);
  for (i = 0; i < tv_out->nreg; i++) {
    TVEC_REG(tv_out, in, i)->f = 0;
    if (i < tv_out->nrout) TVEC_REG(tv_out, out, i)->f = 0;
  }

  for (i = 0; i < TVOUT_LIMIT; i++)
    tv_out->curr[i] = tv_out->all[i] = tv_out->grps[i] = 0;

  tv_out->tests = config->tests; tv_out->test = 0;
  tv_out->infile = 0; tv_out->lno = 0; tv_out->fp = 0;
  tv_out->output = o; tv_out->output->ops->bsession(tv_out->output, tv_out);
}

int tvec_end(struct tvec_state *tv)
{
  int rc = tv->output->ops->esession(tv->output);

  tv->output->ops->destroy(tv->output);
  xfree(tv->in); xfree(tv->out);
  return (rc);
}

/*----- Serialization and deserialization ---------------------------------*/

int tvec_serialize(const struct tvec_reg *rv, buf *b,
		   const struct tvec_regdef *regs,
		   unsigned nr, size_t regsz)
{
  unsigned char *bitmap;
  size_t i, bitoff, nbits, bitsz;
  const struct tvec_regdef *rd;
  const struct tvec_reg *r;

  bitoff = BLEN(b);
  for (rd = regs, nbits = 0; rd->name; rd++, nbits++);
  bitsz = (nbits + 7)/8;

  bitmap = buf_get(b, bitsz); if (!bitmap) return (-1);
  memset(bitmap, 0, bitsz);
  for (rd = regs, i = 0; rd->name; rd++, i++) {
    if (rd->i >= nr) continue;
    r = TVEC_GREG(rv, rd->i, regsz); if (!(r->f&TVRF_LIVE)) continue;
    bitmap = BBASE(b) + bitoff; bitmap[i/8] |= 1 << i%8;
    if (rd->ty->tobuf(b, &r->v, rd)) return (-1);
  }
  return (0);
}

int tvec_deserialize(struct tvec_reg *rv, buf *b,
		     const struct tvec_regdef *regs,
		     unsigned nr, size_t regsz)
{
  const unsigned char *bitmap;
  size_t i, nbits, bitsz;
  const struct tvec_regdef *rd;
  struct tvec_reg *r;

  for (rd = regs, nbits = 0; rd->name; rd++, nbits++);
  bitsz = (nbits + 7)/8;

  bitmap = buf_get(b, bitsz); if (!bitmap) return (-1);
  for (rd = regs, i = 0; rd->name; rd++, i++) {
    if (rd->i >= nr) continue;
    if (!(bitmap[i/8]&(1 << i%8))) continue;
    r = TVEC_GREG(rv, rd->i, regsz);
    if (rd->ty->frombuf(b, &r->v, rd)) return (-1);
    r->f |= TVRF_LIVE;
  }
  return (0);
}

/*----- Ad-hoc testing ----------------------------------------------------*/

static const struct tvec_regdef no_regs = { 0, 0, 0, 0, { 0 } };

static void fakefn(const struct tvec_reg *in, struct tvec_reg *out, void *p)
  { assert(!"fake test function"); }

void tvec_adhoc(struct tvec_state *tv, struct tvec_test *t)
{
  t->name = "<unset>"; t->regs = &no_regs; t->env = 0; t->fn = fakefn;
  tv->tests = t;
}

void tvec_begingroup(struct tvec_state *tv, const char *name,
		     const char *file, unsigned lno)
{
  struct tvec_test *t = (/*unconst*/ struct tvec_test *)tv->tests;

  t->name = name; tv->test = t;
  tv->infile = file; tv->lno = tv->test_lno = lno;
  begin_test_group(tv, 0);
}

void tvec_endgroup(struct tvec_state *tv)
{
  if (!(tv->f&TVSF_SKIP)) report_group(tv);
  tv->test = 0;
}

void tvec_begintest(struct tvec_state *tv, const char *file, unsigned lno)
{
  tv->infile = file; tv->lno = tv->test_lno = lno;
  begin_test(tv); tv->f |= TVSF_OPEN;
}

struct adhoc_claim {
  unsigned f;
#define ACF_FRESH 1u
  const char *saved_file; unsigned saved_lno;
};

static void adhoc_claim_setup(struct tvec_state *tv,
			      struct adhoc_claim *ck,
			      const struct tvec_regdef *regs,
			      const char *file, unsigned lno)
{
  struct tvec_test *t = (/*unconst*/ struct tvec_test *)tv->test;

  ck->f = 0;

  if (!(tv->f&TVSF_OPEN))
    { ck->f |= ACF_FRESH; tvec_begintest(tv, file, lno); }

  ck->saved_file = tv->infile; if (file) tv->infile = file;
  ck->saved_lno = tv->test_lno; if (file) tv->test_lno = lno;
  t->regs = regs ? regs : &no_regs;
}

static void adhoc_claim_teardown(struct tvec_state *tv,
				 struct adhoc_claim *ck)
{
  struct tvec_test *t = (/*unconst*/ struct tvec_test *)tv->test;

  t->regs = &no_regs;
  tv->infile = ck->saved_file; tv->test_lno = ck->saved_lno;

  if (ck->f&ACF_FRESH) tvec_endtest(tv);
}

int tvec_claim_v(struct tvec_state *tv, int ok,
		 const char *file, unsigned lno,
		 const char *msg, va_list *ap)
{
  struct adhoc_claim ck;

  adhoc_claim_setup(tv, &ck, 0, file, lno);
  if (!ok) tvec_fail_v(tv, msg, ap);
  adhoc_claim_teardown(tv, &ck);
  return (ok);
}

int tvec_claim(struct tvec_state *tv, int ok,
	       const char *file, unsigned lno, const char *msg, ...)
{
  va_list ap;

  va_start(ap, msg); tvec_claim_v(tv, ok, file, lno, msg, &ap); va_end(ap);
  return (ok);
}

int tvec_claimeq(struct tvec_state *tv,
		 const struct tvec_regty *ty, const union tvec_misc *arg,
		 const char *file, unsigned lno, const char *expr)
{
  struct tvec_regdef regs[2];
  struct adhoc_claim ck;
  int ok;

  tv->in[0].f = tv->out[0].f = TVRF_LIVE;

  regs[0].name = "value"; regs[0].i = 0;
  regs[0].ty = ty; regs[0].f = 0;
  if (arg) regs[0].arg = *arg;
  else regs[0].arg.p = 0;

  regs[1].name = 0;

  adhoc_claim_setup(tv, &ck, regs, file, lno);
  ok = ty->eq(&tv->in[0].v, &tv->out[0].v, &regs[0]);
  if (!ok)
    { tvec_fail(tv, "%s", expr); tvec_mismatch(tv, TVMF_IN | TVMF_OUT); }
  adhoc_claim_teardown(tv, &ck);
  return (ok);
}

/*----- That's all, folks -------------------------------------------------*/