DevFS initial implementation

runtime/include/dart_tools_api.h

 // Copyright (c) 2011, 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.
 
 #ifndef INCLUDE_DART_TOOLS_API_H_
 #define INCLUDE_DART_TOOLS_API_H_
 
 #include "include/dart_api.h"
 
 /** \mainpage Dart Tools Embedding API Reference
@@ skipping 879 matching lines @@
  *
  * \return Success if the arguments are well formed.  Otherwise, returns an
  *   error handle.
  */
 DART_EXPORT Dart_Handle Dart_ServiceSendDataEvent(const char* stream_id,
                                                   const char* event_kind,
                                                   const uint8_t* bytes,
                                                   intptr_t bytes_length);
 
 /*
+ * =====
+ * DevFS
+ * =====
+ */
+
+/**
+ * Determines if a uri is a DevFS uri.
+ *
+ * \param uri The uri to test. This parameter is a string.
+ *
+ * \return true if uri is a DevFS uri and false otherwise.
+ */
+DART_EXPORT bool Dart_IsDevFSUri(Dart_Handle uri);

[turnidge, 2016/06/10 18:45:34]

Consider dropping the embedding api changes until they are actually used
somewhere.

+
+
+/**
+ * Attempts to read the DevFS file at uri.
+ *
+ * \param uri The uri to read. This parameter is a string.
+ *
+ * \return A typed data array of Dart_TypedData_kUint8 containing the contents
+ * of the file. Otherwise, returns an error handle.
+ */
+DART_EXPORT Dart_Handle Dart_DevFSReadFile(Dart_Handle uri);
+
+
+/**
+ * Attempts to read the DevFS file at uri.
+ *
+ * \param uri The uri to read. This parameter is a string.
+ *
+ * \return A string containing the contents of the file. Otherwise,
+ * returns an error handle.
+ */
+DART_EXPORT Dart_Handle Dart_DevFSReadFileAsUTF8String(Dart_Handle uri);
+
+
+/*
  * ========
  * Timeline
  * ========
  */
 
 /**
  * Returns a timestamp in microseconds. This timestamp is suitable for
  * passing into the timeline system.
  *
  * \return A timestamp that can be passed to the timeline system.
@@ skipping 151 matching lines @@
  * \param start_recording See Dart_EmbedderTimelineStartRecording.
  * \param stop_recording See Dart_EmbedderTimelineStopRecording.
  *
  * NOTE: To avoid races, this should be called before Dart_Initialize.
  */
 DART_EXPORT void Dart_SetEmbedderTimelineCallbacks(
     Dart_EmbedderTimelineStartRecording start_recording,
     Dart_EmbedderTimelineStopRecording stop_recording);
 
 #endif  // INCLUDE_DART_TOOLS_API_H_