Loading...
Searching...
No Matches
stelaParser.hpp
Go to the documentation of this file.
1
2#pragma once
3
4#include "stela/ast.hpp"
9
10namespace by {
11 class stelaTokenScan;
12
39 class _nout stelaParser: public stelaTokenScanable {
40 BY(ME(stelaParser))
41
42 public:
44
45 public:
51 tstr<stela> parse(const std::string& codes);
63 tstr<stela> parseFromFile(const std::string& path);
70
71 stelaTokenDispatcher& getDispatcher();
72 std::vector<ncnt>& getIndents();
73
74 nbool isInit() const;
75
80 template <typename T> void setScan() { _mode = &T::instance; }
81
82 void rel();
83
94 int popState();
95
96 // events:
97 // scan:
98 using stelaTokenScanable::onScan;
108 nint onScan(stelaParser& ps, ZZSTYPE* val, ZZLTYPE* loc, zzscan_t scanner, nbool& isBypass) override;
158
159 // keyword:
160 stela* onDefBlock(stela* stmt);
161 stela* onDefBlock(stela* blk, stela* stmt);
162 stela* onDefBlock();
163
164 // expr:
165 // def:
166 // var:
173 template <typename T> stela* onPrimitive(const T& arg) { return new valStela(arg); }
174
175 verStela* onVer(const std::string& version);
176
177 stela* onDefProp(const std::string& name, stela& rhs);
178 stela* onDefAssign(const std::string& name, stela* rhs);
179 // obj:
180 stela* onDefOrigin(const std::string& name, stela& blk);
181 // container:
182 stela* onDefArray(const stela& elem);
183 stela* onDefArray(stela& as, const stela& elem);
184 // file:
185 stela* onCompilationUnit(stela* blk);
186
192 void onParseErr(const std::string& msg, const nchar* symbolName);
197 void report(const std::string& msg);
198
199 private:
200 void _prepare();
201 void* _scanString(const nchar* src, void* scanner);
202 nint _onTokenEndOfInlineBlock(nint tok);
203 nint _onScan(ZZSTYPE* val, ZZLTYPE* loc, zzscan_t scanner);
204 tstr<stela> _finalize();
205
206 private:
207 stelaTokenScan* _mode;
208 nbool _isIgnoreWhitespace;
209 stelaTokenDispatcher _dispatcher;
210 std::vector<ncnt> _indents;
211 tstr<stela> _root;
212 std::vector<nint> _states;
213 stelaSmartDedent _dedent;
214 std::vector<std::string> _errs;
215 };
216} // namespace by
Core AST node for stela configuration language.
Definition stela.hpp:49
Parser for stela configuration language.
Definition stelaParser.hpp:39
void setScan()
Sets the scanning mode for the lexer.
Definition stelaParser.hpp:80
nint onScan(stelaParser &ps, ZZSTYPE *val, ZZLTYPE *loc, zzscan_t scanner, nbool &isBypass) override
Handles scanning for the lexer, overriding the base stelaTokenScanable behavior.
nint onIndent(ncnt col, nint tok)
Handles an increase in indentation.
tstr< stela > parseFromFile(const std::string &path)
Parses stela code from the specified file path.
int popState()
Pops a Flex scanner state from the state stack.
int pushState(int newState)
Pushes a new Flex scanner state onto the state stack.
nint onTokenComma(nint tok)
Handles the comma token.
void onParseErr(const std::string &msg, const nchar *symbolName)
Handles a parse error, reporting the message and the symbol where the error occurred.
nint onTokenColon(nint tok)
Handles the colon token.
tstr< stela > parseFromFile(const nchar *path)
Parses stela code from the specified C-style file path.
tstr< stela > parse(const nchar *codes)
Parses the given C-style string of stela code.
tstr< stela > parse(const std::string &codes)
Parses the given string of stela code.
nchar onScanUnexpected(const nchar *token)
Handles an unexpected token encountered during scanning.
nint onIgnoreIndent(nint tok)
Handles ignoring indentation (e.g., for inline blocks).
stela * onPrimitive(const T &arg)
Creates a valStela object from a primitive value.
Definition stelaParser.hpp:173
void report(const std::string &msg)
Reports a message, typically an error or warning, encountered during parsing.
nint onTokenNewLine(nint tok)
Handles the newline token.
nint onTokenEndOfFile()
Handles the end-of-file token.
nint onDedent(ncnt col, nint tok)
Handles a decrease in indentation.
Smart dedent handler for indentation-based parsing.
Definition stelaSmartDedent.hpp:25
Token dispatcher for managing token queue during parsing.
Definition stelaTokenDispatcher.hpp:14
Base class for token scanning strategies.
Definition stelaTokenScan.hpp:30
Interface for token scanning during stela parsing.
Definition stelaTokenScanable.hpp:19
Value stela node for storing primitive values.
Definition valStela.hpp:17
Version stela node for semantic version handling.
Definition verStela.hpp:17
Rich logging support with polymorphic type conversion.
Definition richLog.hpp:34