onbrisca.models package

Submodules

onbrisca.models.bridge module

class onbrisca.models.bridge.Bridge(*args, **kwargs)

Bases: BridgeBase

Bridge model that calculates and saves the stream ratio.

exception DoesNotExist

Bases: ObjectDoesNotExist

exception MultipleObjectsReturned

Bases: MultipleObjectsReturned

async asave(*args, **kwargs)

bridgeline

A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.

fingerprint

A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.

async helper_path(consensus: Consensus) → list

is_valid(ratio, ratio_threshold=0.9)

latest_measurement()

measurements

Accessor to the related objects manager on the reverse side of a many-to-one relation.

In the example:

class Child(Model):
    parent = ForeignKey(Parent, related_name='children')

Parent.children is a ReverseManyToOneDescriptor instance.

Most of the implementation is delegated to a dynamically defined manager class built by create_forward_many_to_many_manager() defined below.

objects = <onbrisca.models.bridge.BridgeManager object>

set_bw_filt()

set_bw_mean()

set_ratio()

set_ratio_filt(muf)

set_ratio_stream(mu)

set_ratios(mu, muf)

class onbrisca.models.bridge.BridgeManager(*args, **kwargs)

Bases: BridgeManagerBase

BridgeManager model for operations with all the bridges.

async acount()

bridgelines() → list

bridgelines_config() → dict

bridgelines_from_bridges(bridges) → list

Return a bridgelines list for the given set of bridges.

delete_invalid()

Delete the bridges in the database that have invalid bridgelines, so that they don’t fail to be set to tor configuration.

mu()

muf()

ordered()

onbrisca.models.bridge_heartbeat module

class onbrisca.models.bridge_heartbeat.BridgeHeartbeat(id, _obj_created_at, _obj_updated_at, loops_count, measured_count, measured_percent, previous_measured_percent, elapsed_time, _min_percent_relays_to_report_reached_at)

Bases: Heartbeat

exception DoesNotExist

Bases: DoesNotExist

exception MultipleObjectsReturned

Bases: MultipleObjectsReturned

log_status()

Print the new percentage of the different bridges that were measured.

This way it can be known whether the scanner is making progress measuring all the Network.

Log the percentage, the number of bridges measured and not measured, the number of loops and the time elapsed since it started measuring.

objects = <onbrisca.models.bridge_heartbeat.BridgeHeartbeatManager object>

class onbrisca.models.bridge_heartbeat.BridgeHeartbeatManager(*args, **kwargs)

Bases: BaseManager

onbrisca.models.bridge_measurement module

class onbrisca.models.bridge_measurement.BridgeMeasurement(id, _obj_created_at, _obj_updated_at, bridge, webserver, bandwidth, error)

Bases: BaseModel

exception DoesNotExist

Bases: ObjectDoesNotExist

exception MultipleObjectsReturned

Bases: MultipleObjectsReturned

async ameasure_bandwidth(http_client, bytes_range, size=16384)

async asave(*args, **kwargs)

bandwidth

A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.

bridge

Accessor to the related object on the forward side of a many-to-one or one-to-one (via ForwardOneToOneDescriptor subclass) relation.

In the example:

class Child(Model):
    parent = ForeignKey(Parent, related_name='children')

Child.parent is a ForwardManyToOneDescriptor instance.

bridge_id

error

A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.

async finish_with_error(error)

id

A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.

objects = <onbrisca.models.bridge_measurement.BridgeMeasurementManager object>

webserver

Accessor to the related object on the forward side of a many-to-one or one-to-one (via ForwardOneToOneDescriptor subclass) relation.

In the example:

class Child(Model):
    parent = ForeignKey(Parent, related_name='children')

Child.parent is a ForwardManyToOneDescriptor instance.

webserver_id

class onbrisca.models.bridge_measurement.BridgeMeasurementManager(*args, **kwargs)

Bases: BaseManager

onbrisca.models.bridge_scanner module

class onbrisca.models.bridge_scanner.BridgeScanner(*args, **kwargs)

Bases: Scanner

Singleton class that manages the measurers.

And initializes all the needed objects.

exception DoesNotExist

Bases: DoesNotExist

exception MultipleObjectsReturned

Bases: MultipleObjectsReturned

async ameasure_bridge(bridge: Bridge)

delete_old_objects(days=28)

handle_new_descriptor_event(event)

init(port=None, socket=None)

run()

scan()

async scan_bridge()

scan_bridges()

Module contents