site

type RegInfo struct {
	Name    string
	Aliases []string
	Creator func(string, *config.SiteConfigStruct, *config.ConfigStruct) (Site, error)
}

type Site interface {
	GetName() string
	// default sent http request headers
	GetDefaultHttpHeaders() [][]string
	GetSiteConfig() *config.SiteConfigStruct
	// download torrent by id (e.g. 12345), sitename.id (e.g. mteam.12345),
	// or absolute download url (e.g. https://kp.m-team.cc/download.php?id=12345).
	DownloadTorrent(url string) (content []byte, filename string, id string, err error)
	// download torrent by torrent id (e.g. "12345")
	DownloadTorrentById(id string) (content []byte, filename string, err error)
	GetLatestTorrents(full bool) ([]*Torrent, error)
	// sort: size|name|none(or "")
	GetAllTorrents(sort string, desc bool, pageMarker string, baseUrl string) (
		torrents []*Torrent, nextPageMarker string, err error)
	// can use "%s" as keyword placeholder in baseUrl
	SearchTorrents(keyword string, baseUrl string) ([]*Torrent, error)
	// Publish (upload) new torrent to site, return uploaded torrent id
	// Some keys in metadata should be handled specially:
	// If metadata contains "_dryrun", use dry run mode;
	PublishTorrent(contents []byte, metadata url.Values) (id string, err error)
	GetStatus() (*Status, error)
	PurgeCache()
}

type SiteCreator func(*RegInfo) (Site, error)

type Status struct {
	UserName            string
	UserDownloaded      int64
	UserUploaded        int64
	TorrentsSeedingCnt  int64
	TorrentsLeechingCnt int64
}

type Torrent struct {
	Name               string
	Description        string
	Id                 string // optional torrent id in the site
	InfoHash           string
	DownloadUrl        string
	DownloadMultiplier float64
	UploadMultiplier   float64
	DiscountEndTime    int64
	Time               int64 // torrent timestamp
	Size               int64
	IsSizeAccurate     bool
	Seeders            int64
	Leechers           int64
	Snatched           int64
	HasHnR             bool     // true if has any type of HR
	IsActive           bool     // true if torrent is or had ever been downloaded / seeding
	IsCurrentActive    bool     // true if torrent is currently downloading / seeding. If true, so will be IsActive
	Paid               bool     // "付费"种子: (第一次)下载或汇报种子时扣除魔力/积分
	Bought             bool     // 适用于付费种子：已购买
	Neutral            bool     // 中性种子：不计算上传、下载、做种魔力
	Tags               []string // labels, e.g. category and other meta infos.
}