https://github.com/bhftbootcamp/awscs3.jl
Julia wrapper for aws-c-s3
https://github.com/bhftbootcamp/awscs3.jl
aws-c-s3 s3
Last synced: about 1 month ago
JSON representation
Julia wrapper for aws-c-s3
- Host: GitHub
- URL: https://github.com/bhftbootcamp/awscs3.jl
- Owner: bhftbootcamp
- License: mit
- Created: 2026-05-04T10:46:23.000Z (3 months ago)
- Default Branch: master
- Last Pushed: 2026-05-04T13:07:56.000Z (3 months ago)
- Last Synced: 2026-05-04T13:32:58.458Z (3 months ago)
- Topics: aws-c-s3, s3
- Language: Julia
- Size: 50.8 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
README
# AWSCS3.jl
[](https://bhftbootcamp.github.io/AWSCS3.jl/stable/)
[](https://bhftbootcamp.github.io/AWSCS3.jl/dev/)
[](https://github.com/bhftbootcamp/AWSCS3.jl/actions/workflows/ci.yml?query=branch%3Amaster)
[](https://codecov.io/gh/bhftbootcamp/AWSCS3.jl)
[](https://github.com/bhftbootcamp/Green)
AWSCS3 is a lightweight, high-performance Julia client for S3-compatible object storage (AWS S3, etc.). Built on the AWS C SDK for maximum throughput.
## Installation
If you haven't installed our [local registry](https://github.com/bhftbootcamp/Green) yet, do that first:
```
] registry add https://github.com/bhftbootcamp/Green.git
```
To install AWSCS3, simply use the Julia package manager:
```julia
] add AWSCS3
```
## Usage
Let's look at some of the most used cases
```julia
using AWSCS3
client = S3Client(
host = "my_host",
region = "us-east-1",
access_key = ENV["S3_ACCESS_KEY"],
secret_key = ENV["S3_SECRET_KEY"],
)
bucket_exists(client, "my-bucket") || create_bucket(client, "my-bucket")
put_object(client, "my-bucket", "demo/hello.txt", "Hello, World!")
put_object(client, "my-bucket", "demo/data.bin", UInt8[0x01, 0x02, 0x03, 0x04])
body = get_object(client, "my-bucket", "demo/hello.txt") |> String
for obj in list_objects(client, "my-bucket"; prefix = "demo/")
println("$(obj.key) ($(obj.size) bytes)")
end
copy_object(client, "my-bucket", "demo/hello.txt", "my-bucket", "demo/hello_copy.txt")
delete_objects(client, "my-bucket", ["demo/hello.txt", "demo/hello_copy.txt", "demo/data.bin"])
close(client)
```
## Useful Links
- [AWS C S3](https://github.com/awslabs/aws-c-s3) – underlying C library for S3 operations.
Prebuilt binaries are downloaded automatically during installation. If a binary is not available for your platform, you can build the shim library from source:
```bash
bash deps/build_shim.sh
```
## Contributing
Contributions to AWSCS3 are welcome! If you encounter a bug, have a feature request, or would like to contribute code, please open an issue or a pull request on GitHub.