diff options
author | Morris Jobke <hey@morrisjobke.de> | 2021-05-25 17:54:06 +0300 |
---|---|---|
committer | GitHub <noreply@github.com> | 2021-05-25 17:54:06 +0300 |
commit | 726d01843e13529777b8a043f0ed997f1bf864dd (patch) | |
tree | 09c2ecac914e501cdb2be35e43bb8d67b1237562 /core/Command | |
parent | 0815be1ca85698bf571b8e907056274499226335 (diff) | |
parent | d606799ee2b3a6e11e616cd5606901754aa70c93 (diff) |
Merge pull request #26600 from hosting-de/feature/occ-tags
Add commands to manage tags via OCC
Diffstat (limited to 'core/Command')
-rw-r--r-- | core/Command/SystemTag/Add.php | 101 | ||||
-rw-r--r-- | core/Command/SystemTag/Delete.php | 64 | ||||
-rw-r--r-- | core/Command/SystemTag/Edit.php | 119 | ||||
-rw-r--r-- | core/Command/SystemTag/ListCommand.php | 85 |
4 files changed, 369 insertions, 0 deletions
diff --git a/core/Command/SystemTag/Add.php b/core/Command/SystemTag/Add.php new file mode 100644 index 00000000000..e16c0da126b --- /dev/null +++ b/core/Command/SystemTag/Add.php @@ -0,0 +1,101 @@ +<?php +/** + * @copyright Copyright (c) 2021, hosting.de, Johannes Leuker <developers@hosting.de> + * + * @author Johannes Leuker <developers@hosting.de> + * + * @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 OC\Core\Command\SystemTag; + +use OC\Core\Command\Base; +use OCP\SystemTag\ISystemTag; +use OCP\SystemTag\ISystemTagManager; +use OCP\SystemTag\TagAlreadyExistsException; +use Symfony\Component\Console\Input\InputArgument; +use Symfony\Component\Console\Input\InputInterface; +use Symfony\Component\Console\Output\OutputInterface; + +class Add extends Base { + + /** @var ISystemTagManager */ + protected $systemTagManager; + + public function __construct(ISystemTagManager $systemTagManager) { + $this->systemTagManager = $systemTagManager; + parent::__construct(); + } + + protected function configure() { + $this + ->setName('tag:add') + ->setDescription('Add new tag') + ->addArgument( + 'name', + InputArgument::REQUIRED, + 'name of the tag', + ) + ->addArgument( + 'access', + InputArgument::REQUIRED, + 'access level of the tag (public, restricted or invisible)', + ); + parent::configure(); + } + + protected function execute(InputInterface $input, OutputInterface $output): int { + $name = $input->getArgument('name'); + if ($name === '') { + $output->writeln('<error>`name` can\'t be empty</error>'); + return 3; + } + + switch ($input->getArgument('access')) { + case 'public': + $userVisible = true; + $userAssignable = true; + break; + case 'restricted': + $userVisible = true; + $userAssignable = false; + break; + case 'invisible': + $userVisible = false; + $userAssignable = false; + break; + default: + $output->writeln('<error>`access` property is invalid</error>'); + return 1; + } + + try { + $tag = $this->systemTagManager->createTag($name, $userVisible, $userAssignable); + + $this->writeArrayInOutputFormat($input, $output, + [ + 'id' => $tag->getId(), + 'name' => $tag->getName(), + 'access' => ISystemTag::ACCESS_LEVEL_LOOKUP[$tag->getAccessLevel()], + ]); + return 0; + } catch (TagAlreadyExistsException $e) { + $output->writeln('<error>'.$e->getMessage().'</error>'); + return 2; + } + } +} diff --git a/core/Command/SystemTag/Delete.php b/core/Command/SystemTag/Delete.php new file mode 100644 index 00000000000..cc06b7d513c --- /dev/null +++ b/core/Command/SystemTag/Delete.php @@ -0,0 +1,64 @@ +<?php +/** + * @copyright Copyright (c) 2021, hosting.de, Johannes Leuker <developers@hosting.de> + * + * @author Johannes Leuker <developers@hosting.de> + * + * @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 OC\Core\Command\SystemTag; + +use OC\Core\Command\Base; +use OCP\SystemTag\ISystemTagManager; +use OCP\SystemTag\TagNotFoundException; +use Symfony\Component\Console\Input\InputInterface; +use Symfony\Component\Console\Input\InputOption; +use Symfony\Component\Console\Output\OutputInterface; + +class Delete extends Base { + + /** @var ISystemTagManager */ + protected $systemTagManager; + + public function __construct(ISystemTagManager $systemTagManager) { + $this->systemTagManager = $systemTagManager; + parent::__construct(); + } + + protected function configure() { + $this + ->setName('tag:delete') + ->setDescription('delete a tag') + ->addArgument( + 'id', + InputOption::VALUE_REQUIRED, + 'The ID of the tag that should be deleted', + ); + } + + protected function execute(InputInterface $input, OutputInterface $output): int { + try { + $this->systemTagManager->deleteTags($input->getArgument('id')); + $output->writeln('<info>The specified tag was deleted</info>'); + return 0; + } catch (TagNotFoundException $e) { + $output->writeln('<error>Tag not found</error>'); + return 1; + } + } +} diff --git a/core/Command/SystemTag/Edit.php b/core/Command/SystemTag/Edit.php new file mode 100644 index 00000000000..8f58d08e2cf --- /dev/null +++ b/core/Command/SystemTag/Edit.php @@ -0,0 +1,119 @@ +<?php +/** + * @copyright Copyright (c) 2021, hosting.de, Johannes Leuker <developers@hosting.de> + * + * @author Johannes Leuker <developers@hosting.de> + * + * @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 OC\Core\Command\SystemTag; + +use OC\Core\Command\Base; +use OCP\SystemTag\ISystemTagManager; +use OCP\SystemTag\TagAlreadyExistsException; +use OCP\SystemTag\TagNotFoundException; +use Symfony\Component\Console\Input\InputInterface; +use Symfony\Component\Console\Input\InputOption; +use Symfony\Component\Console\Output\OutputInterface; + +class Edit extends Base { + + /** @var ISystemTagManager */ + protected $systemTagManager; + + /** + * @param ISystemTagManager $systemTagManager + */ + public function __construct(ISystemTagManager $systemTagManager) { + $this->systemTagManager = $systemTagManager; + parent::__construct(); + } + + protected function configure() { + $this + ->setName('tag:edit') + ->setDescription('edit tag attributes') + ->addArgument( + 'id', + InputOption::VALUE_REQUIRED, + 'The ID of the tag that should be deleted', + ) + ->addOption( + 'name', + null, + InputOption::VALUE_OPTIONAL, + 'sets the \'name\' parameter', + ) + ->addOption( + 'access', + null, + InputOption::VALUE_OPTIONAL, + 'sets the access control level (public, restricted, invisible)', + ); + } + + protected function execute(InputInterface $input, OutputInterface $output): int { + $tagArray = $this->systemTagManager->getTagsByIds($input->getArgument('id')); + // returns an array, but we always expect 0 or 1 results + + if (!$tagArray) { + $output->writeln('<error>Tag not found</error>'); + return 3; + } + + $tag = array_values($tagArray)[0]; + $name = $tag->getName(); + if (!empty($input->getOption('name'))) { + $name = $input->getOption('name'); + } + + $userVisible = $tag->isUserVisible(); + $userAssignable = $tag->isUserAssignable(); + if ($input->getOption('access')) { + switch ($input->getOption('access')) { + case 'public': + $userVisible = true; + $userAssignable = true; + break; + case 'restricted': + $userVisible = true; + $userAssignable = false; + break; + case 'invisible': + $userVisible = false; + $userAssignable = false; + break; + default: + $output->writeln('<error>`access` property is invalid</error>'); + return 1; + } + } + + try { + $this->systemTagManager->updateTag($input->getArgument('id'), $name, $userVisible, $userAssignable); + $output->writeln('<info>Tag updated ("' . $name . '", '. $userVisible . ', ' . $userAssignable . ')</info>'); + return 0; + } catch (TagNotFoundException $e) { + $output->writeln('<error>Tag not found</error>'); + return 1; + } catch (TagAlreadyExistsException $e) { + $output->writeln('<error>'.$e->getMessage().'</error>'); + return 2; + } + } +} diff --git a/core/Command/SystemTag/ListCommand.php b/core/Command/SystemTag/ListCommand.php new file mode 100644 index 00000000000..72ef1467f40 --- /dev/null +++ b/core/Command/SystemTag/ListCommand.php @@ -0,0 +1,85 @@ +<?php +/** + * @copyright Copyright (c) 2021, hosting.de, Johannes Leuker <developers@hosting.de> + * + * @author Johannes Leuker <developers@hosting.de> + * + * @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 OC\Core\Command\SystemTag; + +use OC\Core\Command\Base; +use OCP\SystemTag\ISystemTagManager; +use OCP\SystemTag\ISystemTag; +use Symfony\Component\Console\Input\InputInterface; +use Symfony\Component\Console\Input\InputOption; +use Symfony\Component\Console\Output\OutputInterface; + +class ListCommand extends Base { + + /** @var ISystemTagManager */ + protected $systemTagManager; + + public function __construct(ISystemTagManager $systemTagManager) { + $this->systemTagManager = $systemTagManager; + parent::__construct(); + } + + protected function configure() { + $this + ->setName('tag:list') + ->setDescription('list tags') + ->addOption( + 'visibilityFilter', + null, + InputOption::VALUE_OPTIONAL, + 'filter by visibility (1,0)' + ) + ->addOption( + 'nameSearchPattern', + null, + InputOption::VALUE_OPTIONAL, + 'optional search pattern for the tag name (infix)' + ); + parent::configure(); + } + + protected function execute(InputInterface $input, OutputInterface $output): int { + $tags = $this->systemTagManager->getAllTags( + $input->getOption('visibilityFilter'), + $input->getOption('nameSearchPattern') + ); + + $this->writeArrayInOutputFormat($input, $output, $this->formatTags($tags)); + return 0; + } + + /** + * @param ISystemtag[] $tags + * @return array + */ + private function formatTags(array $tags) { + foreach ($tags as $tag) { + $result[$tag->getId()] = [ + 'name' => $tag->getName(), + 'access' => ISystemTag::ACCESS_LEVEL_LOOKUP[$tag->getAccessLevel()], + ]; + } + return $result; + } +} |