Create a package:cronet_http/cronet_http.dart import (#859)

Author: brianquinlan

pkgs/cronet_http/CHANGELOG.md

@@ -1,3 +1,8 @@
+## 0.2.0
+
+* Restructure `package:cronet_http` to offer a
+  `package:cronet_http/cronet_http.dart` import.
+
 ## 0.1.2
 
 * Fix a NPE that occurs when an error occurs before a response is received.

pkgs/cronet_http/example/integration_test/client_test.dart

@@ -2,7 +2,7 @@
 // for details. All rights reserved. Use of this source code is governed by a
 // BSD-style license that can be found in the LICENSE file.
 
-import 'package:cronet_http/cronet_client.dart';
+import 'package:cronet_http/cronet_http.dart';
 import 'package:http/http.dart';
 import 'package:http_client_conformance_tests/http_client_conformance_tests.dart';
 import 'package:integration_test/integration_test.dart';

pkgs/cronet_http/example/integration_test/cronet_configuration_test.dart

@@ -6,7 +6,7 @@
 
 import 'dart:io';
 
-import 'package:cronet_http/cronet_client.dart';
+import 'package:cronet_http/cronet_http.dart';
 import 'package:integration_test/integration_test.dart';
 import 'package:test/test.dart';
 

pkgs/cronet_http/example/lib/main.dart

@@ -6,7 +6,7 @@ import 'dart:convert';
 import 'dart:io';
 
 import 'package:cached_network_image/cached_network_image.dart';
-import 'package:cronet_http/cronet_client.dart';
+import 'package:cronet_http/cronet_http.dart';
 import 'package:flutter/material.dart';
 import 'package:http/http.dart';
 

pkgs/cronet_http/lib/cronet_http.dart

@@ -0,0 +1,58 @@
+// Copyright (c) 2023, the Dart project authors.  Please see the AUTHORS file
+// for details. All rights reserved. Use of this source code is governed by a
+// BSD-style license that can be found in the LICENSE file.
+
+/// An Android Flutter plugin that provides access to the
+/// [Cronet](https://developer.android.com/guide/topics/connectivity/cronet/reference/org/chromium/net/package-summary)
+/// HTTP client.
+///
+/// ```
+/// import 'package:cronet_http/cronet_http.dart';
+///
+/// void main() async {
+///   var client = CronetClient();
+///   final response = await client.get(
+///       Uri.https('www.googleapis.com', '/books/v1/volumes', {'q': '{http}'}));
+///   if (response.statusCode != 200) {
+///     throw HttpException('bad response: ${response.statusCode}');
+///   }
+///
+///   final decodedResponse =
+///       jsonDecode(utf8.decode(response.bodyBytes)) as Map;
+///
+///   final itemCount = decodedResponse['totalItems'];
+///   print('Number of books about http: $itemCount.');
+///   for (var i = 0; i < min(itemCount, 10); ++i) {
+///     print(decodedResponse['items'][i]['volumeInfo']['title']);
+///   }
+/// }
+/// ```
+///
+/// [CronetClient] is an implementation of the `package:http` [Client],
+/// which means that it can easily used conditionally based on the current
+/// platform.
+///
+/// ```
+/// void main() {
+///   var clientFactory = Client.new; // Constructs the default client.
+///   if (Platform.isAndroid) {
+///     Future<CronetEngine>? engine;
+///     clientFactory = () {
+///       engine ??= CronetEngine.build(
+///           cacheMode: CacheMode.memory, userAgent: 'MyAgent');
+///       return CronetClient.fromCronetEngineFuture(engine!);
+///     };
+///   }
+///   runWithClient(() => runApp(const MyFlutterApp()), clientFactory);
+/// }
+/// ```
+///
+/// After the above setup, calling [Client] methods or any of the
+/// `package:http` convenient functions (e.g. [get]) will result in
+/// [CronetClient] being used on Android.
+
+import 'package:http/http.dart';
+
+import 'src/cronet_client.dart';
+
+export 'src/cronet_client.dart';

pkgs/cronet_http/lib/cronet_client.dart renamed to pkgs/cronet_http/lib/src/cronet_client.dart

@@ -17,7 +17,7 @@ import 'dart:async';
 import 'package:flutter/services.dart';
 import 'package:http/http.dart';
 
-import 'src/messages.dart' as messages;
+import 'messages.dart' as messages;
 
 late final _api = messages.HttpApi();
 

pkgs/cronet_http/pubspec.yaml

@@ -1,7 +1,7 @@
 name: cronet_http
 description: >
   An Android Flutter plugin that provides access to the Cronet HTTP client.
-version: 0.1.2
+version: 0.2.0
 repository: https://github.com/dart-lang/http/tree/master/pkgs/cronet_http
 
 environment: