A golang WebDAV client library.
gowebdav library allows to perform following actions on the remote WebDAV server:
- create path
- get files list
- download file
- upload file
- get information about specified file/folder
- move file to another location
- copy file to another location
- delete file
First of all you should create Client instance using NewClient() function:
root := "https://webdav.mydomain.me"
user := "user"
password := "password"
c := gowebdav.NewClient(root, user, password)After you can use this Client to perform actions, described below.
NOTICE: we will not check errors in examples, to focus you on the gowebdav library's code, but you should do it in your code!
err := c.Mkdir("folder", 0644)In case you want to create several folders you can use c.MkdirAll():
err := c.MkdirAll("folder/subfolder/subfolder2", 0644)files, _ := c.ReadDir("folder/subfolder")
for _, file := range files {
//notice that [file] has os.FileInfo type
fmt.Println(file.Name())
}webdavFilePath := "folder/subfolder/file.txt"
localFilePath := "/tmp/webdav/file.txt"
bytes, _ := c.Read(webdavFilePath)
ioutil.WriteFile(localFilePath, bytes, 0644)Also you can use c.ReadStream() method:
webdavFilePath := "folder/subfolder/file.txt"
localFilePath := "/tmp/webdav/file.txt"
reader, _ := c.ReadStream(webdavFilePath)
file, _ := os.Create(localFilePath)
defer file.Close()
io.Copy(file, reader)webdavFilePath := "folder/subfolder/file.txt"
localFilePath := "/tmp/webdav/file.txt"
bytes, _ := ioutil.ReadFile(localFilePath)
c.Write(webdavFilePath, bytes, 0644)webdavFilePath := "folder/subfolder/file.txt"
localFilePath := "/tmp/webdav/file.txt"
file, _ := os.Open(localFilePath)
defer file.Close()
c.WriteStream(webdavFilePath, file, 0644)webdavFilePath := "folder/subfolder/file.txt"
info := c.Stat(webdavFilePath)
//notice that [info] has os.FileInfo type
fmt.Println(info)oldPath := "folder/subfolder/file.txt"
newPath := "folder/subfolder/moved.txt"
isOverwrite := true
c.Rename(oldPath, newPath, isOverwrite)oldPath := "folder/subfolder/file.txt"
newPath := "folder/subfolder/file-copy.txt"
isOverwrite := true
c.Copy(oldPath, newPath, isOverwrite)webdavFilePath := "folder/subfolder/file.txt"
c.Remove(webdavFilePath)More details about WebDAV server you can read from following resources:
- RFC 4918 - HTTP Extensions for Web Distributed Authoring and Versioning (WebDAV)
- RFC 5689 - Extended MKCOL for Web Distributed Authoring and Versioning (WebDAV)
- RFC 2616 - HTTP/1.1 Status Code Definitions
- WebDav: Next Generation Collaborative Web Authoring By Lisa Dusseaul
NOTICE: RFC 2518 is obsoleted by RFC 4918 in June 2007
All contributing are welcome. If you have any suggestions or find some bug - please create an Issue to let us make this project better. We appreciate your help!
This library is distributed under the BSD 3-Clause license found in the LICENSE file.
import "github.com/studio-b12/gowebdav"
Package gowebdav is a WebDAV client library with a command line tool included.
- func FixSlash(s string) string
- func FixSlashes(s string) string
- func Join(path0 string, path1 string) string
- func PathEscape(path string) string
- func ReadConfig(uri, netrc string) (string, string)
- func String(r io.Reader) string
- type Authenticator
- type BasicAuth
- type Client
- func NewClient(uri, user, pw string) *Client
- func (c *Client) Connect() error
- func (c *Client) Copy(oldpath, newpath string, overwrite bool) error
- func (c *Client) Mkdir(path string, _ os.FileMode) error
- func (c *Client) MkdirAll(path string, _ os.FileMode) error
- func (c *Client) Read(path string) ([]byte, error)
- func (c *Client) ReadDir(path string) ([]os.FileInfo, error)
- func (c *Client) ReadStream(path string) (io.ReadCloser, error)
- func (c *Client) Remove(path string) error
- func (c *Client) RemoveAll(path string) error
- func (c *Client) Rename(oldpath, newpath string, overwrite bool) error
- func (c *Client) SetHeader(key, value string)
- func (c *Client) SetTimeout(timeout time.Duration)
- func (c *Client) SetTransport(transport http.RoundTripper)
- func (c *Client) Stat(path string) (os.FileInfo, error)
- func (c *Client) Write(path string, data []byte, _ os.FileMode) error
- func (c *Client) WriteStream(path string, stream io.Reader, _ os.FileMode) error
- type DigestAuth
- type File
- func (f File) ContentType() string
- func (f File) ETag() string
- func (f File) IsDir() bool
- func (f File) ModTime() time.Time
- func (f File) Mode() os.FileMode
- func (f File) Name() string
- func (f File) Path() string
- func (f File) Size() int64
- func (f File) String() string
- func (f File) Sys() interface{}
- type NoAuth
basicAuth.go client.go digestAuth.go doc.go file.go netrc.go requests.go utils.go
func FixSlash(s string) stringFixSlash appends a trailing / to our string
func FixSlashes(s string) stringFixSlashes appends and prepends a / if they are missing
func Join(path0 string, path1 string) stringJoin joins two paths
func PathEscape(path string) stringPathEscape escapes all segemnts of a given path
func ReadConfig(uri, netrc string) (string, string)ReadConfig reads login and password configuration from ~/.netrc machine foo.com login username password 123456
func String(r io.Reader) stringString pulls a string out of our io.Reader
type Authenticator interface {
Type() string
User() string
Pass() string
Authorize(*Client, string, string)
}Authenticator stub
type BasicAuth struct {
// contains filtered or unexported fields
}BasicAuth structure holds our credentials
func (b *BasicAuth) Authorize(c *Client, method string, path string)Authorize the current request
func (b *BasicAuth) Pass() stringPass holds the BasicAuth password
func (b *BasicAuth) Type() stringType identifies the BasicAuthenticator
func (b *BasicAuth) User() stringUser holds the BasicAuth username
type Client struct {
// contains filtered or unexported fields
}Client defines our structure
func NewClient(uri, user, pw string) *ClientNewClient creates a new instance of client
func (c *Client) Connect() errorConnect connects to our dav server
func (c *Client) Copy(oldpath, newpath string, overwrite bool) errorCopy copies a file from A to B
func (c *Client) Mkdir(path string, _ os.FileMode) errorMkdir makes a directory
func (c *Client) MkdirAll(path string, _ os.FileMode) errorMkdirAll like mkdir -p, but for webdav
func (c *Client) Read(path string) ([]byte, error)Read reads the contents of a remote file
func (c *Client) ReadDir(path string) ([]os.FileInfo, error)ReadDir reads the contents of a remote directory
func (*Client) ReadStream
func (c *Client) ReadStream(path string) (io.ReadCloser, error)ReadStream reads the stream for a given path
func (c *Client) Remove(path string) errorRemove removes a remote file
func (c *Client) RemoveAll(path string) errorRemoveAll removes remote files
func (c *Client) Rename(oldpath, newpath string, overwrite bool) errorRename moves a file from A to B
func (c *Client) SetHeader(key, value string)SetHeader lets us set arbitrary headers for a given client
func (*Client) SetTimeout
func (c *Client) SetTimeout(timeout time.Duration)SetTimeout exposes the ability to set a time limit for requests
func (*Client) SetTransport
func (c *Client) SetTransport(transport http.RoundTripper)SetTransport exposes the ability to define custom transports
func (c *Client) Stat(path string) (os.FileInfo, error)Stat returns the file stats for a specified path
func (c *Client) Write(path string, data []byte, _ os.FileMode) errorWrite writes data to a given path
func (*Client) WriteStream
func (c *Client) WriteStream(path string, stream io.Reader, _ os.FileMode) errorWriteStream writes a stream
type DigestAuth struct {
// contains filtered or unexported fields
}DigestAuth structure holds our credentials
func (d *DigestAuth) Authorize(c *Client, method string, path string)Authorize the current request
func (d *DigestAuth) Pass() stringPass holds the DigestAuth password
func (d *DigestAuth) Type() stringType identifies the DigestAuthenticator
func (d *DigestAuth) User() stringUser holds the DigestAuth username
type File struct {
// contains filtered or unexported fields
}File is our structure for a given file
func (File) ContentType
func (f File) ContentType() stringContentType returns the content type of a file
func (f File) ETag() stringETag returns the ETag of a file
func (f File) IsDir() boolIsDir let us see if a given file is a directory or not
func (f File) ModTime() time.TimeModTime returns the modified time of a file
func (f File) Mode() os.FileModeMode will return the mode of a given file
func (f File) Name() stringName returns the name of a file
func (f File) Path() stringPath returns the full path of a file
func (f File) Size() int64Size returns the size of a file
func (f File) String() stringString lets us see file information
func (f File) Sys() interface{}Sys ????
type NoAuth struct {
// contains filtered or unexported fields
}NoAuth structure holds our credentials
func (n *NoAuth) Authorize(c *Client, method string, path string)Authorize the current request
func (n *NoAuth) Pass() stringPass returns the current password
func (n *NoAuth) Type() stringType identifies the authenticator
func (n *NoAuth) User() stringUser returns the current user
Generated by godoc2md