Server : Apache System : Linux server2.corals.io 4.18.0-348.2.1.el8_5.x86_64 #1 SMP Mon Nov 15 09:17:08 EST 2021 x86_64 User : corals ( 1002) PHP Version : 7.4.33 Disable Function : exec,passthru,shell_exec,system Directory :  /home/corals/old/vendor/sebastianfeldmann/git/src/Command/Log/

Upload File : current_dir [ Writeable ] document_root [ Writeable ]

<?php

/**
 * This file is part of SebastianFeldmann\Git.
 *
 * (c) Sebastian Feldmann <[email protected]>
 *
 * For the full copyright and license information, please view the LICENSE
 * file that was distributed with this source code.
 */

namespace SebastianFeldmann\Git\Command\Log;

use SebastianFeldmann\Git\Command\Base;

/**
 * Class Log
 *
 * @package SebastianFeldmann\Git
 * @author  Sebastian Feldmann <[email protected]>
 * @link    https://github.com/sebastianfeldmann/git
 * @since   Class available since Release 0.9.0
 */
abstract class Log extends Base
{
    /**
     * Pretty log format.
     * --pretty
     *
     * @var string
     */
    protected string $format = '%h -%d %s (%ci) <%an>';

    /**
     * Diff filter types
     * --diff-filter
     *
     * @var string
     */
    protected string $diffFilter = '';

    /**
     * Include or hide merge commits.
     * --no-merges
     *
     * @var string
     */
    protected string $merges = ' --no-merges';


    /**
     * Set min and max date
     * --before --after
     *
     * @var string
     */
    protected string $date = '';

    /**
     * Shorten commit hashes.
     * --abbrev-commit
     *
     * @var string
     */
    protected string $abbrev = ' --abbrev-commit';

    /**
     * Can be revision or date query.
     *  1.0.0..
     *  0.9.0..1.2.0
     *  --after='2016-12-31'
     *  --after='2016-12-31' --before='2017-01-31'
     *
     * @var string
     */
    protected string $revSelection = '';

    /**
     * Filter log by author.
     * --author
     *
     * @var string
     */
    protected string $author = '';

    /**
     * Define the pretty log format.
     *
     * @param  string $format
     * @return \SebastianFeldmann\Git\Command\Log\Log
     */
    public function prettyFormat(string $format): Log
    {
        $this->format = $format;
        return $this;
    }

    /**
     * Set the diff filter
     *
     * @param array<string> $filter
     * @return $this
     */
    public function withDiffFilter(array $filter): Log
    {
        $this->diffFilter = empty($filter) ? '' : ' --diff-filter=' . implode('', $filter);
        return $this;
    }

    /**
     * Define merge commit behaviour.
     *
     * @param  bool $bool
     * @return \SebastianFeldmann\Git\Command\Log\Log
     */
    public function withMerges(bool $bool = true): Log
    {
        $this->merges = ($bool ? '' : ' --no-merges');
        return $this;
    }

    /**
     * Define commit hash behaviour.
     *
     * @param  bool $bool
     * @return \SebastianFeldmann\Git\Command\Log\Log
     */
    public function abbrevCommit(bool $bool = true): Log
    {
        $this->abbrev = ($bool ? ' --abbrev--commit' : '');
        return $this;
    }

    /**
     * Set revision range.
     *
     *   REV..REV
     *   REV..    // meaning HASH..HEAD
     *
     * @param  string $from
     * @param  string $to
     * @return \SebastianFeldmann\Git\Command\Log\Log
     */
    public function byRange(string $from, string $to = ''): Log
    {
        $this->revSelection = ' ' . escapeshellarg($from) . '..'
                              . (empty($to) ? '' : escapeshellarg($to));
        return $this;
    }

    /**
     * Set list of revisions to check
     *
     * @param string ...$revisions
     * @return $this
     */
    public function byRevisions(string ...$revisions): Log
    {
        $this->revSelection = implode(' ', $revisions);
        return $this;
    }

    /**
     * Set author filter.
     *
     * @param  string $author
     * @return \SebastianFeldmann\Git\Command\Log\Log
     */
    public function authoredBy(string $author): Log
    {
        $this->author = ' --author=' . escapeshellarg($author);
        return $this;
    }

    /**
     * Set date range.
     *
     * @param  string $from
     * @param  string $to
     * @return \SebastianFeldmann\Git\Command\Log\Log
     */
    public function byDate(string $from, string $to = ''): Log
    {
        $this->date = ' --after=' . escapeshellarg($from)
                              . (empty($to) ? '' : ' --before=' . escapeshellarg($to));
        return $this;
    }
}