mirror of
https://github.com/rclone/rclone.git
synced 2024-12-01 13:04:21 +08:00
96 lines
2.8 KiB
Go
96 lines
2.8 KiB
Go
|
package http
|
||
|
|
|
||
|
|
import (
|
||
|
|
"embed"
|
||
|
|
"html/template"
|
||
|
|
"os"
|
||
|
|
"time"
|
||
|
|
|
||
|
|
"github.com/spf13/pflag"
|
||
|
|
|
||
|
|
"github.com/rclone/rclone/fs/config/flags"
|
||
|
|
)
|
||
|
|
|
||
|
|
// TemplateHelp describes how to use a custom template
|
||
|
|
var TemplateHelp = `
|
||
|
|
#### Template
|
||
|
|
|
||
|
|
` + "`--template`" + ` allows a user to specify a custom markup template for HTTP
|
||
|
|
and WebDAV serve functions. The server exports the following markup
|
||
|
|
to be used within the template to server pages:
|
||
|
|
|
||
|
|
| Parameter | Description |
|
||
|
|
| :---------- | :---------- |
|
||
|
|
| .Name | The full path of a file/directory. |
|
||
|
|
| .Title | Directory listing of .Name |
|
||
|
|
| .Sort | The current sort used. This is changeable via ?sort= parameter |
|
||
|
|
| | Sort Options: namedirfirst,name,size,time (default namedirfirst) |
|
||
|
|
| .Order | The current ordering used. This is changeable via ?order= parameter |
|
||
|
|
| | Order Options: asc,desc (default asc) |
|
||
|
|
| .Query | Currently unused. |
|
||
|
|
| .Breadcrumb | Allows for creating a relative navigation |
|
||
|
|
|-- .Link | The relative to the root link of the Text. |
|
||
|
|
|-- .Text | The Name of the directory. |
|
||
|
|
| .Entries | Information about a specific file/directory. |
|
||
|
|
|-- .URL | The 'url' of an entry. |
|
||
|
|
|-- .Leaf | Currently same as 'URL' but intended to be 'just' the name. |
|
||
|
|
|-- .IsDir | Boolean for if an entry is a directory or not. |
|
||
|
|
|-- .Size | Size in Bytes of the entry. |
|
||
|
|
|-- .ModTime | The UTC timestamp of an entry. |
|
||
|
|
`
|
||
|
|
|
||
|
|
// TemplateConfig for the templating functionality
|
||
|
|
type TemplateConfig struct {
|
||
|
|
Path string
|
||
|
|
}
|
||
|
|
|
||
|
|
// AddFlagsPrefix for the templating functionality
|
||
|
|
func (cfg *TemplateConfig) AddFlagsPrefix(flagSet *pflag.FlagSet, prefix string) {
|
||
|
|
flags.StringVarP(flagSet, &cfg.Path, prefix+"template", "", cfg.Path, "User-specified template")
|
||
|
|
}
|
||
|
|
|
||
|
|
// AddTemplateFlagsPrefix for the templating functionality
|
||
|
|
func AddTemplateFlagsPrefix(flagSet *pflag.FlagSet, prefix string, cfg *TemplateConfig) {
|
||
|
|
cfg.AddFlagsPrefix(flagSet, prefix)
|
||
|
|
}
|
||
|
|
|
||
|
|
// DefaultTemplateCfg returns a new config which can be customized by command line flags
|
||
|
|
func DefaultTemplateCfg() TemplateConfig {
|
||
|
|
return TemplateConfig{}
|
||
|
|
}
|
||
|
|
|
||
|
|
// AfterEpoch returns the time since the epoch for the given time
|
||
|
|
func AfterEpoch(t time.Time) bool {
|
||
|
|
return t.After(time.Time{})
|
||
|
|
}
|
||
|
|
|
||
|
|
// Assets holds the embedded filesystem for the default template
|
||
|
|
//
|
||
|
|
//go:embed templates
|
||
|
|
var Assets embed.FS
|
||
|
|
|
||
|
|
// GetTemplate returns the HTML template for serving directories via HTTP/WebDAV
|
||
|
|
func GetTemplate(tmpl string) (*template.Template, error) {
|
||
|
|
var readFile = os.ReadFile
|
||
|
|
if tmpl == "" {
|
||
|
|
tmpl = "templates/index.html"
|
||
|
|
readFile = Assets.ReadFile
|
||
|
|
}
|
||
|
|
|
||
|
|
data, err := readFile(tmpl)
|
||
|
|
if err != nil {
|
||
|
|
return nil, err
|
||
|
|
}
|
||
|
|
|
||
|
|
funcMap := template.FuncMap{
|
||
|
|
"afterEpoch": AfterEpoch,
|
||
|
|
}
|
||
|
|
|
||
|
|
tpl, err := template.New("index").Funcs(funcMap).Parse(string(data))
|
||
|
|
if err != nil {
|
||
|
|
return nil, err
|
||
|
|
}
|
||
|
|
|
||
|
|
return tpl, nil
|
||
|
|
}
|