AWS SDK for Zig
Go to file
Emil Lerch 5ee53a493d
some codegen changes needed/investigation into http_query (see note)
This fixes main compile issues. Problems that remain:

* json is borked for objects with key/value keys that need to be coerced
* currently all request structures need an http_query declaration, and this may be a hard requirement
* need to revisit all the places where we are reading http response bodies
* there are 35 compile errors that do not have reference traces and will take a while to track down
2023-08-05 12:41:04 -07:00
.gitea/workflows update to use ntfy action 2023-03-27 15:38:27 -07:00
codegen some codegen changes needed/investigation into http_query (see note) 2023-08-05 12:41:04 -07:00
src some codegen changes needed/investigation into http_query (see note) 2023-08-05 12:41:04 -07:00
.gitignore some codegen changes needed/investigation into http_query (see note) 2023-08-05 12:41:04 -07:00
CopyStep.zig these are old changes, but I believe part of 0.11 from a while back 2023-08-04 10:06:54 -07:00
GitRepoStep.zig these are old changes, but I believe part of 0.11 from a while back 2023-08-04 10:06:54 -07: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 to reflect the pending 0.11 move 2023-08-04 09:38:25 -07:00
VersionStep.zig these are old changes, but I believe part of 0.11 from a while back 2023-08-04 10:06:54 -07:00
build.zig partial upgrade of build 2023-08-04 16:40:24 -07:00
build.zig.zon partial upgrade of build 2023-08-04 16:40:24 -07:00
build_test.zig these are old changes, but I believe part of 0.11 from a while back 2023-08-04 10:06:54 -07:00
zfetch_deps.zig dig out aws crt. project no longer builds 2022-01-10 21:49:59 -08:00

README.md

AWS SDK for Zig

Build Status

Now that 0.11 has been released, work will commence to move to the new compiler

Current executable size for the demo is 1.7M (90k of which is the AWS PEM file, and approximately 600K for XML services) after compiling with -Drelease-safe and stripping the executable after compilation. This is for x86_linux, and will vary based on services used. 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. The old branch is deprecated.

Limitations

WebIdentityToken is not yet implemented.

TODO List:

  • Bump to zig 0.11 and replace zFetch with std.http.Client
  • Implement sigv4a signing
  • Implement jitter/exponential backoff
  • Implement timeouts and other TODO's in the code
  • Add option to cache signature keys
  • Move CI to github actions based on gittea's implementation

Compiler wishlist/watchlist: