2015-04-14 21:59:41 +08:00
|
|
|
package torrent
|
|
|
|
|
2015-04-28 13:24:17 +08:00
|
|
|
import (
|
|
|
|
"github.com/anacrolix/torrent/metainfo"
|
|
|
|
)
|
|
|
|
|
2015-04-14 21:59:41 +08:00
|
|
|
// The public interface for a torrent within a Client.
|
|
|
|
|
|
|
|
// A handle to a live torrent within a Client.
|
|
|
|
type Torrent struct {
|
|
|
|
cl *Client
|
|
|
|
*torrent
|
2015-04-29 22:30:19 +08:00
|
|
|
}
|
|
|
|
|
|
|
|
// Closed when the info (.Info()) for the torrent has become available. Using
|
|
|
|
// features of Torrent that require the info before it is available will have
|
|
|
|
// undefined behaviour.
|
|
|
|
func (t *Torrent) GotInfo() <-chan struct{} {
|
|
|
|
return t.torrent.gotMetainfo
|
2015-04-28 13:24:17 +08:00
|
|
|
}
|
|
|
|
|
|
|
|
func (t *Torrent) Info() *metainfo.Info {
|
|
|
|
return t.torrent.Info
|
2015-04-14 21:59:41 +08:00
|
|
|
}
|
|
|
|
|
2015-06-03 11:30:55 +08:00
|
|
|
// Returns a Reader bound to the torrent's data. All read calls block until
|
|
|
|
// the data requested is actually available. Priorities are set to ensure the
|
|
|
|
// data requested will be downloaded as soon as possible.
|
2015-04-14 21:59:41 +08:00
|
|
|
func (t *Torrent) NewReader() (ret *Reader) {
|
|
|
|
ret = &Reader{
|
|
|
|
t: t,
|
|
|
|
readahead: 5 * 1024 * 1024,
|
|
|
|
}
|
|
|
|
return
|
|
|
|
}
|
2015-06-01 16:22:12 +08:00
|
|
|
|
|
|
|
// Returns the state of pieces of the torrent. They are grouped into runs of
|
|
|
|
// same state. The sum of the state run lengths is the number of pieces
|
|
|
|
// in the torrent.
|
|
|
|
func (t *Torrent) PieceStateRuns() []PieceStateRun {
|
|
|
|
t.stateMu.Lock()
|
|
|
|
defer t.stateMu.Unlock()
|
|
|
|
return t.torrent.pieceStateRuns()
|
|
|
|
}
|
2015-06-23 00:02:22 +08:00
|
|
|
|
|
|
|
func (t Torrent) NumPieces() int {
|
|
|
|
return t.numPieces()
|
|
|
|
}
|
|
|
|
|
|
|
|
func (t Torrent) Drop() {
|
|
|
|
t.cl.mu.Lock()
|
|
|
|
t.cl.dropTorrent(t.InfoHash)
|
|
|
|
t.cl.mu.Unlock()
|
|
|
|
}
|