Files
archived-doc-base/scripts/translation/lib/RevcheckFileItem.php
2024-12-22 01:01:21 +01:00

78 lines
2.8 KiB
PHP

<?php
/**
* +----------------------------------------------------------------------+
* | Copyright (c) 1997-2023 The PHP Group |
* +----------------------------------------------------------------------+
* | This source file is subject to version 3.01 of the PHP license, |
* | that is bundled with this package in the file LICENSE, and is |
* | available through the world-wide-web at the following url: |
* | https://www.php.net/license/3_01.txt. |
* | If you did not receive a copy of the PHP license and are unable to |
* | obtain it through the world-wide-web, please send a note to |
* | license@php.net, so we can mail you a copy immediately. |
* +----------------------------------------------------------------------+
* | Authors: André L F S Bacci <ae php.net> |
* +----------------------------------------------------------------------+
* | Description: General data of a file in a documentation tree. |
* +----------------------------------------------------------------------+
*/
require_once __DIR__ . '/all.php';
class RevcheckFileItem
{
public string $file = ""; // from fs
public int $size = 0 ; // from fs
public int $date = 0 ; // from vcs, source only, date of head or diff commit
public string $hashLast = ""; // derived by addGitLogData
public string $hashDiff = ""; // derived by addGitLogData, isSyncHash
public RevcheckStatus $status; // target only
public RevtagInfo|null $revtag; // target only
private array $hashList; // source only
private bool $hashStop; // source only
function __construct( string $file , int $size )
{
$this->file = $file;
$this->size = $size;
$this->date = 0;
$this->status = RevcheckStatus::Untranslated;
$this->revtag = null;
$this->hashList = [];
$this->hashStop = false;
}
public function addGitLogData( string $hash , string $date , bool $skip ) : void
{
// Accumulates valid hashes for RevcheckStatus::TranslatedOk status.
// This includes topmost runs of [skip-revcheck] tags and one normal,
// unmarked hash. Stop after first normal hash is found.
if ( $this->hashStop )
return;
$this->hashList[] = $hash;
if ( $this->hashLast == "" )
{
$this->date = $date;
$this->hashLast = $hash;
}
if ( $skip )
$this->hashDiff = $hash;
else
$this->hashStop = true;
}
public function isSyncHash( $hash ) : bool
{
$sync = in_array( $hash , $this->hashList );
if ( $sync )
$this->hashDiff = $hash;
return $sync;
}
}