Find a file
Paul Berry 2d1c691625 Propagate non-nullability of contexts through the analyzer codebase.
Now that null contexts are impossible during analyzer resolution
(https://dart-review.googlesource.com/c/sdk/+/357522), it's possible
to make a lot of variables, fields and parameters that represent
contexts non-nullable.

This change propagates non-nullability of contexts through the
analyzer to the extent that can be done reasonably quickly and
safely. In particular, it makes the following changes:

- It changes the following helper methods so that they no longer
  accept a `null` context:
  - TypeSystemImpl.acceptsFunctionType
  - TypeSystemImpl.refineNumericInvocationContext
  - TypeSystemImpl.setupGenericTypeInference
  - TypeSystemImpl._refineNumericInvocationContextNullSafe
  - InvocationInferenceHelper.inferTearOff
  - InvocationInferenceHelper.resolveMethodInvocation
  - ElementResolver.visitMethodInvocation
  - ErrorDetectionHelpers.getImplicitCallMethod
  - ResolverVisitor.insertGenericFunctionInstantiation
  - ResolverVisitor._insertImplicitCallReference
  - ResolverVisitor._resolveRewrittenFunctionExpressionInvocation
  - StaticTypeAnalyzer.visitConditionalExpression
  - StaticTypeAnalyzer.visitIntegerLiteral
  - AstResolver.resolveExpression

- It changes the following classes so that their `resolve` methods no
  longer accept a `null` context (nor do the methods that those
  `resolve` methods defer to):
  - AssignmentExpressionResolver
  - BinaryExpressionResolver
  - ConstructorReferenceResolver
  - FunctionExpressionInvocationResolver
  - FunctionExpressionResolver
  - InstanceCreationExpressionResolver
  - MethodInvocationResolver
  - PostfixExpressionResolver
  - PrefixExpressionResolver
  - PrefixedIdentifierResolver
  - RecordLiteralResolver
  - SimpleIdentifierResolver
  - TypedLiteralResolver

- It changes all the classes in the `InvocationInferrer` class
  hierarchy so that they no longer accept a `null` context.

- It changes the following helper methods so that they no longer
  return a `null` context:
  - AssignmentExpressionResolver._computeRhsContext
  - InvocationInferrer._computeContextForArgument
  - MethodInvocationInferrer._computeContextForArgument
  - YieldStatementResolver._computeContextType

- It changes PropertyElementResolverResult.indexContextType so that it
  no longer can be `null`.

- It ensures that the analyzer always passes a non-null context to the
  _fe_analyzer_shared method `TypeAnalyzer.analyzeExpression`. This
  will pave the way for a follow-up CL that makes that method stop
  accepting `null`.

In many cases, to accomplish this, it was necessary to make explicit
use of the unknown type schema `_`
(UnknownInferredType.instance). Although adding these explicit uses
makes the code a bit more verbose, it's not really fundamentally more
complex than it was before; previously, the code used `null` to
represent `_` in these cases (sometimes implicitly).

Change-Id: I1479e7c59969c59ea67abef30daa6a516b15ed97
Reviewed-on: https://dart-review.googlesource.com/c/sdk/+/358662
Commit-Queue: Paul Berry <paulberry@google.com>
Reviewed-by: Konstantin Shcheglov <scheglov@google.com>
2024-03-20 19:58:49 +00:00
.dart_tool [infra] re-land work to auto-generate .dart_tool/package_config.json 2022-04-12 17:21:02 +00:00
.github Bump actions/checkout from 4.1.1 to 4.1.2 2024-03-19 10:07:23 +00:00
benchmarks [benchmarks] Fix benchmarks warming up incorrectly. 2024-02-22 14:38:19 +00:00
build Reland "[Fuchsia] Remove the legacy gn build rules for fuchsia" 2024-03-14 20:22:12 +00:00
docs Add requirement to fix downstream repositories 2024-03-13 14:13:49 +00:00
pkg Propagate non-nullability of contexts through the analyzer codebase. 2024-03-20 19:58:49 +00:00
runtime [gardening] Skip slow test on reload bots 2024-03-18 21:02:53 +00:00
samples fix use of deprecated members in ffi samples 2024-01-31 22:31:59 +00:00
sdk [dart2wasm] Update built-in string imports according to the latest spec 2024-03-19 08:20:59 +00:00
tests Remove special analyzer behavior for await expressions with "null context". 2024-03-20 17:33:28 +00:00
third_party [dds/dap] Bump package:dap and the version used by DDS 2024-02-29 19:22:19 +00:00
tools Introduce support for augmentation libraries in Dart.g 2024-03-20 17:10:53 +00:00
utils fix: confused comment content 2024-03-14 08:57:38 +00:00
.clang-format
.gitattributes Fix allowing Windows newlines in sh files. 2024-03-19 11:27:14 +00:00
.gitconfig
.gitignore [infra] Support testing with RBE on Windows. 2024-02-29 10:33:09 +00:00
.gn [build] Switch to Fuchsia core SDK. 2023-11-10 19:23:11 +00:00
.mailmap Fixed various typos in a lot of files 2022-07-25 12:21:59 +00:00
.style.yapf
AUTHORS Simplify the license situation 2022-09-14 21:06:22 +00:00
BUILD.gn [vm] Do not bundle dart.lib in the Dart SDK 2024-02-15 14:09:37 +00:00
CHANGELOG.md Update changelog for improvements in code completion 2024-03-19 17:35:28 +00:00
codereview.settings [infra] Default presubmits to use python3 2021-08-24 08:20:47 +00:00
CONTRIBUTING.md Update CONTRIBUTING.md 2023-11-20 09:29:37 +00:00
DEPS Update pkg:web to 0.5.1 2024-03-20 15:39:59 +00:00
LICENSE Update LICENSE 2021-04-08 07:57:10 +00:00
OWNERS Assign owners to each top level file. 2023-12-14 12:38:11 +00:00
PATENT_GRANT
PRESUBMIT.py [presubmit] Force read files as UTF-8 2024-03-05 14:25:09 +00:00
README.dart-sdk Update README.dart-sdk for inclusion of AOT snapshots 2023-11-21 10:33:22 +00:00
README.md Update readme content 2023-12-18 15:30:58 +00:00
sdk.code-workspace [cleanup] Remove co19_2 and other references to _2 suites 2023-11-22 11:15:57 +00:00
sdk_args.gni [gn] Add an option to specify the sdk_hash 2024-03-07 04:11:48 +00:00
SECURITY.md Add link to published advisories 2022-02-08 19:45:07 +00:00
WATCHLISTS [analyzer] Properly close analyzer WATCHLISTS entry 2023-12-10 18:02:25 +00:00

Dart

An approachable, portable, and productive language for high-quality apps on any platform

Dart is:

  • Approachable: Develop with a strongly typed programming language that is consistent, concise, and offers modern language features like null safety and patterns.

  • Portable: Compile to ARM, x64, or RISC-V machine code for mobile, desktop, and backend. Compile to JavaScript or WebAssembly for the web.

  • Productive: Make changes iteratively: use hot reload to see the result instantly in your running app. Diagnose app issues using DevTools.

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 dart.dev to learn more about the language, tools, and to find codelabs.

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

Our API reference documentation is published at api.dart.dev, based on the stable release. (We also publish docs from our beta and dev channels, as well as from the primary development branch).

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.