Files
post3/todos/POST3-011-examples.md
2026-02-27 11:38:10 +01:00

1.1 KiB

POST3-011: Usage examples

Status: Done Priority: P1 Blocked by: POST3-008

Description

Create runnable examples demonstrating how to use post3 with both the SDK and shell tools.

What was built

Rust examples (crates/post3-sdk/examples/)

  • basic.rs — create bucket, put/get/delete object, list objects with prefix filter
  • metadata.rs — put object with custom metadata (x-amz-meta-*), retrieve via head/get
  • aws_sdk_direct.rs — use aws-sdk-s3 directly (without post3-sdk wrapper), shows raw config

Script examples (examples/)

  • aws-cli.sh — shell script demonstrating all operations via aws CLI
  • curl.sh — shell script demonstrating raw HTTP calls with curl

mise tasks

  • example:basic — runs the basic Rust example
  • example:metadata — runs the metadata Rust example
  • example:aws-sdk — runs the raw aws-sdk-s3 example
  • example:cli — runs the AWS CLI example script
  • example:curl — runs the curl example script

All examples tested and verified working against live server.