sbws.core package¶

Submodules¶

Util functions to cleanup disk space.

sbws.core.cleanup.gen_parser(sub)¶

Helper function for the broader argument parser generating code that adds in all the possible command line arguments for the cleanup command.

Parameters:	sub (argparse._SubParsersAction) – what to add a sub-parser to

sbws.core.cleanup.main(args, conf)¶

Main entry point in to the cleanup command.

Parameters:	args (argparse.Namespace) – command line arguments conf (configparser.ConfigParser) – parsed config files

Measure the relays.

sbws.core.scanner.get_random_range_string(content_length, size)¶

Return a random range of bytes of length size. content_length is the size of the file we will be requesting a range of bytes from.

For example, for content_length of 100 and size 10, this function will return one of the following: ‘0-9’, ‘1-10’, ‘2-11’, […] ‘89-98’, ‘90-99’

sbws.core.scanner.measure_bandwidth_to_server(session, conf, dest, content_length)¶

sbws.core.scanner.measure_relay(args, conf, destinations, cb, rl, relay)¶

sbws.core.scanner.measure_rtt_to_server(session, conf, dest, content_length)¶: Make multiple end-to-end RTT measurements by making small HTTP requests over a circuit + stream that should already exist, persist, and not need rebuilding. If something goes wrong and not all of the RTT measurements can be made, return None. Otherwise return a list of the RTTs (in seconds).

sbws.core.scanner.result_putter(result_dump)¶: Create a function that takes a single argument – the measurement result – and return that function so it can be used by someone else

sbws.core.scanner.result_putter_error(target)¶: Create a function that takes a single argument – an error from a measurement – and return that function so it can be used by someone else

sbws.core.scanner.timed_recv_from_server(session, dest, byte_range)¶: Request the byte_range from the URL at dest. If successful, return True and the time it took to download. Otherwise return False and an exception.

sbws.core.stats.gen_parser(sub)¶

Helper function for the broader argument parser generating code that adds in all the possible command line arguments for the stats command.

Parameters:	sub (argparse._SubParsersAction) – what to add a sub-parser to

sbws.core.stats.main(args, conf)¶

Main entry point into the stats command.

Parameters:	args (argparse.Namespace) – command line arguments conf (configparser.ConfigParser) – parsed config files

sbws.core.stats.print_stats(args, data)¶

Called from main to print various statistics about the organized data to stdout.

Parameters:	args (argparse.Namespace) – command line arguments data (dict) – keyed by relay fingerprint, and with values of `sbws.lib.resultdump.Result` subclasses