cc-switch 0.9.6__tar.gz

cc_switch-0.9.6/.gitignore

@@ -0,0 +1,244 @@
+# Runtime config — personal per-user settings; template is slife.template.json5.
+slife.json5
+
+# Playwright MCP browser traces (test artifacts)
+.playwright-mcp/
+
+# Credential store encrypted backup
+credentials.crypt
+
+# WeChat session files (contain auth tokens)
+wechat_*.json5
+
+# Runtime logs
+logs/
+
+# User-saved files (memfiles plugin storage — per-agent runtime data)
+*.files/
+
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[codz]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#   Usually these files are written by a python script from a template
+#   before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py.cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+# .python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+# Pipfile.lock
+
+# UV
+#   Similar to Pipfile.lock, it is generally recommended to include uv.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+# uv.lock
+
+# poetry
+#   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
+# poetry.lock
+# poetry.toml
+
+# pdm
+#   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
+#   pdm recommends including project-wide configuration in pdm.toml, but excluding .pdm-python.
+#   https://pdm-project.org/en/latest/usage/project/#working-with-version-control
+# pdm.lock
+# pdm.toml
+.pdm-python
+.pdm-build/
+
+# pixi
+#   Similar to Pipfile.lock, it is generally recommended to include pixi.lock in version control.
+# pixi.lock
+#   Pixi creates a virtual environment in the .pixi directory, just like venv module creates one
+#   in the .venv directory. It is recommended not to include this directory in version control.
+.pixi
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# Redis
+*.rdb
+*.aof
+*.pid
+
+# RabbitMQ
+mnesia/
+rabbitmq/
+rabbitmq-data/
+
+# ActiveMQ
+activemq-data/
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.envrc
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# PyCharm
+#   JetBrains specific template is maintained in a separate JetBrains.gitignore that can
+#   be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
+#   and can be added to the global gitignore or merged into this file.  For a more nuclear
+#   option (not recommended) you can uncomment the following to ignore the entire idea folder.
+# .idea/
+
+# Abstra
+#   Abstra is an AI-powered process automation framework.
+#   Ignore directories containing user credentials, local state, and settings.
+#   Learn more at https://abstra.io/docs
+.abstra/
+
+# Visual Studio Code
+#   Visual Studio Code specific template is maintained in a separate VisualStudioCode.gitignore 
+#   that can be found at https://github.com/github/gitignore/blob/main/Global/VisualStudioCode.gitignore
+#   and can be added to the global gitignore or merged into this file. However, if you prefer, 
+#   you could uncomment the following to ignore the entire vscode folder
+# .vscode/
+# Temporary file for partial code execution
+tempCodeRunnerFile.py
+
+# Ruff stuff:
+.ruff_cache/
+
+# PyPI configuration file
+.pypirc
+
+# Marimo
+marimo/_static/
+marimo/_lsp/
+__marimo__/
+
+# Streamlit
+.streamlit/secrets.toml
+
+# SQLite database files (may appear anywhere in the project)
+*.db
+*.db-shm
+*.db-wal
+
+# local DB backups (never committed)
+slife.db.bak*

cc_switch-0.9.6/PKG-INFO

