Build Plugin

[adam-fowler]

At this point this is a little experimental. I can't use it in the current release of Soto as it requires Swift 5.6 or later.

This PR adds a build plugin that will generate AWS service swift files from a Smithy model file and the endpoints.json file from AWS. In theory someone doesn't need to download the whole of Soto anymore. There is one gotcha here, without Soto you don't get the extension code. In some cases this will just be missing functionality but for services that require middleware (S3, Glacier, ApiGateway) they will not compile.

Changes include

• Adding a couple of new options to SotoCodeGenerator to deal with single service files. Previously it assumed we were working on a folder of service files.
• Combined some of the generated source files so there is always the same number of files output. The plugin needs to know what files will be generated.
• Create build plugin

For a project to use this it needs to add the following dependencies to their Package.swift

        .package(url: "https://github.com/soto-project/soto-codegenerator", branch: "feature/plugin"),
        .package(url: "https://github.com/soto-project/soto-core.git", from: "6.0.0")

Create a target with an empty dummy.swift file and the Smithy model file for the service you want code for. You can find the service files here. In the Package.swift add the target as follows

        .target(
            name: "MyService",
            dependencies: [.product(name: "SotoCore", package: "soto-core")],
            plugins: [.plugin(name: "SotoCodeGeneratorPlugin", package: "soto-codegenerator")]
        ),

Copy the endpoints.json to the root of your package

Now when you build it will generate the swift service files in .build/plugins/outputs/soto-codegenerator-plugin/MyService/SotoCodeGeneratorPlugin/GeneratedSources.

You can find an example project here https://github.com/adam-fowler/soto-codegenerator-plugin-test

[adam-fowler]

@ktoso @0xTim

[adam-fowler]

Eventually I should be able to use this with Soto, and people wouldn't be downloading Swift files for every service. They would just be downloading the service model files and generating the code for services they need.

[0xTim]

Looks great! Looking forward to seeing this get used