NAME

Protocol::BitTorrent - protocol-level support for BitTorrent and .torrent files

VERSION

version 0.004

SYNOPSIS

 package BitTorrent::Implementation;
 use Protocol::BitTorrent;
 ...

DESCRIPTION

This distribution provides handling for the BitTorrent protocol at an abstract level. Although some utilities are provided for dealing with .torrent files, the intention is for this class to act as a base for building BitTorrent client/server/tracker implementations, rather than a complete independent package. Specifically, no attempt is made to listen or connect to network sockets.

See Protocol::BitTorrent::Metainfo for information on dealing with .torrent files, and also check the examples/ and bin/ directories for examples of code using these classes.

An actual working client+tracker implementation can be found in Net::Async::BitTorrent.

METHODS

new

parse_metainfo

Parse .torrent data and return a Protocol::BitTorrent::Metainfo instance.

generate_metainfo

Wrapper around Protocol::BitTorrent::Metainfo for creating new .torrent data.

peer_type_from_id

Returns the client type for a given peer_id.

SEE ALSO

• Net::BitTorrent - seems to be a solid implementation of the protocol, at time of writing was undergoing some refactoring to switch to Moose and AnyEvent although development appears to have stalled for the last year.

• http://wiki.theory.org/BitTorrentSpecification - 'unofficial' spec.

• http://en.wikipedia.org/wiki/Comparison_of_BitTorrent_tracker_software - a list of other BitTorrent software, this list is likely to be more up to date than this section.

AUTHOR

Tom Molesworth <cpan@entitymodel.com>

LICENSE

Copyright Tom Molesworth 2011. Licensed under the same terms as Perl itself.