@@ -0,0 +1,138 @@
+Metadata-Version: 2.3
+Name: cc-switch
+Version: 0.9.6
+Summary: Generate ~/.claude/settings.json from saved provider/model configs
+Project-URL: Homepage, https://github.com/juzcn/slife
+Project-URL: Repository, https://github.com/juzcn/slife
+Author-email: juzcn <zhangjun@cueb.edu.cn>
+License: MIT
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Terminals
+Requires-Python: >=3.13
+Requires-Dist: credstore
+Description-Content-Type: text/markdown
+
+# cc-switch
+
+Generate `~/.claude/settings.json` from saved provider/model configs —
+a small CLI that mirrors the [credstore](../credstore/README.md) pattern.
+
+Non-secret provider *shape* lives in `~/.claude/cc-switch.json`.  API
+keys are **never** stored there — the config keeps the key's *name*,
+and the value is read from credstore at activate time and injected into
+the current process environment as `ANTHROPIC_AUTH_TOKEN`.  The
+generated `settings.json` contains no credential line.
+
+## Install
+
+cc-switch is a standalone PyPI package — installed independently of
+slife (installing slife does **not** bring cc-switch, and vice versa).
+Both depend on [credstore](../credstore/README.md), which is pulled in
+automatically.
+
+```bash
+uv tool install cc-switch
+# or, in this repo:
+uv sync
+```
+
+## Commands
+
+### `cc-switch set <provider-name>`
+
+Create or edit a provider.  Prompts for:
+
+- **Base URL** (required)
+- **API key name** — the credstore key holding the secret (required)
+- **Supported models** (optional; comma, space, or semicolon separated)
+
+If the provider already exists this *edits* it; otherwise it *adds* it.
+
+```bash
+cc-switch set deepseek
+# Base URL [..]: https://api.deepseek.com/anthropic
+# API key name (credstore key): DEEPSEEK_API_KEY
+# Supported models (comma separated): deepseek-chat,deepseek-reasoner
+```
+
+No secret value is ever asked for or written — store it first with:
+
+```bash
+credstore set DEEPSEEK_API_KEY
+```
+
+### `cc-switch activate <provider-name/model-name>`
+
+Writes `~/.claude/settings.json` with stock Claude Code defaults, and
+injects the API key from credstore into the system environment as
+`ANTHROPIC_AUTH_TOKEN` (mirroring `credstore inject` — registry on
+Windows, shell profile on Unix), so a freshly launched Claude Code
+session inherits it.  The settings file contains **no** credential.
+
+If the provider's API key is not in credstore, `activate` fails loudly
+with a `credstore set <key>` hint instead of writing an unusable setup.
+
+```bash
+cc-switch activate deepseek/deepseek-chat
+```
+
+If the model is omitted and the provider has exactly one model, it is
+used; if several, you are prompted to pick one.
+
+### `cc-switch activate <provider-name/model-name> --custom`
+
+Like `activate`, but lets you override every model slot first —
+`ANTHROPIC_DEFAULT_HAIKU_MODEL`, `ANTHROPIC_DEFAULT_SONNET_MODEL`,
+`ANTHROPIC_DEFAULT_OPUS_MODEL`, `ANTHROPIC_CLAUDE_CODE_SUBAGENT_MODEL`,
+`ANTHROPIC_MODEL`, `ANTHROPIC_CLAUDE_CODE_EFFORT_LEVEL` — one at a time.
+Enter a value to override, or Enter to keep the default.  Overrides are
+one-shot: they never touch the stored provider config.
+
+### `cc-switch list`
+
+Lists every configured provider/model pair, one per line:
+
+```
+deepseek/deepseek-chat
+deepseek/deepseek-reasoner
+scnet/scnet-1m
+```
+
+### `cc-switch list-providers`
+
+Shows provider metadata (base URL, API key name, models) without the
+model-per-line layout of `list`.
+
+### `cc-switch remove <provider-name>`
+
+Deletes a provider config.  Does not touch credstore or settings.json.
+
+## Files
+
+| Path | Purpose |
+|------|---------|
+| `~/.claude/cc-switch.json` | Provider/model shapes (no secrets) |
+| `~/.claude/settings.json` | Generated by `activate` |
+| credstore (`DEEPSEEK_API_KEY`, …) | The actual API key values |
+
+`CC_SWITCH_FILE` overrides the config path; the settings path can be
+overridden for tests.
+
+## Security notes
+
+- The config file holds only metadata — the API key is referenced by name.
+- `activate` reads the secret from credstore and injects it into the
+  system environment as `ANTHROPIC_AUTH_TOKEN` (registry on Windows /
+  shell profile on Unix), mirroring `credstore inject`; it is never
+  written to settings.json.
+- On a TTY, `activate` prints an activation hint without echoing the
+  secret; when stdout is piped it emits the shell export line for `eval`.
+- Restart your shell (or start a new terminal) after activating for the
+  env change to take effect in the current session.
+- Secrets are immutable Python `str` — cc-switch follows credstore's
+  practice of `del`-ing the reference immediately after use.

