aws-sdk-for-zig/example
Emil Lerch 981d5579f1
All checks were successful
aws-zig mach nominated build / build-zig-nominated-mach-latest (push) Successful in 3m5s
aws-zig nightly build / build-zig-nightly (push) Successful in 3m1s
update to compatible package version
2024-06-04 17:04:11 -07:00
..
src update example 2024-04-02 18:30:27 -07:00
build.zig update example to zig 0.13-dev.365 (zig nominated build 2024.05) 2024-06-04 16:35:52 -07:00
build.zig.zon update to compatible package version 2024-06-04 17:04:11 -07:00
README.md add example/update readmes 2023-09-05 18:31:08 -07:00

Example usage of aws-zig module by a client application

This directory has a fully functional command line application that utilizes the aws-zig module using the Zig package manager introduced in Zig 0.11.

A couple things of note:

  • Rather than the typical "we will use the source code repository archive", you will notice in build.zig.zon that the dependency URL is a Gitea actions artifact. This is due to the fact that the aws service models are generated, and the package manager does not currently (I think) have a way to perform compile steps when pulling in a package and using a module. In any case, this seems like a reasonable restriction. The aws-zig SDK repository will build and test each code change, along with model generation, then capture the generated files along with the actual SDK source code and upload the resulting artifact for use. To find the correct artifact, look at the actions page and choose a run (example). Under Artifacts, you will see the tarball and can paste that link into build.zig.zon.
  • The action naming is incorrect according to the zig naming guidelines. This will be fixed in the code generation process shortly, and this example will be updated accordingly.
  • Many (most) AWS services still don't support TLS 1.3. I recommend using mitmproxy during development. Otherwise, it is likely best to wait until service(s) important to you are supported on TLS 1.3.

Usage

After configuring your AWS credentials using the standard tools, a simple zig build run should be sufficient to run this example.