#ifndef src_parse_h
#define src_parse_h

/**
 * @file parse.h
 * @brief Parse a program source code stream into a tree of `yexpr_t`.
 * @addtogroup frontend
 * @{
 */

#include <gen/y.tab.h>
#include <src/expr.h>
#include <src/base/str.h>

#include <stdio.h>

/**
 * @brief Parse `input` (which can be a string, see `fmemopen(3)`).
 *
 * If successful, `true` is returned, and the top-level s-exprs are stored as list into `result`.
 *
 * If not successful, `false` is returned, and `error` will contain a description of the error.
 */
bool yparse(FILE* input, yexpr_t* result, ystr_t* error);

/**
 * @}
 */

#endif