Use Claude Code, Codex, VSCode, Pi, and OpenCode (and 6 other harnesses) for free (1.3B+ free tokens) from your terminal, app, IDE, or phone, and now from the browser with native browser sessions (multi-harness + multi-model) like OpenClaw (voice supported + ToS friendly)
Python
"""Packaged desktop icon and export contracts."""
import builtins
import struct
from pathlib import Path
from types import SimpleNamespace
import pytest
from free_claude_code.cli import desktop_entrypoint
from free_claude_code.cli.desktop_assets import app_icon_bytes, export_app_icon
def test_packaged_icons_have_native_container_headers() -> None:
png = app_icon_bytes(".png")
ico = app_icon_bytes(".ico")
icns = app_icon_bytes(".icns")
assert png.startswith(b"\x89PNG\r\n\x1a\n")
assert struct.unpack(">II", png[16:24]) == (1024, 1024)
assert ico[:4] == b"\x00\x00\x01\x00"
assert struct.unpack("<H", ico[4:6])[0] >= 8
assert icns.startswith(b"icns")
assert struct.unpack(">I", icns[4:8])[0] == len(icns)
def test_export_app_icon_creates_parent_and_preserves_bytes(tmp_path: Path) -> None:
destination = tmp_path / "managed" / "AppIcon.ICNS"
export_app_icon(destination)
assert destination.read_bytes() == app_icon_bytes(".icns")
def test_export_app_icon_rejects_unknown_format(tmp_path: Path) -> None:
with pytest.raises(ValueError, match="Unsupported app icon format"):
export_app_icon(tmp_path / "app-icon.jpg")
def test_desktop_entrypoint_exports_icon_without_launching_tray(
tmp_path: Path,
monkeypatch: pytest.MonkeyPatch,
) -> None:
destination = tmp_path / "app-icon.ico"
monkeypatch.setattr(desktop_entrypoint.sys, "platform", "linux")
desktop_entrypoint.launch(["--export-icon", str(destination)])
assert destination.read_bytes() == app_icon_bytes(".ico")
def test_desktop_entrypoint_rejects_unknown_arguments(
capsys: pytest.CaptureFixture[str],
) -> None:
with pytest.raises(SystemExit) as exc_info:
desktop_entrypoint.launch(["--unknown"])
assert exc_info.value.code == 2
assert "Usage: fcc-desktop" in capsys.readouterr().err
def test_macos_installer_mode_does_not_import_tray(monkeypatch):
from free_claude_code.cli import macos_app
installed = []
monkeypatch.setattr(desktop_entrypoint.sys, "platform", "darwin")
monkeypatch.setattr(macos_app, "install", lambda: installed.append(True))
original_import = builtins.__import__
def checked_import(name, *args, **kwargs):
assert name not in {"pystray", "free_claude_code.cli.desktop_tray"}
return original_import(name, *args, **kwargs)
monkeypatch.setattr(builtins, "__import__", checked_import)
desktop_entrypoint.launch(["--install-macos-app"])
assert installed == [True]
def test_macos_installer_mode_is_rejected_on_windows(monkeypatch):
monkeypatch.setattr(desktop_entrypoint.sys, "platform", "win32")
with pytest.raises(SystemExit) as error:
desktop_entrypoint.launch(["--install-macos-app"])
assert error.value.code == 2
@pytest.mark.parametrize("auto_started", [False, True])
def test_desktop_sets_scaling_before_importing_native_tray(monkeypatch, auto_started):
calls = []
monkeypatch.setattr(desktop_entrypoint.sys, "platform", "win32")
monkeypatch.setattr(
desktop_entrypoint,
"enable_dpi_awareness",
lambda: calls.append("scaling"),
)
original_import = builtins.__import__
def import_module(name, *args, **kwargs):
if name == "free_claude_code.cli.desktop_tray":
assert calls == ["scaling"]
def launch(**kwargs):
assert kwargs == {"auto_started": auto_started}
calls.append("tray")
return SimpleNamespace(launch=launch)
return original_import(name, *args, **kwargs)
monkeypatch.setattr(builtins, "__import__", import_module)
desktop_entrypoint.launch(["--auto-started"] if auto_started else [])
assert calls == ["scaling", "tray"]