lib/ecoli_completed.c

   1 /*
   2  * Copyright (c) 2016, Olivier MATZ <zer0@droids-corp.org>
   3  *
   4  * Redistribution and use in source and binary forms, with or without
   5  * modification, are permitted provided that the following conditions are met:
   6  *
   7  *     * Redistributions of source code must retain the above copyright
   8  *       notice, this list of conditions and the following disclaimer.
   9  *     * Redistributions in binary form must reproduce the above copyright
  10  *       notice, this list of conditions and the following disclaimer in the
  11  *       documentation and/or other materials provided with the distribution.
  12  *     * Neither the name of the University of California, Berkeley nor the
  13  *       names of its contributors may be used to endorse or promote products
  14  *       derived from this software without specific prior written permission.
  15  *
  16  * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND ANY
  17  * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
  18  * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
  19  * DISCLAIMED. IN NO EVENT SHALL THE REGENTS AND CONTRIBUTORS BE LIABLE FOR ANY
  20  * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
  21  * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
  22  * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
  23  * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  24  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
  25  * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  26  */
  27
  28 #include <stdio.h>
  29 #include <stdlib.h>
  30 #include <string.h>
  31 #include <assert.h>
  32 #include <errno.h>
  33
  34 #include <ecoli_malloc.h>
  35 #include <ecoli_strvec.h>
  36 #include <ecoli_keyval.h>
  37 #include <ecoli_log.h>
  38 #include <ecoli_node.h>
  39 #include <ecoli_parsed.h>
  40 #include <ecoli_completed.h>
  41
  42 struct ec_completed *ec_completed(void)
  43 {
  44         struct ec_completed *completed = NULL;
  45
  46         completed = ec_calloc(1, sizeof(*completed));
  47         if (completed == NULL)
  48                 return NULL;
  49
  50         TAILQ_INIT(&completed->elts);
  51         completed->count_match = 0;
  52
  53         return completed;
  54 }
  55
  56 struct ec_completed_elt *ec_completed_elt(const struct ec_node *node,
  57         const char *add)
  58 {
  59         struct ec_completed_elt *elt = NULL;
  60
  61         elt = ec_calloc(1, sizeof(*elt));
  62         if (elt == NULL)
  63                 return NULL;
  64
  65         elt->node = node;
  66         if (add != NULL) {
  67                 elt->add = ec_strdup(add);
  68                 if (elt->add == NULL) {
  69                         ec_completed_elt_free(elt);
  70                         return NULL;
  71                 }
  72         }
  73
  74         return elt;
  75 }
  76
  77 /* XXX define when to use ec_node_complete() or node->complete()
  78  * (same for parse)
  79  * suggestion: node->op() is internal, user calls the function
  80  * other idea: have 2 functions
  81  */
  82 struct ec_completed *ec_node_complete(struct ec_node *node,
  83         const char *str)
  84 {
  85         struct ec_strvec *strvec = NULL;
  86         struct ec_completed *completed;
  87
  88         errno = ENOMEM;
  89         strvec = ec_strvec();
  90         if (strvec == NULL)
  91                 goto fail;
  92
  93         if (ec_strvec_add(strvec, str) < 0)
  94                 goto fail;
  95
  96         completed = ec_node_complete_strvec(node, strvec);
  97         if (completed == NULL)
  98                 goto fail;
  99
 100         ec_strvec_free(strvec);
 101         return completed;
 102
 103  fail:
 104         ec_strvec_free(strvec);
 105         return NULL;
 106 }
 107
 108 /* default completion function: return a no-match element */
 109 struct ec_completed *ec_node_default_complete(const struct ec_node *gen_node,
 110         const struct ec_strvec *strvec)
 111 {
 112         struct ec_completed *completed;
 113         struct ec_completed_elt *completed_elt;
 114
 115         (void)strvec;
 116
 117         completed = ec_completed();
 118         if (completed == NULL)
 119                 return NULL;
 120
 121         completed_elt = ec_completed_elt(gen_node, NULL);
 122         if (completed_elt == NULL) {
 123                 ec_completed_free(completed);
 124                 return NULL;
 125         }
 126
 127         ec_completed_add_elt(completed, completed_elt);
 128
 129         return completed;
 130 }
 131
 132 struct ec_completed *ec_node_complete_strvec(struct ec_node *node,
 133         const struct ec_strvec *strvec)
 134 {
 135         int ret;
 136
 137         /* build the node if required */
 138         if (node->type->build != NULL) {
 139                 if ((node->flags & EC_NODE_F_BUILT) == 0) {
 140                         ret = node->type->build(node);
 141                         if (ret < 0) {
 142                                 errno = -ret;
 143                                 return NULL;
 144                         }
 145                 }
 146         }
 147         node->flags |= EC_NODE_F_BUILT;
 148
 149         if (node->type->complete == NULL) {
 150                 errno = ENOTSUP;
 151                 return NULL;
 152         }
 153
 154         return node->type->complete(node, strvec);
 155 }
 156
 157 /* count the number of identical chars at the beginning of 2 strings */
 158 static size_t strcmp_count(const char *s1, const char *s2)
 159 {
 160         size_t i = 0;
 161
 162         while (s1[i] && s2[i] && s1[i] == s2[i])
 163                 i++;
 164
 165         return i;
 166 }
 167
 168 void ec_completed_add_elt(
 169         struct ec_completed *completed, struct ec_completed_elt *elt)
 170 {
 171         size_t n;
 172
 173         TAILQ_INSERT_TAIL(&completed->elts, elt, next);
 174         completed->count++;
 175         if (elt->add != NULL)
 176                 completed->count_match++;
 177         if (elt->add != NULL) {
 178                 if (completed->smallest_start == NULL) {
 179                         completed->smallest_start = ec_strdup(elt->add);
 180                 } else {
 181                         n = strcmp_count(elt->add,
 182                                 completed->smallest_start);
 183                         completed->smallest_start[n] = '\0';
 184                 }
 185         }
 186 }
 187
 188 void ec_completed_elt_free(struct ec_completed_elt *elt)
 189 {
 190         ec_free(elt->add);
 191         ec_free(elt);
 192 }
 193
 194 void ec_completed_merge(struct ec_completed *completed1,
 195         struct ec_completed *completed2)
 196 {
 197         struct ec_completed_elt *elt;
 198
 199         assert(completed1 != NULL);
 200         assert(completed2 != NULL);
 201
 202         while (!TAILQ_EMPTY(&completed2->elts)) {
 203                 elt = TAILQ_FIRST(&completed2->elts);
 204                 TAILQ_REMOVE(&completed2->elts, elt, next);
 205                 ec_completed_add_elt(completed1, elt);
 206         }
 207
 208         ec_completed_free(completed2);
 209 }
 210
 211 void ec_completed_free(struct ec_completed *completed)
 212 {
 213         struct ec_completed_elt *elt;
 214
 215         if (completed == NULL)
 216                 return;
 217
 218         while (!TAILQ_EMPTY(&completed->elts)) {
 219                 elt = TAILQ_FIRST(&completed->elts);
 220                 TAILQ_REMOVE(&completed->elts, elt, next);
 221                 ec_completed_elt_free(elt);
 222         }
 223         ec_free(completed->smallest_start);
 224         ec_free(completed);
 225 }
 226
 227 void ec_completed_dump(FILE *out, const struct ec_completed *completed)
 228 {
 229         struct ec_completed_elt *elt;
 230
 231         if (completed == NULL || completed->count == 0) {
 232                 fprintf(out, "no completion\n");
 233                 return;
 234         }
 235
 236         fprintf(out, "completion: count=%u match=%u smallest_start=<%s>\n",
 237                 completed->count, completed->count_match,
 238                 completed->smallest_start);
 239
 240         TAILQ_FOREACH(elt, &completed->elts, next) {
 241                 fprintf(out, "add=<%s>, node=%p, node_type=%s\n",
 242                         elt->add, elt->node, elt->node->type->name);
 243         }
 244 }
 245
 246 const char *ec_completed_smallest_start(
 247         const struct ec_completed *completed)
 248 {
 249         if (completed == NULL || completed->smallest_start == NULL)
 250                 return "";
 251
 252         return completed->smallest_start;
 253 }
 254
 255 unsigned int ec_completed_count(
 256         const struct ec_completed *completed,
 257         enum ec_completed_filter_flags flags)
 258 {
 259         unsigned int count = 0;
 260
 261         if (completed == NULL)
 262                 return count;
 263
 264         if (flags & EC_MATCH)
 265                 count += completed->count_match;
 266         if (flags & EC_NO_MATCH)
 267                 count += (completed->count - completed->count_match); //XXX
 268
 269         return count;
 270 }
 271
 272 struct ec_completed_iter *
 273 ec_completed_iter(struct ec_completed *completed,
 274         enum ec_completed_filter_flags flags)
 275 {
 276         struct ec_completed_iter *iter;
 277
 278         iter = ec_calloc(1, sizeof(*iter));
 279         if (iter == NULL)
 280                 return NULL;
 281
 282         iter->completed = completed;
 283         iter->flags = flags;
 284         iter->cur = NULL;
 285
 286         return iter;
 287 }
 288
 289 const struct ec_completed_elt *ec_completed_iter_next(
 290         struct ec_completed_iter *iter)
 291 {
 292         if (iter->completed == NULL)
 293                 return NULL;
 294
 295         do {
 296                 if (iter->cur == NULL) {
 297                         iter->cur = TAILQ_FIRST(&iter->completed->elts);
 298                 } else {
 299                         iter->cur = TAILQ_NEXT(iter->cur, next);
 300                 }
 301
 302                 if (iter->cur == NULL)
 303                         break;
 304
 305                 if (iter->cur->add == NULL &&
 306                                 (iter->flags & EC_NO_MATCH))
 307                         break;
 308
 309                 if (iter->cur->add != NULL &&
 310                                 (iter->flags & EC_MATCH))
 311                         break;
 312
 313         } while (iter->cur != NULL);
 314
 315         return iter->cur;
 316 }
 317
 318 void ec_completed_iter_free(struct ec_completed_iter *iter)
 319 {
 320         ec_free(iter);
 321 }