wing compile api

Summary

a compile api as part of @winglang/wing

Feature Spec

Alongside with wing cli, you can compile a wing program using @winglang/wing/compile API

import { compile } from '@winglang/wing';

const wsim = await compile('./hello.w', { 
  target: 'sim' 
  // any other compiler flag
});
const simulator = new sdk.testing.Simulator({simfile : wsim}) 

Use Cases

It allows developer to compile wing programs programmatically (without having to run the CLI)
Here is a concrete example discussed in #876 :

Imagine this e2e test from the simulator.

Given the following code:

code.w

bring cloud;

let bucket = new cloud.Bucket();
inflight my_inflight(a:str): str{
  bucket.put("file.txt", a);
};

new cloud.Function(my_inflight);

We can use the compile command in the following jest test

basic.test.ts

import { compile } from '@winglang/wing';
import * as sdk from '@winglang/wingsdk';


let simulator : sdk.testing.Simulator
describe('basic compiler tests', () => { 
  beforeAll(async () => {
  const wsim = await compile('./code.w', { target: 'sim' });
  });
  beforeEach(async ()=> {
    simulator = new sdk.testing.Simulator({simfile : wsim}) 
    await simulator.start()
  });
  afterEach(async () => {
    await simulator.stop()
  })
  test('test function writes to bucket', async () => {
    let bucket = simulator.getResourceByPath("root/cloud.Bucket") as sdk.sim.IBucketClient
    let fn = simulator.getResourceByPath("root/cloud.Function") as sdk.sim.IFunctionClient
    await fn.invoke("somevalue")
    let output = await bucket.get('file.txt')
    expect(output).toBe('somevalue')
  });
});

Implementation Notes

No response

Component

Compiler

Start by tracing the existing wing CLI compiler entry point and the @winglang/wing package exports to determine where a compile API belongs. Use the provided basic.test.ts scenario and its Simulator setup as the acceptance path. Done means a Wing program can be compiled programmatically with a target such as sim and the resulting output can be passed to the simulator.