2007-02-20 05:32:13 +01:00
<?xml version="1.0" encoding="utf-8" ?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
< html xmlns = "http://www.w3.org/1999/xhtml" xml:lang = "en" lang = "en" >
< head >
< meta http-equiv = "Content-Type" content = "text/html; charset=utf-8" / >
< meta name = "generator" content = "Docutils 0.5: http://docutils.sourceforge.net/" / >
< title > libtorrent python binding< / title >
< meta name = "author" content = "Arvid Norberg, arvid@rasterbar.com" / >
2008-10-20 00:42:56 +02:00
< link rel = "stylesheet" type = "text/css" href = "../../css/base.css" / >
< link rel = "stylesheet" type = "text/css" href = "../../css/rst.css" / >
2007-02-20 05:32:13 +01:00
< link rel = "stylesheet" href = "style.css" type = "text/css" / >
2008-10-20 00:42:56 +02:00
< style type = "text/css" >
/* Hides from IE-mac \*/
* html pre { height: 1%; }
/* End hide from IE-mac */
< / style >
2007-02-20 05:32:13 +01:00
< / head >
< body >
< div class = "document" id = "libtorrent-python-binding" >
2008-10-20 00:42:56 +02:00
< div id = "container" >
< div id = "headerNav" >
< ul >
< li class = "first" > < a href = "/" > Home< / a > < / li >
< li > < a href = "../../products.html" > Products< / a > < / li >
< li > < a href = "../../contact.html" > Contact< / a > < / li >
< / ul >
< / div >
< div id = "header" >
< h1 > < span > Rasterbar Software< / span > < / h1 >
< h2 > < span > Software developement and consulting< / span > < / h2 >
< / div >
< div id = "main" >
2007-02-20 05:32:13 +01:00
< h1 class = "title" > libtorrent python binding< / h1 >
< table class = "docinfo" frame = "void" rules = "none" >
< col class = "docinfo-name" / >
< col class = "docinfo-content" / >
< tbody valign = "top" >
< tr > < th class = "docinfo-name" > Author:< / th >
2008-04-05 06:53:22 +02:00
< td > Arvid Norberg, < a class = "last reference external" href = "mailto:arvid@rasterbar.com" > arvid@ rasterbar.com< / a > < / td > < / tr >
2007-02-20 05:32:13 +01:00
< / tbody >
< / table >
< div class = "contents topic" id = "table-of-contents" >
2008-04-05 06:53:22 +02:00
< p class = "topic-title first" > Table of contents< / p >
2007-02-20 05:32:13 +01:00
< ul class = "simple" >
2008-10-20 00:42:56 +02:00
< li > < a class = "reference internal" href = "#building" id = "id2" > building< / a > < ul >
< li > < a class = "reference internal" href = "#building-using-setup-py" id = "id3" > building using setup.py< / a > < / li >
< li > < a class = "reference internal" href = "#building-using-boost-build" id = "id4" > building using boost build< / a > < / li >
< / ul >
< / li >
< li > < a class = "reference internal" href = "#using-libtorrent-in-python" id = "id5" > using libtorrent in python< / a > < / li >
2007-02-20 05:32:13 +01:00
< / ul >
< / div >
2008-04-05 06:53:22 +02:00
< div class = "section" id = "building" >
< h1 > building< / h1 >
2007-02-20 05:32:13 +01:00
< p > Building the libtorrent python bindings will produce a shared library (DLL)
which is a python module that can be imported in a python program.< / p >
2008-10-20 00:42:56 +02:00
< div class = "section" id = "building-using-setup-py" >
< h2 > building using setup.py< / h2 >
2008-12-02 09:41:02 +01:00
< p > There is a < tt class = "docutils literal" > < span class = "pre" > setup.py< / span > < / tt > shipped with libtorrent that can be used on windows.
On windows the setup.py will invoke < tt class = "docutils literal" > < span class = "pre" > bjam< / span > < / tt > and assume that you have boost
sources at < tt class = "docutils literal" > < span class = "pre" > $BOOST_PATH< / span > < / tt > . The resulting executable is self-contained, it does
not depend any boost or libtorrent dlls.< / p >
< p > On other systems, the setup.py is generated by running
< tt class = "docutils literal" > < span class = "pre" > ./configure< / span > < span class = "pre" > --enable-python-binding< / span > < / tt > .< / p >
2008-10-20 00:42:56 +02:00
< p > To build the Python bindings do:< / p >
< ol class = "arabic" >
< li > < p class = "first" > Run:< / p >
< pre class = "literal-block" >
python setup.py build
< / pre >
< / li >
< li > < p class = "first" > As root, run:< / p >
< pre class = "literal-block" >
python setup.py install
< / pre >
< / li >
< / ol >
< / div >
< div class = "section" id = "building-using-boost-build" >
< h2 > building using boost build< / h2 >
< p > To set up your build environment, you need to add some settings to your
2007-02-20 05:32:13 +01:00
< tt class = "docutils literal" > < span class = "pre" > $BOOST_BUILD_PATH/user-config.jam< / span > < / tt > .< / p >
< p > Make sure your user config contains the following line:< / p >
< pre class = "literal-block" >
using python : 2.3 ;
< / pre >
< p > Set the version to the version of python you have installed or want to use. If
you've installed python in a non-standard location, you have to add the prefix
path used when you installed python as a second option. Like this:< / p >
< pre class = "literal-block" >
using python : 2.3 : /usr ;
< / pre >
< p > The bindings require < em > at least< / em > python version 2.2.< / p >
< p > For more information on how to install and set up boost-build, see the
2008-04-05 06:53:22 +02:00
< a class = "reference external" href = "building.html#step-2-setup-bbv2" > building libtorrent< / a > section.< / p >
2007-02-20 05:32:13 +01:00
< p > Once you have boost-build set up, you cd to the < tt class = "docutils literal" > < span class = "pre" > bindings/python< / span > < / tt >
directory and invoke < tt class = "docutils literal" > < span class = "pre" > bjam< / span > < / tt > with the apropriate settings. For the available
2008-04-05 06:53:22 +02:00
build variants, see < a class = "reference external" href = "building.html#step-3-building-libtorrent" > libtorrent build options< / a > .< / p >
2007-02-20 05:32:13 +01:00
< p > For example:< / p >
< pre class = "literal-block" >
2008-03-10 07:30:34 +01:00
$ bjam dht-support=on boost=source release link=static
2007-02-20 05:32:13 +01:00
< / pre >
< p > On Mac OS X, this will produce the following python module:< / p >
< pre class = "literal-block" >
bin/darwin-4.0/release/dht-support-on/link-static/logging-none/threading-multi/libtorrent.so
< / pre >
< / div >
2008-10-20 00:42:56 +02:00
< / div >
2008-04-05 06:53:22 +02:00
< div class = "section" id = "using-libtorrent-in-python" >
< h1 > using libtorrent in python< / h1 >
2007-02-20 05:32:13 +01:00
< p > The python interface is nearly identical to the C++ interface. Please refer to
2008-04-05 06:53:22 +02:00
the < a class = "reference external" href = "manual.html" > main library reference< / a > . The main differences are:< / p >
< dl class = "docutils" >
< dt > asio::tcp::endpoint< / dt >
< dd > The endpoint type is represented as a tuple of a string (as the address) and an int for
the port number. E.g. < tt class = "docutils literal" > < span class = "pre" > ('127.0.0.1',< / span > < span class = "pre" > 6881)< / span > < / tt > represents the localhost port 6881.< / dd >
< dt > libtorrent::time_duration< / dt >
< dd > The time duration is represented as a number of seconds in a regular integer.< / dd >
< / dl >
< p > The following functions takes a reference to a container that is filled with
entries by the function. The python equivalent of these functions instead returns
a list of entries.< / p >
< ul class = "simple" >
< li > torrent_handle::get_peer_info< / li >
< li > torrent_handle::file_progress< / li >
< li > torrent_handle::get_download_queue< / li >
< li > torrent_handle::piece_availability< / li >
< / ul >
2007-02-20 05:32:13 +01:00
< p > For an example python program, see < tt class = "docutils literal" > < span class = "pre" > client.py< / span > < / tt > in the < tt class = "docutils literal" > < span class = "pre" > bindings/python< / span > < / tt >
directory.< / p >
< p > A very simple example usage of the module would be something like this:< / p >
< pre class = "literal-block" >
import libtorrent as lt
import time
ses = lt.session()
ses.listen_on(6881, 6891)
e = lt.bdecode(open(" test.torrent" , 'rb').read())
info = lt.torrent_info(e)
2008-03-10 07:30:34 +01:00
h = ses.add_torrent(info, " ./" , storage_mode=storage_mode_sparse)
2007-02-20 05:32:13 +01:00
while (not h.is_seed()):
s = h.status()
2008-10-21 11:31:16 +02:00
state_str = ['queued', 'checking', 'downloading metadata', \
2007-02-20 05:32:13 +01:00
'downloading', 'finished', 'seeding', 'allocating']
print '%.2f%% complete (down: %.1f kb/s up: %.1f kB/s peers: %d) %s' % \
(s.progress * 100, s.download_rate / 1000, s.upload_rate / 1000, \
s.num_peers, state_str[s.state])
time.sleep(1)
< / pre >
< / div >
2008-10-20 00:42:56 +02:00
< / div >
< div id = "footer" >
< span > Copyright © 2005 Rasterbar Software.< / span >
< / div >
< / div >
< script src = "http://www.google-analytics.com/urchin.js" type = "text/javascript" >
< / script >
< script type = "text/javascript" >
_uacct = "UA-1599045-1";
urchinTracker();
< / script >
2007-02-20 05:32:13 +01:00
< / div >
< / body >
< / html >
