ed/gencpp
1
0
Fork 0
mirror of https://github.com/Ed94/gencpp.git synced 2024-11-10 02:54:53 -08:00
Code Issues Packages Projects Releases Wiki Activity

namespace macro unused in gen.dep.cpp, updates to readme.

Browse Source
This commit is contained in:
Edward R. Gonzalez 2023-07-24 14:30:35 -04:00
parent 39390535ce
commit 88a43cb11f
2 changed files with 14 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

16
Readme.md
View File

@ -5,6 +5,14 @@ An attempt at simple staged metaprogramming for c/c++.
The library API is a composition of code element constructors. The library API is a composition of code element constructors.
These build up a code AST to then serialize with a file builder. These build up a code AST to then serialize with a file builder.
General goal is to have a less than 15k sloc library that takes at most a couple of hours to learn and make use of.
*Why 15?* Assuming a seasoned coder of C++ can read and understand around 1000-2000 lines of code per hour, 15,000 could be understood in under 16-18 hours
and have confidence in modifying for their use case.
This code base attempts follow the [handmade philosophy](https://handmade.network/manifesto),
its not meant to be a black box metaprogramming utility, its meant for the user to extend for their project domain.
### TOC ### TOC
* [Notes](#notes) * [Notes](#notes)
@ -171,8 +179,7 @@ This method is setup where all the metaprogram's code are the within the same fi
* Execution statement validation : Execution expressions are defined using the untyped API. * Execution statement validation : Execution expressions are defined using the untyped API.
* Lambdas (This naturally means its unsupported) * Lambdas (This naturally means its unsupported)
* RAII : This needs support for constructors/destructor parsing * RAII : This needs support for constructors/destructor parsing
* I haven't gotten around to yet, only useful (to me) for third-party scanning * Haven't gotten around to yet, only useful (to me) for third-party scanning
* Multiple Inheritance : Working on it..
Keywords kept from "Modern C++": Keywords kept from "Modern C++":
@ -461,6 +468,7 @@ The lexing and parsing takes shortcuts from whats expected in the standard.
* typedefs have attributes with the type (`parse_type`) * typedefs have attributes with the type (`parse_type`)
* As a general rule; if its not available from the upfront constructors, its not available in the parsing constructors. * As a general rule; if its not available from the upfront constructors, its not available in the parsing constructors.
* *Upfront constructors are not necessarily used in the parsing constructors, this is just a good metric to know what can be parsed.* * *Upfront constructors are not necessarily used in the parsing constructors, this is just a good metric to know what can be parsed.*
* Parsing attributes can be extended to support user defined macros by defining `GEN_Define_Attribute_Tokens` (see `gen.hpp` for the formatting)
Usage: Usage:
@ -685,7 +693,7 @@ Names or Content fields are interned strings and thus showed be cached using `ge
`def_operator` is the most sophisticated constructor as it has multiple permutations of definitions that could be created that are not trivial to determine if valid. `def_operator` is the most sophisticated constructor as it has multiple permutations of definitions that could be created that are not trivial to determine if valid.
If extendeding parsing capability If extendeding parsing capability, ECode, ESpecifier, may need to be modified along with making a new `AST_<Name>` and `Code<Name>` if its desired to preserve the same interface. The lexer (see the `Parser` namespace in `gen.cpp`) will most likely also need to be extended to support any unsupported or custom tokens.
# TODO # TODO
@ -705,7 +713,7 @@ If extendeding parsing capability
* Convert GlobalAllocator to a slab allocator: * Convert GlobalAllocator to a slab allocator:
```md ```md
Slab classes (for 10 mb arena) Slab classes (for 100 mb arena)
1KB slab: 5MB ( 5MB / 1KB ~ 5,000 blocks ) 1KB slab: 5MB ( 5MB / 1KB ~ 5,000 blocks )
4KB slab: 10MB ( 10MB / 4KB ~ 2,500 blocks ) 4KB slab: 10MB ( 10MB / 4KB ~ 2,500 blocks )

5
project/dependencies/gen.dep.cpp
View File

@ -81,7 +81,7 @@
#pragma endregion Macros & Includes #pragma endregion Macros & Includes
namespace gen { GEN_NS_BEGIN
#pragma region Debug #pragma region Debug
void assert_handler( char const* condition, char const* file, s32 line, char const* msg, ... ) void assert_handler( char const* condition, char const* file, s32 line, char const* msg, ... )
@ -3265,5 +3265,4 @@ namespace gen {
#endif #endif
#pragma endregion Timing #pragma endregion Timing
// namespace gen GEN_NS_END
}