mirror of
https://github.com/Relintai/sfw.git
synced 2024-12-20 21:06:49 +01:00
Work on a doc generator.
This commit is contained in:
parent
3e062f3d6f
commit
dc2d3cfeea
8
docs/compile_linux.sh
Executable file
8
docs/compile_linux.sh
Executable file
@ -0,0 +1,8 @@
|
|||||||
|
|
||||||
|
ccache g++ -Wall -g -c sfw.cpp -o sfw.o
|
||||||
|
ccache g++ -Wall -g -c main.cpp -o main.o
|
||||||
|
|
||||||
|
#-static-libgcc -static-libstdc++
|
||||||
|
|
||||||
|
ccache g++ -Wall -lm -ldl -lpthread -lX11 -g sfw.o main.o -o game
|
||||||
|
|
427
docs/main.cpp
Normal file
427
docs/main.cpp
Normal file
@ -0,0 +1,427 @@
|
|||||||
|
|
||||||
|
#include "sfw.h"
|
||||||
|
|
||||||
|
void print_list(const List<String> &list) {
|
||||||
|
for (const List<String>::Element *E = list.front(); E; E = E->next()) {
|
||||||
|
ERR_PRINT(E->get());
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
String get_structure_name(const String &data) {
|
||||||
|
String fl = data.get_slicec('\n', 0);
|
||||||
|
|
||||||
|
String l = fl.get_slicec('{', 0);
|
||||||
|
l = l.get_slicec(':', 0);
|
||||||
|
|
||||||
|
l = l.replace("struct", "").replace("class", "").replace("enum", "").replace("union", "").strip_edges();
|
||||||
|
|
||||||
|
return l;
|
||||||
|
}
|
||||||
|
|
||||||
|
String get_structure_parents(const String &data) {
|
||||||
|
String fl = data.get_slicec('\n', 0);
|
||||||
|
|
||||||
|
String l = fl.get_slicec('{', 0);
|
||||||
|
|
||||||
|
if (!l.contains(":")) {
|
||||||
|
return String();
|
||||||
|
}
|
||||||
|
|
||||||
|
l = l.get_slicec(':', 1);
|
||||||
|
|
||||||
|
//l = l.replace("public", "").replace("protected", "").replace("private", "");
|
||||||
|
l = l.strip_edges();
|
||||||
|
|
||||||
|
return l;
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
bool is_structure_template_specialization_or_parent_is_template(const String &data) {
|
||||||
|
String fl = data.get_slicec('\n', 0);
|
||||||
|
String l = fl.get_slicec('{', 0);
|
||||||
|
|
||||||
|
return l.contains("<");
|
||||||
|
}
|
||||||
|
|
||||||
|
List<String> process_classes_and_structs(const List<String> &list) {
|
||||||
|
List<String> ret;
|
||||||
|
|
||||||
|
for (const List<String>::Element *E = list.front(); E; E = E->next()) {
|
||||||
|
String s = E->get();
|
||||||
|
|
||||||
|
s = s.replace(" _FORCE_INLINE_ ", " ");
|
||||||
|
s = s.replace("_FORCE_INLINE_ ", "");
|
||||||
|
s = s.replace(" _NO_DISCARD_CLASS_ ", " ");
|
||||||
|
s = s.replace(" inline ", " ");
|
||||||
|
s = s.replace("inline ", "");
|
||||||
|
|
||||||
|
Vector<String> lines = s.split("\n");
|
||||||
|
|
||||||
|
if (lines.size() == 0) {
|
||||||
|
continue;
|
||||||
|
}
|
||||||
|
|
||||||
|
if (lines.size() == 1) {
|
||||||
|
ret.push_back(s);
|
||||||
|
continue;
|
||||||
|
}
|
||||||
|
|
||||||
|
String stripped;
|
||||||
|
|
||||||
|
//remove method implementations
|
||||||
|
int current_scope_count = 0;
|
||||||
|
int current_target_scope_count = -1;
|
||||||
|
bool in_method = false;
|
||||||
|
bool method_signature_found = false;
|
||||||
|
String processed_line;
|
||||||
|
for (int i = 0; i < lines.size(); ++i) {
|
||||||
|
String l = lines[i];
|
||||||
|
|
||||||
|
for (int j = 0; j < l.length(); ++j) {
|
||||||
|
CharType current_char = l[j];
|
||||||
|
|
||||||
|
if (current_char == '{') {
|
||||||
|
++current_scope_count;
|
||||||
|
} else if (current_char == '}') {
|
||||||
|
--current_scope_count;
|
||||||
|
|
||||||
|
if (in_method) {
|
||||||
|
if (current_target_scope_count == current_scope_count) {
|
||||||
|
//found method end
|
||||||
|
|
||||||
|
in_method = false;
|
||||||
|
|
||||||
|
processed_line += ";";
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
if (method_signature_found) {
|
||||||
|
if (current_char == ')') {
|
||||||
|
method_signature_found = false;
|
||||||
|
in_method = true;
|
||||||
|
|
||||||
|
processed_line += l.substr_index(0, j + 1);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
if (!in_method) {
|
||||||
|
if (current_char == '(') {
|
||||||
|
method_signature_found = true;
|
||||||
|
current_target_scope_count = current_scope_count;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
if (in_method) {
|
||||||
|
if (current_char == ';') {
|
||||||
|
if (current_target_scope_count == current_scope_count) {
|
||||||
|
//No implementation
|
||||||
|
in_method = false;
|
||||||
|
|
||||||
|
processed_line += ";";
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
if (!in_method) {
|
||||||
|
if (processed_line.size() != 0) {
|
||||||
|
stripped += processed_line + "\n";
|
||||||
|
processed_line.clear();
|
||||||
|
} else {
|
||||||
|
stripped += l + "\n";
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
ret.push_back(stripped);
|
||||||
|
}
|
||||||
|
|
||||||
|
return ret;
|
||||||
|
}
|
||||||
|
|
||||||
|
void process_file(const String &path) {
|
||||||
|
FileAccess f;
|
||||||
|
|
||||||
|
String file_data = f.read_file(path);
|
||||||
|
|
||||||
|
LOG_MSG("Processing file: " + path);
|
||||||
|
|
||||||
|
file_data = file_data.replace("\r", "");
|
||||||
|
|
||||||
|
// Strip comments probably in probably the worst (but simplest) way possible
|
||||||
|
List<String> file_lines_no_comments;
|
||||||
|
Vector<String> fl = file_data.split("\n");
|
||||||
|
|
||||||
|
file_data.clear();
|
||||||
|
|
||||||
|
bool in_multiline_comment = false;
|
||||||
|
bool in_comment = false;
|
||||||
|
for (int i = 0; i < fl.size(); ++i) {
|
||||||
|
String l = fl[i];
|
||||||
|
|
||||||
|
if (in_comment) {
|
||||||
|
if (l[l.length() - 1] != '\\') {
|
||||||
|
//if escaped newline in // style comment, then this will be skipped
|
||||||
|
in_comment = false;
|
||||||
|
continue;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
String final_line;
|
||||||
|
CharType last_char = '\0';
|
||||||
|
int comment_start_index = 0;
|
||||||
|
bool had_comment = false;
|
||||||
|
|
||||||
|
for (int j = 0; j < l.length(); ++j) {
|
||||||
|
CharType current_char = l[j];
|
||||||
|
|
||||||
|
if (!in_multiline_comment) {
|
||||||
|
if (last_char == '/' && current_char == '*') {
|
||||||
|
in_multiline_comment = true;
|
||||||
|
had_comment = true;
|
||||||
|
|
||||||
|
final_line += l.substr_index(comment_start_index, j - 1);
|
||||||
|
|
||||||
|
comment_start_index = j - 1;
|
||||||
|
} else if (last_char == '/' && current_char == '/') {
|
||||||
|
had_comment = true;
|
||||||
|
final_line += l.substr_index(comment_start_index, j - 1);
|
||||||
|
|
||||||
|
in_comment = true;
|
||||||
|
break;
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
if (last_char == '*' && current_char == '/') {
|
||||||
|
comment_start_index = j + 1;
|
||||||
|
|
||||||
|
had_comment = true;
|
||||||
|
|
||||||
|
in_multiline_comment = false;
|
||||||
|
|
||||||
|
//to make sure */* wont be read as both the end and beginning of a comment block on the next iteration
|
||||||
|
++j;
|
||||||
|
current_char = '\0';
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
last_char = current_char;
|
||||||
|
}
|
||||||
|
|
||||||
|
if (in_comment) {
|
||||||
|
if (l[l.length() - 1] != '\\') {
|
||||||
|
//if escaped newline in // style comment, then this will be skipped
|
||||||
|
in_comment = false;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
if (!had_comment && !in_multiline_comment) {
|
||||||
|
file_lines_no_comments.push_back(l);
|
||||||
|
} else {
|
||||||
|
if (!final_line.empty()) {
|
||||||
|
file_lines_no_comments.push_back(final_line);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
fl.clear();
|
||||||
|
|
||||||
|
//print_list(file_lines_no_comments);
|
||||||
|
|
||||||
|
// Strip more than one empty lines in a row
|
||||||
|
List<String> file_lines_no_comments_processed;
|
||||||
|
|
||||||
|
int current_empty_line_count = 0;
|
||||||
|
for (const List<String>::Element *E = file_lines_no_comments.front(); E; E = E->next()) {
|
||||||
|
String l = E->get();
|
||||||
|
|
||||||
|
if (l.strip_edges().empty()) {
|
||||||
|
++current_empty_line_count;
|
||||||
|
|
||||||
|
if (current_empty_line_count <= 1) {
|
||||||
|
file_lines_no_comments_processed.push_back(l);
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
current_empty_line_count = 0;
|
||||||
|
file_lines_no_comments_processed.push_back(l);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
//print_list(file_lines_no_comments_processed);
|
||||||
|
|
||||||
|
file_lines_no_comments.clear();
|
||||||
|
|
||||||
|
// in global scope
|
||||||
|
List<String> enums;
|
||||||
|
List<String> structs;
|
||||||
|
List<String> classes;
|
||||||
|
|
||||||
|
enum Types {
|
||||||
|
TYPE_NONE = 0,
|
||||||
|
TYPE_ENUM,
|
||||||
|
TYPE_STRUCT,
|
||||||
|
TYPE_CLASS,
|
||||||
|
};
|
||||||
|
|
||||||
|
Types current_type = TYPE_NONE;
|
||||||
|
int current_scope_level = 0;
|
||||||
|
String current_str;
|
||||||
|
for (const List<String>::Element *E = file_lines_no_comments_processed.front(); E; E = E->next()) {
|
||||||
|
String l = E->get();
|
||||||
|
|
||||||
|
if (current_type == TYPE_NONE) {
|
||||||
|
if (l.contains("template")) {
|
||||||
|
current_str = l + "\n";
|
||||||
|
}
|
||||||
|
|
||||||
|
//Not we should be able to do this, because of how the code style is
|
||||||
|
if (l.contains("enum ") && l.contains("{")) {
|
||||||
|
if (l.contains("}")) {
|
||||||
|
enums.push_back(current_str);
|
||||||
|
//ERR_PRINT("TYPE_ENUM");
|
||||||
|
//ERR_PRINT(current_str);
|
||||||
|
current_str.clear();
|
||||||
|
continue;
|
||||||
|
}
|
||||||
|
|
||||||
|
// We only care about global scope stuff, so this should always work
|
||||||
|
current_scope_level = 1;
|
||||||
|
current_type = TYPE_ENUM;
|
||||||
|
current_str += l + "\n";
|
||||||
|
continue;
|
||||||
|
} else if (l.contains("struct ") && l.contains("{")) {
|
||||||
|
if (l.contains("}")) {
|
||||||
|
structs.push_back(current_str);
|
||||||
|
//ERR_PRINT("TYPE_STRUCT");
|
||||||
|
//ERR_PRINT(current_str);
|
||||||
|
current_str.clear();
|
||||||
|
continue;
|
||||||
|
}
|
||||||
|
|
||||||
|
current_scope_level = 1;
|
||||||
|
current_type = TYPE_STRUCT;
|
||||||
|
current_str += l + "\n";
|
||||||
|
continue;
|
||||||
|
} else if (l.contains("class ") && l.contains("{")) {
|
||||||
|
if (l.contains("}")) {
|
||||||
|
classes.push_back(current_str);
|
||||||
|
//ERR_PRINT("TYPE_CLASS");
|
||||||
|
//ERR_PRINT(current_str);
|
||||||
|
current_str.clear();
|
||||||
|
continue;
|
||||||
|
}
|
||||||
|
|
||||||
|
current_scope_level = 1;
|
||||||
|
current_type = TYPE_CLASS;
|
||||||
|
current_str += l + "\n";
|
||||||
|
continue;
|
||||||
|
}
|
||||||
|
|
||||||
|
if (!current_str.empty()) {
|
||||||
|
current_str.clear();
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
for (int j = 0; j < l.length(); ++j) {
|
||||||
|
CharType current_char = l[j];
|
||||||
|
|
||||||
|
if (current_char == '}') {
|
||||||
|
--current_scope_level;
|
||||||
|
|
||||||
|
if (current_scope_level == 0) {
|
||||||
|
current_str += l + "\n";
|
||||||
|
|
||||||
|
switch (current_type) {
|
||||||
|
case TYPE_NONE:
|
||||||
|
//cant happen
|
||||||
|
break;
|
||||||
|
case TYPE_ENUM:
|
||||||
|
enums.push_back(current_str);
|
||||||
|
//ERR_PRINT("TYPE_ENUM");
|
||||||
|
break;
|
||||||
|
case TYPE_STRUCT:
|
||||||
|
structs.push_back(current_str);
|
||||||
|
//ERR_PRINT("TYPE_STRUCT");
|
||||||
|
break;
|
||||||
|
case TYPE_CLASS:
|
||||||
|
classes.push_back(current_str);
|
||||||
|
//ERR_PRINT("TYPE_CLASS");
|
||||||
|
break;
|
||||||
|
}
|
||||||
|
|
||||||
|
//ERR_PRINT(current_str);
|
||||||
|
|
||||||
|
current_type = TYPE_NONE;
|
||||||
|
current_str.clear();
|
||||||
|
continue;
|
||||||
|
}
|
||||||
|
} else if (current_char == '{') {
|
||||||
|
++current_scope_level;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
current_str += l + "\n";
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
file_lines_no_comments_processed.clear();
|
||||||
|
|
||||||
|
structs = process_classes_and_structs(structs);
|
||||||
|
classes = process_classes_and_structs(classes);
|
||||||
|
|
||||||
|
//ERR_PRINT("ENUMS");
|
||||||
|
//print_list(enums);
|
||||||
|
//ERR_PRINT("STRUCTS");
|
||||||
|
//print_list(structs);
|
||||||
|
//ERR_PRINT("CLASSES");
|
||||||
|
//print_list(classes);
|
||||||
|
|
||||||
|
ERR_PRINT("ENUMS");
|
||||||
|
|
||||||
|
for (const List<String>::Element *E = enums.front(); E; E = E->next()) {
|
||||||
|
ERR_PRINT(get_structure_name(E->get()));
|
||||||
|
}
|
||||||
|
|
||||||
|
ERR_PRINT("STRUCTS");
|
||||||
|
|
||||||
|
for (const List<String>::Element *E = structs.front(); E; E = E->next()) {
|
||||||
|
ERR_PRINT(get_structure_name(E->get()));
|
||||||
|
ERR_PRINT(get_structure_parents(E->get()));
|
||||||
|
ERR_PRINT("=====");
|
||||||
|
if (is_structure_template_specialization_or_parent_is_template(E->get())) {
|
||||||
|
ERR_PRINT("!!!!!!");
|
||||||
|
}
|
||||||
|
}
|
||||||
|
ERR_PRINT("CLASSES");
|
||||||
|
|
||||||
|
for (const List<String>::Element *E = classes.front(); E; E = E->next()) {
|
||||||
|
ERR_PRINT(get_structure_name(E->get()));
|
||||||
|
ERR_PRINT(get_structure_parents(E->get()));
|
||||||
|
ERR_PRINT("=====");
|
||||||
|
if (is_structure_template_specialization_or_parent_is_template(E->get())) {
|
||||||
|
ERR_PRINT("!!!!!!");
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
//ERR_PRINT("COUNT");
|
||||||
|
//ERR_PRINT(itos(enums.size()));
|
||||||
|
//ERR_PRINT(itos(structs.size()));
|
||||||
|
//ERR_PRINT(itos(classes.size()));
|
||||||
|
}
|
||||||
|
|
||||||
|
int main(int argc, char **argv) {
|
||||||
|
SFWCore::setup();
|
||||||
|
|
||||||
|
List<String> args;
|
||||||
|
|
||||||
|
for (int i = 1; i < argc; ++i) {
|
||||||
|
args.push_back(String::utf8(argv[i]));
|
||||||
|
}
|
||||||
|
|
||||||
|
for (List<String>::Element *E = args.front(); E; E = E->next()) {
|
||||||
|
process_file(E->get());
|
||||||
|
}
|
||||||
|
|
||||||
|
SFWCore::cleanup();
|
||||||
|
|
||||||
|
return 0;
|
||||||
|
}
|
Loading…
Reference in New Issue
Block a user