gencpp/project
2023-07-23 23:28:21 -04:00
..
gen.cpp Should support parsing full definitions within typedef... (need to make tests) 2023-07-23 23:28:21 -04:00
gen.dep.cpp Update to readme, update CodePool_NumBlocks to 64k 2023-07-21 01:12:38 -04:00
gen.dep.hpp Added macros to make the gen namespace optional. 2023-07-23 22:25:19 -04:00
gen.editor.hpp Update to readme, update CodePool_NumBlocks to 64k 2023-07-21 01:12:38 -04:00
gen.hpp Adding tuning macros for memory usage of the library, fixes. 2023-07-23 23:11:53 -04:00
gen.pop_ignores.inline.hpp Some refactors (see description) 2023-07-18 23:33:00 -04:00
gen.push_ignores.inline.hpp Some refactors (see description) 2023-07-18 23:33:00 -04:00
gen.scanner.hpp Update to readme, update CodePool_NumBlocks to 64k 2023-07-21 01:12:38 -04:00
gen.undef.macros.hpp Removed GEN_FEATURE_PARSING macro, fixes to readme 2023-07-19 00:14:15 -04:00
Readme.md Moved the indentation for the library over 2023-07-19 23:42:28 -04:00

Documentation

The core library is contained within gen.hpp and gen.cpp. Things related to the editor and scanner are in their own respective files. (Ex: gen.scanner.<hpp/cpp> )

gen.hpp

Feature Macros:

  • GEN_DONT_ENFORCE_GEN_TIME_GUARD : By default, the library ( gen.hpp/ gen.cpp ) expects the macro GEN_TIME to be defined, this disables that.
  • GEN_ROLL_OWN_DEPENDENCIES : Optional override so that user may define the dependencies themselves.
  • GEN_DEFINE_LIBRARY_CORE_CONSTANTS : Optional typename codes as they are non-standard to C/C++ and not necessary to library usage
  • GEN_ENFORCE_STRONG_CODE_TYPES : Enforces casts to filtered code types.

GEN_USE_RECURSIVE_AST_DUPLICATION is available but its not well tested and should not need to be used.
If constructing ASTs properly. There should be no modification of ASTs, and thus this would never become an issue.
(I will probably remove down the line...)

Due to the design of gen.hpp to support being written alongside runtime intended code (in the same file), all the code is wrapped in a GEN_TIME #ifdef and then wrapped further in a gen namespace to avoid pollution of the global scope.

Note: Its possible with the scanner feature to support parsing runtime files that use "generic" macros or identifiers with certain patterns.
This can be used to auto-queue generation of dependent definitions for the symbols used.

Organization

Dependencies : Mostly from the c-zpl library.

log_failure definition : based on whether to always use fatal on all errors

Major enum definitions and their associated functions used with the AST data

  • ECode : Used to tag ASTs by their type
  • EOperator : Used to tag operator overloads with their op type
  • ESpecifier : Used with specifier ASTs for all specifiers the user may tag an associated AST with.
  • AccessSpec : Used with class and struct ASTs to denote the public, protected, or private fields.
  • EnumT : Used with def_enum to determine if constructing a regular enum or an enum class.
  • ModuleFlag : Used with any valid definition that can have export or import related keywords associated with it.

Data Structures

StringCache : Hash table for cached strings. (StringCached typedef used to denote strings managed by it)

Code : Wrapper for AST with functionality for handling it appropriately.
AST : The node data structure for the code.
Code Types : Codes with typed ASTs. Body, Param, and Specifier have unique implementation, the rest use Define_CodeType
AST Types : Filtered AST definitions.

Gen Interface

First set of forwards are either backend functions used for various aspects of AST generation or configurations allocators used for different containers.

Interface forwards defined in order of: Upfront, Parsing, Untyped.

From there forwards for the File handlers are defined: Builder, Editor, Scanner.

Macros

General helper macros are defined along with the optional DSL macros.

Constants

Constants including optional ones are defined.

Inlines

Inlined functions related to the AST datatype that required forwards for gen interface functions are defined.

gen.cpp

  • Dependencies
  • Static data
  • AST Body case macros are next.
  • AST implementation
  • Gen interface begins with its init, deinit, etc.. Until make_code_entires
  • operator__validate defined, which will be used to verify if an operator definition is constructible.
  • Allocator interface for data arrays, code pool, code entries, string arenas, and string table.
  • Helper macros used throughout the constructor API
  • Upfront constructors, following the same order as shown in the header.
  • Parsing constructors, it defines its own lexer, and has many helper functions for parsing not exposed through the header.
  • Untyped constructors
  • Builder
  • Editor
  • Scanner