tusd/pkg/handler/config.go

84 lines
2.9 KiB
Go
Raw Normal View History

package handler
2016-02-21 22:25:35 +00:00
import (
2016-03-11 19:46:34 +00:00
"errors"
2016-02-21 22:25:35 +00:00
"log"
"net/url"
"os"
)
// Config provides a way to configure the Handler depending on your needs.
type Config struct {
// DataStore implementation used to store and retrieve the single uploads.
2016-03-12 15:51:00 +00:00
// The usage of this field is deprecated and should be avoided in favor of
// StoreComposer.
2016-03-12 21:24:57 +00:00
DataStore DataStore
2016-03-12 15:51:00 +00:00
// StoreComposer points to the store composer from which the core data store
// and optional dependencies should be taken. May only be nil if DataStore is
// set.
2016-02-21 22:25:35 +00:00
StoreComposer *StoreComposer
// MaxSize defines how many bytes may be stored in one single upload. If its
// value is is 0 or smaller no limit will be enforced.
MaxSize int64
// BasePath defines the URL path used for handling uploads, e.g. "/files/".
// If no trailing slash is presented it will be added. You may specify an
// absolute URL containing a scheme, e.g. "http://tus.io"
BasePath string
isAbs bool
// NotifyCompleteUploads indicates whether sending notifications about
// completed uploads using the CompleteUploads channel should be enabled.
2016-02-21 22:25:35 +00:00
NotifyCompleteUploads bool
2016-03-12 21:24:57 +00:00
// NotifyTerminatedUploads indicates whether sending notifications about
// terminated uploads using the TerminatedUploads channel should be enabled.
NotifyTerminatedUploads bool
// NotifyUploadProgress indicates whether sending notifications about
// the upload progress using the UploadProgress channel should be enabled.
NotifyUploadProgress bool
// NotifyCreatedUploads indicates whether sending notifications about
// the upload having been created using the CreatedUploads channel should be enabled.
NotifyCreatedUploads bool
// Logger is the logger to use internally, mostly for printing requests.
2016-02-21 22:25:35 +00:00
Logger *log.Logger
// Respect the X-Forwarded-Host, X-Forwarded-Proto and Forwarded headers
// potentially set by proxies when generating an absolute URL in the
2016-09-27 20:10:16 +00:00
// response to POST requests.
2016-02-21 22:25:35 +00:00
RespectForwardedHeaders bool
}
func (config *Config) validate() error {
if config.Logger == nil {
config.Logger = log.New(os.Stdout, "[tusd] ", log.Ldate|log.Ltime)
2016-02-21 22:25:35 +00:00
}
base := config.BasePath
uri, err := url.Parse(base)
if err != nil {
return err
}
// Ensure base path ends with slash to remove logic from absFileURL
if base != "" && string(base[len(base)-1]) != "/" {
base += "/"
}
// Ensure base path begins with slash if not absolute (starts with scheme)
if !uri.IsAbs() && len(base) > 0 && string(base[0]) != "/" {
base = "/" + base
}
config.BasePath = base
config.isAbs = uri.IsAbs()
if config.StoreComposer == nil {
config.StoreComposer = newStoreComposerFromDataStore(config.DataStore)
2016-03-11 19:46:34 +00:00
config.DataStore = nil
2016-02-21 22:25:35 +00:00
} else if config.DataStore != nil {
2016-03-11 19:46:34 +00:00
return errors.New("tusd: either StoreComposer or DataStore may be set in Config, but not both")
}
if config.StoreComposer.Core == nil {
return errors.New("tusd: StoreComposer in Config needs to contain a non-nil core")
2016-02-21 22:25:35 +00:00
}
return nil
}