@looker/sdk-codegen 21.7.3 → 21.8.0

package/lib/esm/python.gen.js

@@ -1,211 +1,154 @@
-function _defineProperty(obj, key, value) { if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
-
-import { describeParam, EnumType, strBody } from './sdkModels';
-import { CodeGen, trimInputs } from './codeGen';
-export class PythonGen extends CodeGen {
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.PythonGen = void 0;
+var _sdkModels = require("./sdkModels");
+var _codeGen = require("./codeGen");
+function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+function _toPropertyKey(arg) { var key = _toPrimitive(arg, "string"); return typeof key === "symbol" ? key : String(key); }
+function _toPrimitive(input, hint) { if (typeof input !== "object" || input === null) return input; var prim = input[Symbol.toPrimitive]; if (prim !== undefined) { var res = prim.call(input, hint || "default"); if (typeof res !== "object") return res; throw new TypeError("@@toPrimitive must return a primitive value."); } return (hint === "string" ? String : Number)(input); }
+class PythonGen extends _codeGen.CodeGen {
   constructor() {
     super(...arguments);
-
     _defineProperty(this, "codePath", './python/');
-
     _defineProperty(this, "packagePath", 'looker_sdk');
-
     _defineProperty(this, "itself", 'self');
-
     _defineProperty(this, "fileExtension", '.py');
-
     _defineProperty(this, "commentStr", '# ');
-
     _defineProperty(this, "nullStr", 'None');
-
     _defineProperty(this, "indentStr", '    ');
-
     _defineProperty(this, "argDelimiter", ",\n".concat(this.indentStr.repeat(3)));
-
     _defineProperty(this, "argSetSep", '=');
-
     _defineProperty(this, "paramDelimiter", ',\n');
-
     _defineProperty(this, "propDelimiter", '\n');
-
     _defineProperty(this, "dataStructureDelimiter", ', ');
-
     _defineProperty(this, "enumDelimiter", '\n');
-
     _defineProperty(this, "codeQuote", '"');
-
     _defineProperty(this, "typeOpen", '(');
-
     _defineProperty(this, "typeClose", ')');
-
     _defineProperty(this, "hashKeyQuote", '"');
-
     _defineProperty(this, "useModelClassForTypes", true);
-
     _defineProperty(this, "endTypeStr", '');
-
     _defineProperty(this, "pythonKeywords", new Set(['False', 'None', 'True', 'and', 'as', 'assert', 'async', 'await', 'break', 'class', 'continue', 'def', 'del', 'elif', 'else', 'except', 'finally', 'for', 'from', 'global', 'if', 'import', 'in', 'is', 'lambda', 'nonlocal', 'not', 'or', 'pass', 'raise', 'return', 'try', 'while', 'with', 'yield']));
-
     _defineProperty(this, "hooks", []);
-
     _defineProperty(this, "structureHookTK", 'translate_keys_structure_hook');
-
     _defineProperty(this, "pythonReservedKeywordClasses", new Set());
-
     _defineProperty(this, "methodsPrologue", _indent => "\n# ".concat(this.warnEditing(), "\nimport datetime\nfrom typing import Any, MutableMapping, Optional, Sequence, Union, cast\nimport warnings\n\nfrom . import models as mdls\nfrom ").concat(this.packagePath, ".rtl import api_methods\nfrom ").concat(this.packagePath, ".rtl import transport\n\nclass ").concat(this.packageName, "(api_methods.APIMethods):\n"));
-
     _defineProperty(this, "methodsEpilogue", _indent => this.apiVersion === '3.1' ? "LookerSDK = ".concat(this.packageName) : '');
-
     _defineProperty(this, "modelsPrologue", _indent => "\n# ".concat(this.warnEditing(), "\nimport datetime\nimport enum\nfrom typing import Any, MutableMapping, Optional, Sequence\n\ntry:\n    from typing import ForwardRef  # type: ignore\nexcept ImportError:\n    from typing import _ForwardRef as ForwardRef  # type: ignore\n\nimport attr\n\nfrom ").concat(this.packagePath, ".rtl import model\nfrom ").concat(this.packagePath, ".rtl import serialize as sr\n\nEXPLICIT_NULL = model.EXPLICIT_NULL  # type: ignore\nDelimSequence = model.DelimSequence\n"));
-
     _defineProperty(this, "modelsEpilogue", _indent => "\nimport functools  # noqa:E402\n\nforward_ref_structure_hook = functools.partial(\n    sr.forward_ref_structure_hook, globals(), sr.converter".concat(this.apiRef, "\n)\nsr.converter").concat(this.apiRef, ".register_structure_hook_func(\n    lambda t: t.__class__ is ForwardRef, forward_ref_structure_hook\n)\n").concat(this.structureHookTK, " = functools.partial(sr.translate_keys_structure_hook, sr.converter").concat(this.apiRef, ")\n").concat(this.hooks.join('\n'), "\n"));
-
     _defineProperty(this, "isBareForwardRef", prop => {
-      return prop.required && (prop.type.customType || prop.type instanceof EnumType) && !['ArrayType', 'HashType', 'DelimArrayType'].includes(prop.type.className);
+      return prop.required && (prop.type.customType || prop.type instanceof _sdkModels.EnumType) && !['ArrayType', 'HashType', 'DelimArrayType'].includes(prop.type.className);
     });
   }
-
   sdkFileName(baseFileName) {
     return this.fileName("sdk/api".concat(this.apiRef, "/").concat(baseFileName));
   }
-
   argGroup(_indent, args) {
     if (!args || args.length === 0) return this.nullStr;
     var hash = [];
-
     for (var arg of args) {
       hash.push("\"".concat(arg, "\": ").concat(arg));
     }
-
     return "{".concat(hash.join(this.dataStructureDelimiter), "}");
   }
-
   beginRegion(indent, description) {
     return "".concat(indent, "#region ").concat(description);
   }
-
   endRegion(indent, _description) {
     return "".concat(indent, "#endregion");
   }
-
   declareProperty(indent, property) {
     var annotations = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : false;
     var mappedType = this.typeMapModels(property.type);
     var propName = property.name;
-
     if (this.pythonKeywords.has(propName)) {
       propName = propName + '_';
     }
-
     var propType = mappedType.name;
-
     if (!property.required) {
       propType = "Optional[".concat(mappedType.name, "]");
     }
-
     var propDef;
-
     if (annotations) {
       var annotation = propType;
-
       if (this.isBareForwardRef(property)) {
         annotation = "ForwardRef(".concat(propType, ")");
       }
-
       propDef = "".concat(this.bumper(indent), "\"").concat(propName, "\": ").concat(annotation);
     } else {
       if (!property.required) {
         propType += " = ".concat(this.nullStr);
       }
-
       propDef = "".concat(indent).concat(propName, ": ").concat(propType);
     }
-
     return propDef;
   }
-
   methodReturnType(method) {
     var type = this.typeMapMethods(method.type);
     var returnType = type.name;
-
     if (method.responseIsBoth()) {
       returnType = "Union[".concat(returnType, ", bytes]");
     } else if (method.responseIsBinary()) {
       returnType = 'bytes';
     }
-
     return returnType;
   }
-
   methodSignature(indent, method) {
     var _method$description;
-
     var returnType = this.methodReturnType(method);
     var bump = this.bumper(indent);
     var params = [];
     var args = method.allParams;
-
     if (args && args.length > 0) {
       method.allParams.forEach(p => params.push(this.declareParameter(bump, method, p)));
     }
-
     var head = (_method$description = method.description) === null || _method$description === void 0 ? void 0 : _method$description.trim();
     head = (head ? "".concat(head, "\n\n") : '') + "".concat(method.httpMethod, " ").concat(method.endpoint, " -> ").concat(returnType);
     params.push("".concat(bump, "transport_options: Optional[transport.TransportOptions] = None,"));
     return this.commentHeader(indent, head) + "".concat(indent, "def ").concat(method.name, "(\n") + "".concat(bump, "self").concat(params.length > 0 ? ',\n' : '') + "".concat(params.join(this.paramDelimiter), "\n") + "".concat(indent, ") -> ").concat(returnType, ":\n");
   }
-
   declareParameter(indent, method, param) {
     var type;
-
-    if (param.location === strBody) {
+    if (param.location === _sdkModels.strBody) {
       type = this.writeableType(param.type, method) || param.type;
     } else {
       type = param.type;
     }
-
     var mapped = this.typeMapMethods(type);
     var paramType = param.required ? mapped.name : "Optional[".concat(mapped.name, "]");
-    return this.commentHeader(indent, describeParam(param)) + "".concat(indent).concat(param.name, ": ").concat(paramType) + (param.required ? '' : " = ".concat(mapped.default));
+    return this.commentHeader(indent, (0, _sdkModels.describeParam)(param)) + "".concat(indent).concat(param.name, ": ").concat(paramType) + (param.required ? '' : " = ".concat(mapped.default));
   }
-
   makeTheCall(method, inputs) {
     var origDelim = this.argDelimiter;
     this.argDelimiter = ",\n".concat(this.indentStr);
-    inputs = trimInputs(inputs);
     var resp = "response = sdk.".concat(method.name, "(");
     var args = this.assignParams(method, inputs);
     this.argDelimiter = origDelim;
     return "".concat(resp).concat(args, ")");
   }
-
   initArg(indent, property) {
     var propName = property.name;
-
     if (this.pythonKeywords.has(propName)) {
       propName = propName + '_';
     }
-
     return "".concat(indent, "self.").concat(propName, " = ").concat(propName);
   }
-
   declareType(indent, type) {
     var decl = super.declareType(indent, type);
-
-    if (type instanceof EnumType) {
+    if (type instanceof _sdkModels.EnumType) {
       var invalid = 'invalid_api_enum_value = "invalid_api_enum_value"' + '\n\n\n# https://github.com/python/mypy/issues/2427' + "\n".concat(type.name, ".__new__ = model.safe_enum__new__  # type: ignore");
       decl += "\n".concat(this.bumper(indent)).concat(invalid);
     }
-
     return decl;
   }
-
   typeProperties(type) {
     return Object.values(type.requiredProperties).concat(Object.values(type.optionalProperties));
   }
-
   construct(indent, type) {
-    if (type instanceof EnumType) return '';
+    if (type instanceof _sdkModels.EnumType) return '';
     indent = this.bumper(indent);
     var bump = this.bumper(indent);
     var annotations = [];
@@ -217,100 +160,76 @@ export class PythonGen extends CodeGen {
       inits.push(this.initArg(bump, prop));
     });
     var result = '';
-
     if (Object.values(type.properties).some(this.isBareForwardRef)) {
       result = "\n".concat(indent, "__annotations__ = {\n") + "".concat(annotations.join(',\n')) + "\n".concat(indent, "}");
     }
-
     result += "\n\n".concat(indent, "def __init__(self, *").concat(this.argDelimiter) + "".concat(args.join(this.argDelimiter), "):\n") + inits.join('\n');
     return result;
   }
-
   declareConstructorArg(indent, property) {
     var mappedType = this.typeMapModels(property.type);
     var propType;
-
     if (property.required) {
       propType = mappedType.name;
     } else {
       propType = "Optional[".concat(mappedType.name, "] = ").concat(this.nullStr);
     }
-
     var propName = property.name;
-
     if (this.pythonKeywords.has(propName)) {
       propName = propName + '_';
     }
-
     return "".concat(indent).concat(propName, ": ").concat(propType);
   }
-
   argFill(current, args) {
     if (!current && args.trim() === this.nullStr) {
       return '';
     }
-
     var delimiter = ',\n';
-
     if (!current) {
       delimiter = '';
     } else if (args.match(/, {2}#/)) {
       delimiter = delimiter.replace(',', '');
     }
-
     return "".concat(args).concat(delimiter).concat(current);
   }
-
   httpArgs(callerIndent, method) {
     var currIndent = this.bumper(callerIndent);
     var args = '';
     args = this.argFill(args, "".concat(currIndent, "transport_options=transport_options"));
-
     if (method.bodyArg) {
       args = this.argFill(args, "".concat(currIndent, "body=").concat(method.bodyArg));
     }
-
     if (method.queryArgs.length) {
       var queryParams = this.argGroup('', method.queryArgs);
       args = this.argFill(args, "".concat(currIndent, "query_params=").concat(queryParams));
     }
-
     var returnType = this.methodReturnType(method);
-
     if (method.responseIsBoth()) {
       returnType += ',  # type: ignore';
     }
-
     args = this.argFill(args, "".concat(currIndent, "structure=").concat(returnType));
     var endpoint = "\"".concat(method.endpoint, "\"");
-
     if (/\{\w+\}/.test(endpoint)) {
       endpoint = "f".concat(endpoint);
     }
-
     args = this.argFill(args, "".concat(currIndent, "path=").concat(endpoint));
     return args;
   }
-
   httpCall(callerIndent, method) {
     var currIndent = this.bumper(callerIndent);
     var deprecation = '';
-
     if (method.name === 'login_user') {
       deprecation = "".concat(callerIndent, "warnings.warn(\"login_user behavior changed significantly ") + "in 21.4.0. See https://git.io/JOtH1\")\n";
     }
-
     var callOpener = "".concat(callerIndent, "response = cast(\n") + "".concat(currIndent).concat(this.methodReturnType(method), ",\n") + "".concat(currIndent).concat(this.it(method.httpMethod.toLowerCase()), "(\n");
     var callArgs = "".concat(this.httpArgs(currIndent, method), "\n");
     var callCloser = "".concat(currIndent, ")\n").concat(callerIndent, ")\n");
     var returnStmt = "".concat(callerIndent, "return response");
     return deprecation + callOpener + callArgs + callCloser + returnStmt;
   }
-
   encodePathParams(indent, method) {
     var encodings = '';
     var pathParams = method.pathParams;
-
     if (pathParams.length > 0) {
       for (var param of pathParams) {
         if (param.doEncode()) {
@@ -318,76 +237,57 @@ export class PythonGen extends CodeGen {
         }
       }
     }
-
     return encodings;
   }
-
   declareMethod(indent, method) {
     var bump = this.bumper(indent);
     return this.methodSignature(indent, method) + this.summary(bump, method.summary) + this.encodePathParams(bump, method) + this.httpCall(bump, method);
   }
-
   typeSignature(indent, type) {
     var bump = this.bumper(indent);
     var b2 = this.bumper(bump);
     var attrs = [];
-    var isEnum = type instanceof EnumType;
+    var isEnum = type instanceof _sdkModels.EnumType;
     var baseClass = isEnum ? 'enum.Enum' : 'model.Model';
     var usesReservedPythonKeyword = false;
-
     if (!isEnum) {
       for (var prop of this.typeProperties(type)) {
         var propName = prop.name;
-
         if (this.pythonKeywords.has(propName)) {
           propName = propName + '_';
           usesReservedPythonKeyword = true;
         }
-
         var attr = "".concat(b2).concat(propName, ":");
-
         if (prop.description) {
           attr += " ".concat(prop.description);
         }
-
         attrs.push(attr);
       }
     }
-
     if (usesReservedPythonKeyword) {
       this.hooks.push("sr.converter".concat(this.apiRef, ".register_structure_hook(\n").concat(bump).concat(type.name, ",  # type: ignore\n").concat(bump).concat(this.structureHookTK, "  # type:ignore\n)"));
     }
-
     var result = "\n" + (isEnum ? '' : "".concat(indent, "@attr.s(auto_attribs=True, init=False)\n")) + "".concat(indent, "class ").concat(type.name, "(").concat(baseClass, "):\n") + "".concat(bump, "\"\"\"\n") + (type.description ? "".concat(bump).concat(type.description, "\n\n") : '');
-
     if (attrs.length > 0) {
       result += "".concat(bump, "Attributes:\n") + "".concat(attrs.join('\n'), "\n");
     }
-
     return result + "".concat(bump, "\"\"\"\n");
   }
-
   summary(indent, text) {
     return text ? "".concat(indent, "\"\"\"").concat(text, "\"\"\"\n") : '';
   }
-
   prefixModelsNamespace(name, format) {
     var forwardRef = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : false;
-
     if (format === 'models') {
       name = forwardRef ? "\"".concat(name, "\"") : name;
     } else if (format === 'methods') {
       name = "mdls.".concat(name);
     }
-
     return name;
   }
-
   typeMap(type) {
     var format = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 'methods';
-
     var asString = (_, v) => "\"".concat(v, "\"");
-
     var pythonTypes = {
       any: {
         default: this.nullStr,
@@ -455,62 +355,45 @@ export class PythonGen extends CodeGen {
       }
     };
     super.typeMap(type);
-
     if (type.elementType) {
       var map = this.typeMap(type.elementType, format);
       var typeName;
-
       var _name;
-
       var defaultValue = this.nullStr;
       var asVal;
-
       switch (type.className) {
         case 'ArrayType':
           typeName = 'Sequence';
           _name = "".concat(typeName, "[").concat(map.name, "]");
           break;
-
         case 'HashType':
           typeName = 'MutableMapping';
           _name = typeName + '[str, ' + (type.elementType.name === 'string' ? 'Any' : map.name) + ']';
           break;
-
         case 'DelimArrayType':
           typeName = this.prefixModelsNamespace('DelimSequence', format);
           _name = "".concat(typeName, "[").concat(map.name, "]");
-
           asVal = (_, v) => "".concat(typeName, "([").concat(v, "])");
-
           break;
-
         case 'EnumType':
           _name = typeName = this.prefixModelsNamespace(type.name, format, true);
-
           asVal = (_, v) => "".concat(typeName, ".").concat(v);
-
           break;
-
         default:
           throw new Error("Don't know how to handle: ".concat(JSON.stringify(type)));
       }
-
       var mt = {
         default: defaultValue,
         name: _name
       };
-
       if (asVal) {
         mt.asVal = asVal;
       }
-
       return mt;
     }
-
     if (!type.name) {
       throw new Error('Cannot output a nameless type.');
     }
-
     var name = this.prefixModelsNamespace(type.name, format, !!type.customType);
     var result = pythonTypes[type.name];
     return result || {
@@ -518,14 +401,12 @@ export class PythonGen extends CodeGen {
       name: name
     };
   }
-
   typeMapMethods(type) {
     return this.typeMap(type, 'methods');
   }
-
   typeMapModels(type) {
     return this.typeMap(type, 'models');
   }
-
 }
+exports.PythonGen = PythonGen;
 //# sourceMappingURL=python.gen.js.map