A proof of concept REPL environment for Dart.
See the Dart REPL Directions brain-dump for possible ideas and directions.
You can install and setup dart_repl using:
pub global activate dart_repl
To run it, simply execute:
pub global run dart_repl
If you run it from a directory that contains a Dart package (it needs a .packages file), it will load all dependencies automatically and allow you to import libraries adhoc from the command-line:
pub global run dart_repl --adhoc-import package:built_collection/built_collection.dart
(if your package depends on built_collection).
Alternatively, you can use the import() builtin command instead of the commmand-line flag --adhoc-import:
$ pub global run dart_repl
>>> import('package:built_collection/built_collection.dart');
This is the preferred way of running dart_repl as it requires no additional setup.
You can add a dev_dependency: to your pubspec.yaml:
dev_dependencies:
dart_repl:
[...]
You can then run the REPL with:
pub run dart_repl
It will automatically resolve all additional adhoc imports against the dependencies of your package:
pub run dart_repl --adhoc-import package:built_collection/built_collection.dart
From the command-line
dart bin/dart_repl.dart
To import additional libraries, you need to specify a package directory (--package-dir) to allow it to resolve dependencies:
dart bin/dart_repl.dart --package-dir ~/git/built_collection.dart/ --adhoc-import lib/built_collection.dart
Please file feature requests and bugs at the issue tracker.
[X] provide a back channel for the sandbox to change its own package config. [] find a way to unexport a library (can we enumerate all the symbols from a library and hide them?)
Variables need to be declared with var or final now.
Each top level declaration spawns a new compilation unit. All compilation units are chained
together. This means that you can freely redeclare variables. They will shadow each other.
This can lead to unintended consequences though:
>>> var a = 1
>>> void ip() { print(a++); }
>>> ip()
1
>>> ip()
2
>>> var a = 1;
>>> ip()
3
>>> a
1
The old behavior (non-shadowed, undeclared variables) is available using the scratch Scope.
>>> scratch.a = 1
1
>>> void ip() { print(++scratch.a); }
>>> ip()
2
>>> ip()
3
>>> scratch.a = 1
1
>>> ip()
2
The Scope behavior is ideal, however, I don't know how to lift it into the global namespace. Before I was evaluating every expression and statement within the Scope, so you could access all its fields without qualification. However, with top-level declaration, this is not possible anymore. This would mean having different semantics:
>>> a = 1
1
but
>>> class X { void ip() { print(++scratch.a); } }
A solution would be to generate a global scope file that is constantly reloaded. This seems infeasible for more complex inputs and for redefinitions.
Because each top-level decl is its own compilation unit, imports only work within the
same cell/input.
>>> import 'dart:io'; get pwd => Directory.current;
>>> pwd
Directory: '/Users/blackhc/IdeaProjects/dart_repl'
>>> Directory.current
Unhandled exception:
NoSuchMethodError: No top-level getter 'Directory' declared.
To make a library available to following cells, you have to use export.
>>> export 'dart:io'
>>> Directory.current
Directory: '/Users/blackhc/IdeaProjects/dart_repl'
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent