Kamaelia.Protocol.Torrent.TorrentService

• component TorrentService

• BitTorrent Sharing Service
  • How does it work?

BitTorrent Sharing Service

The TorrentService component provides a service that allows the sharing of a single BitTorrent Client with more than one component that might want to use it.

Use the TorrentPatron component to make use of BitTorrent through this service.

Generally, you should not create a TorrentService yourself. If one is needed, one will be created by TorrentPatron. If a TorrentService already exists, creating one yourself may crash Python (see the effects of creating two TorrentClient components in TorrentClient.py)

The shutting down of this component (when it is no longer in use) is very ugly.

How does it work?

This component forwards messages from TorrentPatrons to a single TorrentClient it creates and also delivers responses from TorrentClient to the TorrentPatron appropriate to the response content.

TorrentClient handles new torrent requests sequentially, so as long as we keep a record of what order the requests of TorrentPatrons were forwarded, we can work out who to send TorrentClient's response to. Then, since all further messages are assigned a torrentid by TorrentClient, we can route all messages labelled with a particular id to to the TorrentPatron that started that torrent.

---

Kamaelia.Protocol.Torrent.TorrentService.TorrentService

class TorrentService(Axon.AdaptiveCommsComponent.AdaptiveCommsComponent)

TorrentService() -> new TorrentService component

Use TorrentService.getTorrentService(...) in preference as it returns an existing instance, or automatically creates a new one.

Inboxes

• control : Recieving a Axon.Ipc.shutdown() message here causes shutdown
• _torrentcontrol : Notice that TorrentClient has shutdown
• inbox : Connects to TorrentClient (the BitTorrent code)
• notify : Used to be notified about things to select

Outboxes

• debug : Information that may aid debugging
• outbox : Connects to TorrentClient (the BitTorrent code)
• signal : Not used

Methods defined here

__init__(self)

addClient(self, replyService)

Registers a TorrentPatron with this service, creating an outbox connected to it

debug(self, msg)

initTorrentClient(self)

main(self)

Main loop

removeClient(self, replyService)

Deregisters a TorrentPatron with this service, deleting its outbox

sendToClient(self, msg, replyService)

Send a message to a TorrentPatron