1 #include <tools/ccanlint/ccanlint.h>
2 #include <tools/tools.h>
3 #include <ccan/talloc/talloc.h>
4 #include <ccan/str/str.h>
17 /* Creates and adds an example file. */
18 static char *add_example(struct manifest *m, struct ccan_file *source,
20 struct doc_section *example)
27 name = talloc_asprintf(m, "%s/example-%s-%s.c",
32 /* example->function == 'struct foo' */
33 while (strchr(name, ' '))
34 *strchr(name, ' ') = '_';
36 name = maybe_temp_file(m, ".c", keep, name);
37 f = new_ccan_file(m, talloc_dirname(m, name), talloc_basename(m, name));
38 talloc_steal(f, name);
39 list_add_tail(&m->examples, &f->list);
41 fd = open(f->fullname, O_WRONLY | O_CREAT | O_EXCL, 0600);
43 return talloc_asprintf(m, "Creating temporary file %s: %s",
44 f->fullname, strerror(errno));
46 for (i = 0; i < example->num_lines; i++) {
47 if (write(fd, example->lines[i], strlen(example->lines[i]))
48 != strlen(example->lines[i])
49 || write(fd, "\n", 1) != 1) {
51 return "Failure writing to temporary file";
58 /* FIXME: We should have one example per function in header. */
59 static void extract_examples(struct manifest *m,
61 unsigned int *timeleft,
65 struct doc_section *d;
66 bool have_info_example = false, have_header_example = false;
69 list_for_each(get_ccan_file_docs(m->info_file), d, list) {
70 if (streq(d->type, "example")) {
71 score->error = add_example(m, m->info_file, keep, d);
74 have_info_example = true;
78 /* Check main header. */
79 list_for_each(&m->h_files, f, list) {
80 if (!strstarts(f->name, m->basename)
81 || strlen(f->name) != strlen(m->basename) + 2)
84 list_for_each(get_ccan_file_docs(f), d, list) {
85 if (streq(d->type, "example")) {
86 score->error = add_example(m, f, keep, d);
89 have_header_example = true;
94 if (!have_info_example && !have_header_example) {
95 score->error = "You don't have any Example: sections";
97 } else if (!have_info_example) {
98 score->error = "You don't have an Example: section in _info";
101 } else if (!have_header_example) {
102 score->error = talloc_asprintf(score,
103 "You don't have an Example: section in %s.h",
108 score->score = score->total;
113 struct ccanlint has_examples = {
114 .key = "has-examples",
115 .name = "_info and header files have examples",
116 .check = extract_examples,
119 REGISTER_TEST(has_examples, &has_info, NULL);