mikekistler

How to Create the Restler Config for an Azure Service

Let me start with the tip that Marina gave me in email:

My usual way of creating config.json is to compile one spec via “--api_spec”, then copying the generated config out of the ‘Compile’ folder and modifying the paths.

There are two different ways to run the Compile step of Restler:

restler compile --api_spec <path to OpenAPI definition>

mikekistler

An Alternative Solution for Request/Response Metadata

This gist offers an alternative to Brian's proposal for handling metadata / solving Issue #182.

This proposal is to (mostly) "leave things as is", document them clearly, and then give users guidance for handling cases such as the scenarious identified in the on how to handle cases such as the use cases described in the Wiki page for this issue.

What do I mean by "leave things as is"?

mikekistler

    string newProjectName = "MyProject";
    RequestContent creationRequestContent = RequestContent.Create(
        new {
            description = "This is the description for a test project",
            language = "en",
            multilingualResource = false,
            settings = new {
                defaultAnswer = "No answer found for your question."
                }
            }

mikekistler

The Cadl named union:

model Cat {
  meow: int32;
};
model Dog {
  bark: string;
};
union Pet { cat: Cat, dot: Dog }