Package: caffoa
DEPRECATEDThis tool was superseeded bycaffoa.net.
Use caffoa.net as nuget tool to create your open api files.caffoa: Create Azure Function From Open ApiTool to autogenerate azure function templates for .NET from openapi declaration.
Instead of generating stubs, the goal is to be able to change the api and re-generate the files without overwriting your code.Currently considered alpha state. If something does not work that you feel should work, create a ticket with your openapi spec.It usesprancefor parsing the openapi spec.UsageAs code generation needs a lot of configuration, all configuration is done using a config file in yaml format.The minimal config file is as follows:config:version:2services:-apiPath:my-service.openapi.ymlfunction:name:MyClassNamenamespace:MyNamespacetargetFolder:./outputmodel:namespace:MyNamespace.ModeltargetFolder:./output/ModelYou can add multiple services. Also, you can omit eithermodelorfunctionif you do not need one of them.
Then, call the tool:python3-mcaffoa--configpath_to_config.ymlCreate Azure Function template:If you specified thefunctionpart in the config file,
the tool will create two files in the specified target folder:MyClassNameFunction.generated.csIMyClassNameService.generated.csYour job now is to create an implementation for theIMyClassNameServiceinterface.Furthermore, you needDependency Injectionto pass your implementation to the constructor of the function.Now implement all the logic in your implementation of the interface. You can now change your API, and regenerate the generated files without overwriting your code.Create data objects from schemasIf you specified themodelpart in the config file, the tool will generate a file for each schema defined in the components section of the openapi definition. The filename will be the schema name converted to UpperCamelCase with generated.cs added to the end (Example:userwill create a classUserdefined in the fileUser.generated.cs).
The file will contain a shared class, with all properties of the schema. You can implement a shared class in a different file to add logic to these objects.RestrictionsThe schema must be defined in the components section.Furthermore, schemas may not be nested without reference.
(You can easily overcome this restriction by defining more schemas in the components section and have them reference each other.)allOf is implemented as inheritance, and therefore can only handle allOf with one reference and one direct configurationAdvanced configuration optionsThere are multiple optional configuration options that you can use:config:clearGeneratedFiles:true# default is false, removes all files below the working directory, that end in .generated.csversion:2# 1 (legacy, default), 2 (current), 3 (experimental)useFactory:false# version 2+ if set to true, a factory interface is created additionally to the Service interface. Useful if you need to have different behaviors based on headers.prefix:"Pre"# A prefix that is added to all model classessuffix:"Suf"# A suffix that is added to all model classeserrorFolder:./output/errors# version 3+ only. Folder where ClientError Exceptions are generatederrorNamespace:MyErrorNamespace# # version 3+ only. Namespace for  ClientError Exceptions are generatedimports:# a list of imports that will be added to most generated classes-MySpecialNamespaceservices:-apiPath:userservice.openapi.ymlconfig:prefix:# overrides the config element from the global configsuffix:# overrides the config element from the global configuseFactory:# overrides the config element from the global configerrorFolder:# overrides the config element from the global configerrorNamespace:# overrides the config element from the global configimports:# overrides the imports from the global configfunction:name:MyClassNamenamespace:MyNamespacetargetFolder:./outputfunctionsName:MyFunctions# name of the functions class. defaults to {name}FunctionsinterfaceName:IMyInterface# name of the interface class. defaults to I{name}Service.interfaceNamespace:MyInterfaceNamespace# defaults to 'namespace'. If given, the interface uses this namespaceinterfaceTargetFolder:./output/shared# defaults to 'targetFolder'. If given, the interface is written to this folder## for version 1 and 2, you can add boilerplate code to each invocation.## you can add placeholders: {BASE} for the full invocation code, or {CALL} for just the function call.## {BASE} will be replaced with "return await Service(req, log).{CALL};"## {CALL} will be replaced with 'FunctionName(params)'boilerplate:|try {{BASE}catch(SomethingNotFoundException e) {return new HttpResponseMessage(HttpStatusCode.NotFound){Content = new StringContent(err.Message)};}## if you need specific imports for your boilerplate, add them here:imports:# overrides the imports from the config section-MyNamespace.Exceptions.SomethingNotFoundExceptionmodel:namespace:MyNamespace.ModeltargetFolder:./output/Model# you can exclude objects from generation:excludes:-objectToExclude# you can also generate only some classesinclude:-objectToInclude-otherObjectToIncludeimports:# overrides the imports from the global config-someImportprefix:# (Deprecated for version 3+) override prefix from the config sectionsuffix:# (Deprecated for version 3+) override suffix from the config sectionVersion 3If you have a well specified openapi doc, use only json request bodies and returns, and you want strict rules what you get to work with and what you return, you can try out version 3.Version 3 parses the return and requestBody specifications, and handles the object wrapping for you.Request bodies that have well-defined schemas will be deserialized to the objectResponses that have well-defined schemas will be serialized to Json responsesThe interface will not have IActionResult returns, but need to return the actual object for the methodThe interface will have the actual type that was passed along in the body as parameterErrors (400-499) will be implemented as Exceptions, that you can throw in your implementation.If you return a JSON Object with your Errors, a derived class will be created for thatIf you have different return codes for one object (e.g. 200 or 201 for a put request), the return of the interface will be (YourObject, int).Version 3 takes over a lot of boilerplate code for you. Furthermore, it forces you to not cut corners, as you cannot return a different object than the specification calls for.