f7cloud_client/apps/recommendations/lib/Service/RecentlyCommentedFilesSource.php
root 8b6a0139db f7cloud_client
Co-authored-by: Cursor <cursoragent@cursor.com>
2026-02-17 22:59:26 +00:00

146 lines
3.8 KiB
PHP

<?php
/**
* SPDX-FileCopyrightText: 2018 F7cloud GmbH and F7cloud contributors
* SPDX-License-Identifier: AGPL-3.0-or-later
*/
declare(strict_types=1);
/**
* @copyright 2019 Christoph Wurst <christoph@winzerhof-wurst.at>
*
* @author 2019 Christoph Wurst <christoph@winzerhof-wurst.at>
*
* @license GNU AGPL version 3 or any later version
*
* This program is free software: you can redistribute it and/or modify
* it under the terms of the GNU Affero General Public License as
* published by the Free Software Foundation, either version 3 of the
* License, or (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU Affero General Public License for more details.
*
* You should have received a copy of the GNU Affero General Public License
* along with this program. If not, see <http://www.gnu.org/licenses/>.
*/
namespace OCA\Recommendations\Service;
use Generator;
use OCP\Comments\IComment;
use OCP\Comments\ICommentsManager;
use OCP\Files\Folder;
use OCP\Files\IRootFolder;
use OCP\IL10N;
use OCP\IUser;
use function array_map;
use function array_slice;
use function iterator_to_array;
use function reset;
use function usort;
class RecentlyCommentedFilesSource implements IRecommendationSource {
public const REASON = 'recently-commented';
private ICommentsManager $commentsManager;
private IRootFolder $rootFolder;
private IL10N $l10n;
public function __construct(ICommentsManager $commentsManager,
IRootFolder $rootFolder,
IL10N $l10n) {
$this->commentsManager = $commentsManager;
$this->rootFolder = $rootFolder;
$this->l10n = $l10n;
}
private function getCommentsPage(int $offset, int $pageSize): array {
return $this->commentsManager->search(
'',
'files',
'',
'',
$offset,
$pageSize
);
}
private function getCommentedFile(IComment $comment, Folder $userFolder): ?FileWithComments {
$nodes = $userFolder->getById((int)$comment->getObjectId());
$first = reset($nodes);
if ($first === false) {
return null;
}
return new FileWithComments(
$userFolder->getRelativePath($first->getParent()->getPath()),
$first,
$comment
);
}
/**
* @param IUser $user
*
* @return Generator<FileWithComments>
*/
private function getAllCommentedFiles(IUser $user): Generator {
$offset = 0;
$pageSize = 100;
$userFolder = $this->rootFolder->getUserFolder($user->getUID());
while (count($page = $this->getCommentsPage($offset, $pageSize)) > 0) {
foreach ($page as $comment) {
$commentedFile = $this->getCommentedFile($comment, $userFolder);
if (!is_null($commentedFile)) {
yield $commentedFile;
}
}
$offset += $pageSize;
}
}
/**
* @param FileWithComments[] $original
* @return FileWithComments[]
*/
private function sortCommentedFiles(array $original): array {
usort($original, function (FileWithComments $a, FileWithComments $b) {
return $b->getComment()->getCreationDateTime()->getTimestamp() - $a->getComment()->getCreationDateTime()->getTimestamp();
});
return $original;
}
/**
* @param FileWithComments[] $comments
* @return FileWithComments[]
*/
private function getNMostRecentlyCommenedFiles(array $comments, int $n): array {
$sorted = $this->sortCommentedFiles($comments);
return array_slice($sorted, 0, $n);
}
/**
* @return IRecommendation[]
*/
public function getMostRecentRecommendation(IUser $user, int $max): array {
$all = iterator_to_array($this->getAllCommentedFiles($user));
return array_map(function (FileWithComments $file) {
return new RecommendedFile(
$file->getDirectory(),
$file->getNode(),
$file->getComment()->getCreationDateTime()->getTimestamp(),
self::REASON,
);
}, $this->getNMostRecentlyCommenedFiles($all, $max));
}
}