cc_switch-0.9.6/README.md

@@ -0,0 +1,119 @@
+# cc-switch
+
+Generate `~/.claude/settings.json` from saved provider/model configs —
+a small CLI that mirrors the [credstore](../credstore/README.md) pattern.
+
+Non-secret provider *shape* lives in `~/.claude/cc-switch.json`.  API
+keys are **never** stored there — the config keeps the key's *name*,
+and the value is read from credstore at activate time and injected into
+the current process environment as `ANTHROPIC_AUTH_TOKEN`.  The
+generated `settings.json` contains no credential line.
+
+## Install
+
+cc-switch is a standalone PyPI package — installed independently of
+slife (installing slife does **not** bring cc-switch, and vice versa).
+Both depend on [credstore](../credstore/README.md), which is pulled in
+automatically.
+
+```bash
+uv tool install cc-switch
+# or, in this repo:
+uv sync
+```
+
+## Commands
+
+### `cc-switch set <provider-name>`
+
+Create or edit a provider.  Prompts for:
+
+- **Base URL** (required)
+- **API key name** — the credstore key holding the secret (required)
+- **Supported models** (optional; comma, space, or semicolon separated)
+
+If the provider already exists this *edits* it; otherwise it *adds* it.
+
+```bash
+cc-switch set deepseek
+# Base URL [..]: https://api.deepseek.com/anthropic
+# API key name (credstore key): DEEPSEEK_API_KEY
+# Supported models (comma separated): deepseek-chat,deepseek-reasoner
+```
+
+No secret value is ever asked for or written — store it first with:
+
+```bash
+credstore set DEEPSEEK_API_KEY
+```
+
+### `cc-switch activate <provider-name/model-name>`
+
+Writes `~/.claude/settings.json` with stock Claude Code defaults, and
+injects the API key from credstore into the system environment as
+`ANTHROPIC_AUTH_TOKEN` (mirroring `credstore inject` — registry on
+Windows, shell profile on Unix), so a freshly launched Claude Code
+session inherits it.  The settings file contains **no** credential.
+
+If the provider's API key is not in credstore, `activate` fails loudly
+with a `credstore set <key>` hint instead of writing an unusable setup.
+
+```bash
+cc-switch activate deepseek/deepseek-chat
+```
+
+If the model is omitted and the provider has exactly one model, it is
+used; if several, you are prompted to pick one.
+
+### `cc-switch activate <provider-name/model-name> --custom`
+
+Like `activate`, but lets you override every model slot first —
+`ANTHROPIC_DEFAULT_HAIKU_MODEL`, `ANTHROPIC_DEFAULT_SONNET_MODEL`,
+`ANTHROPIC_DEFAULT_OPUS_MODEL`, `ANTHROPIC_CLAUDE_CODE_SUBAGENT_MODEL`,
+`ANTHROPIC_MODEL`, `ANTHROPIC_CLAUDE_CODE_EFFORT_LEVEL` — one at a time.
+Enter a value to override, or Enter to keep the default.  Overrides are
+one-shot: they never touch the stored provider config.
+
+### `cc-switch list`
+
+Lists every configured provider/model pair, one per line:
+
+```
+deepseek/deepseek-chat
+deepseek/deepseek-reasoner
+scnet/scnet-1m
+```
+
+### `cc-switch list-providers`
+
+Shows provider metadata (base URL, API key name, models) without the
+model-per-line layout of `list`.
+
+### `cc-switch remove <provider-name>`
+
+Deletes a provider config.  Does not touch credstore or settings.json.
+
+## Files
+
+| Path | Purpose |
+|------|---------|
+| `~/.claude/cc-switch.json` | Provider/model shapes (no secrets) |
+| `~/.claude/settings.json` | Generated by `activate` |
+| credstore (`DEEPSEEK_API_KEY`, …) | The actual API key values |
+
+`CC_SWITCH_FILE` overrides the config path; the settings path can be
+overridden for tests.
+
+## Security notes
+
+- The config file holds only metadata — the API key is referenced by name.
+- `activate` reads the secret from credstore and injects it into the
+  system environment as `ANTHROPIC_AUTH_TOKEN` (registry on Windows /
+  shell profile on Unix), mirroring `credstore inject`; it is never
+  written to settings.json.
+- On a TTY, `activate` prints an activation hint without echoing the
+  secret; when stdout is piped it emits the shell export line for `eval`.
+- Restart your shell (or start a new terminal) after activating for the
+  env change to take effect in the current session.
+- Secrets are immutable Python `str` — cc-switch follows credstore's
+  practice of `del`-ing the reference immediately after use.

