[dart][dart-dio] Update pubspec/readme templates (#9201)

* Add homepage option to pubspec.yaml

package validation fails when trying to publish to pub.dev

See: https://dart.dev/tools/pub/pubspec
Blocking https://github.com/bigpanther/trober/pull/108

cc: @kuhnroyal

* Add missing fields

* Update templates and generate samples

Co-authored-by: Harsimran Singh Maan <maan.harry@gmail.com>

modules/openapi-generator/src/main/resources/dart-dio/pubspec.mustache

@@ -1,16 +1,22 @@
 name: {{pubName}}
 version: {{pubVersion}}
 description: {{pubDescription}}
+homepage: {{pubHomepage}}
+authors:
+  - '{{{pubAuthor}}} <{{{pubAuthorEmail}}}>'
+
 environment:
-    sdk: '>=2.7.0 <3.0.0'
+  sdk: '>=2.7.0 <3.0.0'
+
 dependencies:
-    dio: '^3.0.9'
-    built_value: '>=7.1.0 <8.0.0'
-    built_collection: '>=4.3.2 <5.0.0'
+  dio: '^3.0.9'
+  built_value: '>=7.1.0 <8.0.0'
+  built_collection: '>=4.3.2 <5.0.0'
 {{#timeMachine}}
-    time_machine: '^0.9.12'
+  time_machine: '^0.9.12'
 {{/timeMachine}}
+
 dev_dependencies:
-    built_value_generator: '>=7.1.0 <8.0.0'
-    build_runner: any
-    test: '>=1.3.0 <1.16.0'
+  built_value_generator: '>=7.1.0 <8.0.0'
+  build_runner: any
+  test: '>=1.3.0 <1.16.0'

modules/openapi-generator/src/main/resources/dart/libraries/dio/README.mustache

@@ -21,25 +21,32 @@ For more information, please visit [{{{infoUrl}}}]({{{infoUrl}}})
 
 * Dart 2.12.0 or later OR Flutter 1.26.0 or later
 * Dio 4.0.0+
+{{#useDateLibTimeMachine}}
 * timemachine option currently **DOES NOT** support sound null-safety and may not work
+{{/useDateLibTimeMachine}}
 
 ## Installation & Usage
 
-### Github
-If this Dart package is published to Github, please include the following in pubspec.yaml
-```
-name: {{pubName}}
-version: {{pubVersion}}
-description: {{pubDescription}}
+### pub.dev
+To use the package from [pub.dev](https://pub.dev), please include the following in pubspec.yaml
+```yaml
 dependencies:
-  {{pubName}}:
-    git: https://github.com/{{gitUserId}}/{{gitRepoId}}.git
-      version: 'any'
+  {{pubName}}: {{pubVersion}}
 ```
 
-### Local
-To use the package in your local drive, please include the following in pubspec.yaml
+### Github
+If this Dart package is published to Github, please include the following in pubspec.yaml
+```yaml
+dependencies:
+  {{pubName}}:
+    git:
+      url: https://github.com/{{gitUserId}}/{{gitRepoId}}.git
+      #ref: main
 ```
+
+### Local development
+To use the package from your local drive, please include the following in pubspec.yaml
+```yaml
 dependencies:
   {{pubName}}:
     path: /path/to/{{pubName}}

modules/openapi-generator/src/main/resources/dart/libraries/dio/pubspec.mustache

@@ -1,6 +1,9 @@
 name: {{pubName}}
 version: {{pubVersion}}
 description: {{pubDescription}}
+homepage: {{pubHomepage}}
+authors:
+  - '{{{pubAuthor}}} <{{{pubAuthorEmail}}}>'
 
 environment:
   sdk: '>=2.12.0 <3.0.0'

samples/openapi3/client/petstore/dart-dio-next/petstore_client_lib_fake/README.md

@@ -10,25 +10,29 @@ This Dart package is automatically generated by the [OpenAPI Generator](https://
 
 * Dart 2.12.0 or later OR Flutter 1.26.0 or later
 * Dio 4.0.0+
-* timemachine option currently **DOES NOT** support sound null-safety and may not work
 
 ## Installation & Usage
 
-### Github
-If this Dart package is published to Github, please include the following in pubspec.yaml
-```
-name: openapi
-version: 1.0.0
-description: OpenAPI API client
+### pub.dev
+To use the package from [pub.dev](https://pub.dev), please include the following in pubspec.yaml
+```yaml
 dependencies:
-  openapi:
-    git: https://github.com/GIT_USER_ID/GIT_REPO_ID.git
-      version: 'any'
+  openapi: 1.0.0
 ```
 
-### Local
-To use the package in your local drive, please include the following in pubspec.yaml
+### Github
+If this Dart package is published to Github, please include the following in pubspec.yaml
+```yaml
+dependencies:
+  openapi:
+    git:
+      url: https://github.com/GIT_USER_ID/GIT_REPO_ID.git
+      #ref: main
 ```
+
+### Local development
+To use the package from your local drive, please include the following in pubspec.yaml
+```yaml
 dependencies:
   openapi:
     path: /path/to/openapi

samples/openapi3/client/petstore/dart-dio-next/petstore_client_lib_fake/pubspec.yaml

@@ -1,6 +1,9 @@
 name: openapi
 version: 1.0.0
 description: OpenAPI API client
+homepage: homepage
+authors:
+  - 'Author <author@homepage>'
 
 environment:
   sdk: '>=2.12.0 <3.0.0'

samples/openapi3/client/petstore/dart-dio/petstore_client_lib/pubspec.yaml

@@ -1,13 +1,19 @@
 name: openapi
 version: 1.0.0
 description: OpenAPI API client
+homepage: homepage
+authors:
+  - 'Author <author@homepage>'
+
 environment:
-    sdk: '>=2.7.0 <3.0.0'
+  sdk: '>=2.7.0 <3.0.0'
+
 dependencies:
-    dio: '^3.0.9'
-    built_value: '>=7.1.0 <8.0.0'
-    built_collection: '>=4.3.2 <5.0.0'
+  dio: '^3.0.9'
+  built_value: '>=7.1.0 <8.0.0'
+  built_collection: '>=4.3.2 <5.0.0'
+
 dev_dependencies:
-    built_value_generator: '>=7.1.0 <8.0.0'
-    build_runner: any
-    test: '>=1.3.0 <1.16.0'
+  built_value_generator: '>=7.1.0 <8.0.0'
+  build_runner: any
+  test: '>=1.3.0 <1.16.0'

samples/openapi3/client/petstore/dart-dio/petstore_client_lib_fake/pubspec.yaml

@@ -1,13 +1,19 @@
 name: openapi
 version: 1.0.0
 description: OpenAPI API client
+homepage: homepage
+authors:
+  - 'Author <author@homepage>'
+
 environment:
-    sdk: '>=2.7.0 <3.0.0'
+  sdk: '>=2.7.0 <3.0.0'
+
 dependencies:
-    dio: '^3.0.9'
-    built_value: '>=7.1.0 <8.0.0'
-    built_collection: '>=4.3.2 <5.0.0'
+  dio: '^3.0.9'
+  built_value: '>=7.1.0 <8.0.0'
+  built_collection: '>=4.3.2 <5.0.0'
+
 dev_dependencies:
-    built_value_generator: '>=7.1.0 <8.0.0'
-    build_runner: any
-    test: '>=1.3.0 <1.16.0'
+  built_value_generator: '>=7.1.0 <8.0.0'
+  build_runner: any
+  test: '>=1.3.0 <1.16.0'