{"id":15722607,"url":"https://github.com/britzl/aws-sdk-lua","last_synced_at":"2025-05-07T21:42:43.082Z","repository":{"id":151986034,"uuid":"95771924","full_name":"britzl/aws-sdk-lua","owner":"britzl","description":"Auto generated AWS SDK for Lua","archived":false,"fork":false,"pushed_at":"2020-03-12T12:34:11.000Z","size":14903,"stargazers_count":39,"open_issues_count":8,"forks_count":10,"subscribers_count":6,"default_branch":"master","last_synced_at":"2025-03-31T14:21:42.934Z","etag":null,"topics":["amazon-web-services","aws-sdk","defold","defold-library","lua"],"latest_commit_sha":null,"homepage":null,"language":"Lua","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/britzl.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-06-29T11:43:51.000Z","updated_at":"2024-09-09T11:35:59.000Z","dependencies_parsed_at":null,"dependency_job_id":"b35b3101-aedd-429d-8f70-4e87f4fd10ca","html_url":"https://github.com/britzl/aws-sdk-lua","commit_stats":null,"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/britzl%2Faws-sdk-lua","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/britzl%2Faws-sdk-lua/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/britzl%2Faws-sdk-lua/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/britzl%2Faws-sdk-lua/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/britzl","download_url":"https://codeload.github.com/britzl/aws-sdk-lua/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252961810,"owners_count":21832189,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["amazon-web-services","aws-sdk","defold","defold-library","lua"],"created_at":"2024-10-03T22:08:38.562Z","updated_at":"2025-05-07T21:42:43.058Z","avatar_url":"https://github.com/britzl.png","language":"Lua","readme":"[![Build Status](https://travis-ci.org/britzl/aws-sdk-lua.svg?branch=master)](https://travis-ci.org/britzl/aws-sdk-lua)\n\n# AWS SDK for Lua (beta)\nUnofficial AWS SDK for Lua, available for LuaJIT and Lua 5.1 and later. The SDK has been used in production, specifically GameLift, but several other services are untested.\n\nFor release notes, see the [CHANGELOG](CHANGELOG.md).\n\n## Installing\n\n### Defold\nYou can use the AWS SDK for Lua in your own project by adding this project as a [Defold library dependency](http://www.defold.com/manuals/libraries/). Open your game.project file and in the dependencies field under project add:\n\n\thttps://github.com/britzl/aws-sdk-lua/archive/master.zip\n\nOr point to the ZIP file of a [specific release](https://github.com/britzl/aws-sdk-lua/releases).\n\n\n### LuaRocks\nThe SDK is currently not distributed via LuaRocks. LuaRocks distribution will happen once the SDK is stable and moved out of beta.\n\n## Usage\nUsing the AWS SDK for Lua is a simple process requiring only a few steps of configuration:\n\n\t-- Configure AWS to work with Defold (specifically to use http.request() provided by the Defold engine to make HTTP calls)\n\tlocal config = require \"aws-skd.core.config\"\n\tconfig.use_defold()\n\t-- config.use_corona()\n\t-- config.use_luasocket()\n\n\t-- Set access key and secret access key (read this from config file or os.env)\n\tlocal credentials = require \"aws-sdk.core.credentials\"\n\tcredentials.set(access_key, secret_access_key)\n\n\t-- Initialise the AWS service to use, in this case GameLift\n\tlocal gamelift = require \"aws-sdk.gamelift\"\n\tgamelift.init({ region = \"eu-central-1\" })\n\n\t-- Make a call to a GameLift endpoint\n\tlocal input = gamelift.CreateGameSessionInput({\n\t\tCreatorId = \"c6e209af-4ac0-47b4-c752-60f81db6d2d0\",\n\t\tAliasId = \"alias-4cfbed10-a54d-4e9f-8bc0-ba7f98a6ef40\",\n\t\tName = \"My session\",\n\t\tMaximumPlayerSessionCount = 10\n\t})\n\tgamelift.CreateGameSessionAsync(input, function(response, error_message)\n\t\tif not error_message then\n\t\t\tprint(response.GameSession.GameSessionId)\n\t\tend\n\tend)\n\n## Generating code\nThe SDK generates the code for all AWS services, their input and output including input validation. The code generator uses official AWS SDK API definitions from the [AWS SDK for Javascript project](https://github.com/aws/aws-sdk-js/tree/master/apis). The code generator uses a [Mustache template](https://mustache.github.io/) and a small Python script to parse the API definitions and outputs one Lua file per AWS service. You can run the generator yourself from a terminal:\n\n\tpython generate.py\n\nThe script reads the definition files from ````apis/```` folder and outputs generated code to the ````aws-sdk/```` folder.\n\n## Getting Help\nPlease use these community resources for getting help. We use the GitHub issues for tracking bugs and feature requests and have limited bandwidth to address them.\n\n * Ask a question on the [Defold forum](https://forum.defold.com/)\n * Come join the Defold [slack channel](https://www.defold.com/slack/)\n * If it turns out that you may have found a bug, please [open an issue](https://github.com/britzl/aws-sdk-lua/issues/new)\n\n## Opening Issues\nIf you encounter a bug with the AWS SDK for Lua we would like to hear\nabout it. Search the [existing issues](https://github.com/britzl/aws-sdk-lua/issues)\nand try to make sure your problem doesn’t already exist before opening a new\nissue. It’s helpful if you include the version of the SDK and the Lua version\nyou’re using. Please include a stack trace and reduced repro\ncase when appropriate, too.\n\nThe GitHub issues are intended for bug reports and feature requests. For help\nand questions with using the AWS SDK for Lua please make use of the\nresources listed in the [Getting Help](https://github.com/britzl/aws-sdk-lua#getting-help)\nsection. There are limited resources available for handling issues and by\nkeeping the list of open issues lean we can respond in a timely manner.\n\n## License\nThis SDK is distributed under the\n[Apache License, Version 2.0](http://www.apache.org/licenses/LICENSE-2.0),\nsee LICENSE.txt for more information.\n\n## Third-party code used\nThe SDK uses code from the following projects:\n\n* AWS Service definitions from the [AWS SDK for Javascript](https://github.com/aws/aws-sdk-js/tree/master/apis)\n* Cryptographic functions from the [Lua-Lockbox](https://github.com/somesocks/lua-lockbox) project.\n* JSON encoder from [json.lua](https://github.com/rxi/json.lua)\n* URL encode/decode from the [Lua User Wiki]()\n* XML parser from [xml2lua](https://github.com/manoelcampos/xml2lua) project.\n","funding_links":[],"categories":["Libraries"],"sub_categories":["Programming Language"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbritzl%2Faws-sdk-lua","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbritzl%2Faws-sdk-lua","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbritzl%2Faws-sdk-lua/lists"}