aboutsummaryrefslogtreecommitdiff
path: root/vendor/github.com/nsheridan/wkfs/s3/README.md
diff options
context:
space:
mode:
Diffstat (limited to 'vendor/github.com/nsheridan/wkfs/s3/README.md')
-rw-r--r--vendor/github.com/nsheridan/wkfs/s3/README.md41
1 files changed, 41 insertions, 0 deletions
diff --git a/vendor/github.com/nsheridan/wkfs/s3/README.md b/vendor/github.com/nsheridan/wkfs/s3/README.md
new file mode 100644
index 0000000..177f738
--- /dev/null
+++ b/vendor/github.com/nsheridan/wkfs/s3/README.md
@@ -0,0 +1,41 @@
+## S3 plugin for WKFS
+
+
+
+Package `s3` registers an AWS S3 filesystem at the well-known `/s3/` filesystem path.
+
+Sample usage:
+
+```go
+package main
+
+import (
+ "fmt"
+ "io"
+ "log"
+
+ "github.com/nsheridan/wkfs/s3"
+ "go4.org/wkfs"
+)
+
+func main() {
+ opts := &s3.Options{
+ Region: "us-east-1"
+ AccessKey: "abcdef"
+ SecretKey: "secret"
+ }
+ s3.Register(opts)
+ f, err := wkfs.Create("/s3/some-bucket/hello.txt")
+ if err != nil {
+ log.Fatal(err)
+ }
+ _, err := io.WriteString(f, "hello, world")
+ if err != nil {
+ log.Fatal(err)
+ }
+}
+```
+
+
+
+`Options` are completely optional as the AWS SDK will attempt to obtain credentials from a number of locations - see [the documentation for details](http://docs.aws.amazon.com/sdk-for-go/v1/developer-guide/configuring-sdk.html) - e.g. if you're using environment variables you can register the filesystem with `s3.Register(nil)`.