AWS SDK for Zig
Go to file
Emil Lerch bb93f41b85
add xml_shaper (see below)
This will use the Vulkan xml parser to parse data, then
massage that into a passed type. It uses code patterned
off the standard library Json parser to do the work.

The final, commented test is exposing a compiler bug that
needs to be reduced and sent to the zig team. Initial reports
from IRC indicate that the team is not focusing on compiler
bugs until stage 2 is done (hopefully May 2022)
2022-02-11 09:22:32 -08:00
codegen update generated models for xml mappings 2022-02-10 15:13:44 -08:00
smithy update generated models for xml mappings 2022-02-10 15:13:44 -08:00
src add xml_shaper (see below) 2022-02-11 09:22:32 -08:00
.drone.yml add macos to CI 2022-02-08 22:36:36 -08:00
.gitignore add macos to CI 2022-02-08 22:36:36 -08:00
Amazon_Root_CA_1.pem add tls trust chain for AWS 2022-01-19 21:17:44 -08:00
build_test.zig add build_test/VersionStep 2022-01-12 16:52:45 -08:00
build.zig add macos to CI 2022-02-08 22:36:36 -08:00
CopyStep.zig dig out aws crt. project no longer builds 2022-01-10 21:49:59 -08:00
GitRepoStep.zig dig out aws crt. project no longer builds 2022-01-10 21:49:59 -08:00
LICENSE first thing that actually works 2021-04-27 11:24:01 -07:00
Makefile first thing that actually works 2021-04-27 11:24:01 -07:00
README.md update README with new XML information 2022-02-10 15:29:51 -08:00
VersionStep.zig fix build 2022-01-12 18:25:53 -08:00
zfetch_deps.zig dig out aws crt. project no longer builds 2022-01-10 21:49:59 -08:00

AWS SDK for Zig (zig native branch)

Build Status

This SDK currently supports all AWS services except EC2 and S3. These two services only support XML, and zig 0.9.0 and master both trigger compile errors while incorporating the XML parser in conjunction with a process to fill the types. S3 also requires some plumbing tweaks in the signature calculation. Examples of usage are in src/main.zig.

Current executable size for the demo is 953k (90k of which is the AWS PEM file) after compiling with -Drelease-safe and stripping the executable after compilation. This is for x86_linux. Tested targets:

  • x86_64-linux
  • riscv64-linux
  • aarch64-linux
  • x86_64-windows
  • arm-linux
  • aarch64-macos
  • x86_64-macos

Tested targets are built, but not continuously tested, by CI.

Building

zig build should work. It will build the code generation project, run the code generation, then build the main project with the generated code.

First time build should use zig build -Dfetch to fetch dependent packages (zfetch and friends).

Running

This library mimics the aws c libraries for it's work, so it operates like most other 'AWS things'. main.zig gives you a handful of examples for working with services. For local testing or alternative endpoints, there's no real standard, so there is code to look for AWS_ENDPOINT_URL environment variable that will supersede all other configuration. Note that an alternative endpoint may require passing in a client option to specify an different TLS root certificate (pass null to disable certificate verification).

The old branch exists for posterity, and supports x86_64 linux. This branch is recommended moving forward.

Limitations

There are many nuances of AWS V4 signature calculation. S3 is not supported because it uses many of these test cases. WebIdentityToken is not yet implemented.

TODO List:

  • To work around compiler issues, the best option may be to convert from Xml to json, then parse from there. This will be pursued first. It may need to wait for zig 0.10.0 when self-hosted compiler is likely to be completed (zig 0.10.0 eta May 2022) discovered. If we need to wait, S3, EC2 and other restXml protocols will be blocked.
  • Implement AWS restXml protocol. Includes S3. Total service count 4. This may be blocked due to the same issue as EC2.
  • Implement AWS EC2 query protocol. Includes EC2. Total service count 1. This may be blocked on a compiler bug, though has not been tested with zig 0.9.0. More details and llvm ir log can be found in the XML branch.
  • Implement sigv4a signing
  • Implement jitter/exponential backoff
  • Implement timeouts and other TODO's in the code
  • Add option to cache signature keys

Compiler wishlist/watchlist: