Checkpoints Example

import time

import openhtf as htf
from openhtf.output.callbacks import console_summary
from openhtf.output.callbacks import json_factory
from openhtf.util import checkpoints


@htf.measures(htf.Measurement('hello_world_measurement'))
def hello_phase(test):
    test.measurements.hello_world_measurement = 'Hello!'


@htf.measures(
    htf.Measurement('fixed_time')
    .in_range(0, 10)
    .doc('This is going to fail validation.')
    .with_units(htf.units.SECOND)
)
def failing_phase(test):
    test.measurements.fixed_time = 20         # FAIL: 20 is outside 0..10


@htf.measures('first_measurement', 'second_measurement')
def lots_of_measurements(test):
    test.measurements.first_measurement = 'First!'
    test.measurements['second_measurement'] = 'Second :('


def long_running_phase(test):
    # A burn-in you do not want to run on a unit that already failed.
    for _ in range(10):
        test.logger.info('Still running....')
        time.sleep(10)
    test.logger.info('Done with long_running_phase')


def main():
    test = htf.Test(
        hello_phase,
        failing_phase,
        lots_of_measurements,
        checkpoints.checkpoint(),          # STOP here if any phase above failed
        long_running_phase,
    )
    test.add_output_callbacks(console_summary.ConsoleSummary())
    test.add_output_callbacks(json_factory.OutputToJSON('./checkpoints.json', indent=2))
    test.execute(test_start=lambda: 'MyDutId')


if __name__ == '__main__':
    main()

$ python checkpoints.py
openhtf_test:FAIL
failed phase: failing_phase [ran for 0.00 sec]
  failed_item: fixed_time (Outcome.FAIL)
    measured_value: 20
    validators:
      validator: 0 <= x <= 10

======================= test: openhtf_test  outcome: FAIL ======================