| |
|
- BaseSelectionManager
-
- SelectionManager
- NodeGenerator
-
- BwWeightedGenerator
- OrderedExitGenerator
- UniformGenerator
- NodeRestriction
-
- ConserveExitsRestriction
- CountryCodeRestriction
- CountryRestriction
- ExitPolicyRestriction
- FlagsRestriction
- IdHexRestriction
- MetaNodeRestriction
-
- AtLeastNNodeRestriction
- NodeRestrictionList
- NotNodeRestriction
- OrNodeRestriction
- MinBWRestriction
- NickRestriction
- OSRestriction
- PercentileRestriction
- RateLimitedRestriction
- VersionExcludeRestriction
- VersionIncludeRestriction
- VersionRangeRestriction
- PathRestriction
-
- ContinentJumperRestriction
- ContinentRestriction
- MetaPathRestriction
-
- PathRestrictionList
- SingleCountryRestriction
- Subnet16Restriction
- UniqueContinentRestriction
- UniqueCountryRestriction
- UniqueRestriction
- PathSelector
- _SocketWrapper(socket._socketobject)
-
- SmartSocket
- TorCtl.TorCtl.Connection
-
- Connection
- TorCtl.TorCtl.ConsensusTracker(TorCtl.TorCtl.EventHandler)
-
- PathBuilder
-
- CircuitHandler
-
- StreamHandler
class BaseSelectionManager |
| |
The BaseSelectionManager is a minimalistic node selection manager.
It is meant to be used with a PathSelector that consists of an
entry NodeGenerator, a middle NodeGenerator, and an exit NodeGenerator.
However, none of these are absolutely necessary. It is possible
to completely avoid them if you wish by hacking whatever selection
mechanisms you want straight into this interface and then passing
an instance to a PathBuilder implementation.
|
| |
Methods defined here:
- __init__(self)
- new_consensus(self, consensus)
- This method is called whenever a consensus change occurs.
This method should NOT throw any exceptions.
- reconfigure(self, consensus=None)
- This method is called whenever a significant configuration change
occurs. Currently, this only happens via PathBuilder.__init__ and
PathBuilder.schedule_selmgr().
This method should NOT throw any exceptions.
- select_path(self)
- Returns a new path in the form of a list() of Router instances.
May throw a RestrictionError.
- set_exit(self, exit_name)
- This method provides notification that a fixed exit is desired.
This method should NOT throw any exceptions.
- set_target(self, host, port)
- This method provides notification that a new target endpoint is
desired.
May throw a RestrictionError if target is impossible to reach.
|
class BwWeightedGenerator(NodeGenerator) |
| |
This is a generator designed to match the Tor Path Selection
algorithm. It will generate nodes weighted by their bandwidth,
but take the appropriate weighting into account against guard
nodes and exit nodes when they are chosen for positions other
than guard/exit. For background see:
routerlist.c::smartlist_choose_by_bandwidth(),
http://archives.seul.org/or/dev/Jul-2007/msg00021.html,
http://archives.seul.org/or/dev/Jul-2007/msg00056.html, and
https://tor-svn.freehaven.net/svn/tor/trunk/doc/spec/path-spec.txt
The formulas used are from the first or-dev link, but are proven
optimal and equivalent to the ones now used in routerlist.c in the
second or-dev link.
|
| |
Methods defined here:
- __init__(self, sorted_r, rstr_list, pathlen, exit=False, guard=False)
- Pass exit=True to create a generator for exit-nodes
- generate(self)
- rebuild(self, sorted_r=None)
Methods inherited from NodeGenerator:
- all_chosen(self)
- Return true if all the routers have been marked as chosen
- mark_chosen(self, r)
- Mark a router as chosen: remove it from the list of routers
that can be returned in the future
- reset_restriction(self, rstr_list)
- Reset the restriction list to a new list
- rewind(self)
- Rewind the generator to the 'beginning'
|
class CircuitHandler(PathBuilder) |
| |
CircuitHandler that extends from PathBuilder to handle multiple
circuits as opposed to just one.
|
| |
- Method resolution order:
- CircuitHandler
- PathBuilder
- TorCtl.TorCtl.ConsensusTracker
- TorCtl.TorCtl.EventHandler
- TorCtl.TorCtl.EventSink
Methods defined here:
- __init__(self, c, selmgr, num_circuits, RouterClass)
- Constructor. 'c' is a Connection, 'selmgr' is a SelectionManager,
'num_circuits' is the number of circuits to keep in the pool,
and 'RouterClass' is a class that inherits from Router and is used
to create annotated Routers.
- build_circuit(self, host, port)
- Build a circuit
- check_circuit_pool(self)
- Init or check the status of the circuit-pool
- circ_status_event(self, c)
- Handle circuit status events
Methods inherited from PathBuilder:
- attach_stream_any(self, stream, badcircs)
- Attach a stream to a valid circuit, avoiding any in 'badcircs'
- bandwidth_event(self, b)
- build_path(self)
- Get a path from the SelectionManager's PathSelector, can be used
e.g. for generating paths without actually creating any circuits
- circuit_list(self)
- Return an iterator or a list of circuits prioritized for
stream selection.
- close_all_circuits(self)
- Close all open circuits
- close_all_streams(self, reason)
- Close all open streams
- close_circuit(self, id)
- Close a circuit with given id
- heartbeat_event(self, event)
- This function handles dispatching scheduled jobs. If you
extend PathBuilder and want to implement this function for
some reason, be sure to call the parent class
- new_consensus_event(self, n)
- new_desc_event(self, d)
- reset(self)
- Resets accumulated state. Currently only clears the
ExactUniformGenerator state.
- schedule_immediate(self, job)
- Schedules an immediate job to be run before the next event is
processed.
- schedule_low_prio(self, job)
- Schedules a job to be run when a non-time critical event arrives.
- schedule_selmgr(self, job)
- Schedules an immediate job to be run before the next event is
processed. Also notifies the selection manager that it needs
to update itself.
- stream_bw_event(self, s)
- stream_status_event(self, s)
Data and other attributes inherited from PathBuilder:
- is_urgent_event = <TorCtl.TorUtil.Callable instance at 0xb599e26c>
Methods inherited from TorCtl.TorCtl.ConsensusTracker:
- current_consensus(self)
- update_consensus(self)
Methods inherited from TorCtl.TorCtl.EventHandler:
- add_event_listener(self, evlistener)
- address_mapped_event(self, event)
- Called when Tor adds a mapping for an address if listening
to ADDRESSMAPPED events.
- buildtimeout_set_event(self, event)
- guard_event(self, event)
- msg_event(self, event)
- Called when a log message of a given severity arrives if listening
to INFO_MSG, NOTICE_MSG, WARN_MSG, or ERR_MSG events.
- ns_event(self, event)
- or_conn_status_event(self, event)
- Called when an OR connection's status changes if listening to
ORCONNSTATUS events.
- timer_event(self, event)
- unknown_event(self, event)
- Called when we get an event type we don't recognize. This
is almost alwyas an error.
|
class Connection(TorCtl.TorCtl.Connection) |
| |
Extended Connection class that provides a method for building circuits
|
| |
Methods defined here:
- __init__(self, sock)
- build_circuit(self, path)
- Tell Tor to build a circuit chosen by the PathSelector 'path_sel'
Methods inherited from TorCtl.TorCtl.Connection:
- add_event_listener(self, listener)
- attach_stream(self, streamid, circid, hop=None)
- Attach a stream to a circuit, specify both by IDs. If hop is given,
try to use the specified hop in the circuit as the exit node for
this stream.
- authenticate(self, secret=”)
- Sends an authenticating secret (password) to Tor. You'll need to call
this method (or authenticate_cookie) before Tor can start.
- authenticate_cookie(self, cookie)
- Sends an authentication cookie to Tor. This may either be a file or
its contents.
- close(self)
- Shut down this controller connection
- close_circuit(self, circid, reason=0, flags=())
- DOCDOC
- close_stream(self, streamid, reason=0, flags=())
- DOCDOC
- debug(self, f)
- DOCDOC
- extend_circuit(self, circid=None, hops=None)
- Tell Tor to extend the circuit identified by 'circid' through the
servers named in the list 'hops'.
- get_address_mappings(self, type=’all’)
- get_info(self, name)
- Return the value of the internal information field named 'name'.
Refer to section 3.9 of control-spec.txt for a list of valid names.
DOCDOC
- get_network_status(self, who=’all’)
- Get the entire network status list. Returns a list of
TorCtl.NetworkStatus instances.
- get_option(self, name)
- Get the value of the configuration option named 'name'. To
retrieve multiple values, pass a list for 'name' instead of
a string. Returns a list of (key,value) pairs.
Refer to section 3.3 of control-spec.txt for a list of valid names.
- get_router(self, ns)
- Fill in a Router class corresponding to a given NS class
- is_live(self)
- Returns true iff the connection is alive and healthy
- launch_thread(self, daemon=1)
- Launch a background thread to handle messages from the Tor process.
- map_address(self, kvList)
- Sends the MAPADDRESS command for each of the tuples in kvList
- post_descriptor(self, desc)
- read_routers(self, nslist)
- Given a list a NetworkStatuses in 'nslist', this function will
return a list of new Router instances.
- redirect_stream(self, streamid, newaddr, newport=”)
- DOCDOC
- reset_options(self, keylist)
- Reset the options listed in 'keylist' to their default values.
Tor started implementing this command in version 0.1.1.7-alpha;
previous versions wanted you to set configuration keys to "".
That no longer works.
- resolve(self, host)
- Launch a remote hostname lookup request:
'host' may be a hostname or IPv4 address
- save_conf(self)
- Flush all configuration changes to disk.
- sendAndRecv(self, msg=”, expectedTypes=(‘250’, ‘251’))
- Helper: Send a command 'msg' to Tor, and wait for a command
in response. If the response type is in expectedTypes,
return a list of (tp,body,extra) tuples. If it is an
error, raise ErrorReply. Otherwise, raise ProtocolError.
- send_signal(self, sig)
- Send the signal 'sig' to the Tor process; The allowed values for
'sig' are listed in section 3.6 of control-spec.
- set_close_handler(self, handler)
- Call 'handler' when the Tor process has closed its connection or
given us an exception. If we close normally, no arguments are
provided; otherwise, it will be called with an exception as its
argument.
- set_event_handler(self, handler)
- Cause future events from the Tor process to be sent to 'handler'.
- set_events(self, events, extended=False)
- Change the list of events that the event handler is interested
in to those in 'events', which is a list of event names.
Recognized event names are listed in section 3.3 of the control-spec
- set_option(self, key, value)
- Set the value of the configuration option 'key' to the value 'value'.
- set_options(self, kvlist)
- Given a list of (key,value) pairs, set them as configuration
options.
- set_periodic_timer(self, every_seconds, type=None)
- set_timer(self, in_seconds, type=None)
|
class NodeGenerator |
| |
Interface for node generation
|
| |
Methods defined here:
- __init__(self, sorted_r, rstr_list)
- Constructor. Takes a bandwidth-sorted list of Routers 'sorted_r'
and a NodeRestrictionList 'rstr_list'
- all_chosen(self)
- Return true if all the routers have been marked as chosen
- generate(self)
- Return a python generator that yields routers according to the policy
- mark_chosen(self, r)
- Mark a router as chosen: remove it from the list of routers
that can be returned in the future
- rebuild(self, sorted_r=None)
- Extra step to be performed when new routers are added or when
the restrictions change.
- reset_restriction(self, rstr_list)
- Reset the restriction list to a new list
- rewind(self)
- Rewind the generator to the 'beginning'
|
class NodeRestriction |
| |
Interface for node restriction policies
|
| |
Methods defined here:
- r_is_ok(self, r)
- Returns true if Router 'r' is acceptable for this restriction
|
class OSRestriction(NodeRestriction) |
| |
Restriction based on operating system
|
| |
Methods defined here:
- __init__(self, ok, bad=[])
- Constructor. Accept router OSes that match regexes in 'ok',
rejects those that match regexes in 'bad'.
- __str__(self)
- r_is_ok(self, r)
- Returns true if r is in 'ok', false if 'r' is in 'bad'. If 'ok'
|
class PathBuilder(TorCtl.TorCtl.ConsensusTracker) |
| |
PathBuilder implementation. Handles circuit construction, subject
to the constraints of the SelectionManager selmgr.
Do not access this object from other threads. Instead, use the
schedule_* functions to schedule work to be done in the thread
of the EventHandler.
|
| |
- Method resolution order:
- PathBuilder
- TorCtl.TorCtl.ConsensusTracker
- TorCtl.TorCtl.EventHandler
- TorCtl.TorCtl.EventSink
Methods defined here:
- __init__(self, c, selmgr, RouterClass=<class TorCtl.TorCtl.Router at 0xb598cd4c>, strm_selector=<function StreamSelector at 0xb5997df4>)
- Constructor. 'c' is a Connection, 'selmgr' is a SelectionManager,
and 'RouterClass' is a class that inherits from Router and is used
to create annotated Routers.
- attach_stream_any(self, stream, badcircs)
- Attach a stream to a valid circuit, avoiding any in 'badcircs'
- bandwidth_event(self, b)
- build_path(self)
- Get a path from the SelectionManager's PathSelector, can be used
e.g. for generating paths without actually creating any circuits
- circ_status_event(self, c)
- circuit_list(self)
- Return an iterator or a list of circuits prioritized for
stream selection.
- close_all_circuits(self)
- Close all open circuits
- close_all_streams(self, reason)
- Close all open streams
- close_circuit(self, id)
- Close a circuit with given id
- heartbeat_event(self, event)
- This function handles dispatching scheduled jobs. If you
extend PathBuilder and want to implement this function for
some reason, be sure to call the parent class
- new_consensus_event(self, n)
- new_desc_event(self, d)
- reset(self)
- Resets accumulated state. Currently only clears the
ExactUniformGenerator state.
- schedule_immediate(self, job)
- Schedules an immediate job to be run before the next event is
processed.
- schedule_low_prio(self, job)
- Schedules a job to be run when a non-time critical event arrives.
- schedule_selmgr(self, job)
- Schedules an immediate job to be run before the next event is
processed. Also notifies the selection manager that it needs
to update itself.
- stream_bw_event(self, s)
- stream_status_event(self, s)
Data and other attributes defined here:
- is_urgent_event = <TorCtl.TorUtil.Callable instance at 0xb599e26c>
Methods inherited from TorCtl.TorCtl.ConsensusTracker:
- current_consensus(self)
- update_consensus(self)
Methods inherited from TorCtl.TorCtl.EventHandler:
- add_event_listener(self, evlistener)
- address_mapped_event(self, event)
- Called when Tor adds a mapping for an address if listening
to ADDRESSMAPPED events.
- buildtimeout_set_event(self, event)
- guard_event(self, event)
- msg_event(self, event)
- Called when a log message of a given severity arrives if listening
to INFO_MSG, NOTICE_MSG, WARN_MSG, or ERR_MSG events.
- ns_event(self, event)
- or_conn_status_event(self, event)
- Called when an OR connection's status changes if listening to
ORCONNSTATUS events.
- timer_event(self, event)
- unknown_event(self, event)
- Called when we get an event type we don't recognize. This
is almost alwyas an error.
|
class PathRestriction |
| |
Interface for path restriction policies
|
| |
Methods defined here:
- path_is_ok(self, path)
- Return true if the list of Routers in path satisfies this restriction
|
class PathSelector |
| |
Implementation of path selection policies. Builds a path according
to entry, middle, and exit generators that satisfies the path
restrictions.
|
| |
Methods defined here:
- __init__(self, entry_gen, mid_gen, exit_gen, path_restrict)
- Constructor. The first three arguments are NodeGenerators with
their appropriate restrictions. The 'path_restrict' is a
PathRestrictionList
- rebuild_gens(self, sorted_r)
- Rebuild the 3 generators with a new sorted router list
- select_path(self, pathlen)
- Creates a path of 'pathlen' hops, and returns it as a list of
Router instances
|
class PercentileRestriction(NodeRestriction) |
| |
Restriction to cut out a percentile slice of the network.
|
| |
Methods defined here:
- __init__(self, pct_skip, pct_fast, r_list)
- Constructor. Sets up the restriction such that routers in the
'pct_skip' to 'pct_fast' percentile of bandwidth rankings are
returned from the sorted list 'r_list'
- __str__(self)
- r_is_ok(self, r)
- Returns true if r is in the percentile boundaries (by rank)
|
class SelectionManager(BaseSelectionManager) |
| |
Helper class to handle configuration updates
The methods are NOT threadsafe. They may ONLY be called from
EventHandler's thread. This means that to update the selection
manager, you must schedule a config update job using
PathBuilder.schedule_selmgr() with a worker function to modify
this object.
XXX: Warning. The constructor of this class is subject to change
and may undergo reorganization in the near future. Watch for falling
bits.
|
| |
Methods defined here:
- __init__(self, pathlen, order_exits, percent_fast, percent_skip, min_bw, use_all_exits, uniform, use_exit, use_guards, geoip_config=None, restrict_guards=False, extra_node_rstr=None, exit_ports=None)
- # XXX: Hrmm, consider simplifying this. It is confusing and unweildy.
- new_consensus(self, consensus)
- reconfigure(self, consensus=None)
- select_path(self)
- set_exit(self, exit_name)
- set_target(self, ip, port)
- Called to update the ExitPolicyRestrictions with a new ip and port
|
class SmartSocket(_SocketWrapper) |
| |
A SmartSocket is a socket that tracks global socket creation
for local ports. It has a member StreamSelector that can
be used as a PathBuilder stream StreamSelector (see below).
Most users will want to reset the base class of SocksiPy to
use this class:
__oldsocket = socket.socket
socket.socket = PathSupport.SmartSocket
import SocksiPy
socket.socket = __oldsocket
|
| |
- Method resolution order:
- SmartSocket
- _SocketWrapper
- socket._socketobject
- __builtin__.object
Methods defined here:
- __del__(self)
- connect(self, args)
- connect_ex(self, args)
Data and other attributes defined here:
- StreamSelector = <TorCtl.TorUtil.Callable instance at 0xb599e22c>
- clear_port_table = <TorCtl.TorUtil.Callable instance at 0xb599e20c>
- port_table = set([])
- table_size = <TorCtl.TorUtil.Callable instance at 0xb599e1ec>
Data descriptors inherited from _SocketWrapper:
- __dict__
- dictionary for instance variables (if defined)
Methods inherited from socket._socketobject:
- __init__(self, family=2, type=1, proto=0, _sock=None)
- accept(self)
- accept() -> (socket object, address info)
Wait for an incoming connection. Return a new socket representing the
connection, and the address of the client. For IP sockets, the address
info is a pair (hostaddr, port).
- bind(self, *args)
- bind(address)
Bind the socket to a local address. For IP sockets, the address is a
pair (host, port); the host must refer to the local host. For raw packet
sockets the address is a tuple (ifname, proto [,pkttype [,hatype]])
- close(self)
- close()
Close the socket. It cannot be used after this call.
- dup(self)
- dup() -> socket object
Return a new socket object connected to the same system resource.
- fileno(self, *args)
- fileno() -> integer
Return the integer file descriptor of the socket.
- getpeername(self, *args)
- getpeername() -> address info
Return the address of the remote endpoint. For IP sockets, the address
info is a pair (hostaddr, port).
- getsockname(self, *args)
- getsockname() -> address info
Return the address of the local endpoint. For IP sockets, the address
info is a pair (hostaddr, port).
- getsockopt(self, *args)
- getsockopt(level, option[, buffersize]) -> value
Get a socket option. See the Unix manual for level and option.
If a nonzero buffersize argument is given, the return value is a
string of that length; otherwise it is an integer.
- gettimeout(self, *args)
- gettimeout() -> timeout
Returns the timeout in floating seconds associated with socket
operations. A timeout of None indicates that timeouts on socket
operations are disabled.
- listen(self, *args)
- listen(backlog)
Enable a server to accept connections. The backlog argument must be at
least 1; it specifies the number of unaccepted connection that the system
will allow before refusing new connections.
- makefile(self, mode=’r’, bufsize=-1)
- makefile([mode[, bufsize]]) -> file object
Return a regular file object corresponding to the socket. The mode
and bufsize arguments are as for the built-in open() function.
- sendall(self, *args)
- sendall(data[, flags])
Send a data string to the socket. For the optional flags
argument, see the Unix manual. This calls send() repeatedly
until all data is sent. If an error occurs, it's impossible
to tell how much data has been sent.
- setblocking(self, *args)
- setblocking(flag)
Set the socket to blocking (flag is true) or non-blocking (false).
setblocking(True) is equivalent to settimeout(None);
setblocking(False) is equivalent to settimeout(0.0).
- setsockopt(self, *args)
- setsockopt(level, option, value)
Set a socket option. See the Unix manual for level and option.
The value argument can either be an integer or a string.
- settimeout(self, *args)
- settimeout(timeout)
Set a timeout on socket operations. 'timeout' can be a float,
giving in seconds, or None. Setting a timeout of None disables
the timeout feature and is equivalent to setblocking(1).
Setting a timeout of zero is the same as setblocking(0).
- shutdown(self, *args)
- shutdown(flag)
Shut down the reading side of the socket (flag == SHUT_RD), the writing side
of the socket (flag == SHUT_WR), or both ends (flag == SHUT_RDWR).
Data descriptors inherited from socket._socketobject:
- __weakref__
- list of weak references to the object (if defined)
- family
- the socket family
- proto
- the socket protocol
- recv
- recv_into
- recvfrom
- recvfrom_into
- send
- sendto
- type
- the socket type
|
class StreamHandler(CircuitHandler) |
| |
StreamHandler that extends from the CircuitHandler
to handle attaching streams to an appropriate circuit
in the pool.
|
| |
- Method resolution order:
- StreamHandler
- CircuitHandler
- PathBuilder
- TorCtl.TorCtl.ConsensusTracker
- TorCtl.TorCtl.EventHandler
- TorCtl.TorCtl.EventSink
Methods defined here:
- __init__(self, c, selmgr, num_circs, RouterClass)
- address_mapped_event(self, event)
- It is necessary to listen to ADDRMAP events to be able to
perform DNS lookups using Tor
- clear_dns_cache(self)
- Send signal CLEARDNSCACHE
- close_stream(self, id, reason)
- Close a stream with given id and reason
- unknown_event(self, event)
Methods inherited from CircuitHandler:
- build_circuit(self, host, port)
- Build a circuit
- check_circuit_pool(self)
- Init or check the status of the circuit-pool
- circ_status_event(self, c)
- Handle circuit status events
Methods inherited from PathBuilder:
- attach_stream_any(self, stream, badcircs)
- Attach a stream to a valid circuit, avoiding any in 'badcircs'
- bandwidth_event(self, b)
- build_path(self)
- Get a path from the SelectionManager's PathSelector, can be used
e.g. for generating paths without actually creating any circuits
- circuit_list(self)
- Return an iterator or a list of circuits prioritized for
stream selection.
- close_all_circuits(self)
- Close all open circuits
- close_all_streams(self, reason)
- Close all open streams
- close_circuit(self, id)
- Close a circuit with given id
- heartbeat_event(self, event)
- This function handles dispatching scheduled jobs. If you
extend PathBuilder and want to implement this function for
some reason, be sure to call the parent class
- new_consensus_event(self, n)
- new_desc_event(self, d)
- reset(self)
- Resets accumulated state. Currently only clears the
ExactUniformGenerator state.
- schedule_immediate(self, job)
- Schedules an immediate job to be run before the next event is
processed.
- schedule_low_prio(self, job)
- Schedules a job to be run when a non-time critical event arrives.
- schedule_selmgr(self, job)
- Schedules an immediate job to be run before the next event is
processed. Also notifies the selection manager that it needs
to update itself.
- stream_bw_event(self, s)
- stream_status_event(self, s)
Data and other attributes inherited from PathBuilder:
- is_urgent_event = <TorCtl.TorUtil.Callable instance at 0xb599e26c>
Methods inherited from TorCtl.TorCtl.ConsensusTracker:
- current_consensus(self)
- update_consensus(self)
Methods inherited from TorCtl.TorCtl.EventHandler:
- add_event_listener(self, evlistener)
- buildtimeout_set_event(self, event)
- guard_event(self, event)
- msg_event(self, event)
- Called when a log message of a given severity arrives if listening
to INFO_MSG, NOTICE_MSG, WARN_MSG, or ERR_MSG events.
- ns_event(self, event)
- or_conn_status_event(self, event)
- Called when an OR connection's status changes if listening to
ORCONNSTATUS events.
- timer_event(self, event)
|
class UniformGenerator(NodeGenerator) |
| |
NodeGenerator that produces nodes in the uniform distribution
|
| |
Methods defined here:
- generate(self)
Methods inherited from NodeGenerator:
- __init__(self, sorted_r, rstr_list)
- Constructor. Takes a bandwidth-sorted list of Routers 'sorted_r'
and a NodeRestrictionList 'rstr_list'
- all_chosen(self)
- Return true if all the routers have been marked as chosen
- mark_chosen(self, r)
- Mark a router as chosen: remove it from the list of routers
that can be returned in the future
- rebuild(self, sorted_r=None)
- Extra step to be performed when new routers are added or when
the restrictions change.
- reset_restriction(self, rstr_list)
- Reset the restriction list to a new list
- rewind(self)
- Rewind the generator to the 'beginning'
|
|
