Merge pull request #1319 from dart-lang/merge-http_parser-package

Merge `package:http_parser`

Author: mosuem

.github/ISSUE_TEMPLATE/http_parser.md

@@ -0,0 +1,5 @@
+---
+name: "package:http_parser"
+about: "Create a bug or file a feature request against package:http_parser."
+labels: "package:http_parser"
+---

.github/labeler.yml

@@ -16,6 +16,10 @@
  - changed-files:
  - any-glob-to-any-file: 'pkgs/http/**'
 
+'package:http_parser':
+ - changed-files:
+ - any-glob-to-any-file: 'pkgs/http_parser/**'
+
 'package:http_client_conformance_tests':
  - changed-files:
- - any-glob-to-any-file: 'pkgs/http_client_conformance_tests/**'
+ - any-glob-to-any-file: 'pkgs/http_client_conformance_tests/**'

.github/workflows/http_parser.yaml

@@ -0,0 +1,74 @@
+name: package:http_parser
+
+on:
+ push:
+ branches:
+ - master
+ paths:
+ - '.github/workflows/http_parser.yaml'
+ - 'pkgs/http_parser/**'
+ pull_request:
+ paths:
+ - '.github/workflows/http_parser.yaml'
+ - 'pkgs/http_parser/**'
+ schedule:
+ - cron: "0 0 * * 0"
+
+env:
+ PUB_ENVIRONMENT: bot.github
+
+defaults: 
+ run: 
+ working-directory: pkgs/http_parser/
+
+permissions: read-all
+
+jobs:
+ # Check code formatting and static analysis on a single OS (linux)
+ # against Dart dev.
+ analyze:
+ runs-on: ubuntu-latest
+ strategy:
+ fail-fast: false
+ matrix:
+ sdk: [dev]
+ steps:
+ - uses: actions/checkout@d632683dd7b4114ad314bca15554477dd762a938
+ - uses: dart-lang/setup-dart@0a8a0fc875eb934c15d08629302413c671d3f672
+ with:
+ sdk: ${{ matrix.sdk }}
+ - id: install
+ name: Install dependencies
+ run: dart pub get
+ - name: Check formatting
+ run: dart format --output=none --set-exit-if-changed .
+ if: always() && steps.install.outcome == 'success'
+ - name: Analyze code
+ run: dart analyze --fatal-infos
+ if: always() && steps.install.outcome == 'success'
+
+ test:
+ needs: analyze
+ runs-on: ${{ matrix.os }}
+ strategy:
+ fail-fast: false
+ matrix:
+ os: [ubuntu-latest]
+ sdk: [3.4, dev]
+ steps:
+ - uses: actions/checkout@d632683dd7b4114ad314bca15554477dd762a938
+ - uses: dart-lang/setup-dart@0a8a0fc875eb934c15d08629302413c671d3f672
+ with:
+ sdk: ${{ matrix.sdk }}
+ - id: install
+ name: Install dependencies
+ run: dart pub get
+ - name: Run VM tests
+ run: dart test --platform vm
+ if: always() && steps.install.outcome == 'success'
+ - name: Run Chrome tests
+ run: dart test --platform chrome
+ if: always() && steps.install.outcome == 'success'
+ - name: Run Chrome tests - wasm
+ run: dart test --platform chrome --compiler dart2wasm
+ if: always() && steps.install.outcome == 'success'

README.md

