ftps

README

FTPS Implementation for Go

Information

This implementation does not implement the full FTP/FTPS specification. Only a small subset.

I have not done a security review of the code, yet. Therefore no guarantee is given. It would be nice if somebody could do a security review and report back if the implementation is vulnerable.

Installation

go get github.com/webguerilla/ftps

Usage

ftps := new(FTPS)

ftps.TLSConfig.InsecureSkipVerify = true // often necessary in shared hosting environments
ftps.Debug = true

err := ftps.Connect("localhost", 21)
if err != nil {
	panic(err)
}

err = ftps.Login("username", "password")
if err != nil {
	panic(err)
}

directory, err := ftps.PrintWorkingDirectory()
if err != nil {
	panic(err)
}
log.Printf("Current working directory: %s", directory)

err = ftps.Quit()
if err != nil {
	panic(err)
}

Credits

This work was inspired by the work of jlaffaye (https://github.com/jlaffaye/ftp) and smallfish (https://github.com/smallfish/ftp).

Documentation

Index

• type Client
  • func NewClient(user string, pass string, host string) *Client
  • func NewClientWithTLSConfig(user string, pass string, host string, config *tls.Config) *Client
  • func (c *Client) Download(filePath string) error
  • func (c *Client) DownloadFile(file *os.File) error
  • func (c *Client) DownloadWriter(writer io.Writer) error
  • func (c *Client) Upload(filePath string) error
  • func (c *Client) UploadFile(remoteFilepath string, file *os.File) error
  • func (c *Client) UploadReader(remoteFilepath string, source io.Reader) error
• type Entry
• type EntryType
• type FTPS
  • func (ftps *FTPS) ChangeWorkingDirectory(path string) (err error)
  • func (ftps *FTPS) Connect(host string, port int) (err error)
  • func (ftps *FTPS) DeleteFile(path string) (err error)
  • func (ftps *FTPS) List() (entries []Entry, err error)
  • func (ftps *FTPS) Login(username, password string) (err error)
  • func (ftps *FTPS) MakeDirectory(path string) (err error)
  • func (ftps *FTPS) PrintWorkingDirectory() (directory string, err error)
  • func (ftps *FTPS) Quit() (err error)
  • func (ftps *FTPS) RemoveDirectory(path string) (err error)
  • func (ftps *FTPS) RetrieveFile(remoteFilepath string, file *os.File) (err error)
  • func (ftps *FTPS) RetrieveWriter(remoteFilepath string, w io.Writer) (err error)
  • func (ftps *FTPS) StoreFile(remoteFilepath string, f *os.File) (err error)
  • func (ftps *FTPS) StoreReader(remoteFilepath string, r io.Reader) (err error)

Types

type Client

type Client struct {
	UserName  string
	Password  string
	Host      string
	TLSConfig *tls.Config
}

Client FTPS Client

func NewClient

func NewClient(user string, pass string, host string) *Client

NewClient return new FTPS Client

func NewClientWithTLSConfig

func NewClientWithTLSConfig(user string, pass string, host string, config *tls.Config) *Client

func (*Client) Download

func (c *Client) Download(filePath string) error

Download file from server

func (*Client) DownloadFile

func (c *Client) DownloadFile(file *os.File) error

DownloadFile file from server

func (*Client) DownloadWriter

func (c *Client) DownloadWriter(writer io.Writer) error

DownloadFile file from server

func (*Client) Upload

func (c *Client) Upload(filePath string) error

Upload file to Server

func (*Client) UploadFile

func (c *Client) UploadFile(remoteFilepath string, file *os.File) error

UploadFile file to Server

func (*Client) UploadReader

func (c *Client) UploadReader(remoteFilepath string, source io.Reader) error

UploadFile file to Server

type Entry

type Entry struct {
	Type EntryType
	Name string
	Size uint64
	Time time.Time
}

type EntryType

type EntryType int

const (
	EntryTypeFile EntryType = iota
	EntryTypeFolder
	EntryTypeLink
)

type FTPS

type FTPS struct {
	Debug     bool
	TLSConfig tls.Config
	// contains filtered or unexported fields
}

func (*FTPS) ChangeWorkingDirectory

func (ftps *FTPS) ChangeWorkingDirectory(path string) (err error)

func (*FTPS) Connect

func (ftps *FTPS) Connect(host string, port int) (err error)

func (*FTPS) DeleteFile

func (ftps *FTPS) DeleteFile(path string) (err error)

func (*FTPS) List

func (ftps *FTPS) List() (entries []Entry, err error)

func (*FTPS) Login

func (ftps *FTPS) Login(username, password string) (err error)

func (*FTPS) MakeDirectory

func (ftps *FTPS) MakeDirectory(path string) (err error)

func (*FTPS) PrintWorkingDirectory

func (ftps *FTPS) PrintWorkingDirectory() (directory string, err error)

func (*FTPS) Quit

func (ftps *FTPS) Quit() (err error)

func (*FTPS) RemoveDirectory

func (ftps *FTPS) RemoveDirectory(path string) (err error)

func (*FTPS) RetrieveFile

func (ftps *FTPS) RetrieveFile(remoteFilepath string, file *os.File) (err error)

func (*FTPS) RetrieveWriter

func (ftps *FTPS) RetrieveWriter(remoteFilepath string, w io.Writer) (err error)

func (*FTPS) StoreFile

func (ftps *FTPS) StoreFile(remoteFilepath string, f *os.File) (err error)

func (*FTPS) StoreReader

func (ftps *FTPS) StoreReader(remoteFilepath string, r io.Reader) (err error)