IMPORTANT NOTE: this project requires a custom version of tornado from
https://github.com/kzahel/tornado_gen that has a special
IOStream.read_chunk method. Please install this using virtualenv. If
you don't know how to use virtualenv, first learn about that.

SECONDARY NOTE: some features require a patched bencode

def bdecode(x,strict=True):                                                             
    try:                                                                                                                                                                
        r, l = decode_func[x[0]](x, 0)                                                                                                                                  
    except (IndexError, KeyError, ValueError):                                                                                                                          
        raise BTFailure("not a valid bencoded string")                                                                                                                  
    if l != len(x) and strict:                                                                                                                                          
        raise BTFailure("invalid bencoded value (data after valid prefix)")                                                                                             
    return r                                                                

torrent client using tornado's ioloop.
fast and efficient for downloading files.

now downloads from non-100% complete peers

has support for ut_metadata extension


Behavior:
====

Accepts connections on options.port, and attempts to download from
anyone who connects on that port and sends a valid BitTorrent
handshake message. If the handshake message includes the extension
which supports sending the torrent metadata, it will request that
first.

Also with startup options it can initiate a connection to another
peer.

Running:
====
python -m ktorrent.serve

Testing:
====

try running uTorrent and with a torrent selected, go to the "peers"
pane, right click, "add peer" and enter the host:port (default port
8030) and start the torrent. You should see ktorrent start to download
pieces.


Other options:
====

- options.datapath - place to store torrent files and torrent data

- options.resume_file - place to store torrent metadata info (infohash
to .torrent file disk location mapping)

- options.startup_connect_to - give an ip:port and it will initiate a
handshake with this address, using either:

  - options.startup_connect_torrent (a filesystem path of a .torrent file)
    or
  - options.startup_connet_to_hash (a 40 character hex torrent infohash)

- if options.startup_exit_on_close is specified, the program will quit
after the first peer connection closes.


Currently not very useful options:
====

- options.frontend_port - a web interface for controlling/observing
  program behavior (has no functionality -- yet)

- options.static_path - where the web interface can serve static files
  from (like html or images)

- options.template_path - where the web interface can serve template
  files from (for html)