Merge pull request #17825 from hashicorp/jbardin/go-getter-update
update go-getter
This commit is contained in:
commit
0ad9d7b392
|
@ -232,6 +232,9 @@ The options below are available to all protocols:
|
||||||
* `checksum` - Checksum to verify the downloaded file or archive. See
|
* `checksum` - Checksum to verify the downloaded file or archive. See
|
||||||
the entire section on checksumming above for format and more details.
|
the entire section on checksumming above for format and more details.
|
||||||
|
|
||||||
|
* `filename` - When in file download mode, allows specifying the name of the
|
||||||
|
downloaded file on disk. Has no effect in directory mode.
|
||||||
|
|
||||||
### Local Files (`file`)
|
### Local Files (`file`)
|
||||||
|
|
||||||
None
|
None
|
||||||
|
@ -282,7 +285,7 @@ be used automatically.
|
||||||
* `aws_access_key_id` (required) - Minio access key.
|
* `aws_access_key_id` (required) - Minio access key.
|
||||||
* `aws_access_key_secret` (required) - Minio access key secret.
|
* `aws_access_key_secret` (required) - Minio access key secret.
|
||||||
* `region` (optional - defaults to us-east-1) - Region identifier to use.
|
* `region` (optional - defaults to us-east-1) - Region identifier to use.
|
||||||
* `version` (optional - fefaults to Minio default) - Configuration file format.
|
* `version` (optional - defaults to Minio default) - Configuration file format.
|
||||||
|
|
||||||
#### S3 Bucket Examples
|
#### S3 Bucket Examples
|
||||||
|
|
||||||
|
|
|
@ -17,6 +17,7 @@ import (
|
||||||
"strings"
|
"strings"
|
||||||
|
|
||||||
urlhelper "github.com/hashicorp/go-getter/helper/url"
|
urlhelper "github.com/hashicorp/go-getter/helper/url"
|
||||||
|
"github.com/hashicorp/go-safetemp"
|
||||||
)
|
)
|
||||||
|
|
||||||
// Client is a client for downloading things.
|
// Client is a client for downloading things.
|
||||||
|
@ -100,17 +101,14 @@ func (c *Client) Get() error {
|
||||||
dst := c.Dst
|
dst := c.Dst
|
||||||
src, subDir := SourceDirSubdir(src)
|
src, subDir := SourceDirSubdir(src)
|
||||||
if subDir != "" {
|
if subDir != "" {
|
||||||
tmpDir, err := ioutil.TempDir("", "tf")
|
td, tdcloser, err := safetemp.Dir("", "getter")
|
||||||
if err != nil {
|
if err != nil {
|
||||||
return err
|
return err
|
||||||
}
|
}
|
||||||
if err := os.RemoveAll(tmpDir); err != nil {
|
defer tdcloser.Close()
|
||||||
return err
|
|
||||||
}
|
|
||||||
defer os.RemoveAll(tmpDir)
|
|
||||||
|
|
||||||
realDst = dst
|
realDst = dst
|
||||||
dst = tmpDir
|
dst = td
|
||||||
}
|
}
|
||||||
|
|
||||||
u, err := urlhelper.Parse(src)
|
u, err := urlhelper.Parse(src)
|
||||||
|
@ -232,7 +230,18 @@ func (c *Client) Get() error {
|
||||||
// Destination is the base name of the URL path in "any" mode when
|
// Destination is the base name of the URL path in "any" mode when
|
||||||
// a file source is detected.
|
// a file source is detected.
|
||||||
if mode == ClientModeFile {
|
if mode == ClientModeFile {
|
||||||
dst = filepath.Join(dst, filepath.Base(u.Path))
|
filename := filepath.Base(u.Path)
|
||||||
|
|
||||||
|
// Determine if we have a custom file name
|
||||||
|
if v := q.Get("filename"); v != "" {
|
||||||
|
// Delete the query parameter if we have it.
|
||||||
|
q.Del("filename")
|
||||||
|
u.RawQuery = q.Encode()
|
||||||
|
|
||||||
|
filename = v
|
||||||
|
}
|
||||||
|
|
||||||
|
dst = filepath.Join(dst, filename)
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|
|
@ -1,7 +1,15 @@
|
||||||
package getter
|
package getter
|
||||||
|
|
||||||
|
import (
|
||||||
|
"strings"
|
||||||
|
)
|
||||||
|
|
||||||
// Decompressor defines the interface that must be implemented to add
|
// Decompressor defines the interface that must be implemented to add
|
||||||
// support for decompressing a type.
|
// support for decompressing a type.
|
||||||
|
//
|
||||||
|
// Important: if you're implementing a decompressor, please use the
|
||||||
|
// containsDotDot helper in this file to ensure that files can't be
|
||||||
|
// decompressed outside of the specified directory.
|
||||||
type Decompressor interface {
|
type Decompressor interface {
|
||||||
// Decompress should decompress src to dst. dir specifies whether dst
|
// Decompress should decompress src to dst. dir specifies whether dst
|
||||||
// is a directory or single file. src is guaranteed to be a single file
|
// is a directory or single file. src is guaranteed to be a single file
|
||||||
|
@ -31,3 +39,20 @@ func init() {
|
||||||
"zip": new(ZipDecompressor),
|
"zip": new(ZipDecompressor),
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
// containsDotDot checks if the filepath value v contains a ".." entry.
|
||||||
|
// This will check filepath components by splitting along / or \. This
|
||||||
|
// function is copied directly from the Go net/http implementation.
|
||||||
|
func containsDotDot(v string) bool {
|
||||||
|
if !strings.Contains(v, "..") {
|
||||||
|
return false
|
||||||
|
}
|
||||||
|
for _, ent := range strings.FieldsFunc(v, isSlashRune) {
|
||||||
|
if ent == ".." {
|
||||||
|
return true
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return false
|
||||||
|
}
|
||||||
|
|
||||||
|
func isSlashRune(r rune) bool { return r == '/' || r == '\\' }
|
||||||
|
|
|
@ -13,6 +13,7 @@ import (
|
||||||
func untar(input io.Reader, dst, src string, dir bool) error {
|
func untar(input io.Reader, dst, src string, dir bool) error {
|
||||||
tarR := tar.NewReader(input)
|
tarR := tar.NewReader(input)
|
||||||
done := false
|
done := false
|
||||||
|
dirHdrs := []*tar.Header{}
|
||||||
for {
|
for {
|
||||||
hdr, err := tarR.Next()
|
hdr, err := tarR.Next()
|
||||||
if err == io.EOF {
|
if err == io.EOF {
|
||||||
|
@ -21,7 +22,7 @@ func untar(input io.Reader, dst, src string, dir bool) error {
|
||||||
return fmt.Errorf("empty archive: %s", src)
|
return fmt.Errorf("empty archive: %s", src)
|
||||||
}
|
}
|
||||||
|
|
||||||
return nil
|
break
|
||||||
}
|
}
|
||||||
if err != nil {
|
if err != nil {
|
||||||
return err
|
return err
|
||||||
|
@ -34,6 +35,11 @@ func untar(input io.Reader, dst, src string, dir bool) error {
|
||||||
|
|
||||||
path := dst
|
path := dst
|
||||||
if dir {
|
if dir {
|
||||||
|
// Disallow parent traversal
|
||||||
|
if containsDotDot(hdr.Name) {
|
||||||
|
return fmt.Errorf("entry contains '..': %s", hdr.Name)
|
||||||
|
}
|
||||||
|
|
||||||
path = filepath.Join(path, hdr.Name)
|
path = filepath.Join(path, hdr.Name)
|
||||||
}
|
}
|
||||||
|
|
||||||
|
@ -47,6 +53,10 @@ func untar(input io.Reader, dst, src string, dir bool) error {
|
||||||
return err
|
return err
|
||||||
}
|
}
|
||||||
|
|
||||||
|
// Record the directory information so that we may set its attributes
|
||||||
|
// after all files have been extracted
|
||||||
|
dirHdrs = append(dirHdrs, hdr)
|
||||||
|
|
||||||
continue
|
continue
|
||||||
} else {
|
} else {
|
||||||
// There is no ordering guarantee that a file in a directory is
|
// There is no ordering guarantee that a file in a directory is
|
||||||
|
@ -84,7 +94,23 @@ func untar(input io.Reader, dst, src string, dir bool) error {
|
||||||
if err := os.Chmod(path, hdr.FileInfo().Mode()); err != nil {
|
if err := os.Chmod(path, hdr.FileInfo().Mode()); err != nil {
|
||||||
return err
|
return err
|
||||||
}
|
}
|
||||||
|
|
||||||
|
// Set the access and modification time
|
||||||
|
if err := os.Chtimes(path, hdr.AccessTime, hdr.ModTime); err != nil {
|
||||||
|
return err
|
||||||
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
// Adding a file or subdirectory changes the mtime of a directory
|
||||||
|
// We therefore wait until we've extracted everything and then set the mtime and atime attributes
|
||||||
|
for _, dirHdr := range dirHdrs {
|
||||||
|
path := filepath.Join(dst, dirHdr.Name)
|
||||||
|
if err := os.Chtimes(path, dirHdr.AccessTime, dirHdr.ModTime); err != nil {
|
||||||
|
return err
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
return nil
|
||||||
}
|
}
|
||||||
|
|
||||||
// tarDecompressor is an implementation of Decompressor that can
|
// tarDecompressor is an implementation of Decompressor that can
|
||||||
|
|
|
@ -11,6 +11,7 @@ import (
|
||||||
"runtime"
|
"runtime"
|
||||||
"sort"
|
"sort"
|
||||||
"strings"
|
"strings"
|
||||||
|
"time"
|
||||||
|
|
||||||
"github.com/mitchellh/go-testing-interface"
|
"github.com/mitchellh/go-testing-interface"
|
||||||
)
|
)
|
||||||
|
@ -22,6 +23,7 @@ type TestDecompressCase struct {
|
||||||
Err bool // Err is whether we expect an error or not
|
Err bool // Err is whether we expect an error or not
|
||||||
DirList []string // DirList is the list of files for Dir mode
|
DirList []string // DirList is the list of files for Dir mode
|
||||||
FileMD5 string // FileMD5 is the expected MD5 for a single file
|
FileMD5 string // FileMD5 is the expected MD5 for a single file
|
||||||
|
Mtime *time.Time // Mtime is the optionally expected mtime for a single file (or all files if in Dir mode)
|
||||||
}
|
}
|
||||||
|
|
||||||
// TestDecompressor is a helper function for testing generic decompressors.
|
// TestDecompressor is a helper function for testing generic decompressors.
|
||||||
|
@ -68,6 +70,14 @@ func TestDecompressor(t testing.T, d Decompressor, cases []TestDecompressCase) {
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
if tc.Mtime != nil {
|
||||||
|
actual := fi.ModTime()
|
||||||
|
expected := *tc.Mtime
|
||||||
|
if actual != expected {
|
||||||
|
t.Fatalf("err %s: expected mtime '%s' for %s, got '%s'", tc.Input, expected.String(), dst, actual.String())
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
|
|
||||||
|
@ -84,6 +94,21 @@ func TestDecompressor(t testing.T, d Decompressor, cases []TestDecompressCase) {
|
||||||
if !reflect.DeepEqual(actual, expected) {
|
if !reflect.DeepEqual(actual, expected) {
|
||||||
t.Fatalf("bad %s\n\n%#v\n\n%#v", tc.Input, actual, expected)
|
t.Fatalf("bad %s\n\n%#v\n\n%#v", tc.Input, actual, expected)
|
||||||
}
|
}
|
||||||
|
// Check for correct atime/mtime
|
||||||
|
for _, dir := range actual {
|
||||||
|
path := filepath.Join(dst, dir)
|
||||||
|
if tc.Mtime != nil {
|
||||||
|
fi, err := os.Stat(path)
|
||||||
|
if err != nil {
|
||||||
|
t.Fatalf("err: %s", err)
|
||||||
|
}
|
||||||
|
actual := fi.ModTime()
|
||||||
|
expected := *tc.Mtime
|
||||||
|
if actual != expected {
|
||||||
|
t.Fatalf("err %s: expected mtime '%s' for %s, got '%s'", tc.Input, expected.String(), path, actual.String())
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
}()
|
}()
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
|
@ -42,6 +42,11 @@ func (d *ZipDecompressor) Decompress(dst, src string, dir bool) error {
|
||||||
for _, f := range zipR.File {
|
for _, f := range zipR.File {
|
||||||
path := dst
|
path := dst
|
||||||
if dir {
|
if dir {
|
||||||
|
// Disallow parent traversal
|
||||||
|
if containsDotDot(f.Name) {
|
||||||
|
return fmt.Errorf("entry contains '..': %s", f.Name)
|
||||||
|
}
|
||||||
|
|
||||||
path = filepath.Join(path, f.Name)
|
path = filepath.Join(path, f.Name)
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|
|
@ -11,6 +11,7 @@ import (
|
||||||
"strings"
|
"strings"
|
||||||
|
|
||||||
urlhelper "github.com/hashicorp/go-getter/helper/url"
|
urlhelper "github.com/hashicorp/go-getter/helper/url"
|
||||||
|
"github.com/hashicorp/go-safetemp"
|
||||||
"github.com/hashicorp/go-version"
|
"github.com/hashicorp/go-version"
|
||||||
)
|
)
|
||||||
|
|
||||||
|
@ -105,13 +106,11 @@ func (g *GitGetter) Get(dst string, u *url.URL) error {
|
||||||
// GetFile for Git doesn't support updating at this time. It will download
|
// GetFile for Git doesn't support updating at this time. It will download
|
||||||
// the file every time.
|
// the file every time.
|
||||||
func (g *GitGetter) GetFile(dst string, u *url.URL) error {
|
func (g *GitGetter) GetFile(dst string, u *url.URL) error {
|
||||||
td, err := ioutil.TempDir("", "getter-git")
|
td, tdcloser, err := safetemp.Dir("", "getter")
|
||||||
if err != nil {
|
if err != nil {
|
||||||
return err
|
return err
|
||||||
}
|
}
|
||||||
if err := os.RemoveAll(td); err != nil {
|
defer tdcloser.Close()
|
||||||
return err
|
|
||||||
}
|
|
||||||
|
|
||||||
// Get the filename, and strip the filename from the URL so we can
|
// Get the filename, and strip the filename from the URL so we can
|
||||||
// just get the repository directly.
|
// just get the repository directly.
|
||||||
|
|
|
@ -2,7 +2,6 @@ package getter
|
||||||
|
|
||||||
import (
|
import (
|
||||||
"fmt"
|
"fmt"
|
||||||
"io/ioutil"
|
|
||||||
"net/url"
|
"net/url"
|
||||||
"os"
|
"os"
|
||||||
"os/exec"
|
"os/exec"
|
||||||
|
@ -10,6 +9,7 @@ import (
|
||||||
"runtime"
|
"runtime"
|
||||||
|
|
||||||
urlhelper "github.com/hashicorp/go-getter/helper/url"
|
urlhelper "github.com/hashicorp/go-getter/helper/url"
|
||||||
|
"github.com/hashicorp/go-safetemp"
|
||||||
)
|
)
|
||||||
|
|
||||||
// HgGetter is a Getter implementation that will download a module from
|
// HgGetter is a Getter implementation that will download a module from
|
||||||
|
@ -64,13 +64,13 @@ func (g *HgGetter) Get(dst string, u *url.URL) error {
|
||||||
// GetFile for Hg doesn't support updating at this time. It will download
|
// GetFile for Hg doesn't support updating at this time. It will download
|
||||||
// the file every time.
|
// the file every time.
|
||||||
func (g *HgGetter) GetFile(dst string, u *url.URL) error {
|
func (g *HgGetter) GetFile(dst string, u *url.URL) error {
|
||||||
td, err := ioutil.TempDir("", "getter-hg")
|
// Create a temporary directory to store the full source. This has to be
|
||||||
|
// a non-existent directory.
|
||||||
|
td, tdcloser, err := safetemp.Dir("", "getter")
|
||||||
if err != nil {
|
if err != nil {
|
||||||
return err
|
return err
|
||||||
}
|
}
|
||||||
if err := os.RemoveAll(td); err != nil {
|
defer tdcloser.Close()
|
||||||
return err
|
|
||||||
}
|
|
||||||
|
|
||||||
// Get the filename, and strip the filename from the URL so we can
|
// Get the filename, and strip the filename from the URL so we can
|
||||||
// just get the repository directly.
|
// just get the repository directly.
|
||||||
|
|
|
@ -4,12 +4,13 @@ import (
|
||||||
"encoding/xml"
|
"encoding/xml"
|
||||||
"fmt"
|
"fmt"
|
||||||
"io"
|
"io"
|
||||||
"io/ioutil"
|
|
||||||
"net/http"
|
"net/http"
|
||||||
"net/url"
|
"net/url"
|
||||||
"os"
|
"os"
|
||||||
"path/filepath"
|
"path/filepath"
|
||||||
"strings"
|
"strings"
|
||||||
|
|
||||||
|
"github.com/hashicorp/go-safetemp"
|
||||||
)
|
)
|
||||||
|
|
||||||
// HttpGetter is a Getter implementation that will download from an HTTP
|
// HttpGetter is a Getter implementation that will download from an HTTP
|
||||||
|
@ -135,25 +136,27 @@ func (g *HttpGetter) GetFile(dst string, u *url.URL) error {
|
||||||
if err != nil {
|
if err != nil {
|
||||||
return err
|
return err
|
||||||
}
|
}
|
||||||
defer f.Close()
|
|
||||||
|
|
||||||
_, err = io.Copy(f, resp.Body)
|
n, err := io.Copy(f, resp.Body)
|
||||||
|
if err == nil && n < resp.ContentLength {
|
||||||
|
err = io.ErrShortWrite
|
||||||
|
}
|
||||||
|
if err1 := f.Close(); err == nil {
|
||||||
|
err = err1
|
||||||
|
}
|
||||||
return err
|
return err
|
||||||
}
|
}
|
||||||
|
|
||||||
// getSubdir downloads the source into the destination, but with
|
// getSubdir downloads the source into the destination, but with
|
||||||
// the proper subdir.
|
// the proper subdir.
|
||||||
func (g *HttpGetter) getSubdir(dst, source, subDir string) error {
|
func (g *HttpGetter) getSubdir(dst, source, subDir string) error {
|
||||||
// Create a temporary directory to store the full source
|
// Create a temporary directory to store the full source. This has to be
|
||||||
td, err := ioutil.TempDir("", "tf")
|
// a non-existent directory.
|
||||||
|
td, tdcloser, err := safetemp.Dir("", "getter")
|
||||||
if err != nil {
|
if err != nil {
|
||||||
return err
|
return err
|
||||||
}
|
}
|
||||||
defer os.RemoveAll(td)
|
defer tdcloser.Close()
|
||||||
|
|
||||||
// We have to create a subdirectory that doesn't exist for the file
|
|
||||||
// getter to work.
|
|
||||||
td = filepath.Join(td, "data")
|
|
||||||
|
|
||||||
// Download that into the given directory
|
// Download that into the given directory
|
||||||
if err := Get(td, source); err != nil {
|
if err := Get(td, source); err != nil {
|
||||||
|
|
|
@ -0,0 +1,362 @@
|
||||||
|
Mozilla Public License, version 2.0
|
||||||
|
|
||||||
|
1. Definitions
|
||||||
|
|
||||||
|
1.1. "Contributor"
|
||||||
|
|
||||||
|
means each individual or legal entity that creates, contributes to the
|
||||||
|
creation of, or owns Covered Software.
|
||||||
|
|
||||||
|
1.2. "Contributor Version"
|
||||||
|
|
||||||
|
means the combination of the Contributions of others (if any) used by a
|
||||||
|
Contributor and that particular Contributor's Contribution.
|
||||||
|
|
||||||
|
1.3. "Contribution"
|
||||||
|
|
||||||
|
means Covered Software of a particular Contributor.
|
||||||
|
|
||||||
|
1.4. "Covered Software"
|
||||||
|
|
||||||
|
means Source Code Form to which the initial Contributor has attached the
|
||||||
|
notice in Exhibit A, the Executable Form of such Source Code Form, and
|
||||||
|
Modifications of such Source Code Form, in each case including portions
|
||||||
|
thereof.
|
||||||
|
|
||||||
|
1.5. "Incompatible With Secondary Licenses"
|
||||||
|
means
|
||||||
|
|
||||||
|
a. that the initial Contributor has attached the notice described in
|
||||||
|
Exhibit B to the Covered Software; or
|
||||||
|
|
||||||
|
b. that the Covered Software was made available under the terms of
|
||||||
|
version 1.1 or earlier of the License, but not also under the terms of
|
||||||
|
a Secondary License.
|
||||||
|
|
||||||
|
1.6. "Executable Form"
|
||||||
|
|
||||||
|
means any form of the work other than Source Code Form.
|
||||||
|
|
||||||
|
1.7. "Larger Work"
|
||||||
|
|
||||||
|
means a work that combines Covered Software with other material, in a
|
||||||
|
separate file or files, that is not Covered Software.
|
||||||
|
|
||||||
|
1.8. "License"
|
||||||
|
|
||||||
|
means this document.
|
||||||
|
|
||||||
|
1.9. "Licensable"
|
||||||
|
|
||||||
|
means having the right to grant, to the maximum extent possible, whether
|
||||||
|
at the time of the initial grant or subsequently, any and all of the
|
||||||
|
rights conveyed by this License.
|
||||||
|
|
||||||
|
1.10. "Modifications"
|
||||||
|
|
||||||
|
means any of the following:
|
||||||
|
|
||||||
|
a. any file in Source Code Form that results from an addition to,
|
||||||
|
deletion from, or modification of the contents of Covered Software; or
|
||||||
|
|
||||||
|
b. any new file in Source Code Form that contains any Covered Software.
|
||||||
|
|
||||||
|
1.11. "Patent Claims" of a Contributor
|
||||||
|
|
||||||
|
means any patent claim(s), including without limitation, method,
|
||||||
|
process, and apparatus claims, in any patent Licensable by such
|
||||||
|
Contributor that would be infringed, but for the grant of the License,
|
||||||
|
by the making, using, selling, offering for sale, having made, import,
|
||||||
|
or transfer of either its Contributions or its Contributor Version.
|
||||||
|
|
||||||
|
1.12. "Secondary License"
|
||||||
|
|
||||||
|
means either the GNU General Public License, Version 2.0, the GNU Lesser
|
||||||
|
General Public License, Version 2.1, the GNU Affero General Public
|
||||||
|
License, Version 3.0, or any later versions of those licenses.
|
||||||
|
|
||||||
|
1.13. "Source Code Form"
|
||||||
|
|
||||||
|
means the form of the work preferred for making modifications.
|
||||||
|
|
||||||
|
1.14. "You" (or "Your")
|
||||||
|
|
||||||
|
means an individual or a legal entity exercising rights under this
|
||||||
|
License. For legal entities, "You" includes any entity that controls, is
|
||||||
|
controlled by, or is under common control with You. For purposes of this
|
||||||
|
definition, "control" means (a) the power, direct or indirect, to cause
|
||||||
|
the direction or management of such entity, whether by contract or
|
||||||
|
otherwise, or (b) ownership of more than fifty percent (50%) of the
|
||||||
|
outstanding shares or beneficial ownership of such entity.
|
||||||
|
|
||||||
|
|
||||||
|
2. License Grants and Conditions
|
||||||
|
|
||||||
|
2.1. Grants
|
||||||
|
|
||||||
|
Each Contributor hereby grants You a world-wide, royalty-free,
|
||||||
|
non-exclusive license:
|
||||||
|
|
||||||
|
a. under intellectual property rights (other than patent or trademark)
|
||||||
|
Licensable by such Contributor to use, reproduce, make available,
|
||||||
|
modify, display, perform, distribute, and otherwise exploit its
|
||||||
|
Contributions, either on an unmodified basis, with Modifications, or
|
||||||
|
as part of a Larger Work; and
|
||||||
|
|
||||||
|
b. under Patent Claims of such Contributor to make, use, sell, offer for
|
||||||
|
sale, have made, import, and otherwise transfer either its
|
||||||
|
Contributions or its Contributor Version.
|
||||||
|
|
||||||
|
2.2. Effective Date
|
||||||
|
|
||||||
|
The licenses granted in Section 2.1 with respect to any Contribution
|
||||||
|
become effective for each Contribution on the date the Contributor first
|
||||||
|
distributes such Contribution.
|
||||||
|
|
||||||
|
2.3. Limitations on Grant Scope
|
||||||
|
|
||||||
|
The licenses granted in this Section 2 are the only rights granted under
|
||||||
|
this License. No additional rights or licenses will be implied from the
|
||||||
|
distribution or licensing of Covered Software under this License.
|
||||||
|
Notwithstanding Section 2.1(b) above, no patent license is granted by a
|
||||||
|
Contributor:
|
||||||
|
|
||||||
|
a. for any code that a Contributor has removed from Covered Software; or
|
||||||
|
|
||||||
|
b. for infringements caused by: (i) Your and any other third party's
|
||||||
|
modifications of Covered Software, or (ii) the combination of its
|
||||||
|
Contributions with other software (except as part of its Contributor
|
||||||
|
Version); or
|
||||||
|
|
||||||
|
c. under Patent Claims infringed by Covered Software in the absence of
|
||||||
|
its Contributions.
|
||||||
|
|
||||||
|
This License does not grant any rights in the trademarks, service marks,
|
||||||
|
or logos of any Contributor (except as may be necessary to comply with
|
||||||
|
the notice requirements in Section 3.4).
|
||||||
|
|
||||||
|
2.4. Subsequent Licenses
|
||||||
|
|
||||||
|
No Contributor makes additional grants as a result of Your choice to
|
||||||
|
distribute the Covered Software under a subsequent version of this
|
||||||
|
License (see Section 10.2) or under the terms of a Secondary License (if
|
||||||
|
permitted under the terms of Section 3.3).
|
||||||
|
|
||||||
|
2.5. Representation
|
||||||
|
|
||||||
|
Each Contributor represents that the Contributor believes its
|
||||||
|
Contributions are its original creation(s) or it has sufficient rights to
|
||||||
|
grant the rights to its Contributions conveyed by this License.
|
||||||
|
|
||||||
|
2.6. Fair Use
|
||||||
|
|
||||||
|
This License is not intended to limit any rights You have under
|
||||||
|
applicable copyright doctrines of fair use, fair dealing, or other
|
||||||
|
equivalents.
|
||||||
|
|
||||||
|
2.7. Conditions
|
||||||
|
|
||||||
|
Sections 3.1, 3.2, 3.3, and 3.4 are conditions of the licenses granted in
|
||||||
|
Section 2.1.
|
||||||
|
|
||||||
|
|
||||||
|
3. Responsibilities
|
||||||
|
|
||||||
|
3.1. Distribution of Source Form
|
||||||
|
|
||||||
|
All distribution of Covered Software in Source Code Form, including any
|
||||||
|
Modifications that You create or to which You contribute, must be under
|
||||||
|
the terms of this License. You must inform recipients that the Source
|
||||||
|
Code Form of the Covered Software is governed by the terms of this
|
||||||
|
License, and how they can obtain a copy of this License. You may not
|
||||||
|
attempt to alter or restrict the recipients' rights in the Source Code
|
||||||
|
Form.
|
||||||
|
|
||||||
|
3.2. Distribution of Executable Form
|
||||||
|
|
||||||
|
If You distribute Covered Software in Executable Form then:
|
||||||
|
|
||||||
|
a. such Covered Software must also be made available in Source Code Form,
|
||||||
|
as described in Section 3.1, and You must inform recipients of the
|
||||||
|
Executable Form how they can obtain a copy of such Source Code Form by
|
||||||
|
reasonable means in a timely manner, at a charge no more than the cost
|
||||||
|
of distribution to the recipient; and
|
||||||
|
|
||||||
|
b. You may distribute such Executable Form under the terms of this
|
||||||
|
License, or sublicense it under different terms, provided that the
|
||||||
|
license for the Executable Form does not attempt to limit or alter the
|
||||||
|
recipients' rights in the Source Code Form under this License.
|
||||||
|
|
||||||
|
3.3. Distribution of a Larger Work
|
||||||
|
|
||||||
|
You may create and distribute a Larger Work under terms of Your choice,
|
||||||
|
provided that You also comply with the requirements of this License for
|
||||||
|
the Covered Software. If the Larger Work is a combination of Covered
|
||||||
|
Software with a work governed by one or more Secondary Licenses, and the
|
||||||
|
Covered Software is not Incompatible With Secondary Licenses, this
|
||||||
|
License permits You to additionally distribute such Covered Software
|
||||||
|
under the terms of such Secondary License(s), so that the recipient of
|
||||||
|
the Larger Work may, at their option, further distribute the Covered
|
||||||
|
Software under the terms of either this License or such Secondary
|
||||||
|
License(s).
|
||||||
|
|
||||||
|
3.4. Notices
|
||||||
|
|
||||||
|
You may not remove or alter the substance of any license notices
|
||||||
|
(including copyright notices, patent notices, disclaimers of warranty, or
|
||||||
|
limitations of liability) contained within the Source Code Form of the
|
||||||
|
Covered Software, except that You may alter any license notices to the
|
||||||
|
extent required to remedy known factual inaccuracies.
|
||||||
|
|
||||||
|
3.5. Application of Additional Terms
|
||||||
|
|
||||||
|
You may choose to offer, and to charge a fee for, warranty, support,
|
||||||
|
indemnity or liability obligations to one or more recipients of Covered
|
||||||
|
Software. However, You may do so only on Your own behalf, and not on
|
||||||
|
behalf of any Contributor. You must make it absolutely clear that any
|
||||||
|
such warranty, support, indemnity, or liability obligation is offered by
|
||||||
|
You alone, and You hereby agree to indemnify every Contributor for any
|
||||||
|
liability incurred by such Contributor as a result of warranty, support,
|
||||||
|
indemnity or liability terms You offer. You may include additional
|
||||||
|
disclaimers of warranty and limitations of liability specific to any
|
||||||
|
jurisdiction.
|
||||||
|
|
||||||
|
4. Inability to Comply Due to Statute or Regulation
|
||||||
|
|
||||||
|
If it is impossible for You to comply with any of the terms of this License
|
||||||
|
with respect to some or all of the Covered Software due to statute,
|
||||||
|
judicial order, or regulation then You must: (a) comply with the terms of
|
||||||
|
this License to the maximum extent possible; and (b) describe the
|
||||||
|
limitations and the code they affect. Such description must be placed in a
|
||||||
|
text file included with all distributions of the Covered Software under
|
||||||
|
this License. Except to the extent prohibited by statute or regulation,
|
||||||
|
such description must be sufficiently detailed for a recipient of ordinary
|
||||||
|
skill to be able to understand it.
|
||||||
|
|
||||||
|
5. Termination
|
||||||
|
|
||||||
|
5.1. The rights granted under this License will terminate automatically if You
|
||||||
|
fail to comply with any of its terms. However, if You become compliant,
|
||||||
|
then the rights granted under this License from a particular Contributor
|
||||||
|
are reinstated (a) provisionally, unless and until such Contributor
|
||||||
|
explicitly and finally terminates Your grants, and (b) on an ongoing
|
||||||
|
basis, if such Contributor fails to notify You of the non-compliance by
|
||||||
|
some reasonable means prior to 60 days after You have come back into
|
||||||
|
compliance. Moreover, Your grants from a particular Contributor are
|
||||||
|
reinstated on an ongoing basis if such Contributor notifies You of the
|
||||||
|
non-compliance by some reasonable means, this is the first time You have
|
||||||
|
received notice of non-compliance with this License from such
|
||||||
|
Contributor, and You become compliant prior to 30 days after Your receipt
|
||||||
|
of the notice.
|
||||||
|
|
||||||
|
5.2. If You initiate litigation against any entity by asserting a patent
|
||||||
|
infringement claim (excluding declaratory judgment actions,
|
||||||
|
counter-claims, and cross-claims) alleging that a Contributor Version
|
||||||
|
directly or indirectly infringes any patent, then the rights granted to
|
||||||
|
You by any and all Contributors for the Covered Software under Section
|
||||||
|
2.1 of this License shall terminate.
|
||||||
|
|
||||||
|
5.3. In the event of termination under Sections 5.1 or 5.2 above, all end user
|
||||||
|
license agreements (excluding distributors and resellers) which have been
|
||||||
|
validly granted by You or Your distributors under this License prior to
|
||||||
|
termination shall survive termination.
|
||||||
|
|
||||||
|
6. Disclaimer of Warranty
|
||||||
|
|
||||||
|
Covered Software is provided under this License on an "as is" basis,
|
||||||
|
without warranty of any kind, either expressed, implied, or statutory,
|
||||||
|
including, without limitation, warranties that the Covered Software is free
|
||||||
|
of defects, merchantable, fit for a particular purpose or non-infringing.
|
||||||
|
The entire risk as to the quality and performance of the Covered Software
|
||||||
|
is with You. Should any Covered Software prove defective in any respect,
|
||||||
|
You (not any Contributor) assume the cost of any necessary servicing,
|
||||||
|
repair, or correction. This disclaimer of warranty constitutes an essential
|
||||||
|
part of this License. No use of any Covered Software is authorized under
|
||||||
|
this License except under this disclaimer.
|
||||||
|
|
||||||
|
7. Limitation of Liability
|
||||||
|
|
||||||
|
Under no circumstances and under no legal theory, whether tort (including
|
||||||
|
negligence), contract, or otherwise, shall any Contributor, or anyone who
|
||||||
|
distributes Covered Software as permitted above, be liable to You for any
|
||||||
|
direct, indirect, special, incidental, or consequential damages of any
|
||||||
|
character including, without limitation, damages for lost profits, loss of
|
||||||
|
goodwill, work stoppage, computer failure or malfunction, or any and all
|
||||||
|
other commercial damages or losses, even if such party shall have been
|
||||||
|
informed of the possibility of such damages. This limitation of liability
|
||||||
|
shall not apply to liability for death or personal injury resulting from
|
||||||
|
such party's negligence to the extent applicable law prohibits such
|
||||||
|
limitation. Some jurisdictions do not allow the exclusion or limitation of
|
||||||
|
incidental or consequential damages, so this exclusion and limitation may
|
||||||
|
not apply to You.
|
||||||
|
|
||||||
|
8. Litigation
|
||||||
|
|
||||||
|
Any litigation relating to this License may be brought only in the courts
|
||||||
|
of a jurisdiction where the defendant maintains its principal place of
|
||||||
|
business and such litigation shall be governed by laws of that
|
||||||
|
jurisdiction, without reference to its conflict-of-law provisions. Nothing
|
||||||
|
in this Section shall prevent a party's ability to bring cross-claims or
|
||||||
|
counter-claims.
|
||||||
|
|
||||||
|
9. Miscellaneous
|
||||||
|
|
||||||
|
This License represents the complete agreement concerning the subject
|
||||||
|
matter hereof. If any provision of this License is held to be
|
||||||
|
unenforceable, such provision shall be reformed only to the extent
|
||||||
|
necessary to make it enforceable. Any law or regulation which provides that
|
||||||
|
the language of a contract shall be construed against the drafter shall not
|
||||||
|
be used to construe this License against a Contributor.
|
||||||
|
|
||||||
|
|
||||||
|
10. Versions of the License
|
||||||
|
|
||||||
|
10.1. New Versions
|
||||||
|
|
||||||
|
Mozilla Foundation is the license steward. Except as provided in Section
|
||||||
|
10.3, no one other than the license steward has the right to modify or
|
||||||
|
publish new versions of this License. Each version will be given a
|
||||||
|
distinguishing version number.
|
||||||
|
|
||||||
|
10.2. Effect of New Versions
|
||||||
|
|
||||||
|
You may distribute the Covered Software under the terms of the version
|
||||||
|
of the License under which You originally received the Covered Software,
|
||||||
|
or under the terms of any subsequent version published by the license
|
||||||
|
steward.
|
||||||
|
|
||||||
|
10.3. Modified Versions
|
||||||
|
|
||||||
|
If you create software not governed by this License, and you want to
|
||||||
|
create a new license for such software, you may create and use a
|
||||||
|
modified version of this License if you rename the license and remove
|
||||||
|
any references to the name of the license steward (except to note that
|
||||||
|
such modified license differs from this License).
|
||||||
|
|
||||||
|
10.4. Distributing Source Code Form that is Incompatible With Secondary
|
||||||
|
Licenses If You choose to distribute Source Code Form that is
|
||||||
|
Incompatible With Secondary Licenses under the terms of this version of
|
||||||
|
the License, the notice described in Exhibit B of this License must be
|
||||||
|
attached.
|
||||||
|
|
||||||
|
Exhibit A - Source Code Form License Notice
|
||||||
|
|
||||||
|
This Source Code Form is subject to the
|
||||||
|
terms of the Mozilla Public License, v.
|
||||||
|
2.0. If a copy of the MPL was not
|
||||||
|
distributed with this file, You can
|
||||||
|
obtain one at
|
||||||
|
http://mozilla.org/MPL/2.0/.
|
||||||
|
|
||||||
|
If it is not possible or desirable to put the notice in a particular file,
|
||||||
|
then You may include the notice in a location (such as a LICENSE file in a
|
||||||
|
relevant directory) where a recipient would be likely to look for such a
|
||||||
|
notice.
|
||||||
|
|
||||||
|
You may add additional accurate notices of copyright ownership.
|
||||||
|
|
||||||
|
Exhibit B - "Incompatible With Secondary Licenses" Notice
|
||||||
|
|
||||||
|
This Source Code Form is "Incompatible
|
||||||
|
With Secondary Licenses", as defined by
|
||||||
|
the Mozilla Public License, v. 2.0.
|
|
@ -0,0 +1,10 @@
|
||||||
|
# go-safetemp
|
||||||
|
[![Godoc](https://godoc.org/github.com/hashcorp/go-safetemp?status.svg)](https://godoc.org/github.com/hashicorp/go-safetemp)
|
||||||
|
|
||||||
|
Functions for safely working with temporary directories and files.
|
||||||
|
|
||||||
|
## Why?
|
||||||
|
|
||||||
|
The Go standard library provides the excellent `ioutil` package for
|
||||||
|
working with temporary directories and files. This library builds on top
|
||||||
|
of that to provide safe abstractions above that.
|
|
@ -0,0 +1,40 @@
|
||||||
|
package safetemp
|
||||||
|
|
||||||
|
import (
|
||||||
|
"io"
|
||||||
|
"io/ioutil"
|
||||||
|
"os"
|
||||||
|
"path/filepath"
|
||||||
|
)
|
||||||
|
|
||||||
|
// Dir creates a new temporary directory that isn't yet created. This
|
||||||
|
// can be used with calls that expect a non-existent directory.
|
||||||
|
//
|
||||||
|
// The directory is created as a child of a temporary directory created
|
||||||
|
// within the directory dir starting with prefix. The temporary directory
|
||||||
|
// returned is always named "temp". The parent directory has the specified
|
||||||
|
// prefix.
|
||||||
|
//
|
||||||
|
// The returned io.Closer should be used to clean up the returned directory.
|
||||||
|
// This will properly remove the returned directory and any other temporary
|
||||||
|
// files created.
|
||||||
|
//
|
||||||
|
// If an error is returned, the Closer does not need to be called (and will
|
||||||
|
// be nil).
|
||||||
|
func Dir(dir, prefix string) (string, io.Closer, error) {
|
||||||
|
// Create the temporary directory
|
||||||
|
td, err := ioutil.TempDir(dir, prefix)
|
||||||
|
if err != nil {
|
||||||
|
return "", nil, err
|
||||||
|
}
|
||||||
|
|
||||||
|
return filepath.Join(td, "temp"), pathCloser(td), nil
|
||||||
|
}
|
||||||
|
|
||||||
|
// pathCloser implements io.Closer to remove the given path on Close.
|
||||||
|
type pathCloser string
|
||||||
|
|
||||||
|
// Close deletes this path.
|
||||||
|
func (p pathCloser) Close() error {
|
||||||
|
return os.RemoveAll(string(p))
|
||||||
|
}
|
|
@ -1591,10 +1591,10 @@
|
||||||
"versionExact": "master"
|
"versionExact": "master"
|
||||||
},
|
},
|
||||||
{
|
{
|
||||||
"checksumSHA1": "9VcI9QGCShWIUIL187qRd4sxwb8=",
|
"checksumSHA1": "fvjFEz5PBN1m9ALWf9UuLgTFWLg=",
|
||||||
"path": "github.com/hashicorp/go-getter",
|
"path": "github.com/hashicorp/go-getter",
|
||||||
"revision": "a686900cb3753aa644dc4812be91ceaf9fdd3b98",
|
"revision": "90bb99a48d86cf1d327cee9968f7428f90ba13c1",
|
||||||
"revisionTime": "2017-09-22T19:29:48Z",
|
"revisionTime": "2018-03-27T01:01:14Z",
|
||||||
"version": "master",
|
"version": "master",
|
||||||
"versionExact": "master"
|
"versionExact": "master"
|
||||||
},
|
},
|
||||||
|
@ -1637,6 +1637,12 @@
|
||||||
"revision": "6bb64b370b90e7ef1fa532be9e591a81c3493e00",
|
"revision": "6bb64b370b90e7ef1fa532be9e591a81c3493e00",
|
||||||
"revisionTime": "2016-05-03T14:34:40Z"
|
"revisionTime": "2016-05-03T14:34:40Z"
|
||||||
},
|
},
|
||||||
|
{
|
||||||
|
"checksumSHA1": "CduvzBFfTv77nhjtXPGdIjQQLMI=",
|
||||||
|
"path": "github.com/hashicorp/go-safetemp",
|
||||||
|
"revision": "b1a1dbde6fdc11e3ae79efd9039009e22d4ae240",
|
||||||
|
"revisionTime": "2018-03-26T21:11:50Z"
|
||||||
|
},
|
||||||
{
|
{
|
||||||
"checksumSHA1": "85XUnluYJL7F55ptcwdmN8eSOsk=",
|
"checksumSHA1": "85XUnluYJL7F55ptcwdmN8eSOsk=",
|
||||||
"path": "github.com/hashicorp/go-uuid",
|
"path": "github.com/hashicorp/go-uuid",
|
||||||
|
|
Loading…
Reference in New Issue