6 "github.com/anacrolix/torrent/metainfo"
9 type ClientImplCloser interface {
14 // Represents data storage for an unspecified torrent.
15 type ClientImpl interface {
16 OpenTorrent(info *metainfo.Info, infoHash metainfo.Hash) (TorrentImpl, error)
19 type TorrentCapacity *func() (cap int64, capped bool)
21 // Data storage bound to a torrent.
22 type TorrentImpl struct {
23 Piece func(p metainfo.Piece) PieceImpl
25 // Storages that share the same space, will provide equal pointers. The function is called once
26 // to determine the storage for torrents sharing the same function pointer, and mutated in
28 Capacity TorrentCapacity
31 // Interacts with torrent piece data. Optional interfaces to implement include:
32 // io.WriterTo, such as when a piece supports a more efficient way to write out incomplete chunks.
33 // SelfHashing, such as when a piece supports a more efficient way to hash its contents.
34 type PieceImpl interface {
35 // These interfaces are not as strict as normally required. They can
36 // assume that the parameters are appropriate for the dimensions of the
40 // Called when the client believes the piece data will pass a hash check.
41 // The storage can move or mark the piece data as read-only as it sees
44 MarkNotComplete() error
45 // Returns true if the piece is complete.
46 Completion() Completion
49 type Completion struct {
54 // Allows a storage backend to override hashing (i.e. if it can do it more efficiently than the torrent client can)
55 type SelfHashing interface {
56 SelfHash() (metainfo.Hash, error)