Lease Validator¶
Lease validator tracks lease usage in intermediate services.
-
class
bosdyn.client.lease_validator.
LeaseValidator
(robot)[source]¶ Bases:
object
Lease validator tracks lease usage in intermediate services.
Track the most recent leases seen for each lease resource and test incoming leases against this state.
- Parameters
robot (Robot) – The robot object for which leases are associated to.
-
get_active_lease
(resource)[source]¶ Get the latest active lease.
- Parameters
resource (string) – the resource for the specific lease to be returned.
- Returns
A Lease class object representing the most recent lease for the requested resource, or None if no lease has been seen.
-
test_active_lease
(incoming_lease, allow_super_leases, allow_different_epoch=False)[source]¶ Compare an incoming lease to the latest active lease.
- Parameters
incoming_lease (Lease object or lease_pb2.Lease) – The incoming lease to test.
allow_super_leases (boolean) – Should the comparison function consider a super lease as ok.
- Returns
The LeaseUseResult proto message representing if the incoming lease is ok.
-
test_and_set_active_lease
(incoming_lease, allow_super_leases, allow_different_epoch=False)[source]¶ Compare an incoming lease to the latest active lease, and if it is ok then set it as the latest lease.
- Parameters
incoming_lease (Lease object or lease_pb2.Lease) – The incoming lease to test.
allow_super_leases (boolean) – Should the comparison function consider a super lease as ok.
- Returns
The LeaseUseResult proto message representing if the incoming lease is ok. Additionally, if the result is STATUS_OK, then update the latest active lease to this incoming lease.