mirror of
https://github.com/HenkKalkwater/harbour-sailfin.git
synced 2024-11-22 09:15:18 +00:00
Initial OpenApi code generator
This commit is contained in:
parent
f7bca333c8
commit
0bd9042ef3
55380
core/openapi.json
Normal file
55380
core/openapi.json
Normal file
File diff suppressed because it is too large
Load diff
476
core/openapigenerator.d
Executable file
476
core/openapigenerator.d
Executable file
|
|
@ -0,0 +1,476 @@
|
||||||
|
#!/usr/bin/env dub
|
||||||
|
/+ dub.sdl:
|
||||||
|
name "openapigenerator.d"
|
||||||
|
dependency "dyaml" version="~>0.8.0"
|
||||||
|
+/
|
||||||
|
import std.algorithm;
|
||||||
|
import std.array;
|
||||||
|
import std.file : mkdirRecurse;
|
||||||
|
import std.exception;
|
||||||
|
import std.path : buildPath, dirSeparator;
|
||||||
|
import std.range;
|
||||||
|
import std.string;
|
||||||
|
import std.stdio;
|
||||||
|
import std.uni;
|
||||||
|
|
||||||
|
import dyaml;
|
||||||
|
|
||||||
|
// CODE GENERATION SETTINGS
|
||||||
|
CasePolicy OPENAPI_CASING = CasePolicy.PASCAL;
|
||||||
|
|
||||||
|
string[] CPP_NAMESPACE = ["Jellyfin", "DTO"];
|
||||||
|
string INCLUDE_PREFIX = "JellyfinQt/DTO";
|
||||||
|
CasePolicy CPP_FILENAME_CASING = CasePolicy.LOWER;
|
||||||
|
CasePolicy CPP_CLASS_CASING = CasePolicy.PASCAL;
|
||||||
|
CasePolicy CPP_CLASS_MEMBER_CASING = CasePolicy.CAMEL;
|
||||||
|
// Prefix for class members.
|
||||||
|
string CPP_CLASS_MEMBER_PREFIX = "m_";
|
||||||
|
CasePolicy CPP_CLASS_METHOD_CASING = CasePolicy.CAMEL;
|
||||||
|
bool GENERATE_PROPERTIES = true;
|
||||||
|
|
||||||
|
// Implementation
|
||||||
|
string outputDirectory = "generated";
|
||||||
|
|
||||||
|
enum CasePolicy {
|
||||||
|
KEEP, // Do not modify
|
||||||
|
PASCAL, // PascalCase
|
||||||
|
CAMEL, // camelCase
|
||||||
|
SNAKE, // snake_case
|
||||||
|
SCREAMING_SNAKE, // SCREAMING_SNAKE_CASE
|
||||||
|
LOWER, // lowercase
|
||||||
|
UPPER // UPPERCASE
|
||||||
|
}
|
||||||
|
|
||||||
|
string USAGE = "USAGE: %s <openapi scheme>";
|
||||||
|
|
||||||
|
class CLIArgumentException : Exception {
|
||||||
|
mixin basicExceptionCtors;
|
||||||
|
}
|
||||||
|
|
||||||
|
int main(string[] args) {
|
||||||
|
try {
|
||||||
|
realMain(args);
|
||||||
|
} catch (CLIArgumentException e) {
|
||||||
|
stderr.writeln(e.message);
|
||||||
|
return -1;
|
||||||
|
}
|
||||||
|
return 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
void realMain(string[] args) {
|
||||||
|
enforce!CLIArgumentException(args.length >= 2, USAGE.format(args[0]));
|
||||||
|
string schemeFile = args[1];
|
||||||
|
|
||||||
|
if (args.length >= 3) outputDirectory = args[2];
|
||||||
|
mkdirRecurse(buildPath(outputDirectory, "include", INCLUDE_PREFIX));
|
||||||
|
mkdirRecurse(buildPath(outputDirectory, "src"));
|
||||||
|
|
||||||
|
Node root = Loader.fromFile(schemeFile).load();
|
||||||
|
foreach(ref string key, ref const Node scheme; root["components"]["schemas"]) {
|
||||||
|
generateFileForSchema(key, scheme, root["components"]["schemas"]);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
void generateFileForSchema(ref string name, ref const Node scheme, Node allSchemas) {
|
||||||
|
string fileBase = name.applyCasePolicy(OPENAPI_CASING, CPP_FILENAME_CASING);
|
||||||
|
File headerFile = File(buildPath(outputDirectory, "include", INCLUDE_PREFIX, fileBase ~ ".h"), "w+");
|
||||||
|
File implementationFile = File(buildPath(outputDirectory, "src", fileBase ~ ".cpp"), "w+");
|
||||||
|
|
||||||
|
if ("enum" in scheme) {
|
||||||
|
string[1] imports = ["QObject"];
|
||||||
|
writeHeaderPreamble(headerFile, name, imports);
|
||||||
|
|
||||||
|
Appender!(string[]) values;
|
||||||
|
foreach (string value; scheme["enum"]) {
|
||||||
|
values ~= value;
|
||||||
|
}
|
||||||
|
writeEnumHeader(headerFile, name, values[]);
|
||||||
|
writeHeaderPostamble(headerFile, name);
|
||||||
|
|
||||||
|
writeImplementationPreamble(implementationFile, name);
|
||||||
|
writeEnumImplementation(implementationFile, name);
|
||||||
|
writeImplementationPostamble(implementationFile, name);
|
||||||
|
}
|
||||||
|
if (scheme["type"].as!string == "object" && "properties" in scheme) {
|
||||||
|
// Determine all imports
|
||||||
|
Appender!(string[]) systemImports, userImports;
|
||||||
|
systemImports ~= ["QObject"];
|
||||||
|
|
||||||
|
MetaTypeInfo[] usedTypes = collectTypeInfo(scheme["properties"], allSchemas);
|
||||||
|
bool importedContainers = false;
|
||||||
|
void collectImports(MetaTypeInfo type) {
|
||||||
|
if (type.needsSystemImport && !systemImports[].canFind(type.typeName)) {
|
||||||
|
if (type.isContainer) {
|
||||||
|
if (!importedContainers) {
|
||||||
|
systemImports ~= ["QList", "QStringList"];
|
||||||
|
importedContainers = true;
|
||||||
|
}
|
||||||
|
if (type.containerType !is null) {
|
||||||
|
collectImports(type.containerType);
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
systemImports ~= [type.typeName];
|
||||||
|
}
|
||||||
|
} else if (type.needsLocalImport && !userImports[].canFind(type.typeName)) {
|
||||||
|
userImports ~= type.typeName;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
foreach (type; usedTypes) {
|
||||||
|
collectImports(type);
|
||||||
|
}
|
||||||
|
|
||||||
|
// Sort them for nicer reading
|
||||||
|
string[] sortedSystemImports = sort(systemImports[]).array;
|
||||||
|
string[] sortedUserImports = sort(userImports[]).array;
|
||||||
|
|
||||||
|
// Write implementation files
|
||||||
|
writeHeaderPreamble(headerFile, name, sortedSystemImports);
|
||||||
|
writeObjectHeader(headerFile, name, usedTypes, sortedUserImports);
|
||||||
|
writeHeaderPostamble(headerFile, name);
|
||||||
|
|
||||||
|
writeImplementationPreamble(implementationFile, name, sortedUserImports);
|
||||||
|
writeObjectImplementation(implementationFile, name, usedTypes);
|
||||||
|
writeImplementationPostamble(implementationFile, name);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// Object
|
||||||
|
MetaTypeInfo[] collectTypeInfo(Node properties, Node allSchemas) {
|
||||||
|
|
||||||
|
// We need to recurse (sometimes)
|
||||||
|
MetaTypeInfo getType(string name, Node node) {
|
||||||
|
MetaTypeInfo info = new MetaTypeInfo();
|
||||||
|
info.name = name.applyCasePolicy(OPENAPI_CASING, CPP_CLASS_MEMBER_CASING);
|
||||||
|
if ("description" in node) {
|
||||||
|
info.description = node["description"].as!string;
|
||||||
|
}
|
||||||
|
|
||||||
|
// Special case for QML
|
||||||
|
if (info.name.toLower() == "id") info.name = "jellyfinId";
|
||||||
|
|
||||||
|
if ("$ref" in node) {
|
||||||
|
string type = node["$ref"].as!string()["#/components/schemas/".length..$];
|
||||||
|
if (type in allSchemas&& "type" in allSchemas[type]
|
||||||
|
&& allSchemas[type]["type"].as!string == "object") {
|
||||||
|
info.needsPointer = true;
|
||||||
|
}
|
||||||
|
info.needsLocalImport = true;
|
||||||
|
info.typeName = type;
|
||||||
|
return info;
|
||||||
|
}
|
||||||
|
if (!("type" in node)) {
|
||||||
|
info.typeName = "QVariant";
|
||||||
|
info.needsSystemImport = true;
|
||||||
|
return info;
|
||||||
|
}
|
||||||
|
switch(node["type"].as!string) {
|
||||||
|
case "boolean":
|
||||||
|
info.typeName = "bool";
|
||||||
|
return info;
|
||||||
|
case "string":
|
||||||
|
if ("format" in node) {
|
||||||
|
switch(node["format"].as!string) {
|
||||||
|
case "date-time":
|
||||||
|
info.typeName= "QDateTime";
|
||||||
|
info.needsSystemImport = true;
|
||||||
|
return info;
|
||||||
|
default:
|
||||||
|
break;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
info.typeName= "QString";
|
||||||
|
info.needsSystemImport = true;
|
||||||
|
return info;
|
||||||
|
case "integer":
|
||||||
|
if ("format" in node) {
|
||||||
|
info.typeName= "q" ~ node["format"].as!string;
|
||||||
|
return info;
|
||||||
|
}
|
||||||
|
goto default;
|
||||||
|
case "number":
|
||||||
|
if ("format" in node) {
|
||||||
|
switch(node["format"].as!string) {
|
||||||
|
case "float":
|
||||||
|
case "double":
|
||||||
|
info.typeName = node["format"].as!string;
|
||||||
|
return info;
|
||||||
|
default:
|
||||||
|
break;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
goto default;
|
||||||
|
case "object":
|
||||||
|
info.typeName = "QJsonObject"; // This'll do for now
|
||||||
|
return info;
|
||||||
|
case "array":
|
||||||
|
MetaTypeInfo containedType = getType("arrayItem", node["items"]);
|
||||||
|
info.needsLocalImport = containedType.needsLocalImport;
|
||||||
|
info.needsSystemImport = true;
|
||||||
|
info.isContainer = true;
|
||||||
|
info.containerType = containedType;
|
||||||
|
if (containedType.typeName == "QString") {
|
||||||
|
info.typeName = "QStringList";
|
||||||
|
} else {
|
||||||
|
info.typeName = "QList<" ~ containedType.typeName ~ ">";
|
||||||
|
}
|
||||||
|
return info;
|
||||||
|
default:
|
||||||
|
info.typeName = "UNIMPLEMENTED";
|
||||||
|
return info;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
Appender!(MetaTypeInfo[]) result;
|
||||||
|
|
||||||
|
foreach(const ref string name, const ref Node node; properties) {
|
||||||
|
result ~= getType(name, node);
|
||||||
|
}
|
||||||
|
return result[];
|
||||||
|
}
|
||||||
|
|
||||||
|
void writeObjectHeader(File output, string name, MetaTypeInfo[] properties, string[] userImports) {
|
||||||
|
string className = name.applyCasePolicy(OPENAPI_CASING, CPP_CLASS_CASING);
|
||||||
|
foreach (userClass; userImports) {
|
||||||
|
if (userClass != className) output.writefln("class %s;", userClass);
|
||||||
|
}
|
||||||
|
if (userImports.length > 0) output.writeln();
|
||||||
|
output.writefln("class %s : public QObject {", className);
|
||||||
|
output.writefln("\tQ_OBJECT");
|
||||||
|
output.writefln("public:");
|
||||||
|
output.writefln("\t%s(QObject *parent = nullptr);", className);
|
||||||
|
output.writeln();
|
||||||
|
|
||||||
|
// Generate Q_PROPERTIES
|
||||||
|
foreach (property; properties) {
|
||||||
|
// Avoid clashes with QML
|
||||||
|
if (property.description.length > 0) {
|
||||||
|
output.writefln("\t/**");
|
||||||
|
output.writefln("\t * @brief %s", property.description);
|
||||||
|
output.writefln("\t */");
|
||||||
|
}
|
||||||
|
output.writefln("\tQ_PROPERTY(%s %s READ %s WRITE set%s NOTIFY %sChanged)",
|
||||||
|
property.typeNameWithQualifiers, property.name, property.name, property.writeName, property.name);
|
||||||
|
}
|
||||||
|
|
||||||
|
output.writeln();
|
||||||
|
// Write getters
|
||||||
|
foreach (property; properties) {
|
||||||
|
// Avoid clashes with QML
|
||||||
|
output.writefln("\t%s %s() const;",
|
||||||
|
property.typeNameWithQualifiers, property.name);
|
||||||
|
output.writefln("\tvoid set%s(%s new%s);",
|
||||||
|
property.writeName, property.typeNameWithQualifiers, property.writeName);
|
||||||
|
output.writefln("\t");
|
||||||
|
}
|
||||||
|
|
||||||
|
// Signals
|
||||||
|
output.writefln("signals:");
|
||||||
|
foreach (property; properties) {
|
||||||
|
output.writefln("\tvoid %sChanged(%s new%s);",
|
||||||
|
property.name, property.typeNameWithQualifiers, property.writeName);
|
||||||
|
}
|
||||||
|
output.writefln("protected:");
|
||||||
|
|
||||||
|
// Write member variables
|
||||||
|
foreach (property; properties) {
|
||||||
|
if (property.defaultInitializer.length > 0) {
|
||||||
|
output.writefln("\t%s %s = %s;",
|
||||||
|
property.typeNameWithQualifiers, property.memberName, property.defaultInitializer);
|
||||||
|
} else {
|
||||||
|
output.writefln("\t%s %s;",
|
||||||
|
property.typeNameWithQualifiers, property.memberName);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
output.writefln("};");
|
||||||
|
}
|
||||||
|
|
||||||
|
void writeObjectImplementation(File output, string name, MetaTypeInfo[] properties) {
|
||||||
|
string className = name.applyCasePolicy(OPENAPI_CASING, CPP_CLASS_CASING);
|
||||||
|
|
||||||
|
output.writefln("%s::%s(QObject *parent) : QObject(parent) {}", className, className);
|
||||||
|
output.writeln();
|
||||||
|
|
||||||
|
foreach(property; properties) {
|
||||||
|
output.writefln("%s %s::%s() const { return %s; }", property.typeNameWithQualifiers,
|
||||||
|
className, property.name, property.memberName);
|
||||||
|
|
||||||
|
output.writefln("void %s::set%s(%s new%s) {", className, property.writeName,
|
||||||
|
property.typeNameWithQualifiers, property.writeName);
|
||||||
|
output.writefln("\t%s = new%s;", property.memberName, property.writeName);
|
||||||
|
output.writefln("\temit %sChanged(new%s)", property.name, property.writeName);
|
||||||
|
output.writefln("}");
|
||||||
|
output.writeln();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// Enum
|
||||||
|
void writeEnumHeader(File output, string name, string[] values, string doc = "") {
|
||||||
|
string className = name.applyCasePolicy(OPENAPI_CASING, CPP_CLASS_CASING);
|
||||||
|
output.writefln("class %s {", className);
|
||||||
|
output.writefln("\tQ_GADGET");
|
||||||
|
output.writefln("public:");
|
||||||
|
output.writefln("\tenum %s {", className);
|
||||||
|
foreach (value; values) {
|
||||||
|
output.writefln("\t\t%s,", value);
|
||||||
|
}
|
||||||
|
output.writefln("\t};");
|
||||||
|
output.writefln("\tQ_ENUM(%s)", className);
|
||||||
|
output.writefln("private:");
|
||||||
|
output.writefln("\texplicit %s();", className);
|
||||||
|
output.writefln("};");
|
||||||
|
}
|
||||||
|
|
||||||
|
void writeEnumImplementation(File output, string name) {
|
||||||
|
string className = name.applyCasePolicy(OPENAPI_CASING, CPP_CLASS_CASING);
|
||||||
|
string importName = name.applyCasePolicy(OPENAPI_CASING, CPP_FILENAME_CASING);
|
||||||
|
output.writefln("%s::%s() {}", name, name);
|
||||||
|
}
|
||||||
|
|
||||||
|
// Common
|
||||||
|
void writeHeaderPreamble(File output, string className, string[] imports = []) {
|
||||||
|
string guard = guardName(CPP_NAMESPACE, className);
|
||||||
|
output.writefln("#ifndef %s", guard);
|
||||||
|
output.writefln("#define %s", guard);
|
||||||
|
output.writeln();
|
||||||
|
|
||||||
|
foreach(file; imports) {
|
||||||
|
output.writefln("#include <%s>", file);
|
||||||
|
}
|
||||||
|
|
||||||
|
if (imports.length > 0) output.writeln();
|
||||||
|
|
||||||
|
foreach (namespace; CPP_NAMESPACE) {
|
||||||
|
output.writefln("namespace %s {", namespace);
|
||||||
|
}
|
||||||
|
output.writeln();
|
||||||
|
}
|
||||||
|
|
||||||
|
void writeHeaderPostamble(File output, string className) {
|
||||||
|
output.writeln();
|
||||||
|
foreach(namespace; CPP_NAMESPACE) {
|
||||||
|
output.writefln("} // NS %s", namespace);
|
||||||
|
}
|
||||||
|
output.writeln();
|
||||||
|
output.writefln("#endif // %s", guardName(CPP_NAMESPACE, className));
|
||||||
|
}
|
||||||
|
|
||||||
|
void writeImplementationPreamble(File output, string className, string[] imports = []) {
|
||||||
|
output.writefln("#include <%s>", buildPath(INCLUDE_PREFIX, className.applyCasePolicy(OPENAPI_CASING, CasePolicy.LOWER) ~ ".h"));
|
||||||
|
output.writeln();
|
||||||
|
|
||||||
|
foreach(file; imports) {
|
||||||
|
output.writefln("#include <%s>", buildPath(INCLUDE_PREFIX, file.applyCasePolicy(OPENAPI_CASING, CasePolicy.LOWER) ~ ".h"));
|
||||||
|
}
|
||||||
|
if (imports.length > 0) output.writeln();
|
||||||
|
|
||||||
|
foreach (namespace; CPP_NAMESPACE) {
|
||||||
|
output.writefln("namespace %s {", namespace);
|
||||||
|
}
|
||||||
|
output.writeln();
|
||||||
|
}
|
||||||
|
|
||||||
|
void writeImplementationPostamble(File output, string className) {
|
||||||
|
output.writeln();
|
||||||
|
foreach(namespace; CPP_NAMESPACE) {
|
||||||
|
output.writefln("} // NS %s", namespace);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
// Helper functions
|
||||||
|
string applyCasePolicy(string source, CasePolicy input, CasePolicy output) {
|
||||||
|
if (input == output) return source;
|
||||||
|
switch(output) {
|
||||||
|
case CasePolicy.KEEP:
|
||||||
|
return source;
|
||||||
|
case CasePolicy.PASCAL:
|
||||||
|
if (input == CasePolicy.CAMEL) {
|
||||||
|
char[] result = source.dup;
|
||||||
|
result[0] = cast(char) toUpper(result[0]);
|
||||||
|
return cast(string) result;
|
||||||
|
} else {
|
||||||
|
throw new Exception("Not implemented");
|
||||||
|
}
|
||||||
|
case CasePolicy.CAMEL:
|
||||||
|
if (input == CasePolicy.PASCAL) {
|
||||||
|
char[] result = source.dup;
|
||||||
|
result[0] = cast(char) toLower(result[0]);
|
||||||
|
return cast(string) result;
|
||||||
|
} else {
|
||||||
|
throw new Exception("Not implemented");
|
||||||
|
}
|
||||||
|
case CasePolicy.LOWER:
|
||||||
|
if (input == CasePolicy.CAMEL || input == CasePolicy.PASCAL) {
|
||||||
|
return source.toLower();
|
||||||
|
}
|
||||||
|
throw new Exception("Not implemented");
|
||||||
|
case CasePolicy.UPPER:
|
||||||
|
if (input == CasePolicy.CAMEL || input == CasePolicy.PASCAL) {
|
||||||
|
return source.toUpper();
|
||||||
|
}
|
||||||
|
throw new Exception("Not implemented");
|
||||||
|
case CasePolicy.SCREAMING_SNAKE:
|
||||||
|
if (input == CasePolicy.CAMEL || input == CasePolicy.PASCAL) {
|
||||||
|
char[] mutableSource = source.dup;
|
||||||
|
Appender!(char[]) result;
|
||||||
|
foreach(window; source.slide!(Yes.withPartial)(2)) {
|
||||||
|
dchar c = window.front;
|
||||||
|
window.popFront();
|
||||||
|
dchar n = window.front;
|
||||||
|
if (isLower(c) && !isLower(n)) {
|
||||||
|
result ~= toUpper(c);
|
||||||
|
result ~= '_';
|
||||||
|
} else if (!isLower(c) && !isLower(n)) {
|
||||||
|
result ~= toUpper(c);
|
||||||
|
} else {
|
||||||
|
result ~= toUpper(c);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
result ~= toUpper(source[$ - 1]);
|
||||||
|
return cast(string) result[];
|
||||||
|
}
|
||||||
|
throw new Exception("Not implemented");
|
||||||
|
default:
|
||||||
|
throw new Exception("Not implemented");
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
class MetaTypeInfo {
|
||||||
|
public:
|
||||||
|
string name = "";
|
||||||
|
string typeName = "";
|
||||||
|
string description = "";
|
||||||
|
bool needsPointer = false;
|
||||||
|
bool needsSystemImport = false;
|
||||||
|
bool needsLocalImport = false;
|
||||||
|
bool isContainer = false;
|
||||||
|
MetaTypeInfo containerType = null;
|
||||||
|
|
||||||
|
string writeName() {
|
||||||
|
return name.applyCasePolicy(CPP_CLASS_MEMBER_CASING, CasePolicy.PASCAL);
|
||||||
|
}
|
||||||
|
|
||||||
|
string memberName() {
|
||||||
|
return CPP_CLASS_MEMBER_PREFIX ~ name;
|
||||||
|
}
|
||||||
|
|
||||||
|
string typeNameWithQualifiers() {
|
||||||
|
if (needsPointer) {
|
||||||
|
return typeName~ " *";
|
||||||
|
} else {
|
||||||
|
return typeName;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
string defaultInitializer() {
|
||||||
|
if (needsPointer) return "nullptr";
|
||||||
|
return "";
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
string guardName(string[] namespace, string className) {
|
||||||
|
return namespace.map!toUpper().join("_") ~ "_"
|
||||||
|
~ className.applyCasePolicy(OPENAPI_CASING, CasePolicy.UPPER)
|
||||||
|
~ "_H";
|
||||||
|
}
|
||||||
Loading…
Reference in a new issue