class LockBackendAbstractTest

class LockBackendAbstractTest extends UnitTestCase {
  
  /**
   * The Mocked LockBackendAbstract object.
   */
  protected LockBackendAbstract&MockObject $lock;
  
  /**
   * {@inheritdoc}
   */
  protected function setUp() : void {
    parent::setUp();
    $this->lock = $this->getMockBuilder(StubLockBackendAbstract::class)
      ->onlyMethods([
      'lockMayBeAvailable',
    ])
      ->getMock();
  }
  
  /**
   * Tests the wait() method when lockMayBeAvailable() returns TRUE.
   */
  public function testWaitFalse() : void {
    $this->lock
      ->expects($this->any())
      ->method('lockMayBeAvailable')
      ->with($this->equalTo('test_name'))
      ->willReturn(TRUE);
    $this->assertFalse($this->lock
      ->wait('test_name'));
  }
  
  /**
   * Tests the wait() method when lockMayBeAvailable() returns FALSE.
   *
   * Waiting could take 1 second so we need to extend the possible runtime.
   */
  public function testWaitTrue() : void {
    $this->lock
      ->expects($this->any())
      ->method('lockMayBeAvailable')
      ->with($this->equalTo('test_name'))
      ->willReturn(FALSE);
    $this->assertTrue($this->lock
      ->wait('test_name', 1));
  }
  
  /**
   * Tests the getLockId() method.
   */
  public function testGetLockId() : void {
    $lock_id = $this->lock
      ->getLockId();
    $this->assertIsString($lock_id);
    // Example lock ID would be '7213141505232b6ee2cb967.27683891'.
    $this->assertMatchesRegularExpression('/[\\da-f]+\\.\\d+/', $lock_id);
    // Test the same lock ID is returned a second time.
    $this->assertSame($lock_id, $this->lock
      ->getLockId());
  }

}