Clone this repo:
  1. 54328f7 Merge pull request #287 from dart-lang/gae_upgrade by Luke Church · 32 hours ago master
  2. 1817573 Pull the version from the Platform by Luke Church · 32 hours ago gae_upgrade
  3. 044eb32 Missing whitespace by Luke Church · 33 hours ago
  4. 3af3453 Upgrade GAE configuration by Luke Church · 33 hours ago
  5. b935958 Merge pull request #285 from dart-lang/strong_mode_testing by Luke Church · 4 weeks ago

Dart Services

A server backend to support interactive Dart services.

Build Status Coverage Status Uptime Status

What is it? What does it do?

This project is a small, stateless Dart server, which exposes a RESTful API. The API provides services to:

  • analyze Dart code for errors and warnings (/api/dartservices/v1/analyze)
  • compile Dart code (/api/dartservices/v1/compile)
  • perform code completion for a snippet of Dart code (/api/dartservices/v1/complete)
  • get dartdoc tooltip information for a snippet of Dart code (/api/dartservices/v1/document)
  • format Dart code (/api/dartservices/v1/format)
  • get quick fixes for problems in code (/api/dartservices/v1/fixes)

Try it!

A simple DartPad example of how to use the library is here: https://dartpad.dartlang.org/2a7fd9328e0a567ee79b

Project status

The services APIs are running and available to use. Please give it a try! We may still amend them from time to time in a way that causes breaking changes. If you would like to make sure we discuss this with you first, please get in touch to let us know.

The API

The discovery doc for the server's REST API is available here: http://dart-services.appspot.com/api/discovery/v1/apis/dartservices/v1/rest.

Running

To run the server, run:

dart bin/services.dart --port 8082

The server will run from port 8082 and export several JSON APIs, like /api/compile and /api/analyze.

Deploying

To deploy the server to Dart on AppEngine, follow the instructions here.

Modify warmup.dart to point the BASE_URI to your AppEngine project.

Then run

./tools/deploy.sh

The will deploy the server, and run the warmup sequence and sanity checks.

Related projects

See also the dart-pad repo.

Issues and bugs

Please file reports on the GitHub Issue Tracker.

License and Contributing

Contributions welcome! Please read this short guide first. You can view our license here.