Fix get_language_pair default-pair message

* Point missing-default message to `pairs add` and `pairs set-default`

* Align CLI tests with new guidance

Co-authored-by: AI <ai@sderev.com>

Author: sderev

changelog.d/20260202_234601_sderev_consolidate_dup_fixes.md

@@ -0,0 +1,3 @@
+Fixed
+-----
+* Pointed missing default-pair errors to `vocabmaster pairs add` and `vocabmaster pairs set-default`.

tests/test_cli.py

@@ -6,6 +6,12 @@
 
 from vocabmaster import cli, config_handler, utils
 
+DEFAULT_PAIR_MISSING_MESSAGE = (
+    "No default language pair found. Run 'vocabmaster pairs add' to create a language pair, "
+    "then 'vocabmaster pairs set-default' to choose a default.\n"
+    "See `vocabmaster --help` for more information."
+)
+
 
 @pytest.fixture(autouse=True)
 def reset_click_defaults(monkeypatch):
@@ -480,7 +486,7 @@ def record_generate(translations, anki, language, mother, custom_deck_name=None)
 class TestAnkiCommand:
     def test_anki_requires_default_pair(self, isolated_app_dir, monkeypatch):
         def fail_pair(option):
-            raise ValueError("No default language pair found.")
+            raise ValueError(DEFAULT_PAIR_MISSING_MESSAGE)
 
         monkeypatch.setattr(cli.config_handler, "get_language_pair", fail_pair)
 
@@ -489,6 +495,8 @@ def fail_pair(option):
         assert result.exit_code == 1
         assert "No default language pair found." in result.output
         assert "vocabmaster pairs add" in result.output
+        assert "vocabmaster pairs set-default" in result.output
+        assert "vocabmaster --help" in result.output
 
     def test_anki_generates_deck_when_default_set(self, isolated_app_dir, monkeypatch):
         monkeypatch.setattr(
@@ -583,14 +591,17 @@ def record_explain():
 class TestTokensCommand:
     def test_tokens_requires_default_pair(self, isolated_app_dir, monkeypatch):
         def fail_pair(option):
-            raise ValueError("No default language pair found")
+            raise ValueError(DEFAULT_PAIR_MISSING_MESSAGE)
 
         monkeypatch.setattr(cli.config_handler, "get_language_pair", fail_pair)
 
         result = invoke_cli(["tokens"])
 
         assert result.exit_code == 1
-        assert "No default language pair found" in result.output
+        assert "No default language pair found." in result.output
+        assert "vocabmaster pairs add" in result.output
+        assert "vocabmaster pairs set-default" in result.output
+        assert "vocabmaster --help" in result.output
 
     def test_tokens_requires_words(self, isolated_app_dir, monkeypatch):
         monkeypatch.setattr(
@@ -782,7 +793,7 @@ def test_recover_list_requires_language_pair(self, isolated_app_dir, monkeypatch
         """recover list shows error with hint when no language pair configured."""
 
         def fail_pair(_pair):
-            raise ValueError("No default language pair found.")
+            raise ValueError(DEFAULT_PAIR_MISSING_MESSAGE)
 
         monkeypatch.setattr(cli.config_handler, "get_language_pair", fail_pair)
 
@@ -791,6 +802,8 @@ def fail_pair(_pair):
         assert result.exit_code == 1
         assert "No default language pair found." in result.output
         assert "vocabmaster pairs add" in result.output
+        assert "vocabmaster pairs set-default" in result.output
+        assert "vocabmaster --help" in result.output
 
 
 class TestRecoverRestoreCommand:
@@ -1213,14 +1226,17 @@ def test_recover_validate_invalid_pair(self, isolated_app_dir, monkeypatch):
         """recover validate shows error for invalid language pair."""
 
         def fail_pair(_pair):
-            raise ValueError("No default language pair found.")
+            raise ValueError(DEFAULT_PAIR_MISSING_MESSAGE)
 
         monkeypatch.setattr(cli.config_handler, "get_language_pair", fail_pair)
 
         result = invoke_cli(["recover", "validate"])
 
         assert result.exit_code == 1
         assert "No default language pair found." in result.output
+        assert "vocabmaster pairs add" in result.output
+        assert "vocabmaster pairs set-default" in result.output
+        assert "vocabmaster --help" in result.output
 
 
 class TestConfigHandlerRemove:

vocabmaster/cli.py

@@ -984,7 +984,9 @@ def pairs_inspect_command(pair):
         default_pair = config_handler.get_default_language_pair()
         if default_pair is None:
             click.echo(
-                f"{ERROR_PREFIX} No default language pair found. Run 'vocabmaster pairs add' to create one.",
+                f"{ERROR_PREFIX} No default language pair found. Run 'vocabmaster pairs add' to create a"
+                " language pair, then 'vocabmaster pairs set-default' to choose a default.\n"
+                "See `vocabmaster --help` for more information.",
                 err=True,
             )
             sys.exit(1)

vocabmaster/config_handler.py

@@ -316,9 +316,9 @@ def get_language_pair(language_pair):
         default_pair = get_default_language_pair()
         if default_pair is None:
             raise ValueError(
-                "No default language pair found. Please set a default language pair"
-                " using 'vocabmaster config default'.\nSee `vocabmaster --help` for"
-                " more information."
+                "No default language pair found. Run 'vocabmaster pairs add' to create a"
+                " language pair, then 'vocabmaster pairs set-default' to choose a default.\n"
+                "See `vocabmaster --help` for more information."
             )
         language_to_learn = default_pair["language_to_learn"]
         mother_tongue = default_pair["mother_tongue"]