cc_switch-0.9.6/cc_switch/__init__.py

@@ -0,0 +1,50 @@
+"""cc-switch — generate ~/.claude/settings.json from saved provider/model configs.
+
+A standalone CLI (mirroring the credstore pattern) that keeps the
+non-secret *shape* of a Claude Code provider setup in
+``~/.claude/cc-switch.json`` and materialises it into
+``~/.claude/settings.json``.  Secrets never touch settings.json — the
+API key is read from credstore at activate time and injected only into
+the system environment as ``ANTHROPIC_AUTH_TOKEN``.
+
+Modules::
+
+    cc_switch      Package API (get/save/remove/list/activate)
+    cc_switch.cli  Command-line interface (entry point ``cc-switch``)
+"""
+
+from cc_switch._api import (
+    CONFIG_PATH,
+    add_provider,
+    list_providers,
+    remove_provider,
+    load_config,
+    save_config,
+    update_provider,
+)
+from cc_switch._defaults import (
+    DEFAULT_ENV,
+    DEFAULT_OVERRIDE_KEYS,
+    DEFAULT_SETTINGS,
+    MAIN_MODEL_SLOT_KEYS,
+    default_value,
+    list_default_override_keys,
+)
+
+__version__ = "0.9.6"
+
+__all__ = [
+    "CONFIG_PATH",
+    "DEFAULT_ENV",
+    "DEFAULT_OVERRIDE_KEYS",
+    "DEFAULT_SETTINGS",
+    "MAIN_MODEL_SLOT_KEYS",
+    "add_provider",
+    "default_value",
+    "list_default_override_keys",
+    "list_providers",
+    "load_config",
+    "remove_provider",
+    "save_config",
+    "update_provider",
+]

cc_switch-0.9.6/cc_switch/__main__.py

@@ -0,0 +1,6 @@
+"""cc-switch CLI entry point (``python -m cc_switch``)."""
+
+from cc_switch.cli import main
+
+if __name__ == "__main__":
+    raise SystemExit(main())

cc_switch-0.9.6/cc_switch/_activate.py

