{"id":23391377,"url":"https://github.com/nugine/s3s","last_synced_at":"2025-05-15T07:04:41.366Z","repository":{"id":65333855,"uuid":"584824712","full_name":"Nugine/s3s","owner":"Nugine","description":"S3 Service Adapter","archived":false,"fork":false,"pushed_at":"2025-05-05T17:24:17.000Z","size":2387,"stargazers_count":180,"open_issues_count":47,"forks_count":46,"subscribers_count":10,"default_branch":"main","last_synced_at":"2025-05-15T07:04:35.206Z","etag":null,"topics":["http","rust","s3"],"latest_commit_sha":null,"homepage":"","language":"Rust","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/Nugine.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","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,"zenodo":null},"funding":{"github":null,"patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"lfx_crowdfunding":null,"polar":null,"buy_me_a_coffee":null,"thanks_dev":null,"custom":["https://github.com/Nugine#sponsor","https://paypal.me/nugine0"]}},"created_at":"2023-01-03T15:58:46.000Z","updated_at":"2025-05-09T12:40:40.000Z","dependencies_parsed_at":"2023-02-18T22:15:49.940Z","dependency_job_id":"f13c24ee-fc10-4a2c-ac9a-f36fee412751","html_url":"https://github.com/Nugine/s3s","commit_stats":{"total_commits":179,"total_committers":5,"mean_commits":35.8,"dds":0.03351955307262566,"last_synced_commit":"b0b6878dafee0e08a876bec5239425fc40c01271"},"previous_names":[],"tags_count":20,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Nugine%2Fs3s","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Nugine%2Fs3s/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Nugine%2Fs3s/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Nugine%2Fs3s/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Nugine","download_url":"https://codeload.github.com/Nugine/s3s/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254292039,"owners_count":22046426,"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":["http","rust","s3"],"created_at":"2024-12-22T04:16:01.798Z","updated_at":"2025-05-15T07:04:36.336Z","avatar_url":"https://github.com/Nugine.png","language":"Rust","funding_links":["https://github.com/Nugine#sponsor","https://paypal.me/nugine0"],"categories":[],"sub_categories":[],"readme":"# s3s\n\n[![Apache 2.0 licensed][license-badge]][license-url]\n[![Unsafe Forbidden][unsafe-forbidden-badge]][unsafe-forbidden-url]\n\n[license-badge]: https://img.shields.io/badge/license-Apache--2.0-blue.svg\n[license-url]: ./LICENSE\n[unsafe-forbidden-badge]: https://img.shields.io/badge/unsafe-forbidden-success.svg\n[unsafe-forbidden-url]: https://github.com/rust-secure-code/safety-dance/\n\nS3 Service Adapter\n\n\n| crate                      |                                           version                                           |                                 docs                                 |\n| :------------------------- | :-----------------------------------------------------------------------------------------: | :------------------------------------------------------------------: |\n| [s3s](./crates/s3s/)       |    [![Crates.io](https://img.shields.io/crates/v/s3s.svg)](https://crates.io/crates/s3s)    |    [![Docs](https://docs.rs/s3s/badge.svg)](https://docs.rs/s3s/)    |\n| [s3s-aws](./crates/s3s-aws/)       |    [![Crates.io](https://img.shields.io/crates/v/s3s-aws.svg)](https://crates.io/crates/s3s-aws)    |    [![Docs](https://docs.rs/s3s-aws/badge.svg)](https://docs.rs/s3s-aws/)    |\n| [s3s-fs](./crates/s3s-fs/) | [![Crates.io](https://img.shields.io/crates/v/s3s-fs.svg)](https://crates.io/crates/s3s-fs) | [![Docs](https://docs.rs/s3s-fs/badge.svg)](https://docs.rs/s3s-fs/) |\n\nThis experimental project intends to offer an ergonomic adapter for building S3-compatible services.\n\n`s3s` implements Amazon S3 REST API in the form of a generic [hyper](https://github.com/hyperium/hyper) service. S3-compatible services can focus on the S3 API itself and don't have to care about the HTTP layer.\n\n`s3s-aws` provides useful types and integration with [`aws-sdk-s3`](https://crates.io/crates/aws-sdk-s3).\n\n`s3s-fs` implements the S3 API based on file system, as a sample implementation. It is designed for integration testing, which can be used to [mock an S3 client](https://github.com/Nugine/s3s/blob/main/crates/s3s-fs/tests/it_aws.rs). It also provides a binary for debugging. [Play it!](./CONTRIBUTING.md#play-the-test-server)\n\n## How it works\n\n![architecture diagram](docs/arch/arch.svg)\n\nThe diagram above shows how `s3s` works. \n\n`s3s` converts HTTP requests to operation inputs before calling the user-defined service. \n\n`s3s` converts operation outputs or errors to HTTP responses after calling the user-defined service.\n\nThe data types, serialization and deserialization are generated from the smithy model in [aws-sdk-rust](https://github.com/awslabs/aws-sdk-rust) repository. We apply manual hacks to fix some problems in [smithy server codegen](https://smithy-lang.github.io/smithy-rs/design/server/overview.html) and make `s3s` ready to use now.\n\n## Security\n\n`S3Service` and other adapters in this project have no security protection. If they are exposed to the Internet directly, they may be **attacked**.\n\nIt is up to the user to implement security enhancements such as **HTTP body length limit**, rate limit and back pressure.\n\n## Contributing\n\n+ [Development Guide](./CONTRIBUTING.md)\n\n## Sponsor\n\nWe have a reward funds pool for contributors: \u003chttps://github.com/Nugine/s3s/issues/174\u003e\n\nIf my open-source work has been helpful to you, please [sponsor me](https://github.com/Nugine#sponsor).\n\nEvery little bit helps. Thank you!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnugine%2Fs3s","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnugine%2Fs3s","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnugine%2Fs3s/lists"}