Merge pull request #885 from acelaya-forks/feature/deprecate-create-tag

Feature/deprecate create tag

CHANGELOG.md

@@ -37,7 +37,7 @@ The format is based on [Keep a Changelog](https://keepachangelog.com), and this
 * [#858](https://github.com/shlinkio/shlink/issues/858) Updated to latest infection version. Updated docker images to PHP 7.4.11 and swoole 4.5.5
 
 ### Deprecated
-* *Nothing*
+* [#883](https://github.com/shlinkio/shlink/issues/883) Deprecated `POST /tags` endpoint and `tag:create` command, as tags are created automatically while creating short URLs.
 
 ### Removed
 * *Nothing*

docs/swagger/paths/v1_tags.json

@@ -87,12 +87,13 @@
     },
 
     "post": {
+        "deprecated": true,
         "operationId": "createTags",
         "tags": [
             "Tags"
         ],
         "summary": "Create tags",
-        "description": "Provided a list of tags, creates all that do not yet exist",
+        "description": "Provided a list of tags, creates all that do not yet exist<br />This endpoint is deprecated, as tags are automatically created while creating a short URL",
         "security": [
             {
                 "ApiKey": []

module/CLI/src/Command/Tag/CreateTagCommand.php

@@ -12,6 +12,7 @@ use Symfony\Component\Console\Input\InputOption;
 use Symfony\Component\Console\Output\OutputInterface;
 use Symfony\Component\Console\Style\SymfonyStyle;
 
+/** @deprecated */
 class CreateTagCommand extends Command
 {
     public const NAME = 'tag:create';
@@ -28,7 +29,7 @@ class CreateTagCommand extends Command
     {
         $this
             ->setName(self::NAME)
-            ->setDescription('Creates one or more tags.')
+            ->setDescription('[Deprecated] Creates one or more tags.')
             ->addOption(
                 'name',
                 't',

module/Core/src/Tag/TagService.php

@@ -58,6 +58,7 @@ class TagService implements TagServiceInterface
     /**
      * Provided a list of tag names, creates all that do not exist yet
      *
+     * @deprecated
      * @param string[] $tagNames
      * @return Collection|Tag[]
      */

module/Core/src/Tag/TagServiceInterface.php

@@ -28,6 +28,7 @@ interface TagServiceInterface
     public function deleteTags(array $tagNames): void;
 
     /**
+     * @deprecated
      * @param string[] $tagNames
      * @return Collection|Tag[]
      */

module/Rest/src/Action/Tag/CreateTagsAction.php

@@ -10,6 +10,7 @@ use Psr\Http\Message\ServerRequestInterface;
 use Shlinkio\Shlink\Core\Tag\TagServiceInterface;
 use Shlinkio\Shlink\Rest\Action\AbstractRestAction;
 
+/** @deprecated */
 class CreateTagsAction extends AbstractRestAction
 {
     protected const ROUTE_PATH = '/tags';