@@ -15,6 +15,7 @@ and the browser.
 | [flutter_http_example](pkgs/flutter_http_example/) | An Flutter app that demonstrates how to configure and use `package:http`. | — |
 | [http](pkgs/http/) | A composable, multi-platform, Future-based API for HTTP requests. | [![pub package](https://img.shields.io/pub/v/http.svg)](https://pub.dev/packages/http) |
 | [http_client_conformance_tests](pkgs/http_client_conformance_tests/) | A library that tests whether implementations of package:http's `Client` class behave as expected. | |
+| [http_parser](pkgs/http_parser/) | A platform-independent package for parsing and serializing HTTP formats. | [![pub package](https://img.shields.io/pub/v/http_parser.svg)](https://pub.dev/packages/http_parser) |
 | [http_profile](pkgs/http_profile/) | A library used by HTTP client authors to integrate with the DevTools Network View. | [![pub package](https://img.shields.io/pub/v/http_profile.svg)](https://pub.dev/packages/http_profile) |
 | [ok_http](pkgs/ok_http/) | An Android Flutter plugin that provides access to the [OkHttp](https://square.github.io/okhttp/) HTTP client and the OkHttp [WebSocket](https://square.github.io/okhttp/5.x/okhttp/okhttp3/-web-socket/index.html) API. | [![pub package](https://img.shields.io/pub/v/ok_http.svg)](https://pub.dev/packages/ok_http) |
 | [web_socket](pkgs/web_socket/) | Any easy-to-use library for communicating with WebSockets that has multiple implementations. | [![pub package](https://img.shields.io/pub/v/web_socket.svg)](https://pub.dev/packages/web_socket) |

pkgs/http_parser/.gitignore

@@ -0,0 +1,4 @@
+# Don’t commit the following directories created by pub.
+.dart_tool/
+.packages
+pubspec.lock

pkgs/http_parser/CHANGELOG.md

@@ -0,0 +1,146 @@
+## 4.1.1
+
+* Move to `dart-lang/http` monorepo.
+
+## 4.1.0
+
+* `CaseInsensitiveMap`: added constructor `fromEntries`.
+* Require `package:collection` `^1.19.0`
+* Require Dart `^3.4.0`
+
+## 4.0.2
+
+* Remove `package:charcode` from dev_dependencies.
+
+## 4.0.1
+
+* Remove dependency on `package:charcode`.
+
+## 4.0.0
+
+* Stable null safety stable release.
+
+## 4.0.0-nullsafety
+
+* Migrate to null safety.
+
+## 3.1.4
+
+* Fixed lints affecting package health score.
+* Added an example.
+
+## 3.1.3
+
+* Set max SDK version to `<3.0.0`, and adjust other dependencies.
+
+## 3.1.2
+
+* Require Dart SDK 2.0.0-dev.17.0 or greater.
+
+* A number of strong-mode fixes.
+
+## 3.1.1
+
+* Fix a logic bug in the `chunkedCoding` codec. It had been producing invalid
+ output and rejecting valid input.
+
+## 3.1.0
+
+* Add `chunkedCoding`, a `Codec` that supports encoding and decoding the
+ [chunked transfer coding][].
+
+[chunked transfer coding]: https://www.w3.org/Protocols/rfc2616/rfc2616-sec3.html#sec3.6.1
+
+## 3.0.2
+
+* Support `string_scanner` 1.0.0.
+
+## 3.0.1
+
+* Remove unnecessary dependencies.
+
+## 3.0.0
+
+* All deprecated APIs have been removed. No new APIs have been added. Packages
+ that would use 3.0.0 as a lower bound should use 2.2.0 instead—for example,
+ `http_parser: ">=2.2.0 <4.0.0"`.
+
+* Fix all strong-mode warnings.
+
+## 2.2.1
+
+* Add support for `crypto` 1.0.0.
+
+## 2.2.0
+
+* `WebSocketChannel` has been moved to
+ [the `web_socket_channel` package][web_socket_channel]. The implementation
+ here is now deprecated.
+
+[web_socket_channel]: https://pub.dev/packages/web_socket_channel
+
+## 2.1.0
+
+* Added `WebSocketChannel`, an implementation of `StreamChannel` that's backed
+ by a `WebSocket`.
+
+* Deprecated `CompatibleWebSocket` in favor of `WebSocketChannel`.
+
+## 2.0.0
+
+* Removed the `DataUri` class. It's redundant with the `Uri.data` getter that's
+ coming in Dart 1.14, and the `DataUri.data` field in particular was an invalid
+ override of that field.
+
+## 1.1.0
+
+* The MIME spec says that media types and their parameter names are
+ case-insensitive. Accordingly, `MediaType` now uses a case-insensitive map for
+ its parameters and its `type` and `subtype` fields are now always lowercase.
+
+## 1.0.0
+
+This is 1.0.0 because the API is stable—there are no breaking changes.
+
+* Added an `AuthenticationChallenge` class for parsing and representing the
+ value of `WWW-Authenticate` and related headers.
+
+* Added a `CaseInsensitiveMap` class for representing case-insensitive HTTP
+ values.
+
+## 0.0.2+8
+
+* Bring in the latest `dart:io` WebSocket code.
+
+## 0.0.2+7
+
+* Add more detail to the readme.
+
+## 0.0.2+6
+
+* Updated homepage URL.
+
+## 0.0.2+5
+
+* Widen the version constraint on the `collection` package.
+
+## 0.0.2+4
+
+* Widen the `string_scanner` version constraint.
+
+## 0.0.2+3
+
+* Fix a library name conflict.
+
+## 0.0.2+2
+
+* Fixes for HTTP date formatting.
+
+## 0.0.2+1
+
+* Minor code refactoring.
+
+## 0.0.2
+
+* Added `CompatibleWebSocket`, for platform- and API-independent support for the
+ WebSocket API.

pkgs/http_parser/LICENSE

@@ -0,0 +1,27 @@
+Copyright 2014, the Dart project authors. 
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are
+met:
+
+ * Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+ * Redistributions in binary form must reproduce the above
+ copyright notice, this list of conditions and the following
+ disclaimer in the documentation and/or other materials provided
+ with the distribution.
+ * Neither the name of Google LLC nor the names of its
+ contributors may be used to endorse or promote products derived
+ from this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

pkgs/http_parser/README.md

@@ -0,0 +1,22 @@
+[![Pub Package](https://img.shields.io/pub/v/http_parser.svg)](https://pub.dartlang.org/packages/http_parser)
+[![package publisher](https://img.shields.io/pub/publisher/http_parser.svg)](https://pub.dev/packages/http_parser/publisher)
+
+`http_parser` is a platform-independent package for parsing and serializing
+various HTTP-related formats. It's designed to be usable on both the browser and
+the server, and thus avoids referencing any types from `dart:io` or `dart:html`.
+
+## Features
+
+* Support for parsing and formatting dates according to [HTTP/1.1][2616], the
+ HTTP/1.1 standard.
+
+* A `MediaType` class that represents an HTTP media type, as used in `Accept`
+ and `Content-Type` headers. This class supports both parsing and formatting
+ media types according to [HTTP/1.1][2616].
+
+* A `WebSocketChannel` class that provides a `StreamChannel` interface for both
+ the client and server sides of the [WebSocket protocol][6455] independently of
+ any specific server implementation.
+
+[2616]: https://www.w3.org/Protocols/rfc2616/rfc2616-sec3.html
+[6455]: https://tools.ietf.org/html/rfc6455

pkgs/http_parser/analysis_options.yaml

@@ -0,0 +1,33 @@
+# https://dart.dev/tools/analysis#the-analysis-options-file
+include: package:dart_flutter_team_lints/analysis_options.yaml
+
+analyzer:
+ language:
+ strict-casts: true
+ strict-inference: true
+ strict-raw-types: true
+
+linter:
+ rules:
+ - avoid_bool_literals_in_conditional_expressions
+ - avoid_classes_with_only_static_members
+ - avoid_private_typedef_functions
+ - avoid_redundant_argument_values
+ - avoid_returning_this
+ - avoid_unused_constructor_parameters
+ - avoid_void_async
+ - cancel_subscriptions
+ - join_return_with_assignment
+ - literal_only_boolean_expressions
+ - missing_whitespace_between_adjacent_strings
+ - no_adjacent_strings_in_list
+ - no_runtimeType_toString
+ - package_api_docs
+ - prefer_const_declarations
+ - prefer_expression_function_bodies
+ - prefer_final_locals
+ - unnecessary_await_in_return
+ - unnecessary_breaks
+ - use_if_null_to_convert_nulls_to_bools
+ - use_raw_strings
+ - use_string_buffers

pkgs/http_parser/example/example.dart

@@ -0,0 +1,16 @@
+// Copyright (c) 2020, 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.
+
+import 'package:http_parser/http_parser.dart';
+
+void main() {
+ final date = DateTime.utc(2014, 9, 9, 9, 9, 9);
+ print(date); // 2014-09-09 09:09:09.000Z
+
+ final httpDateFormatted = formatHttpDate(date);
+ print(httpDateFormatted); // Tue, 09 Sep 2014 09:09:09 GMT
+
+ final nowParsed = parseHttpDate(httpDateFormatted);
+ print(nowParsed); // 2014-09-09 09:09:09.000Z
+}