File: RevcheckFileItem.php

package info (click to toggle)
php-doc 20250827~git.abe740d%2Bdfsg-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 71,968 kB
  • sloc: xml: 985,760; php: 25,504; javascript: 671; sh: 177; makefile: 37
file content (77 lines) | stat: -rw-r--r-- 2,873 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
<?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;
    }
}