X-Git-Url: http://git.ozlabs.org/?p=ccan;a=blobdiff_plain;f=tools%2Fccanlint%2Ftests%2Fexamples_exist.c;h=c42a2e4e9ff27c5f183b498e798c3ae10a1e238f;hp=947d76a4a768751053e6830b4bb788cb2c56df77;hb=c5a49e4942e98f17744f2a50dead077b34d0ceaf;hpb=051db34fb275491d4d5dfa5bf7970e8e525766d8 diff --git a/tools/ccanlint/tests/examples_exist.c b/tools/ccanlint/tests/examples_exist.c index 947d76a4..c42a2e4e 100644 --- a/tools/ccanlint/tests/examples_exist.c +++ b/tools/ccanlint/tests/examples_exist.c @@ -1,7 +1,9 @@ #include #include -#include #include +#include +#include +#include #include #include #include @@ -16,39 +18,42 @@ /* Creates and adds an example file. */ static char *add_example(struct manifest *m, struct ccan_file *source, - bool keep, struct doc_section *example) { - char *name; + char *name, *linemarker; unsigned int i; int fd; struct ccan_file *f; - name = talloc_asprintf(m, "%s/example-%s-%s.c", - talloc_dirname(m, - source->fullname), - source->name, - example->function); + name = tal_fmt(m, "example-%s-%s", + source->name, example->function); /* example->function == 'struct foo' */ while (strchr(name, ' ')) *strchr(name, ' ') = '_'; - name = maybe_temp_file(m, ".c", keep, name); - f = new_ccan_file(m, talloc_dirname(m, name), talloc_basename(m, name)); - talloc_steal(f, name); + name = temp_file(m, ".c", take(name)); + f = new_ccan_file(m, take(path_dirname(m, name)), + take(path_basename(m, name))); + tal_steal(f, name); list_add_tail(&m->examples, &f->list); fd = open(f->fullname, O_WRONLY | O_CREAT | O_EXCL, 0600); if (fd < 0) - return talloc_asprintf(m, "Creating temporary file %s: %s", - f->fullname, strerror(errno)); + return tal_fmt(m, "Creating temporary file %s: %s", + f->fullname, strerror(errno)); + + /* Add #line to demark where we are from, so errors are correct! */ + linemarker = tal_fmt(f, "#line %i \"%s\"\n", + example->srcline+2, source->fullname); + write(fd, linemarker, strlen(linemarker)); for (i = 0; i < example->num_lines; i++) { if (write(fd, example->lines[i], strlen(example->lines[i])) != strlen(example->lines[i]) || write(fd, "\n", 1) != 1) { close(fd); - return "Failure writing to temporary file"; + return cast_const(char *, + "Failure writing to temporary file"); } } close(fd); @@ -57,7 +62,6 @@ static char *add_example(struct manifest *m, struct ccan_file *source, /* FIXME: We should have one example per function in header. */ static void extract_examples(struct manifest *m, - bool keep, unsigned int *timeleft, struct score *score) { @@ -68,23 +72,22 @@ static void extract_examples(struct manifest *m, score->total = 2; list_for_each(get_ccan_file_docs(m->info_file), d, list) { if (streq(d->type, "example")) { - score->error = add_example(m, m->info_file, keep, d); + score->error = add_example(m, m->info_file, d); if (score->error) return; have_info_example = true; } } - /* Check main header. */ + /* Check all headers for examples. */ list_for_each(&m->h_files, f, list) { - if (!strstarts(f->name, m->basename) - || strlen(f->name) != strlen(m->basename) + 2) - continue; + if (strstarts(f->name, m->basename) + && strlen(f->name) == strlen(m->basename) + 2) + mainh = f; - mainh = f; list_for_each(get_ccan_file_docs(f), d, list) { if (streq(d->type, "example")) { - score->error = add_example(m, f, keep, d); + score->error = add_example(m, f, d); if (score->error) return; have_header_example = true; @@ -92,28 +95,26 @@ static void extract_examples(struct manifest *m, } } + /* We don't fail ccanlint for this. */ + score->pass = true; if (have_info_example && have_header_example) { score->score = score->total; - score->pass = true; return; } - score->error = "Expect examples in header and _info"; if (!have_info_example) score_file_error(score, m->info_file, 0, "No Example: section"); if (!have_header_example) score_file_error(score, mainh, 0, "No Example: section"); score->score = have_info_example + have_header_example; - /* We pass if we find any example. */ - score->pass = score->score != 0; } struct ccanlint examples_exist = { .key = "examples_exist", .name = "_info and main header file have Example: sections", .check = extract_examples, - .needs = "info_exists" + .needs = "info_exists main_header_exists" }; REGISTER_TEST(examples_exist);