xsync-cli 0.1.0__tar.gz → 0.1.1__tar.gz

{xsync_cli-0.1.0 → xsync_cli-0.1.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: xsync-cli
-Version: 0.1.0
+Version: 0.1.1
 Summary: Sync the model list of an OpenAI-compatible endpoint into the Codex model catalog.
 License-Expression: MIT
 License-File: LICENSE

{xsync_cli-0.1.0 → xsync_cli-0.1.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "xsync-cli"
-version = "0.1.0"
+version = "0.1.1"
 description = "Sync the model list of an OpenAI-compatible endpoint into the Codex model catalog."
 readme = "README.md"
 requires-python = ">=3.11"

{xsync_cli-0.1.0 → xsync_cli-0.1.1}/src/xsync_cli/cli.py

@@ -280,12 +280,34 @@ def cmd_codex(args: argparse.Namespace) -> int:
     return EXIT_OK
 
 
+EPILOG = """\
+examples:
+  xsync setup                      make a profile, and read the model list
+  xsync list                       show the profiles. The active one has a star
+  xsync use openrouter             set the active profile
+  xsync codex --init               connect Codex to the endpoint of the profile
+  xsync codex --dry-run            show the difference. Write nothing
+  xsync codex                      sync the models into the Codex catalog
+  xsync codex --reset              remove everything that xsync wrote
+
+files:
+  ~/.config/xsync/profiles.toml    the profiles. `xsync setup` writes this file
+  ~/.codex/<profile>-models.json   the Codex catalog that `xsync codex` writes
+  ~/.codex/config.toml             only `--init` and `--reset` write this file
+
+exit codes:
+  0 success    1 error    2 the endpoint does not answer
+"""
+
+
 def build_parser() -> argparse.ArgumentParser:
     parser = argparse.ArgumentParser(
         prog="xsync",
         description="Sync the model list of an OpenAI-compatible endpoint into a harness.",
+        epilog=EPILOG,
+        formatter_class=argparse.RawDescriptionHelpFormatter,
     )
-    sub = parser.add_subparsers(dest="command", required=True)
+    sub = parser.add_subparsers(dest="command", metavar="command")
 
     sub.add_parser("setup", help="make a profile").set_defaults(func=cmd_setup)
     sub.add_parser("list", help="show the profiles").set_defaults(func=cmd_list)
@@ -314,6 +336,9 @@ def build_parser() -> argparse.ArgumentParser:
 def main(argv: list[str] | None = None) -> int:
     parser = build_parser()
     args = parser.parse_args(argv)
+    if not getattr(args, "command", None):
+        parser.print_help()
+        return EXIT_OK
     try:
         return args.func(args)
     except (ProfileError, ConfigError) as error:

{xsync_cli-0.1.0 → xsync_cli-0.1.1}/tests/test_cli_profiles.py

@@ -100,3 +100,20 @@ def test_remove_deletes_the_profile(store_path):
     store_path.write_text('[profiles.a]\nbase_url = "http://a/v1"\nwire_api = "chat"\n')
     assert cli.main(["remove", "a"]) == 0
     assert "profiles.a" not in store_path.read_text()
+
+
+def test_a_bare_command_shows_the_help(capsys):
+    assert cli.main([]) == 0
+    out = capsys.readouterr().out
+    for name in ("setup", "list", "use", "remove", "codex"):
+        assert name in out
+
+
+def test_the_help_names_the_profile_file(capsys):
+    cli.main([])
+    assert "profiles.toml" in capsys.readouterr().out
+
+
+def test_the_help_shows_an_example(capsys):
+    cli.main([])
+    assert "xsync setup" in capsys.readouterr().out

xsync_cli-0.1.1/tests/test_package_data.py

@@ -0,0 +1,46 @@
+from importlib.resources import files
+
+
+def test_the_rules_file_is_package_data():
+    text = files("xsync_cli.adapters.rules").joinpath("codex.toml").read_text()
+    assert "[defaults]" in text
+
+
+def test_the_generic_prompt_is_package_data():
+    text = files("xsync_cli.adapters.prompts").joinpath("generic-codex.md").read_text()
+    assert text.startswith("You are Codex")
+    assert len(text) > 5000
+
+
+def test_each_named_prompt_exists():
+    for name in ("gpt-5.5.md", "gpt-5.4.md"):
+        text = files("xsync_cli.adapters.prompts").joinpath(name).read_text()
+        assert text.startswith("You are Codex")
+
+
+def test_a_built_wheel_holds_every_data_file():
+    """The wheel must carry the rules file and every prompt.
+
+    The test skips when no wheel exists. Run `uv build` first.
+    """
+    import pathlib
+    import zipfile
+
+    import pytest
+
+    wheels = sorted(pathlib.Path("dist").glob("*.whl"))
+    if not wheels:
+        pytest.skip("no wheel in dist/. Run `uv build` first.")
+
+    names = zipfile.ZipFile(wheels[-1]).namelist()
+    required = (
+        "adapters/rules/codex.toml",
+        "adapters/prompts/generic-codex.md",
+        "adapters/prompts/gpt-5.5.md",
+        "adapters/prompts/gpt-5.4.md",
+        "adapters/prompts/generic-codex.messages.json",
+        "adapters/prompts/gpt-5.5.messages.json",
+        "adapters/prompts/gpt-5.4.messages.json",
+    )
+    for item in required:
+        assert any(item in name for name in names), f"{item} is absent from the wheel"

xsync_cli-0.1.0/tests/test_package_data.py

@@ -1,18 +0,0 @@
-from importlib.resources import files
-
-
-def test_the_rules_file_is_package_data():
-    text = files("xsync_cli.adapters.rules").joinpath("codex.toml").read_text()
-    assert "[defaults]" in text
-
-
-def test_the_generic_prompt_is_package_data():
-    text = files("xsync_cli.adapters.prompts").joinpath("generic-codex.md").read_text()
-    assert text.startswith("You are Codex")
-    assert len(text) > 5000
-
-
-def test_each_named_prompt_exists():
-    for name in ("gpt-5.5.md", "gpt-5.4.md"):
-        text = files("xsync_cli.adapters.prompts").joinpath(name).read_text()
-        assert text.startswith("You are Codex")