Feature: Parse reference attributes from --ref in workspace add (#20261)

conan/cli/commands/workspace.py

@@ -97,13 +97,27 @@ def workspace_add(conan_api: ConanAPI, parser, subparser, *args):
         raise ConanException("Do not use both 'path' and '--ref' argument")
     if args.folder and not args.ref:
         raise ConanException("'--folder' requires '--ref'")
+    if args.ref and any((args.name, args.version, args.user, args.channel)):
+        raise ConanException(
+            "Do not use '--ref' together with '--name', '--version', "
+            "'--user' or '--channel' arguments"
+        )
     remotes = conan_api.remotes.list(args.remote) if not args.no_remote else []
     path = args.path
+    name = args.name
+    version = args.version
+    user = args.user
+    channel = args.channel
     if args.ref:
+        ref = RecipeReference.loads(args.ref)
         cwd, folder = _resolve_ws_relative_folder(conan_api, args.folder)
         path = conan_api.workspace.open(args.ref, remotes, cwd=cwd, folder=folder)
+        name = ref.name
+        version = ref.version
+        user = ref.user
+        channel = ref.channel
     ref = conan_api.workspace.add(path,
-                                  args.name, args.version, args.user, args.channel,
+                                  name, version, user, channel,
                                   args.output_folder, remotes=remotes)
     ConanOutput().success("Reference '{}' added to workspace".format(ref))
 

test/integration/workspace/test_workspace_ref_parse.py

@@ -0,0 +1,38 @@
+import textwrap
+
+from conan.test.utils.tools import TestClient
+
+
+def test_workspace_add_ref_parses_and_persists():
+    client = TestClient()
+    conanfile = textwrap.dedent("""
+        from conan import ConanFile
+
+        class MyPkg(ConanFile):
+            name = "mypkg"
+            version = "1.0"
+    """)
+    client.save({"conanfile.py": conanfile})
+    client.run("export . --user=company")
+    client.run("workspace init .")
+    client.run("workspace add --ref=mypkg/1.0@company")
+    client.run("workspace info")
+    assert "mypkg/1.0@company" in client.out
+
+
+def test_workspace_add_ref_rejects_individual_reference_arguments():
+    client = TestClient()
+    client.run("workspace init .")
+    client.run(
+        "workspace add --ref=mypkg/1.0@company --version=2.0",
+        assert_error=True
+    )
+    assert "Do not use '--ref' together with '--name', '--version', " \
+           "'--user' or '--channel' arguments" in client.out
+
+
+def test_workspace_add_ref_rejects_invalid_reference():
+    client = TestClient()
+    client.run("workspace init .")
+    client.run("workspace add --ref=invalid-format", assert_error=True)
+    assert "not a valid recipe reference" in client.out