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