/// <summary>
/// Hosts an interactive REPL against a supported Workbooks target platform.
/// This is analogous to 'csharp' or 'csi' or any other REPL on the planet.
/// </summary>
static async Task <int> ReplPlayerMain()
{
// As an exercise to the reader, this puppy should take an optional
// workbook flavor ID to know what platform you want to REPL and find
// it in the list of installed and available ones...
// For now we'll just pick the first available option 😺
var workbookTarget = WorkbookAppInstallation.All.FirstOrDefault();
if (workbookTarget == null)
{
RenderError("No workbook target platforms could be found.");
return(1);
}
// We do not currently expose a list of available language descriptions
// for the given build/installation, but if we did, this is when
// you'd want to pick one. Just assume 'csharp' for now. Stay tuned.
language = "csharp";
// A session description combines just enough info for the entire
// EvaluationService to get itself in order to do your bidding.
var sessionDescription = new InteractiveSessionDescription(
language,
workbookTarget.Id,
new EvaluationEnvironment(Environment.CurrentDirectory));
// Now create and get ready to deal with the session; a more complete
// client should handle more than just OnNext from the observer.
var session = InteractiveSession.CreateWorkbookSession();
session.Events.Subscribe(new Observer <InteractiveSessionEvent> (OnSessionEvent));
// And initialize it with all of our prerequisites...
// Status events raised within this method will be posted to the
// observable above ("starting agent", "initializing workspace", etc).
await session.InitializeAsync(sessionDescription);
// At this point we have the following in order, ready to serve:
//
// 1. a connected agent ready to execute code
// 2. a workspace that can perform compliation, intellisense, etc
// 3. an evaluation service that is ready to deal with (1) and (2)
//
// It's at this point that a full UI would allow the user to actually
// run code. This is the "User Experience main()"...
//
// This is the REPL you're looking for...
while (true)
{
// append a new cell (no arguments here imply append)
var cellId = await session.EvaluationService.InsertCodeCellAsync();
// render the initial/top-level prompt
WriteReplPrompt();
while (true)
{
var deltaBuffer = ReadLine();
var existingBuffer = await session.EvaluationService.GetCodeCellBufferAsync(cellId);
await session.EvaluationService.UpdateCodeCellAsync(
cellId,
existingBuffer.Value + deltaBuffer);
if (session.WorkspaceService.IsCellComplete(cellId))
{
break;
}
WriteReplPrompt(secondaryPrompt: true);
}
await session.EvaluationService.EvaluateAsync(cellId);
await EvaluationServiceRaceBug();
}
}
/// <summary>
/// Provides very basic workbook parsing and shunting of code cells
/// into the evaluation service. Does not display non-code-cell contents
/// but does evaluate a workbook from top-to-bottom. Restores nuget
/// packages from the workbook's manifest.
/// </summary>
static async Task <int> WorkbookPlayerMain(string workbookPath)
{
var path = new FilePath(workbookPath);
if (!path.FileExists)
{
Error.WriteLine($"File does not exist: {path}");
return(1);
}
// load the workbook file
var workbook = new WorkbookPackage(path);
await workbook.Open(
quarantineInfo => Task.FromResult(true),
path);
// create and get ready to deal with the session; a more complete
// client should handle more than just OnNext from the observer.
var session = InteractiveSession.CreateWorkbookSession();
session.Events.Subscribe(new Observer <InteractiveSessionEvent> (OnSessionEvent));
#pragma warning disable 0618
// TODO: WorkbookDocumentManifest needs to eliminate AgentType like we've done on web
// to avoid having to use the the flavor mapping in AgentIdentity.
var targetPlatformIdentifier = AgentIdentity.GetFlavorId(workbook.PlatformTargets [0]);
#pragma warning restore 0618
// initialize the session based on manifest metadata from the workbook file
language = workbook.GetLanguageDescriptions().First();
await session.InitializeAsync(new InteractiveSessionDescription (
language,
targetPlatformIdentifier,
new EvaluationEnvironment(Environment.CurrentDirectory)));
// restore NuGet packages
await session.PackageManagerService.RestoreAsync(
workbook.Pages.SelectMany(page => page.Packages));
// insert and evaluate cells in the workbook
foreach (var cell in workbook.IndexPage.Contents.OfType <CodeCell> ())
{
var buffer = cell.CodeAnalysisBuffer.Value;
lastCodeCellId = await session.EvaluationService.InsertCodeCellAsync(
buffer,
lastCodeCellId);
WriteReplPrompt();
WriteLine(buffer);
await session.EvaluationService.EvaluateAsync(lastCodeCellId);
await EvaluationServiceRaceBug();
if (lastCellEvaluationStatus != CodeCellEvaluationStatus.Success)
{
break;
}
}
return(0);
}