parser: Add JSON support with --json (#1812)
This commit is contained in:
Rob Loach
GitHub
parent
246798a0ba
commit
32f3f53718
2 changed files with 155 additions and 25 deletions
|
|
@ -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.
|
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
|
## Constraints
|
||||||
|
|
||||||
This parser is specifically designed to work with raylib.h, so, it has some constraints:
|
This parser is specifically designed to work with raylib.h, so, it has some constraints:
|
||||||
|
|
|
||||||
|
|
@ -66,6 +66,8 @@
|
||||||
#define MAX_LINE_LENGTH 512 // Maximum length of one line (including comments)
|
#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)
|
#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
|
// 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);
|
void GetDataTypeAndName(const char *typeName, int typeNameLen, char *type, char *name);
|
||||||
bool IsTextEqual(const char *text1, const char *text2, unsigned int count);
|
bool IsTextEqual(const char *text1, const char *text2, unsigned int count);
|
||||||
void MemoryCopy(void *dest, const void *src, unsigned int count);
|
void MemoryCopy(void *dest, const void *src, unsigned int count);
|
||||||
|
char* CharReplace(char* text, char search, char replace);
|
||||||
|
|
||||||
// Main entry point
|
// 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;
|
int length = 0;
|
||||||
char *buffer = LoadFileText("../src/raylib.h", &length);
|
char *buffer = LoadFileText("../src/raylib.h", &length);
|
||||||
|
|
||||||
|
|
@ -466,6 +482,9 @@ int main()
|
||||||
// funcs[] -> We have all the functions decomposed into pieces for further analysis
|
// funcs[] -> We have all the functions decomposed into pieces for further analysis
|
||||||
|
|
||||||
// Print structs info
|
// Print structs info
|
||||||
|
switch (outputFormat)
|
||||||
|
{
|
||||||
|
case PlainText: {
|
||||||
printf("\nStructures found: %i\n\n", structCount);
|
printf("\nStructures found: %i\n\n", structCount);
|
||||||
for (int i = 0; i < structCount; i++)
|
for (int i = 0; i < structCount; i++)
|
||||||
{
|
{
|
||||||
|
|
@ -493,6 +512,101 @@ int main()
|
||||||
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]);
|
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");
|
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);
|
free(funcs);
|
||||||
free(structs);
|
free(structs);
|
||||||
|
|
@ -631,6 +745,15 @@ bool IsTextEqual(const char *text1, const char *text2, unsigned int count)
|
||||||
return result;
|
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
|
// Replace text string
|
||||||
// REQUIRES: strlen(), strstr(), strncpy(), strcpy() -> TODO: Replace by custom implementations!
|
// REQUIRES: strlen(), strstr(), strncpy(), strcpy() -> TODO: Replace by custom implementations!
|
||||||
|
|
|
||||||
Loading…
Add table
Add a link
Reference in a new issue