یک S3 Client قابل اتکا در Go بسازید

go version

examples/go/
├── .env       # پس از کپی‌کردن فایل نمونه ساخته می‌شود
├── go.mod     # Module و وابستگی‌های مستقیم
├── go.sum     # Checksum وابستگی‌ها
└── main.go    # Client و هفت فرمان مدیریت فایل

(cd examples/go && go mod download)

cp examples/.env.example examples/go/.env

PARSPACK_S3_ENDPOINT=https://c123456.parspack.net
PARSPACK_S3_BUCKET=c123456
PARSPACK_S3_REGION=us-east-1
PARSPACK_S3_ACCESS_KEY=YOUR_ACCESS_KEY
PARSPACK_S3_SECRET_KEY=YOUR_SECRET_KEY

cfg, err := config.LoadDefaultConfig(ctx,
  config.WithRegion(os.Getenv("PARSPACK_S3_REGION")),
  config.WithCredentialsProvider(
      credentials.NewStaticCredentialsProvider(
          os.Getenv("PARSPACK_S3_ACCESS_KEY"),
          os.Getenv("PARSPACK_S3_SECRET_KEY"),
          "",
      ),
  ),
  config.WithRetryMaxAttempts(3),
)
if err != nil {
  return fmt.Errorf("load AWS config: %w", err)
}

client := s3.NewFromConfig(cfg, func(options *s3.Options) {
  options.BaseEndpoint = aws.String(
      strings.TrimRight(os.Getenv("PARSPACK_S3_ENDPOINT"), "/"),
  )
  options.UsePathStyle = true
})

file, err := os.Open("./hello.txt")
if err != nil {
  return err
}
defer file.Close()

result, err := client.PutObject(ctx, &s3.PutObjectInput{
  Bucket: aws.String(bucket),
  Key: aws.String("tutorial/hello.txt"),
  Body: file,
  ContentType: aws.String("text/plain"),
})
if err != nil {
  return fmt.Errorf("upload object: %w", err)
}
fmt.Println(aws.ToString(result.ETag))

printf 'hello ParsPack\n' > hello.txt
(cd examples/go && go run . upload ../../hello.txt tutorial/hello.txt)

paginator := s3.NewListObjectsV2Paginator(client, &s3.ListObjectsV2Input{
  Bucket: aws.String(bucket),
  Prefix: aws.String("tutorial/"),
})

for paginator.HasMorePages() {
  page, err := paginator.NextPage(ctx)
  if err != nil { return err }
  for _, object := range page.Contents {
      fmt.Println(aws.ToString(object.Key), aws.ToInt64(object.Size))
  }
}

info, err := client.HeadObject(ctx, &s3.HeadObjectInput{
  Bucket: aws.String(bucket),
  Key: aws.String("tutorial/hello.txt"),
})
if err != nil { return err }

fmt.Println(aws.ToInt64(info.ContentLength))
fmt.Println(aws.ToString(info.ContentType))

(cd examples/go && go run . list tutorial/)

(cd examples/go && go run . head tutorial/hello.txt)

result, err := client.GetObject(ctx, &s3.GetObjectInput{
  Bucket: aws.String(bucket),
  Key: aws.String("tutorial/hello.txt"),
})
if err != nil { return err }
defer result.Body.Close()

destination, err := os.Create("./downloads/hello.txt")
if err != nil { return err }
defer destination.Close()
_, err = io.Copy(destination, result.Body)

(cd examples/go && go run . download tutorial/hello.txt ../../downloads/hello.txt)

presign := s3.NewPresignClient(client)
result, err := presign.PresignGetObject(ctx, &s3.GetObjectInput{
  Bucket: aws.String(bucket),
  Key: aws.String("tutorial/hello.txt"),
}, func(options *s3.PresignOptions) {
  options.Expires = 15 * time.Minute
})

(cd examples/go && go run . presign-get tutorial/hello.txt 900)

curl --output invoice.pdf "$SIGNED_DOWNLOAD_URL"

presign := s3.NewPresignClient(client)
result, err := presign.PresignPutObject(ctx, &s3.PutObjectInput{
  Bucket: aws.String(bucket),
  Key: aws.String("tutorial/upload.txt"),
  ContentType: aws.String("text/plain"),
}, func(options *s3.PresignOptions) {
  options.Expires = 15 * time.Minute
})

(cd examples/go && go run . presign-put tutorial/upload.txt text/plain 900)

curl -X PUT -H 'Content-Type: text/plain' \
--upload-file ./hello.txt "$SIGNED_UPLOAD_URL"

await fetch(signed.url, {
method: "PUT",
headers: { "Content-Type": signed.headers["Content-Type"] },
body: file,
});

_, err := client.DeleteObject(ctx, &s3.DeleteObjectInput{
  Bucket: aws.String(bucket),
  Key: aws.String("tutorial/hello.txt"),
})
if err != nil {
  return fmt.Errorf("delete object: %w", err)
}

(cd examples/go && go run . delete tutorial/hello.txt)

ctx, cancel := context.WithTimeout(context.Background(), 2*time.Minute)
defer cancel()

if err := run(ctx); err != nil {
  fmt.Fprintln(os.Stderr, err)
  os.Exit(1)
}

(cd examples/go && go mod download)
cp examples/.env.example examples/go/.env

# مقدارهای examples/go/.env را کامل کنید
printf 'hello ParsPack\n' > hello.txt
(cd examples/go && go run . upload ../../hello.txt tutorial/hello.txt)
(cd examples/go && go run . list tutorial/)
(cd examples/go && go run . head tutorial/hello.txt)
(cd examples/go && go run . download tutorial/hello.txt ../../downloads/hello.txt)
(cd examples/go && go run . presign-get tutorial/hello.txt 900)
(cd examples/go && go run . presign-put tutorial/upload.txt text/plain 900)
(cd examples/go && go run . delete tutorial/hello.txt)