@@ -0,0 +1,142 @@
+"""Activation — materialise a provider/model into ``~/.claude/settings.json``.
+
+Plain ``activate`` fills every model slot with the stock Claude Code
+defaults from :mod:`cc_switch._defaults`; ``--custom`` lets the user
+override each env key interactively before writing.
+
+The secret is read from credstore (by the *api_key_name* referenced in
+the provider config) and injected into the **system environment** as
+``ANTHROPIC_AUTH_TOKEN`` — mirroring ``credstore inject`` (registry on
+Windows, shell profile on Unix).  The generated settings.json never
+contains a credential line, and the env injection survives the transient
+cc-switch process so a new Claude Code session picks it up.
+
+If the secret is missing from credstore, activation fails loudly instead
+of writing an unusable settings.json.
+
+Memory safety: the keyring value is fetched, used, then ``del``-ed
+immediately.
+"""
+
+from __future__ import annotations
+
+import os
+import sys
+
+from cc_switch import _defaults
+
+# Output path — overridable for tests via monkeypatch.
+SETTINGS_PATH = os.path.expanduser("~/.claude/settings.json")
+
+
+class SecretNotFoundError(RuntimeError):
+    """Raised when a provider's api_key_name is not stored in credstore."""
+
+
+def resolve_secret(api_key_name: str) -> str | None:
+    """Read *api_key_name* from credstore (system keyring).
+
+    Returns the secret, or None when the key is not stored or credstore
+    is unavailable.  The caller must ``del`` the returned value after
+    use.  This is the only place cc-switch touches secret material.
+    """
+    try:
+        from credstore import get_credential
+    except Exception:
+        return None
+    return get_credential(api_key_name)
+
+
+def build_env(provider: dict, model_name: str, overrides: dict | None = None) -> dict:
+    """Build the env block for settings.json.
+
+    *overrides* maps env key → value and is used by ``--custom``; a
+    missing key falls back to ``default_value`` — the main-model slots
+    inherit *model_name* (never empty), the rest keep their static
+    default.  Always + ``ANTHROPIC_BASE_URL`` + model — never a secret.
+    """
+    env: dict[str, str] = {}
+    # 1. Every override slot (with the override value where provided)
+    for key in _defaults.DEFAULT_OVERRIDE_KEYS:
+        if overrides and key in overrides:
+            env[key] = str(overrides[key])
+        else:
+            env[key] = _defaults.default_value(key, model_name)
+    # 2. Provider-specific env overrides (applied after the slots)
+    env.update(provider.get("extra_env") or {})
+    # 3. Provider base URL + chosen model
+    env["ANTHROPIC_BASE_URL"] = provider["base_url"]
+    env["ANTHROPIC_MODEL"] = model_name
+    return env
+
+
+def build_settings(provider: dict, model_name: str, overrides: dict | None = None) -> dict:
+    """Return the full settings.json dict (no secret material)."""
+    settings = dict(_defaults.DEFAULT_SETTINGS)
+    settings["env"] = build_env(provider, model_name, overrides)
+    return settings
+
+
+def write_settings(settings: dict) -> None:
+    """Write the settings dict to ``~/.claude/settings.json`` (overrides path)."""
+    import json
+
+    target = SETTINGS_PATH
+    parent = os.path.dirname(target)
+    if parent:
+        os.makedirs(parent, exist_ok=True)
+    with open(target, "w", encoding="utf-8") as fh:
+        json.dump(settings, fh, ensure_ascii=False, indent=2)
+        fh.write("\n")
+
+
+def inject_token(secret: str, shell: str = "auto", output=None) -> None:
+    """Persist *secret* as ``ANTHROPIC_AUTH_TOKEN`` in the system environment.
+
+    Mirrors ``credstore inject``: writes the value to the system env via
+    ``persist_key`` (registry on Windows, shell profile on Unix) so a
+    freshly launched Claude Code session inherits it.  When *output* is
+    a TTY it prints an activation hint (no secret); otherwise it prints
+    the export line for the current shell.
+    """
+    from credstore._shell import format_export, persist_key
+
+    persist_key("ANTHROPIC_AUTH_TOKEN", secret, shell)
+
+    out = output if output is not None else sys.stdout
+    if out.isatty():
+        print(
+            "Injected ANTHROPIC_AUTH_TOKEN into the system environment.",
+            file=out,
+        )
+        print(
+            "Restart your shell (or start a new terminal) for it to take effect.",
+            file=out,
+        )
+    else:
+        print(format_export("ANTHROPIC_AUTH_TOKEN", secret, shell), file=out)
+
+
+def activate(provider: dict, model_name: str, overrides: dict | None = None,
+             shell: str = "auto", output=None) -> dict:
+    """Generate, write settings.json, and inject the secret into the system env.
+
+    Writes settings.json first (so the config shape is in place even if
+    the token lookup then fails), then resolves the API key from
+    credstore.  A missing key raises :class:`SecretNotFoundError` —
+    never a silent skip.  Returns the settings dict that was written.
+    """
+    settings = build_settings(provider, model_name, overrides)
+    write_settings(settings)
+
+    secret = resolve_secret(provider["api_key_name"])
+    if secret is None:
+        raise SecretNotFoundError(
+            f"'{provider['api_key_name']}' is not in credstore.\n"
+            f"Store it first: credstore set {provider['api_key_name']}"
+        )
+    try:
+        inject_token(secret, shell=shell, output=output)
+    finally:
+        del secret
+    return settings