Skip to content

Commit 5d959a8

Browse files
authored
Merge pull request #913 from Backbase/MF-1916-update-android-mustache
Updated README.mustache for android
2 parents 4a41750 + 94adc83 commit 5d959a8

1 file changed

Lines changed: 113 additions & 0 deletions

File tree

Lines changed: 113 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,113 @@
1+
# {{packageName}} - Kotlin client library for {{appName}}
2+
3+
{{#appDescriptionWithNewLines}}
4+
{{{.}}}
5+
{{/appDescriptionWithNewLines}}
6+
7+
## Overview
8+
This API client was generated by the [OpenAPI Generator](https://openapi-generator.tech) project. By using the [openapi-spec](https://github.com/OAI/OpenAPI-Specification) from a remote server, you can easily generate an API client.
9+
10+
- API version: {{appVersion}}
11+
- Package version: {{packageVersion}}
12+
{{^hideGenerationTimestamp}}
13+
- Build date: {{generatedDate}}
14+
{{/hideGenerationTimestamp}}
15+
- Generator version: {{generatorVersion}}
16+
- Build package: {{generatorClass}}
17+
{{#infoUrl}}
18+
For more information, please visit [{{{infoUrl}}}]({{{infoUrl}}})
19+
{{/infoUrl}}
20+
21+
## Requires
22+
23+
{{#jvm}}
24+
* Kotlin 1.7.21
25+
* Gradle 7.5
26+
{{/jvm}}
27+
{{#multiplatform}}
28+
* Kotlin 1.5.10
29+
{{/multiplatform}}
30+
31+
## Build
32+
33+
{{#jvm}}
34+
First, create the gradle wrapper script:
35+
36+
```
37+
gradle wrapper
38+
```
39+
40+
Then, run:
41+
42+
{{/jvm}}
43+
```
44+
./gradlew check assemble
45+
```
46+
47+
This runs all tests and packages the library.
48+
49+
## Features/Implementation Notes
50+
51+
* Supports JSON inputs/outputs, File inputs, and Form inputs.
52+
* Supports collection formats for query parameters: csv, tsv, ssv, pipes.
53+
* Some Kotlin and Java types are fully qualified to avoid conflicts with types defined in OpenAPI definitions.
54+
{{#jvm}}* Implementation of ApiClient is intended to reduce method counts, specifically to benefit Android targets.{{/jvm}}
55+
56+
{{#generateApiDocs}}
57+
<a id="documentation-for-api-endpoints"></a>
58+
## Documentation for API Endpoints
59+
60+
All URIs are relative to *{{{basePath}}}*
61+
62+
| Class | Method | HTTP request | Description |
63+
| ------------ | ------------- | ------------- | ------------- |
64+
{{#apiInfo}}{{#apis}}{{#operations}}{{#operation}}| *{{classname}}* | [**{{operationId}}**]({{apiDocPath}}{{classname}}.md#{{operationIdLowerCase}}) | **{{httpMethod}}** {{path}} | {{{summary}}} |
65+
{{/operation}}{{/operations}}{{/apis}}{{/apiInfo}}
66+
{{/generateApiDocs}}
67+
68+
{{#generateModelDocs}}
69+
<a id="documentation-for-models"></a>
70+
## Documentation for Models
71+
72+
{{#modelPackage}}
73+
{{#models}}{{#model}} - [{{{modelPackage}}}.{{{classname}}}]({{modelDocPath}}{{{classname}}}.md)
74+
{{/model}}{{/models}}
75+
{{/modelPackage}}
76+
{{^modelPackage}}
77+
No model defined in this package
78+
{{/modelPackage}}
79+
{{/generateModelDocs}}
80+
81+
<a id="documentation-for-authorization"></a>
82+
## Documentation for Authorization
83+
84+
{{^authMethods}}Endpoints do not require authorization.{{/authMethods}}
85+
{{#hasAuthMethods}}Authentication schemes defined for the API:{{/hasAuthMethods}}
86+
{{#authMethods}}
87+
<a id="{{name}}"></a>
88+
### {{name}}
89+
90+
{{#isApiKey}}- **Type**: API key
91+
- **API key parameter name**: {{keyParamName}}
92+
- **Location**: {{#isKeyInQuery}}URL query string{{/isKeyInQuery}}{{#isKeyInHeader}}HTTP header{{/isKeyInHeader}}
93+
{{/isApiKey}}
94+
{{#isBasicBasic}}- **Type**: HTTP basic authentication
95+
{{/isBasicBasic}}
96+
{{#isBasicBearer}}- **Type**: HTTP Bearer Token authentication{{#bearerFormat}} ({{{.}}}){{/bearerFormat}}
97+
{{/isBasicBearer}}
98+
{{#isHttpSignature}}- **Type**: HTTP signature authentication
99+
{{/isHttpSignature}}
100+
{{#isOAuth}}- **Type**: OAuth
101+
- **Flow**: {{flow}}
102+
- **Authorization URL**: {{authorizationUrl}}
103+
- **Scopes**: {{^scopes}}N/A{{/scopes}}
104+
{{#scopes}} - {{scope}}: {{description}}
105+
{{/scopes}}
106+
{{/isOAuth}}
107+
108+
{{/authMethods}}{{#infoEmail}}
109+
110+
## Author
111+
112+
{{{.}}}
113+
{{/infoEmail}}

0 commit comments

Comments
 (0)