Skip to content

ccproxy.config.discovery

ccproxy.config.discovery

find_toml_config_file 

find_toml_config_file()

Find the TOML configuration file for ccproxy.

Searches in the following order: 1. .ccproxy.toml in current directory 2. ccproxy.toml in git repository root (if in a git repo) 3. config.toml in XDG_CONFIG_HOME/ccproxy/

Source code in ccproxy/config/discovery.py 
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
def find_toml_config_file() -> Path | None:
    """Find the TOML configuration file for ccproxy.

    Searches in the following order:
    1. .ccproxy.toml in current directory
    2. ccproxy.toml in git repository root (if in a git repo)
    3. config.toml in XDG_CONFIG_HOME/ccproxy/
    """
    # Check current directory first
    candidates = [
        Path(".ccproxy.toml").resolve(),
        Path("ccproxy.toml").resolve(),
    ]

    # Check git repo root
    git_root = find_git_root()
    if git_root:
        candidates.extend(
            [
                git_root / ".ccproxy.toml",
                git_root / "ccproxy.toml",
            ]
        )

    # Check XDG config directory
    config_dir = get_ccproxy_config_dir()
    candidates.append(config_dir / "config.toml")

    # Return first existing file
    for candidate in candidates:
        if candidate.exists() and candidate.is_file():
            return candidate

    return None

find_git_root 

find_git_root(path=None)

Find the root directory of a git repository.

Source code in ccproxy/config/discovery.py 
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
def find_git_root(path: Path | None = None) -> Path | None:
    """Find the root directory of a git repository."""
    import subprocess

    if path is None:
        path = Path.cwd()

    try:
        result = subprocess.run(
            ["git", "rev-parse", "--show-toplevel"],
            cwd=path,
            capture_output=True,
            text=True,
            check=True,
        )
        return Path(result.stdout.strip())
    except (subprocess.CalledProcessError, FileNotFoundError):
        return None

get_ccproxy_config_dir 

get_ccproxy_config_dir()

Get the ccproxy configuration directory.

Returns:

Type Description
Path

Path to the ccproxy configuration directory within XDG_CONFIG_HOME.
Source code in ccproxy/config/discovery.py 
63
64
65
66
67
68
69
def get_ccproxy_config_dir() -> Path:
    """Get the ccproxy configuration directory.

    Returns:
        Path to the ccproxy configuration directory within XDG_CONFIG_HOME.
    """
    return get_xdg_config_home() / "ccproxy"

get_claude_cli_config_dir 

get_claude_cli_config_dir()

Get the Claude CLI configuration directory.

Returns:

Type Description
Path

Path to the Claude CLI configuration directory within XDG_CONFIG_HOME.
Source code in ccproxy/config/discovery.py 
72
73
74
75
76
77
78
def get_claude_cli_config_dir() -> Path:
    """Get the Claude CLI configuration directory.

    Returns:
        Path to the Claude CLI configuration directory within XDG_CONFIG_HOME.
    """
    return get_xdg_config_home() / "claude"

get_claude_docker_home_dir 

get_claude_docker_home_dir()

Get the Claude Docker home directory.

Returns:

Type Description
Path

Path to the Claude Docker home directory within XDG_DATA_HOME.
Source code in ccproxy/config/discovery.py 
81
82
83
84
85
86
87
def get_claude_docker_home_dir() -> Path:
    """Get the Claude Docker home directory.

    Returns:
        Path to the Claude Docker home directory within XDG_DATA_HOME.
    """
    return get_ccproxy_config_dir() / "home"