mirrors/raylib
1
0
Fork 0
mirror of https://github.com/raysan5/raylib.git synced 2025-10-26 12:27:01 +00:00
Code Issues Packages Projects Releases Wiki Activity

parser: Add JSON support with --json (#1812)

Browse Source
This commit is contained in:
Rob Loach
2021-06-06 04:21:56 -04:00
committed by GitHub
parent 246798a0ba
commit 32f3f53718
2 changed files with 155 additions and 25 deletions
Download Patch File Download Diff File Expand all files Collapse all files

7
parser/README.md
View File

@@ -9,6 +9,13 @@ All data is separated into parts, usually as strings. The following types are us
Check `raylib_parser.c` for details about those structs.
## Command Line Arguments
The parser can take a few options...
- `--help` Displays help information about the parser
- `--json` Outputs the header information in JSON format
## Constraints
This parser is specifically designed to work with raylib.h, so, it has some constraints:

173
parser/raylib_parser.c
View File

@@ -66,6 +66,8 @@
#define MAX_LINE_LENGTH 512 // Maximum length of one line (including comments)
#define MAX_STRUCT_LINE_LENGTH 2048 // Maximum length of one struct (multiple lines)
enum OutputFormat { PlainText, JSON }; // Which format the header information should be in
//----------------------------------------------------------------------------------
// Types and Structures Definition
//----------------------------------------------------------------------------------
@@ -107,10 +109,24 @@ char **GetTextLines(const char *buffer, int length, int *linesCount);
void GetDataTypeAndName(const char *typeName, int typeNameLen, char *type, char *name);
bool IsTextEqual(const char *text1, const char *text2, unsigned int count);
void MemoryCopy(void *dest, const void *src, unsigned int count);
char* CharReplace(char* text, char search, char replace);
// Main entry point
int main()
int main(int argc, char* argv[])
{
// Help
if (IsTextEqual(argv[1], "--help", 6)) {
printf("Usage:\n");
printf(" raylib_parser [--json]\n");
return 0;
}
// Allow changing the output format.
int outputFormat = 0;
if (IsTextEqual(argv[1], "--json", 6)) {
outputFormat = JSON;
}
int length = 0;
char *buffer = LoadFileText("../src/raylib.h", &length);
@@ -466,32 +482,130 @@ int main()
// funcs[] -> We have all the functions decomposed into pieces for further analysis
// Print structs info
printf("\nStructures found: %i\n\n", structCount);
for (int i = 0; i < structCount; i++)
switch (outputFormat)
{
printf("Struct %02i: %s (%i fields)\n", i + 1, structs[i].name, structs[i].fieldCount);
//printf("Description: %s\n", structs[i].desc);
for (int f = 0; f < structs[i].fieldCount; f++) printf(" Fields %i: %s %s %s\n", f + 1, structs[i].fieldType[f], structs[i].fieldName[f], structs[i].fieldDesc[f]);
}
case PlainText: {
printf("\nStructures found: %i\n\n", structCount);
for (int i = 0; i < structCount; i++)
{
printf("Struct %02i: %s (%i fields)\n", i + 1, structs[i].name, structs[i].fieldCount);
//printf("Description: %s\n", structs[i].desc);
for (int f = 0; f < structs[i].fieldCount; f++) printf(" Fields %i: %s %s %s\n", f + 1, structs[i].fieldType[f], structs[i].fieldName[f], structs[i].fieldDesc[f]);
}
// Print enums info
printf("\nEnums found: %i\n\n", enumCount);
for (int i = 0; i < enumCount; i++)
{
printf("Enum %02i: %s (%i values)\n", i + 1, enums[i].name, enums[i].valueCount);
//printf("Description: %s\n", enums[i].desc);
for (int e = 0; e < enums[i].valueCount; e++) printf(" Value %s: %i\n", enums[i].valueName[e], enums[i].valueInteger[e]);
}
// Print function info
printf("\nFunctions found: %i\n\n", funcCount);
for (int i = 0; i < funcCount; i++)
{
printf("Function %03i: %s() (%i input parameters)\n", i + 1, funcs[i].name, funcs[i].paramCount);
printf(" Description: %s\n", funcs[i].desc);
printf(" Return type: %s\n", funcs[i].retType);
for (int p = 0; p < funcs[i].paramCount; p++) printf(" Param %i: %s (type: %s)\n", p + 1, funcs[i].paramName[p], funcs[i].paramType[p]);
if (funcs[i].paramCount == 0) printf(" No input parameters\n");
// Print enums info
printf("\nEnums found: %i\n\n", enumCount);
for (int i = 0; i < enumCount; i++)
{
printf("Enum %02i: %s (%i values)\n", i + 1, enums[i].name, enums[i].valueCount);
//printf("Description: %s\n", enums[i].desc);
for (int e = 0; e < enums[i].valueCount; e++) printf(" Value %s: %i\n", enums[i].valueName[e], enums[i].valueInteger[e]);
}
// Print function info
printf("\nFunctions found: %i\n\n", funcCount);
for (int i = 0; i < funcCount; i++)
{
printf("Function %03i: %s() (%i input parameters)\n", i + 1, funcs[i].name, funcs[i].paramCount);
printf(" Description: %s\n", funcs[i].desc);
printf(" Return type: %s\n", funcs[i].retType);
for (int p = 0; p < funcs[i].paramCount; p++) printf(" Param %i: %s (type: %s)\n", p + 1, funcs[i].paramName[p], funcs[i].paramType[p]);
if (funcs[i].paramCount == 0) printf(" No input parameters\n");
}
} break;
case JSON: {
printf("{\n");
printf(" \"structs\": [\n");
for (int i = 0; i < structCount; i++)
{
printf(" {\n");
printf(" \"name\": \"%s\",\n", structs[i].name);
printf(" \"description\": \"%s\",\n", structs[i].desc);
printf(" \"fields\": [\n");
for (int f = 0; f < structs[i].fieldCount; f++)
{
printf(" {\n");
printf(" \"name\": \"%s\",\n", structs[i].fieldName[f]),
printf(" \"type\": \"%s\",\n", structs[i].fieldType[f]),
printf(" \"description\": \"%s\"\n", structs[i].fieldDesc[f] + 3),
printf(" }");
if (f < structs[i].fieldCount - 1)
printf(",\n");
else
printf("\n");
}
printf(" ]\n");
printf(" }");
if (i < structCount - 1)
printf(",\n");
else
printf("\n");
}
printf(" ],\n");
// Print enums info
printf(" \"enums\": [\n");
for (int i = 0; i < enumCount; i++)
{
printf(" {\n");
printf(" \"name\": \"%s\",\n", enums[i].name);
printf(" \"description\": \"%s\",\n", enums[i].desc + 3);
printf(" \"values\": [\n");
for (int e = 0; e < enums[i].valueCount; e++)
{
printf(" {\n");
printf(" \"name\": \"%s\",\n", enums[i].valueName[e]),
printf(" \"value\": %i,\n", enums[i].valueInteger[e]),
printf(" \"description\": \"%s\"\n", enums[i].valueDesc[e] + 3),
printf(" }");
if (e < enums[i].valueCount - 1)
printf(",\n");
else
printf("\n");
}
printf(" ]\n");
printf(" }");
if (i < enumCount - 1)
printf(",\n");
else
printf("\n");
}
printf(" ],\n");
// Print function info
printf(" \"functions\": [\n");
for (int i = 0; i < funcCount; i++)
{
printf(" {\n");
printf(" \"name\": \"%s\",\n", funcs[i].name);
printf(" \"description\": \"%s\",\n", CharReplace(funcs[i].desc, '\\', ' ') + 3);
printf(" \"returnType\": \"%s\"", funcs[i].retType);
if (funcs[i].paramCount == 0)
printf("\n");
else
{
printf(",\n \"params\": {\n");
for (int p = 0; p < funcs[i].paramCount; p++)
{
printf(" \"%s\": \"%s\"", funcs[i].paramName[p], funcs[i].paramType[p]);
if (p < funcs[i].paramCount - 1)
printf(",\n");
else
printf("\n");
}
printf(" }\n");
}
printf(" }");
if (i < funcCount - 1)
printf(",\n");
else
printf("\n");
}
printf(" ]\n");
printf("}\n");
} break;
}
free(funcs);
@@ -631,6 +745,15 @@ bool IsTextEqual(const char *text1, const char *text2, unsigned int count)
return result;
}
// Search and replace a character within a string.
char* CharReplace(char* text, char search, char replace)
{
for (int i = 0; text[i] != '\0'; i++)
if (text[i] == search)
text[i] = replace;
return text;
}
/*
// Replace text string
// REQUIRES: strlen(), strstr(), strncpy(), strcpy() -> TODO: Replace by custom implementations!