Add a mid-sized integration test for the Dart Embedding Api which

runtime/include/dart_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_API_H_
 #define INCLUDE_DART_API_H_
 
 /** \mainpage Dart Embedding API Reference
  *
  * Dart is a class-based programming language for creating structured
@@ skipping 427 matching lines @@
  *
  * This function waits for incoming messages for the current
  * isolate. As new messages arrive, they are handled using
  * Dart_HandleMessage. The routine exits when all ports to the
  * current isolate are closed.
  */
 DART_EXPORT Dart_Handle Dart_RunLoop();
 // TODO(turnidge): Should this be removed from the public api?
 
 /**
+ * Gets the main Dart_Port for the current isolate.
+ */
+DART_EXPORT Dart_Port Dart_GetMainPort();
+
+/**
+ * Does the current isolate have live ReceivePorts?
+ *
+ * A port is live when it has not been closed and when
+ * ReceivePort.receive() has been called to install a receive handler.
+ */

[siva, 2011/11/29 19:50:27]

Is this comment still valid?

[turnidge, 2011/12/05 17:53:34]

Updated.

+DART_EXPORT bool Dart_HasLivePorts();
+
+/**
  * Posts a message for some isolate. The message is built from a raw
  * array.
  *
  * \param port The destination port.
  * \param length The length of the data array.
  * \param data A data array to be sent in the message.
  *
  * \return True if the message was posted.
  */
 DART_EXPORT bool Dart_PostIntArray(Dart_Port port,
                                    intptr_t length,
                                    intptr_t* data);
 // TODO(turnidge): Should this be intptr_t or some fixed length type?
 // TODO(turnidge): Reverse length/data for consistency.
 
 /**
  * Posts a message for some isolate. The message is a serialized
  * object.
  *
  * Requires there to be a current isolate.
  *
  * \param port The destination port.
  * \param object An object from the current isolate.
  *
  * \return True if the message was posted.
  */
 DART_EXPORT bool Dart_Post(Dart_Port port, Dart_Handle object);
 
+/**
+ * Returns a new SendPort with the provided id.
+ */
+DART_EXPORT Dart_Handle Dart_NewSendPort(Dart_Port port);

[siva, 2011/11/29 19:50:27]

I would call the variable port_id to avoid having it seem as a port object.

[turnidge, 2011/12/05 17:53:34]

Done.  I also updated all other Dart_Port parameters in the api at the same
time.

+
+/**
+ * Returns a new ReceivePort with the provided id.
+ *
+ * Do not create multiple ReceivePorts with the same id.

[siva, 2011/11/29 19:50:27]

Is this a comment for the user stating that they should not call this multiple
times for the same id?

[turnidge, 2011/12/05 17:53:34]

Changed this function to Dart_GetReceivePort to imply that there is only one and
updated the code to return the same ReceivePort.

+ */
+DART_EXPORT Dart_Handle Dart_NewReceivePort(Dart_Port port);

[siva, 2011/11/29 19:50:27]

port => port_id

[turnidge, 2011/12/05 17:53:34]

Done.

+
 // --- Scopes ----
 
 /**
  * Enters a new scope.
  *
  * All new local handles will be created in this scope. Additionally,
  * some functions may return "scope allocated" memory which is only
  * valid within this scope.
  *
  * Requires there to be a current isolate.
@@ skipping 718 matching lines @@
 
 // --- Profiling support ----
 
 // External pprof support for gathering and dumping symbolic
 // information that can be used for better profile reports for
 // dynamically generated code.
 DART_EXPORT void Dart_InitPprofSupport();
 DART_EXPORT void Dart_GetPprofSymbolInfo(void** buffer, int* buffer_size);
 
 #endif  // INCLUDE_DART_API_H_