Package DebTorrent

source code

The main package to implement the DebTorrent protocol.

This package, and it's subpackage BT1, contains all the modules needed to implement the DebTorrent protocol.

Submodules

[hide private]

DebTorrent.BT1: More specific sub-modules for the debtorrent protocol.
- DebTorrent.BT1.AptListener: Listen for download requests from Apt.
- DebTorrent.BT1.Choker: Contains the Choker class.
- DebTorrent.BT1.Connecter: For maintaining connections to peers.
- DebTorrent.BT1.Downloader: Download pieces from remote peers.
- DebTorrent.BT1.DownloaderFeedback: Gather and display statistics about the download.
- DebTorrent.BT1.Encrypter: Make encrypted connections to peers.
- DebTorrent.BT1.FileSelector: Enable the selective downloading of files within a torrent.
- DebTorrent.BT1.Filter: Does nothing.
- DebTorrent.BT1.HTTPDownloader: Manage downloading pieces over HTTP.
- DebTorrent.BT1.NatCheck: Check if a peer is unreachable behind a NAT.
- DebTorrent.BT1.PiecePicker: Choose pieces to download.
- DebTorrent.BT1.Rerequester: Communicate with a tracker.
- DebTorrent.BT1.Statistics: Generate statistics for the swarm.
- DebTorrent.BT1.Storage: Low-level writing of files.
- DebTorrent.BT1.StorageWrapper: Manage the storage of data at the piece level.
- DebTorrent.BT1.StreamCheck: Not used.
- DebTorrent.BT1.T2T: Tracker to tracker connection management.
- DebTorrent.BT1.Uploader: Manage uploading to a single peer.
- DebTorrent.BT1.btformats: Functions for verifying debtorrent metainfo.
- DebTorrent.BT1.fakeopen: Fake file handling objects (not used).
- DebTorrent.BT1.makemetafile: Create a torrent file or data structure.
- DebTorrent.BT1.track: Tools to track a download swarm.
DebTorrent.BTcrypto: Encrypted communication support.
DebTorrent.ConfigDir: Manage configuration and cache files.
DebTorrent.ConnChoice: Sets the connection choices that are available.
DebTorrent.CurrentRateMeasure: Measuring rates of download and upload.
DebTorrent.HTTPCache: Manage an HTTP download cache.
DebTorrent.HTTPHandler: Handles incoming HTTP connections from other clients to this server.
DebTorrent.PSYCO: Whether to use the Psyco extension module.
DebTorrent.RateLimiter: Limit the upload rate.
DebTorrent.RateMeasure: Simple measurement of the download rate.
DebTorrent.RawServer: Manage connections to and tasks to be run on the server.
DebTorrent.ServerPortHandler: Wrappers to handle multiple torrent downloads.
DebTorrent.SocketHandler: Handle all sockets.
DebTorrent.bencode: Functions for bencoding and bdecoding data.
DebTorrent.bitfield: Manage creation and modification of bitfields.
DebTorrent.clock: Implement wall clock time for Unix systems.
DebTorrent.download_bt1: Manage a single download.
DebTorrent.inifile: Functions to read/write a Windows-style INI file
DebTorrent.iprangeparse: Deal with all types of IP addresses and IP address ranges.
DebTorrent.launchmanycore: Manage the downloading of multiple torrents in one process.
DebTorrent.parseargs: Functions for dealing with arguments, defaults and options.
DebTorrent.parsedir: Parse a directory for torrent files.
DebTorrent.piecebuffer: Store buffers of piece data.
DebTorrent.selectpoll: Provides socket polling for operating systems that don't support it.
DebTorrent.subnetparse: Deal with all types of IP addresses and IP address subnets.
DebTorrent.torrentlistparse: Parse a file for a list of torrent hashes.
DebTorrent.zurllib: A high-level fetcher for WWW data, similar to the urllib module.

Functions

[hide private]

string

createPeerID(ins='---')
Generate a somewhat random peer ID source code

string

make_readable(s)
Convert a string peer ID to be human-readable.

source code

resetPeerIDs()
Reset the generation of peer IDs before generating a new random one.

source code

Variables

[hide private]

_idprefix = 'T014--'

_idrandom = ['r7VMERo1K-a']

logging.Logger logger = logging.getLogger('DebTorrent')
the logger to send all log messages to for this module

string mapbase64 = '0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklm...
the mapping from 64 bit numbers to string characters

string product_name = 'DebTorrent'
the name given for the package

string protocol_name = 'DebTorrent/0.1'
the protocol name to use in handshaking

report_email = 'debtorrent-devel@lists.alioth.debian.org'

subver = 4

version = 'T-0.1.4 (DebTorrent)'

string version_short = 'T-0.1.4'
the short version number

Imports: DebTorrent.__init__, types.StringType, binascii.b2a_hex, time.clock, DebTorrent.getpid, logging, urllib.quote, sha.sha, time.time

Function Details

[hide private]

createPeerID(ins=`'---'`)

source code

Generate a somewhat random peer ID

Parameters:

ins (string) - the length 3 string to insert in the middle of the peer ID between the prefix and the random part of the ID (optional, defaults to '---')

Returns: string

the peer ID to use

make_readable(s)

source code

Convert a string peer ID to be human-readable.

Parameters:

s (string) - the string to convert

Returns: string

the resulting hex string, or the original string if it was already readable

Variables Details

[hide private]

mapbase64

the mapping from 64 bit numbers to string characters

Type:: string

Value:

'0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz.-'

Package DebTorrent

createPeerID(ins='---')

make_readable(s)

mapbase64

createPeerID(ins=`'---'`)