# Copyright (c) 2013 Chris Lucas, # Permission is hereby granted, free of charge, to any person obtaining # a copy of this software and associated documentation files (the # "Software"), to deal in the Software without restriction, including # without limitation the rights to use, copy, modify, merge, publish, # distribute, sublicense, and/or sell copies of the Software, and to # permit persons to whom the Software is furnished to do so, subject to # the following conditions: # # The above copyright notice and this permission notice shall be # included in all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, # EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF # MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND # NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE # LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION # OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION # WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. # from rtorrent.rpc import Method import rtorrent.rpc from rtorrent.common import safe_repr Method = rtorrent.rpc.Method class Peer: """Represents an individual peer within a L{Torrent} instance.""" def __init__(self, _rt_obj, info_hash, **kwargs): self._rt_obj = _rt_obj self.info_hash = info_hash # : info hash for the torrent the peer is associated with for k in kwargs.keys(): setattr(self, k, kwargs.get(k, None)) self.rpc_id = "{0}:p{1}".format( self.info_hash, self.id) # : unique id to pass to rTorrent def __repr__(self): return safe_repr("Peer(id={0})", self.id) def update(self): """Refresh peer data @note: All fields are stored as attributes to self. @return: None """ multicall = rtorrent.rpc.Multicall(self) retriever_methods = [m for m in methods if m.is_retriever() and m.is_available(self._rt_obj)] for method in retriever_methods: multicall.add(method, self.rpc_id) multicall.call() if rtorrent.connection.Connection._get_client_version_tuple >= .97: methods = [ # RETRIEVERS Method(Peer, 'is_preferred', 'p.is_preferred', boolean=True, ), Method(Peer, 'get_down_rate', 'p.down_rate'), Method(Peer, 'is_unwanted', 'p.is_unwanted', boolean=True, ), Method(Peer, 'get_peer_total', 'p.peer_total'), Method(Peer, 'get_peer_rate', 'p.peer_rate'), Method(Peer, 'get_port', 'p.port'), Method(Peer, 'is_snubbed', 'p.is_snubbed', boolean=True, ), Method(Peer, 'get_id_html', 'p.id_html'), Method(Peer, 'get_up_rate', 'p.up_rate'), Method(Peer, 'is_banned', 'p.banned', boolean=True, ), Method(Peer, 'get_completed_percent', 'p.completed_percent'), Method(Peer, 'completed_percent', 'p.completed_percent'), Method(Peer, 'get_id', 'p.id'), Method(Peer, 'is_obfuscated', 'p.is_obfuscated', boolean=True, ), Method(Peer, 'get_down_total', 'p.down_total'), Method(Peer, 'get_client_version', 'p.client_version'), Method(Peer, 'get_address', 'p.address'), Method(Peer, 'is_incoming', 'p.is_incoming', boolean=True, ), Method(Peer, 'is_encrypted', 'p.is_encrypted', boolean=True, ), Method(Peer, 'get_options_str', 'p.options_str'), Method(Peer, 'get_client_version', 'p.client_version'), Method(Peer, 'get_up_total', 'p.up_total'), # MODIFIERS ] else: methods = [ # RETRIEVERS Method(Peer, 'is_preferred', 'p.is_preferred', boolean=True, ), Method(Peer, 'get_down_rate', 'p.get_down_rate'), Method(Peer, 'is_unwanted', 'p.is_unwanted', boolean=True, ), Method(Peer, 'get_peer_total', 'p.get_peer_total'), Method(Peer, 'get_peer_rate', 'p.get_peer_rate'), Method(Peer, 'get_port', 'p.get_port'), Method(Peer, 'is_snubbed', 'p.is_snubbed', boolean=True, ), Method(Peer, 'get_id_html', 'p.get_id_html'), Method(Peer, 'get_up_rate', 'p.get_up_rate'), Method(Peer, 'is_banned', 'p.banned', boolean=True, ), Method(Peer, 'get_completed_percent', 'p.get_completed_percent'), Method(Peer, 'completed_percent', 'p.completed_percent'), Method(Peer, 'get_id', 'p.get_id'), Method(Peer, 'is_obfuscated', 'p.is_obfuscated', boolean=True, ), Method(Peer, 'get_down_total', 'p.get_down_total'), Method(Peer, 'get_client_version', 'p.get_client_version'), Method(Peer, 'get_address', 'p.get_address'), Method(Peer, 'is_incoming', 'p.is_incoming', boolean=True, ), Method(Peer, 'is_encrypted', 'p.is_encrypted', boolean=True, ), Method(Peer, 'get_options_str', 'p.get_options_str'), Method(Peer, 'get_client_version', 'p.client_version'), Method(Peer, 'get_up_total', 'p.get_up_total'), # MODIFIERS ]