* [task#125033,doing,0.3h] adjust yearly statistic file for commits.

2024-08-07 16:12:22 +08:00
parent 892078f951
commit fda0e961a2
1 changed files with 131 additions and 0 deletions
@@ -0,0 +1,131 @@
+<?php
+/**
+ * 按代码库统计的每年代码提交次数。
+ * Count of yearly commits in codebase.
+ *
+ * 范围：repo
+ * 对象：commit
+ * 目的：scale
+ * 度量名称：按代码库统计的年度代码提交次数
+ * 单位：个
+ * 描述：按代码库统计的的年度代码提交次数是指代码库在某个年度的代码提交数量。这个度量项可以反映代码库的年度开发活动频率和代码更新情况。
+ * 定义：代码库中代码提交次数求和，提交时间为某年。
+ *
+ * @copyright Copyright 2009-2024 禅道软件（青岛）有限公司(ZenTao Software (Qingdao) Co., Ltd. www.zentao.net)
+ * @author    Yanyi Cao <caoyanyi@chandao.com>
+ * @package
+ * @uses      func
+ * @license   ZPL(https://zpl.pub/page/zplv12.html) or AGPL(https://www.gnu.org/licenses/agpl-3.0.en.html)
+ * @Link      https://www.zentao.net
+ */
+class count_of_yearly_code_commits_in_codebase extends baseCalc
+{
+    public $useSCM = true;
+
+    public $dataset = 'getRepoCommits';
+
+    public $fieldList = array('t1.id', 't1.name', 't1.serviceHost', 't1.serviceProject', 't1.SCM', 't2.time', 't1.client', 't1.path', 't1.account', 't1.password', 't1.encoding', 't3.url', 't3.token');
+
+    public $result = array();
+
+    public $rows = array();
+
+    public $apiPath = array(
+        'Gitlab' => '%s/api/v4/projects/%s/repository/',
+        'GitFox' => '%s/api/v1/repos/%s/+/'
+    );
+
+    /**
+     * 通过API获取提交次数。
+     * Get commits by API.
+     *
+     * @param  object $repo
+     * @param  string $begin
+     * @param  string $end
+     * @access public
+     * @return object
+     */
+    public function getCommitCount($repo, $begin, $end)
+    {
+        if(isset($this->result[$repo->id])) return false;
+
+        $repo->client   = '';
+        $repo->account  = '';
+        $repo->encoding = 'utf-8';
+        $repo->password = $repo->token;
+        $repo->apiPath  = sprintf($this->apiPath[$repo->SCM], $repo->url, $repo->serviceProject);
+        $this->scm->setEngine($repo);
+
+        $commits = $this->scm->getCommitByDate($begin, $end);
+        foreach($commits as $commit)
+        {
+            $commit->id = $repo->id;
+            $this->setResult($commit);
+        }
+    }
+
+    /**
+     * 设置结果集。
+     * Set result set.
+     *
+     * @param  object $row
+     * @access public
+     * @return void
+     */
+    public function setResult($row)
+    {
+        $date = substr($row->time, 0, 10);
+        list($year, $month, $day) = explode('-', $date);
+
+        if(!isset($this->result[$row->id]))        $this->result[$row->id] = array();
+        if(!isset($this->result[$row->id][$year])) $this->result[$row->id][$year] = array();
+
+        $this->result[$row->id][$year] ++;
+    }
+
+    /**
+     * 计算并保存结果。
+     * Calculate and save result.
+     *
+     * @param  object $row
+     * @access public
+     * @return void
+     */
+    public function calculate($row)
+    {
+        $this->rows[] = $row;
+    }
+
+    /**
+     * 获取结果。
+     * Get result.
+     *
+     * @param  array  $options
+     * @access public
+     * @return void
+     */
+    public function getResult($options = array())
+    {
+        $year  = (int)$options['year'];
+        $month = (int)$options['month'];
+        $day   = $options['day'];
+
+        list($begin, $end) = explode(',', $day);
+        $begin = "{$year}-{$month}-{$begin}";
+        $end   = "{$year}-{$month}-{$end} 23:59:59";
+
+        foreach($this->rows as $row)
+        {
+            if(in_array($row->SCM, array('Gitlab', 'GitFox')))
+            {
+                if(isset($this->result[$row->id])) continue;
+
+                $this->getCommitCount($row, $begin, $end);
+                continue;
+            }
+
+            $this->setResult($row);
+        }
+        return $this->getRecords(array('repo', 'year'));
+    }
+}