https://github.com/shimohq/awos
AWOS: Wrapper For Aliyun OSS And Amazon S3 SDK
https://github.com/shimohq/awos
aws-s3 golang minio oss
Last synced: 1 day ago
JSON representation
AWOS: Wrapper For Aliyun OSS And Amazon S3 SDK
- Host: GitHub
- URL: https://github.com/shimohq/awos
- Owner: shimohq
- License: apache-2.0
- Created: 2019-01-29T07:52:11.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2024-08-05T15:16:05.000Z (about 1 year ago)
- Last Synced: 2025-08-14T15:57:46.582Z (2 months ago)
- Topics: aws-s3, golang, minio, oss
- Language: Go
- Homepage:
- Size: 161 KB
- Stars: 16
- Watchers: 5
- Forks: 9
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# AWOS: Wrapper For Aliyun OSS And Amazon S3
awos for node: https://github.com/shimohq/awos-js
## Features
- enable shards bucket
- add retry strategy
- avoid 404 status code:
- `Get(objectName string) (string, error)` will return `"", nil` when object not exist
- `Head(key string, meta []string) (map[string]string, error)` will return `nil, nil` when object not exist
## Installing
Use go get to retrieve the SDK to add it to your GOPATH workspace, or project's Go module dependencies.
```bash
go get github.com/shimohq/awos/v3
```
## How to use
```golang
import "github.com/shimohq/awos/v3"
awsClient, err := awos.New(&awos.Options{
// Required, value is one of oss/s3, case insensetive
StorageType: "string"
// Required
AccessKeyID: "string"
// Required
AccessKeySecret: "string"
// Required
Endpoint: "string"
// Required
Bucket: "string"
// Optional, choose which bucket to use based on the last character of the key,
// if bucket is 'content', shards is ['abc', 'edf'],
// then the last character of the key with a/b/c will automatically use the content-abc bucket, and vice versa
Shards: [2]string{"abc","def"}
// Only for s3-like
Region: "string"
// Only for s3-like, whether to force path style URLs for S3 objects.
S3ForcePathStyle: false
// Only for s3-like
SSL: false
})
```
Available operations：
```golang
Get(key string, options ...GetOptions) (string, error)
GetBytes(key string, options ...GetOptions) ([]byte, error)
GetAsReader(key string, options ...GetOptions) (io.ReadCloser, error)
GetWithMeta(key string, attributes []string, options ...GetOptions) (io.ReadCloser, map[string]string, error)
Put(key string, reader io.ReadSeeker, meta map[string]string, options ...PutOptions) error
Del(key string) error
DelMulti(keys []string) error
Head(key string, meta []string) (map[string]string, error)
ListObject(key string, prefix string, marker string, maxKeys int, delimiter string) ([]string, error)
SignURL(key string, expired int64) (string, error)
GetAndDecompress(key string) (string, error)
GetAndDecompressAsReader(key string) (io.ReadCloser, error)
CompressAndPut(key string, reader io.ReadSeeker, meta map[string]string, options ...PutOptions) error
Range(key string, offset int64, length int64) (io.ReadCloser, error)
Exists(key string)(bool, error)
```