aswap 0.1.0__tar.gz

aswap-0.1.0/.gitignore

@@ -0,0 +1 @@
+*

aswap-0.1.0/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2026 Kevin Cui
+Copyright (c) 2025 Onur Cetinkol (claude-swap)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

aswap-0.1.0/PKG-INFO

@@ -0,0 +1,44 @@
+Metadata-Version: 2.5
+Name: aswap
+Version: 0.1.0
+Summary: Account swap for Claude Code: claude-swap 0.27.0b1 (cswap) with 2 maintained patches, as the aswap command
+Project-URL: Homepage, https://github.com/BlackHole1/aswap
+Project-URL: Repository, https://github.com/BlackHole1/aswap
+Project-URL: Issues, https://github.com/BlackHole1/aswap/issues
+Project-URL: Upstream, https://github.com/realiti4/claude-swap
+Author-email: Onur Cetinkol <onurcetinkol@gmail.com>
+License: MIT
+License-File: LICENSE
+Keywords: account-switcher,claude,claude-code,cli
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Utilities
+Requires-Python: >=3.12
+Requires-Dist: keyring>=25.0.0; sys_platform == 'win32'
+Requires-Dist: textual<9,>=8.2.8
+Requires-Dist: truststore>=0.10.4
+Provides-Extra: menubar
+Requires-Dist: rumps>=0.4.0; extra == 'menubar'
+Description-Content-Type: text/markdown
+
+# aswap
+
+Account swap for Claude Code: [claude-swap](https://github.com/realiti4/claude-swap) (`cswap`) with a maintained patch series on top, installed as the `aswap` command.
+
+```bash
+uv tool install aswap      # or: pipx install aswap
+aswap --version
+aswap link                 # optional: also answer to `cswap`
+aswap upgrade              # later
+```
+
+`aswap` accepts everything `cswap` does. What the patches fix, and how the package is built from unmodified upstream plus patches, is documented at <https://github.com/BlackHole1/aswap>.

aswap-0.1.0/README.md

@@ -0,0 +1,12 @@
+# aswap
+
+Account swap for Claude Code: [claude-swap](https://github.com/realiti4/claude-swap) (`cswap`) with a maintained patch series on top, installed as the `aswap` command.
+
+```bash
+uv tool install aswap      # or: pipx install aswap
+aswap --version
+aswap link                 # optional: also answer to `cswap`
+aswap upgrade              # later
+```
+
+`aswap` accepts everything `cswap` does. What the patches fix, and how the package is built from unmodified upstream plus patches, is documented at <https://github.com/BlackHole1/aswap>.

aswap-0.1.0/pyproject.toml

@@ -0,0 +1,72 @@
+[project]
+name = "aswap"
+version = "0.1.0"
+description = "Account swap for Claude Code: claude-swap 0.27.0b1 (cswap) with 2 maintained patches, as the aswap command"
+readme = "README.md"
+requires-python = ">=3.12"
+dependencies = [
+    # Windows-only: needed solely by the one-time keyring -> files migration
+    # (migrations.py) for users upgrading from <=0.10.x. macOS/Linux never
+    # import it on the hot path; the macOS migration has a security-CLI
+    # fallback and the legacy purge sweep no-ops when it's absent.
+    "keyring>=25.0.0; sys_platform == 'win32'",
+    "textual>=8.2.8,<9",
+    "truststore>=0.10.4",
+]
+authors = [{name = "Onur Cetinkol", email = "onurcetinkol@gmail.com"}]
+license = {text = "MIT"}
+keywords = ["claude", "claude-code", "account-switcher", "cli"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: MacOS",
+    "Operating System :: Microsoft :: Windows",
+    "Operating System :: POSIX :: Linux",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Topic :: Utilities",
+]
+
+[project.optional-dependencies]
+menubar = ["rumps>=0.4.0"]
+
+[project.urls]
+Homepage = "https://github.com/BlackHole1/aswap"
+Repository = "https://github.com/BlackHole1/aswap"
+Issues = "https://github.com/BlackHole1/aswap/issues"
+Upstream = "https://github.com/realiti4/claude-swap"
+
+[project.scripts]
+aswap = "aswap.cli:main"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/claude_swap", "src/aswap"]
+
+[dependency-groups]
+dev = ["pytest>=8.0", "pytest-asyncio>=0.24", "pytest-xdist>=3.5"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+pythonpath = ["src"]
+# Parallel by default. The suite is ~1900 tests of mostly-idle work (file
+# locks, subprocess fakes, Textual pilots), so wall clock was dominated by
+# doing them one at a time, not by any single slow test: 25 ms/test spread
+# across the whole suite, with the top five totalling under 7 s of a 51 s run.
+# Measured here, 48 cores: 51.0s serial -> 12.1s (-n 8) -> 7.7s (-n 16), same
+# 1929 passed / 4 skipped every time, three consecutive runs, real account
+# store hash unmoved. `auto` rather than a fixed number so CI runners (2-4
+# cores) and this box both get the cores they have.
+addopts = "-n auto --dist loadgroup"
+asyncio_default_fixture_loop_scope = "function"
+markers = [
+    "no_keychain_fake: opt out of the autouse in-memory Keychain guard (test mocks subprocess itself, or runs against a temp keychain on GitHub Actions)",
+    "no_oauth_profile_fake: opt out of the autouse fetch_oauth_profile stub (test exercises fetch_oauth_profile itself against a mocked urlopen)",
+]

aswap-0.1.0/src/aswap/__init__.py

@@ -0,0 +1,8 @@
+"""The ``aswap`` command: claude-swap with the aswap patch series applied."""
+
+from importlib.metadata import PackageNotFoundError, version
+
+try:
+    __version__ = version("aswap")
+except PackageNotFoundError:  # running from a source checkout
+    __version__ = "0.0.0"

aswap-0.1.0/src/aswap/cli.py

@@ -0,0 +1,131 @@
+"""Entry point for ``aswap``.
+
+Everything is claude-swap's own CLI except two commands of ours:
+
+    aswap link      make ``cswap`` run this install (a ``cswap`` launcher next to ``aswap``)
+    aswap unlink    remove that launcher again
+
+Installers (uv tool, pipx) install every entry point a package declares and
+cannot skip one, so shipping a ``cswap`` entry point would collide with an
+installed upstream claude-swap. A launcher the user creates on purpose keeps
+both choices open: side by side by default, replacement on request.
+"""
+
+from __future__ import annotations
+
+import os
+import shutil
+import sys
+from pathlib import Path
+
+WINDOWS = sys.platform == "win32"
+LAUNCHER = "cswap.exe" if WINDOWS else "cswap"
+
+USAGE = """usage: aswap link [--force]
+       aswap unlink [--force]
+       aswap link --status
+
+Create (or remove) a `cswap` launcher next to the `aswap` command, so `cswap`
+runs this install instead of upstream claude-swap.
+
+  --status   show what `cswap` currently resolves to
+  --force    replace (or remove) a `cswap` that aswap did not create
+"""
+
+
+def _own_launcher() -> Path:
+    """The ``aswap`` launcher the user ran, resolved through PATH when it was
+    typed bare."""
+    argv0 = Path(sys.argv[0] or "")
+    if argv0.parent != Path(".") and argv0.exists():
+        return argv0.absolute()
+    found = shutil.which("aswap")
+    if found:
+        return Path(found).absolute()
+    return argv0.absolute()
+
+
+def _links_to(target: Path, launcher: Path) -> bool:
+    """Whether ``target`` is a launcher aswap created for ``launcher``."""
+    try:
+        if target.is_symlink():
+            return target.resolve() == launcher.resolve()
+        if WINDOWS and target.is_file() and launcher.is_file():
+            return target.read_bytes() == launcher.read_bytes()
+    except OSError:
+        pass
+    return False
+
+
+def _status(target: Path, launcher: Path) -> int:
+    on_path = shutil.which("cswap")
+    if not target.exists() and not target.is_symlink():
+        print(f"cswap: not linked (would be created at {target})")
+    elif _links_to(target, launcher):
+        print(f"cswap -> {launcher}  (linked by aswap)")
+    else:
+        print(f"cswap at {target} is not aswap's (upstream claude-swap or another tool)")
+    if on_path and Path(on_path).absolute() != target:
+        print(f"note: `cswap` on PATH resolves to {on_path} first")
+    return 0
+
+
+def _link(force: bool) -> int:
+    launcher = _own_launcher()
+    if not launcher.exists():
+        print(f"error: cannot locate the aswap launcher (looked at {launcher})", file=sys.stderr)
+        return 1
+    target = launcher.parent / LAUNCHER
+    if _links_to(target, launcher):
+        print(f"cswap already runs aswap ({target})")
+        return 0
+    if target.exists() or target.is_symlink():
+        if not force:
+            print(
+                f"error: {target} exists and is not aswap's.\n"
+                "If it is upstream claude-swap, remove it first (uv tool uninstall claude-swap "
+                "or pipx uninstall claude-swap), or pass --force to replace it.",
+                file=sys.stderr,
+            )
+            return 1
+        target.unlink()
+    if WINDOWS:
+        shutil.copy2(launcher, target)
+    else:
+        os.symlink(launcher.name, target)
+    print(f"linked: {target} -> {launcher.name}")
+    other = shutil.which("cswap")
+    if other and Path(other).absolute() != target:
+        print(f"note: `cswap` on PATH still resolves to {other} first; remove it or reorder PATH")
+    return 0
+
+
+def _unlink(force: bool) -> int:
+    launcher = _own_launcher()
+    target = launcher.parent / LAUNCHER
+    if not target.exists() and not target.is_symlink():
+        print("cswap is not linked")
+        return 0
+    if not _links_to(target, launcher) and not force:
+        print(f"error: {target} was not created by aswap; pass --force to remove it anyway", file=sys.stderr)
+        return 1
+    target.unlink()
+    print(f"unlinked: {target}")
+    return 0
+
+
+def main(argv: list[str] | None = None) -> int | None:
+    args = list(sys.argv[1:] if argv is None else argv)
+    if args and args[0] in ("link", "unlink"):
+        flags = args[1:]
+        unknown = [a for a in flags if a not in ("--force", "--status", "-h", "--help")]
+        if unknown or "-h" in flags or "--help" in flags:
+            print(USAGE, end="", file=sys.stderr if unknown else sys.stdout)
+            return 2 if unknown else 0
+        launcher = _own_launcher()
+        if "--status" in flags:
+            return _status(launcher.parent / LAUNCHER, launcher)
+        return (_link if args[0] == "link" else _unlink)("--force" in flags)
+    from claude_swap.cli import main as cswap_main
+
+    return cswap_main()

aswap-0.1.0/src/claude_swap/__init__.py

@@ -0,0 +1,9 @@
+"""Multi-account switcher for Claude Code."""
+
+from claude_swap.distribution import distribution_version
+
+__version__ = distribution_version()
+
+from claude_swap.switcher import ClaudeAccountSwitcher
+
+__all__ = ["ClaudeAccountSwitcher", "__version__"]

aswap-0.1.0/src/claude_swap/__main__.py

@@ -0,0 +1,6 @@
+"""Allow running as `python -m claude_swap`."""
+
+from claude_swap.cli import main
+
+if __name__ == "__main__":
+    main()

aswap-0.1.0/src/claude_swap/appearance.py

@@ -0,0 +1,218 @@
+"""Terminal appearance detection and theme resolution.
+
+Determines whether the terminal has a light or dark background by querying it
+with OSC 11 (``ESC ] 11 ; ? BEL``) followed by DA1 (``ESC [ c``), reading
+through the ordered DA1 reply, and classifying the preceding ``rgb:…`` reply by
+perceived luminance. Cross-cutting: both the CLI printer and the TUI resolve
+their theme through here.
+
+The query MUST happen while this process owns the terminal in cooked mode —
+before Textual's input driver starts — or the reply is reissued as keystrokes.
+Everything fails safe to ``None`` (→ resolved ``dark``): a terminal that doesn't
+answer, a pipe, Windows, or a parse failure never blocks indefinitely and never
+errors.
+"""
+
+from __future__ import annotations
+
+import os
+import re
+import select
+import sys
+import time
+
+_QUERY = b"\x1b]11;?\x07"  # OSC 11, BEL-terminated
+_DA1_QUERY = b"\x1b[c"      # ordered response boundary
+# DA1 lets unsupported terminals return promptly; the cap mainly covers SSH
+# latency or a non-conforming terminal that answers neither query.
+_TIMEOUT_S = 1.0
+_MAX_REPLY = 256
+# The full `ESC ]11;` opener is required so interleaved or echoed input (e.g.
+# a shell echoing back a pasted escape sequence) can't be misparsed as a
+# background reply just because `]11;rgb:`/`]11;#` appears somewhere in the
+# buffer without the ESC that actually starts an OSC sequence.
+_RGB = re.compile(
+    rb"\x1b\]11;rgb:([0-9a-fA-F]+)/([0-9a-fA-F]+)/([0-9a-fA-F]+)"
+    rb"(?:\x07|\x1b\\)"
+)
+_HEX = re.compile(rb"\x1b\]11;#([0-9a-fA-F]{6})(?:\x07|\x1b\\)")
+# A primary device-attributes reply is CSI ? Ps c. Requiring ``?`` and at
+# least the private marker keeps an echoed DA1 query (CSI c) from looking
+# complete; Ps itself may legally be empty.
+_DA1_REPLY = re.compile(rb"(?:\x1b\[|\x9b)\?[0-9;:]*c")
+
+# Cache: the terminal background can't change within a process, so query once.
+_UNSET = object()
+_cache: object | str | None = _UNSET
+
+
+def _reset_cache() -> None:
+    """Test helper: forget any cached detection result."""
+    global _cache
+    _cache = _UNSET
+
+
+def _parse_osc11(reply: bytes) -> tuple[float, float, float] | None:
+    """Parse an OSC 11 reply into (r, g, b) each normalised to 0..1."""
+    m = _RGB.search(reply)
+    if m:
+        return tuple(
+            int(h, 16) / (16 ** len(h) - 1) for h in m.groups()
+        )  # type: ignore[return-value]
+    m = _HEX.search(reply)
+    if m:
+        h = m.group(1).decode("ascii")
+        return tuple(int(h[i:i + 2], 16) / 255 for i in (0, 2, 4))  # type: ignore[return-value]
+    return None
+
+
+def _classify(reply: bytes) -> str | None:
+    """Light/dark from an OSC 11 reply, or None if unparseable."""
+    rgb = _parse_osc11(reply)
+    if rgb is None:
+        return None
+    r, g, b = rgb
+    luminance = 0.2126 * r + 0.7152 * g + 0.0722 * b  # BT.709-weighted brightness on gamma-encoded channels (approx.)
+    return "light" if luminance > 0.5 else "dark"
+
+
+def _query_terminal_background() -> bytes | None:
+    """Send OSC 11 + DA1 and read through the DA1 reply. None on any failure.
+
+    Isolated so tests can substitute a canned reply without a real tty.
+
+    Terminals process queries in order. DA1 is widely supported, so its reply
+    marks the point after any OSC 11 reply and prevents a slower colour reply
+    from being reissued as shell input after this process restores the tty.
+    The timeout remains a safety cap for high-latency or non-conforming
+    terminals.
+
+    ``TERM=dumb`` and the Linux console don't support this colour query.
+    Likewise, tmux and screen don't pass it through to the outer terminal by
+    default. Those environments short-circuit to ``None`` (resolving to
+    ``dark``) without probing. Fails safe either way.
+    """
+    if os.name == "nt":
+        return None
+    if os.environ.get("TERM") in ("dumb", "linux"):
+        return None
+    if os.environ.get("TMUX") or os.environ.get("STY"):
+        return None
+    try:
+        import termios
+        import tty
+    except ImportError:
+        return None
+    try:
+        if not (sys.stdin.isatty() and sys.stdout.isatty()):
+            return None
+    except (ValueError, OSError):
+        # isatty() can raise on a closed stream.
+        return None
+    try:
+        fd = sys.stdin.fileno()
+        old = termios.tcgetattr(fd)
+    except (termios.error, OSError):
+        return None
+    try:
+        # TCSANOW (not TCSADRAIN): draining first can block under terminal
+        # flow control, and there's no pending output to drain anyway.
+        tty.setcbreak(fd, termios.TCSANOW)
+        sys.stdout.write((_QUERY + _DA1_QUERY).decode("latin-1"))
+        sys.stdout.flush()
+        deadline = time.monotonic() + _TIMEOUT_S
+        buf = b""
+        while time.monotonic() < deadline and len(buf) < _MAX_REPLY:
+            remaining = deadline - time.monotonic()
+            ready, _, _ = select.select([fd], [], [], max(0.0, remaining))
+            if not ready:
+                break
+            chunk = os.read(fd, 32)
+            if not chunk:
+                break
+            buf += chunk
+            # Do not stop at the OSC reply: the DA1 response is the ordered
+            # boundary proving that no colour-query bytes are still in flight.
+            if _DA1_REPLY.search(buf) is not None:
+                break
+        return buf or None
+    except (termios.error, OSError, ValueError):
+        return None
+    finally:
+        try:
+            termios.tcsetattr(fd, termios.TCSANOW, old)
+        except (termios.error, OSError):
+            pass
+
+
+def detect_terminal_background() -> str | None:
+    """'light' | 'dark' from the terminal background, or None if undetectable.
+
+    Cached per process. MUST be first called in cooked mode (before app.run()).
+    """
+    global _cache
+    if _cache is _UNSET:
+        reply = _query_terminal_background()
+        _cache = _classify(reply) if reply is not None else None
+    return _cache  # type: ignore[return-value]
+
+
+def resolve_theme(setting: str, detect=detect_terminal_background) -> str:
+    """Resolve a ui.theme setting to a concrete 'light'/'dark'.
+
+    'dark'/'light' pass through without probing; 'auto' follows ``detect()``,
+    falling back to 'dark' when detection yields None.
+    """
+    if setting in ("dark", "light"):
+        return setting
+    return detect() or "dark"
+
+
+def cli_should_probe(argv: list[str], *, colors_enabled: bool) -> bool:
+    """Whether the CLI should probe the terminal background before dispatch.
+
+    False when colors are off (nothing will render the theme anyway), when
+    the first token is ``run`` (execs a child that takes over the terminal),
+    or when ``--json`` is present (the OSC query must never precede
+    machine-readable output on stdout).
+    """
+    if not colors_enabled:
+        return False
+    if argv and argv[0] == "run":
+        return False
+    if "--json" in argv:
+        return False
+    return True
+
+
+def cli_theme(setting: str, *, detect=detect_terminal_background, colors: bool) -> str:
+    """Resolve a theme for a plain-CLI invocation: probe only when color will
+    actually be emitted; otherwise auto degrades to dark without a tty query."""
+    if setting == "auto" and not colors:
+        return "dark"
+    return resolve_theme(setting, detect=detect)
+
+
+def drain_stdin() -> None:
+    """Discard any pending terminal input (e.g. a late OSC reply) so it isn't
+    reissued as keystrokes once Textual takes over. Best-effort; POSIX only.
+
+    A reply that arrives after the detection deadline and after this drain
+    can, in principle, still reach the running app as stray keystrokes —
+    inherent to any finite-timeout OSC probe, not fully closeable here.
+    """
+    if os.name == "nt":
+        return
+    try:
+        import termios
+    except ImportError:
+        return
+    try:
+        if not sys.stdin.isatty():
+            return
+    except (ValueError, OSError):
+        return
+    try:
+        termios.tcflush(sys.stdin.fileno(), termios.TCIFLUSH)
+    except (termios.error, OSError):
+        pass