Skip to content

by-nir/aws-sdk-zig

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

AWS SDK for Zig

Zig v0.14 (dev) MIT License

The AWS SDK for Zig provides an interface for Amazon Web Services (AWS).

Caution

This project is in early development, DO NOT USE IN PRODUCTION!

Support for the remaining services and features will be added as the project matures and stabilize. Breaking changes are imminent!

Pure Zig implementation, from code generation to runtime SDKs. Building upon the language’s strong foundation, this project provides a performant and fully functioning SDKs, while minimizing dependencies and increased platform portability.

Tip

Use the AWS Lambda Runtime for Zig to deploy Lambda functions written in Zig.

Supported Features

Authentication

Status Method Runs locally
IAM Identity Center authentication
IAM Roles Anywhere
Assume a role
AWS access keys
IAM roles for EC2 instances

Settings

Status Feature Notes
Application ID
Amazon EC2 instance metadata
Amazon S3 access points
Amazon S3 Multi-Region Access Points
AWS Region
AWS STS Regionalized endpoints
Dual-stack and FIPS endpoints
Endpoint discovery
General configuration
IMDS client
Retry behavior
Request compression
Service-specific endpoints
Smart configuration defaults

Contributing

Important

At this point, the project serves as environment for developing other experimental sub-projects. This initiative is in an exploratory phase and is not yet ready for contributions.

📁 Description
sdk AWS SDKs for Zig
Auto-generated, do not modify manually!
aws/runtime SDK runtime shared by all the services
aws/codegen AWS-specific source generation pipeline
smithy/runtime Smithy 2.0 client runtime
smithy/codegen Smithy 2.0 source generation pipeline

CLI Commands

  • zig build --build-file build.codegen.zig Generate the AWS SDKs source code.
    • Optionally specify one or more -Dfilter=sdk_codename to select specific services.
  • zig build test:<service> Run generated SDK service’s unit tests.

License

The author and contributors are not responsible for any issues or damages caused by the use of this software, part of it, or its derivatives. See LICENSE for the complete terms of use.

Note

AWS SDK for Zig is not an official Amazon Web Services software, nor is it affiliated with Amazon Web Services, Inc.

The SDKs code is generated based on a dataset of Smithy models created by Amazon Web Services. The models are extracted from the official AWS SDK for Rust and licensed as declared by Amazon Web Services, Inc. at the source repository. This codebase, including the generated code, are covered by a standalone license.

References

Smithy

AWS SDKs

Releases

No releases published

Packages

No packages published

Languages