Find a file
Jonas Termansen 96cf889e6b [dart:io] Fix HeaderValue parsing, toString(), and support null values.
This is a breaking change. https://github.com/dart-lang/sdk/issues/40709

This change makes the HeaderValue parsing more strict in two invalid
edge cases, supports parameters with null values as a feature, and fixes
toString() so it always produces tokens or quoted-strings valid per RFC
7230 3.2.6.

The empty parameter value without double quotes (which is not allowed by
the standards) is now parsed as the empty string rather than null. E.g.
HeaderValue.parse("v;a=").parameters now gives {"a": ""} rather than
{"a": null}.

Invalid inputs with unbalanced double quotes are now rejected. E.g.
HeaderValue.parse('v;a="b').parameters will now throw a HttpException
instead of giving {"a": "b"}.

The HeaderValue.toString() method now supports parameters with null
values by omitting the value. E.g.:

  HeaderValue("v", {"a": null, "b": "c"}).toString()

now gives

  v; a; b=c

This behavior can be used to implement some features in the Accept and
Sec-WebSocket-Extensions headers.

Likewise the empty value and values using characters outside of RFC 7230
3.2.6 tokens are now correctly implemented by double quoting such values
with escape sequences. E.g.:

  HeaderValue("v",
      {"a": "A", "b": "(B)", "c": "", "d": "ø", "e": "\\\""}).toString()

now gives

   v;a=A;b="(B)";c="";d="ø";e="\\\""

The NNBD migration required making subtle changes to some dart:io
semantics in order to provide a better API. This change backports one of
these semantic changes to the unmigrated SDK so any issues can be
discovered now instead of blocking the future SDK unfork.

Change-Id: Iafc790e03b6290232cac71fe14f995ce0f0b036b
Reviewed-on: https://dart-review.googlesource.com/c/sdk/+/136620
Commit-Queue: Jonas Termansen <sortie@google.com>
Reviewed-by: Lasse R.H. Nielsen <lrn@google.com>
2020-03-18 11:36:36 +00:00
.dart_tool Remove analyzer_fe_comparison from .packages and package_config 2020-03-11 16:54:10 +00:00
.github Update new issue template. 2019-04-30 18:14:21 +00:00
benchmarks [benchmarks] Add typed data copy benchmark 2020-01-24 22:04:35 +00:00
build [BUILD] - Format gn files, this is being done to ensure the unfork CL 2020-03-10 21:56:11 +00:00
client Remove old annotated_steps buildbot scripts and dispatcher 2017-05-23 16:17:02 +02:00
docs Add doc explaining how language versioning and experiments work. 2020-03-10 20:32:31 +00:00
pkg [dart:io] Fix HeaderValue parsing, toString(), and support null values. 2020-03-18 11:36:36 +00:00
runtime [vm] Add sizes to ELF static symbols for Code payloads. 2020-03-18 10:23:36 +00:00
samples [vm/ffi] Rename members in NativeApi to not contain nativeApi 2020-03-04 15:21:55 +00:00
samples-dev Mass format python with yapf 2019-08-05 20:34:31 +00:00
sdk [dart:io] Fix HeaderValue parsing, toString(), and support null values. 2020-03-18 11:36:36 +00:00
sdk_nnbd [dart:io] Fix HeaderValue parsing, toString(), and support null values. 2020-03-18 11:36:36 +00:00
tests [dart:io] Fix HeaderValue parsing, toString(), and support null values. 2020-03-18 11:36:36 +00:00
third_party [BUILD] - Format gn files, this is being done to ensure the unfork CL 2020-03-10 21:56:11 +00:00
tools [dart2js] Fix html_dart2js to handle null argument. 2020-03-17 17:11:36 +00:00
utils [cfe] Remove flag --force-nnbd-checks 2020-03-16 15:01:38 +00:00
.clang-format VM: Re-format to use at most one newline between functions 2017-07-13 08:08:37 -07:00
.gitattributes [test] Fork mirrors tests. 2020-01-22 18:46:23 +00:00
.gitconfig [infra] Add documentation to .gitconfig 2018-06-11 18:24:16 +00:00
.gitignore Cleanup- remove the Dart Editor directories from the .gitignore file 2020-01-10 00:50:06 +00:00
.gn
.mailmap fix my name in .mailmap 2018-09-11 01:45:52 +00:00
.packages Remove analyzer_fe_comparison from .packages and package_config 2020-03-11 16:54:10 +00:00
.style.yapf Mass format python with yapf 2019-08-05 20:34:31 +00:00
.vpython [infra] Add .vpython spec to fix gsutil on the bots (#31065) 2018-10-11 15:11:35 +00:00
AUTHORS [runtime/vm] ARM64: Support unaligned memory accesses for regex. 2019-10-15 20:11:40 +00:00
BUILD.gn [BUILD] - Format gn files, this is being done to ensure the unfork CL 2020-03-10 21:56:11 +00:00
CHANGELOG.md [dart:io] Fix HeaderValue parsing, toString(), and support null values. 2020-03-18 11:36:36 +00:00
codereview.settings Update codereview.settings to Gerrit (dart-review.googlesource.com) 2017-09-04 12:52:09 +00:00
CONTRIBUTING.md Link from CONTRIBUTING to the code of conduct. 2020-01-10 08:12:01 +00:00
DEPS Sync to the latest args 2020-03-17 20:13:25 +00:00
LICENSE Remove third_party licenses from LICENSE 2019-08-21 07:43:34 +00:00
PATENT_GRANT Rename patent file 2019-08-16 12:03:17 +00:00
PRESUBMIT.py Add some minimal presubmit checks to keep forked SDK tests in sync. 2020-01-16 18:50:27 +00:00
README.dart-sdk Add dart2native to sdk README 2020-01-20 09:32:58 +00:00
README.md chore: update contributing link in readme 2020-03-18 09:25:07 +00:00
sdk_args.gni Support building under git-worktree 2019-12-19 23:12:53 +00:00
WATCHLISTS [WATCHLISTS] Add joshualitt@ to dart2js watchlist. 2020-02-28 18:41:45 +00:00

Dart

A client-optimized language for fast apps on any platform

Dart is:

  • Optimized for UI: Develop with a programming language specialized around the needs of user interface creation

  • Productive: Make changes iteratively: use hot reload to see the result instantly in your running app

  • Fast on all platforms: Compile to ARM & x64 machine code for mobile, desktop, and backend. Or compile to JavaScript for the web

Dart's flexible compiler technology lets you run Dart code in different ways, depending on your target platform and goals:

  • Dart Native: For programs targeting devices (mobile, desktop, server, and more), Dart Native includes both a Dart VM with JIT (just-in-time) compilation and an AOT (ahead-of-time) compiler for producing machine code.

  • Dart Web: For programs targeting the web, Dart Web includes both a development time compiler (dartdevc) and a production time compiler (dart2js).

Dart platforms illustration

License & patents

Dart is free and open source.

See LICENSE and PATENT_GRANT.

Using Dart

Visit the dart.dev to learn more about the language, tools, getting started, and more.

Browse pub.dev for more packages and libraries contributed by the community and the Dart team.

Building Dart

If you want to build Dart yourself, here is a guide to getting the source, preparing your machine to build the SDK, and building.

There are more documents on our wiki.

Contributing to Dart

The easiest way to contribute to Dart is to file issues.

You can also contribute patches, as described in Contributing.