py-libp2p/host/basic_host.py

62 lines
1.8 KiB
Python
Raw Normal View History

2018-10-15 13:52:25 +08:00
from .host_interface import IHost
2018-10-15 01:47:06 +08:00
2018-11-13 02:02:49 +08:00
2018-10-15 13:52:25 +08:00
# Upon host creation, host takes in options,
2018-10-15 02:11:03 +08:00
# including the list of addresses on which to listen.
2018-10-15 13:52:25 +08:00
# Host then parses these options and delegates to its Network instance,
2018-10-15 02:11:03 +08:00
# telling it to listen on the given listen addresses.
2018-10-15 13:52:25 +08:00
class BasicHost(IHost):
# default options constructor
2018-10-22 00:55:45 +08:00
def __init__(self, _network):
self.network = _network
2018-11-12 01:36:15 +08:00
self.peerstore = self.network.peerstore
2018-10-15 13:52:25 +08:00
def get_id(self):
"""
:return: peer_id of host
"""
2018-10-22 00:55:45 +08:00
return self.network.get_peer_id()
2018-10-15 13:52:25 +08:00
def get_network(self):
"""
:return: network instance of host
"""
2018-10-22 00:55:45 +08:00
return self.network
2018-10-15 13:52:25 +08:00
2018-11-12 01:36:15 +08:00
def get_peerstore(self):
"""
:return: peerstore of the host (same one as in its network instance)
"""
2018-11-12 01:38:55 +08:00
return self.peerstore
2018-11-12 01:36:15 +08:00
2018-10-22 00:55:45 +08:00
def get_mux(self):
2018-10-15 13:52:25 +08:00
"""
:return: mux instance of host
"""
pass
def set_stream_handler(self, protocol_id, stream_handler):
"""
set stream handler for host
:param protocol_id: protocol id used on stream
:param stream_handler: a stream handler function
:return: true if successful
"""
2018-10-22 00:55:45 +08:00
return self.network.set_stream_handler(protocol_id, stream_handler)
2018-10-15 13:52:25 +08:00
# protocol_id can be a list of protocol_ids
# stream will decide which protocol_id to run on
2018-11-13 00:00:43 +08:00
async def new_stream(self, peer_id, protocol_id):
2018-10-15 13:52:25 +08:00
"""
:param peer_id: peer_id that host is connecting
2018-11-13 02:02:49 +08:00
:param protocol_id: protocol id that stream runs on
2018-10-15 13:52:25 +08:00
:return: true if successful
"""
2018-11-12 09:29:17 +08:00
# TODO: host should return a mux stream not a raw stream
2018-11-13 00:00:43 +08:00
stream = await self.network.new_stream(peer_id, protocol_id)
2018-10-22 00:55:45 +08:00
stream.set_protocol(protocol_id)
return stream