diff options
| author | CoprDistGit <infra@openeuler.org> | 2023-05-10 03:52:29 +0000 |
|---|---|---|
| committer | CoprDistGit <infra@openeuler.org> | 2023-05-10 03:52:29 +0000 |
| commit | 357517caea1b9ecdc436a0218f2a71a7aa28da44 (patch) | |
| tree | 04315a44feac29f3b51afd60e76bd5fdfb69b737 | |
| parent | c64c365077d7b58cd89bf9b5c76affb5f1f5db3b (diff) | |
automatic import of python-caffoaopeneuler20.03
| -rw-r--r-- | .gitignore | 1 | ||||
| -rw-r--r-- | python-caffoa.spec | 516 | ||||
| -rw-r--r-- | sources | 1 |
3 files changed, 518 insertions, 0 deletions
@@ -0,0 +1 @@ +/caffoa-0.37.0.tar.gz diff --git a/python-caffoa.spec b/python-caffoa.spec new file mode 100644 index 0000000..2375028 --- /dev/null +++ b/python-caffoa.spec @@ -0,0 +1,516 @@ +%global _empty_manifest_terminate_build 0 +Name: python-caffoa +Version: 0.37.0 +Release: 1 +Summary: Create Azure Functions From Open Api (for C#) +License: MIT +URL: https://github.com/claasd/caffoa +Source0: https://mirrors.nju.edu.cn/pypi/web/packages/82/72/3e471830744463eedac845d00eb51c1928a13ee89a6d8a4ac83553833a96/caffoa-0.37.0.tar.gz +BuildArch: noarch + +Requires: python3-prance +Requires: python3-openapi-spec-validator +Requires: python3-PyYaml + +%description +# DEPRECATED + +This tool was superseeded by [caffoa.net](https://github.com/claasd/caffoa.net). +Use caffoa.net as nuget tool to create your open api files. + + +# caffoa: Create Azure Function From Open Api + +[](https://pypi.org/project/caffoa/) +[](https://pypi.org/project/caffoa/) + + +Tool 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 uses [prance](https://pypi.org/project/prance/) for parsing the openapi spec. + +# Usage + +As 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: +```yaml +config: + version: 2 +services: + - apiPath: my-service.openapi.yml + function: + name: MyClassName + namespace: MyNamespace + targetFolder: ./output + model: + namespace: MyNamespace.Model + targetFolder: ./output/Model +``` +You can add multiple services. Also, you can omit either `model` or `function` if you do not need one of them. +Then, call the tool: + +```bash +python3 -m caffoa --config path_to_config.yml +``` + +## Create Azure Function template: + +If you specified the `function` part in the config file, +the tool will create two files in the specified target folder: +* MyClassNameFunction.generated.cs +* IMyClassNameService.generated.cs + +Your job now is to create an implementation for the `IMyClassNameService` interface. + +Furthermore, you need [Dependency Injection](https://docs.microsoft.com/en-us/azure/azure-functions/functions-dotnet-dependency-injection) to 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 schemas + +If you specified the `model` part 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: `user`will create a class `User` defined in the file `User.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. + +### Restrictions +* The 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 configuration + +## Advanced configuration options +There are multiple optional configuration options that you can use: +```yaml +config: + clearGeneratedFiles: true # default is false, removes all files below the working directory, that end in .generated.cs + version: 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 classes + suffix: "Suf" # A suffix that is added to all model classes + errorFolder: ./output/errors # version 3+ only. Folder where ClientError Exceptions are generated + errorNamespace: MyErrorNamespace # # version 3+ only. Namespace for ClientError Exceptions are generated + imports: # a list of imports that will be added to most generated classes + - MySpecialNamespace + +services: + - apiPath: userservice.openapi.yml + config: + prefix: # overrides the config element from the global config + suffix: # overrides the config element from the global config + useFactory: # overrides the config element from the global config + errorFolder: # overrides the config element from the global config + errorNamespace: # overrides the config element from the global config + imports: # overrides the imports from the global config + function: + name: MyClassName + namespace: MyNamespace + targetFolder: ./output + functionsName: MyFunctions # name of the functions class. defaults to {name}Functions + interfaceName: IMyInterface # name of the interface class. defaults to I{name}Service. + interfaceNamespace: MyInterfaceNamespace # defaults to 'namespace'. If given, the interface uses this namespace + interfaceTargetFolder: ./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.SomethingNotFoundException + model: + namespace: MyNamespace.Model + targetFolder: ./output/Model + # you can exclude objects from generation: + excludes: + - objectToExclude + # you can also generate only some classes + include: + - objectToInclude + - otherObjectToInclude + imports: # overrides the imports from the global config + - someImport + prefix: # (Deprecated for version 3+) override prefix from the config section + suffix: # (Deprecated for version 3+) override suffix from the config section +``` + +## Version 3 +If 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 object +* Responses that have well-defined schemas will be serialized to Json responses +* The interface will not have IActionResult returns, but need to return the actual object for the method +* The interface will have the actual type that was passed along in the body as parameter +* Errors (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 that +* If 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. + + + +%package -n python3-caffoa +Summary: Create Azure Functions From Open Api (for C#) +Provides: python-caffoa +BuildRequires: python3-devel +BuildRequires: python3-setuptools +BuildRequires: python3-pip +%description -n python3-caffoa +# DEPRECATED + +This tool was superseeded by [caffoa.net](https://github.com/claasd/caffoa.net). +Use caffoa.net as nuget tool to create your open api files. + + +# caffoa: Create Azure Function From Open Api + +[](https://pypi.org/project/caffoa/) +[](https://pypi.org/project/caffoa/) + + +Tool 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 uses [prance](https://pypi.org/project/prance/) for parsing the openapi spec. + +# Usage + +As 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: +```yaml +config: + version: 2 +services: + - apiPath: my-service.openapi.yml + function: + name: MyClassName + namespace: MyNamespace + targetFolder: ./output + model: + namespace: MyNamespace.Model + targetFolder: ./output/Model +``` +You can add multiple services. Also, you can omit either `model` or `function` if you do not need one of them. +Then, call the tool: + +```bash +python3 -m caffoa --config path_to_config.yml +``` + +## Create Azure Function template: + +If you specified the `function` part in the config file, +the tool will create two files in the specified target folder: +* MyClassNameFunction.generated.cs +* IMyClassNameService.generated.cs + +Your job now is to create an implementation for the `IMyClassNameService` interface. + +Furthermore, you need [Dependency Injection](https://docs.microsoft.com/en-us/azure/azure-functions/functions-dotnet-dependency-injection) to 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 schemas + +If you specified the `model` part 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: `user`will create a class `User` defined in the file `User.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. + +### Restrictions +* The 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 configuration + +## Advanced configuration options +There are multiple optional configuration options that you can use: +```yaml +config: + clearGeneratedFiles: true # default is false, removes all files below the working directory, that end in .generated.cs + version: 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 classes + suffix: "Suf" # A suffix that is added to all model classes + errorFolder: ./output/errors # version 3+ only. Folder where ClientError Exceptions are generated + errorNamespace: MyErrorNamespace # # version 3+ only. Namespace for ClientError Exceptions are generated + imports: # a list of imports that will be added to most generated classes + - MySpecialNamespace + +services: + - apiPath: userservice.openapi.yml + config: + prefix: # overrides the config element from the global config + suffix: # overrides the config element from the global config + useFactory: # overrides the config element from the global config + errorFolder: # overrides the config element from the global config + errorNamespace: # overrides the config element from the global config + imports: # overrides the imports from the global config + function: + name: MyClassName + namespace: MyNamespace + targetFolder: ./output + functionsName: MyFunctions # name of the functions class. defaults to {name}Functions + interfaceName: IMyInterface # name of the interface class. defaults to I{name}Service. + interfaceNamespace: MyInterfaceNamespace # defaults to 'namespace'. If given, the interface uses this namespace + interfaceTargetFolder: ./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.SomethingNotFoundException + model: + namespace: MyNamespace.Model + targetFolder: ./output/Model + # you can exclude objects from generation: + excludes: + - objectToExclude + # you can also generate only some classes + include: + - objectToInclude + - otherObjectToInclude + imports: # overrides the imports from the global config + - someImport + prefix: # (Deprecated for version 3+) override prefix from the config section + suffix: # (Deprecated for version 3+) override suffix from the config section +``` + +## Version 3 +If 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 object +* Responses that have well-defined schemas will be serialized to Json responses +* The interface will not have IActionResult returns, but need to return the actual object for the method +* The interface will have the actual type that was passed along in the body as parameter +* Errors (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 that +* If 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. + + + +%package help +Summary: Development documents and examples for caffoa +Provides: python3-caffoa-doc +%description help +# DEPRECATED + +This tool was superseeded by [caffoa.net](https://github.com/claasd/caffoa.net). +Use caffoa.net as nuget tool to create your open api files. + + +# caffoa: Create Azure Function From Open Api + +[](https://pypi.org/project/caffoa/) +[](https://pypi.org/project/caffoa/) + + +Tool 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 uses [prance](https://pypi.org/project/prance/) for parsing the openapi spec. + +# Usage + +As 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: +```yaml +config: + version: 2 +services: + - apiPath: my-service.openapi.yml + function: + name: MyClassName + namespace: MyNamespace + targetFolder: ./output + model: + namespace: MyNamespace.Model + targetFolder: ./output/Model +``` +You can add multiple services. Also, you can omit either `model` or `function` if you do not need one of them. +Then, call the tool: + +```bash +python3 -m caffoa --config path_to_config.yml +``` + +## Create Azure Function template: + +If you specified the `function` part in the config file, +the tool will create two files in the specified target folder: +* MyClassNameFunction.generated.cs +* IMyClassNameService.generated.cs + +Your job now is to create an implementation for the `IMyClassNameService` interface. + +Furthermore, you need [Dependency Injection](https://docs.microsoft.com/en-us/azure/azure-functions/functions-dotnet-dependency-injection) to 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 schemas + +If you specified the `model` part 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: `user`will create a class `User` defined in the file `User.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. + +### Restrictions +* The 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 configuration + +## Advanced configuration options +There are multiple optional configuration options that you can use: +```yaml +config: + clearGeneratedFiles: true # default is false, removes all files below the working directory, that end in .generated.cs + version: 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 classes + suffix: "Suf" # A suffix that is added to all model classes + errorFolder: ./output/errors # version 3+ only. Folder where ClientError Exceptions are generated + errorNamespace: MyErrorNamespace # # version 3+ only. Namespace for ClientError Exceptions are generated + imports: # a list of imports that will be added to most generated classes + - MySpecialNamespace + +services: + - apiPath: userservice.openapi.yml + config: + prefix: # overrides the config element from the global config + suffix: # overrides the config element from the global config + useFactory: # overrides the config element from the global config + errorFolder: # overrides the config element from the global config + errorNamespace: # overrides the config element from the global config + imports: # overrides the imports from the global config + function: + name: MyClassName + namespace: MyNamespace + targetFolder: ./output + functionsName: MyFunctions # name of the functions class. defaults to {name}Functions + interfaceName: IMyInterface # name of the interface class. defaults to I{name}Service. + interfaceNamespace: MyInterfaceNamespace # defaults to 'namespace'. If given, the interface uses this namespace + interfaceTargetFolder: ./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.SomethingNotFoundException + model: + namespace: MyNamespace.Model + targetFolder: ./output/Model + # you can exclude objects from generation: + excludes: + - objectToExclude + # you can also generate only some classes + include: + - objectToInclude + - otherObjectToInclude + imports: # overrides the imports from the global config + - someImport + prefix: # (Deprecated for version 3+) override prefix from the config section + suffix: # (Deprecated for version 3+) override suffix from the config section +``` + +## Version 3 +If 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 object +* Responses that have well-defined schemas will be serialized to Json responses +* The interface will not have IActionResult returns, but need to return the actual object for the method +* The interface will have the actual type that was passed along in the body as parameter +* Errors (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 that +* If 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. + + + +%prep +%autosetup -n caffoa-0.37.0 + +%build +%py3_build + +%install +%py3_install +install -d -m755 %{buildroot}/%{_pkgdocdir} +if [ -d doc ]; then cp -arf doc %{buildroot}/%{_pkgdocdir}; fi +if [ -d docs ]; then cp -arf docs %{buildroot}/%{_pkgdocdir}; fi +if [ -d example ]; then cp -arf example %{buildroot}/%{_pkgdocdir}; fi +if [ -d examples ]; then cp -arf examples %{buildroot}/%{_pkgdocdir}; fi +pushd %{buildroot} +if [ -d usr/lib ]; then + find usr/lib -type f -printf "/%h/%f\n" >> filelist.lst +fi +if [ -d usr/lib64 ]; then + find usr/lib64 -type f -printf "/%h/%f\n" >> filelist.lst +fi +if [ -d usr/bin ]; then + find usr/bin -type f -printf "/%h/%f\n" >> filelist.lst +fi +if [ -d usr/sbin ]; then + find usr/sbin -type f -printf "/%h/%f\n" >> filelist.lst +fi +touch doclist.lst +if [ -d usr/share/man ]; then + find usr/share/man -type f -printf "/%h/%f.gz\n" >> doclist.lst +fi +popd +mv %{buildroot}/filelist.lst . +mv %{buildroot}/doclist.lst . + +%files -n python3-caffoa -f filelist.lst +%dir %{python3_sitelib}/* + +%files help -f doclist.lst +%{_docdir}/* + +%changelog +* Wed May 10 2023 Python_Bot <Python_Bot@openeuler.org> - 0.37.0-1 +- Package Spec generated @@ -0,0 +1 @@ +1187eb7aeb1c7315685662fc423864a0 caffoa-0.37.0.tar.gz |