Get the default path for Commander's data directory. Precedence order (highest to lowest): 1. override_path parameter (e.g., from CLI --data-dir) - auto-appends .keeper if needed 2. KEEPER_DATA_HOME environment variable - auto-appends .keeper if needed 3. Legacy ~/.keeper direc
(override_path=None)
| 36 | return logging.getLogger('keeper') |
| 37 | |
| 38 | def get_default_path(override_path=None): |
| 39 | """ |
| 40 | Get the default path for Commander's data directory. |
| 41 | |
| 42 | Precedence order (highest to lowest): |
| 43 | 1. override_path parameter (e.g., from CLI --data-dir) - auto-appends .keeper if needed |
| 44 | 2. KEEPER_DATA_HOME environment variable - auto-appends .keeper if needed |
| 45 | 3. Legacy ~/.keeper directory if it already exists (backward compatibility) |
| 46 | 4. platformdirs.user_data_dir() + .keeper - platform-appropriate location for new installs |
| 47 | |
| 48 | The legacy check uses directory existence rather than an XDG environment |
| 49 | variable so the resolved path is the same whether Commander is launched |
| 50 | from an interactive shell or a context like `systemctl --user` that does |
| 51 | not inherit the user's environment. |
| 52 | |
| 53 | Args: |
| 54 | override_path (str, optional): Override path, typically from CLI argument |
| 55 | |
| 56 | Returns: |
| 57 | Path: The path to use for Commander's data directory |
| 58 | """ |
| 59 | import platformdirs |
| 60 | |
| 61 | def ensure_keeper_suffix(path_str): |
| 62 | expanded = Path(os.path.expanduser(path_str)) |
| 63 | return expanded if expanded.name == '.keeper' else expanded.joinpath('.keeper') |
| 64 | |
| 65 | if override_path: |
| 66 | default_path = ensure_keeper_suffix(override_path) |
| 67 | else: |
| 68 | keeper_data_home = os.getenv('KEEPER_DATA_HOME') |
| 69 | if keeper_data_home: |
| 70 | default_path = ensure_keeper_suffix(keeper_data_home) |
| 71 | else: |
| 72 | legacy_path = Path.home().joinpath('.keeper') |
| 73 | if legacy_path.is_dir(): |
| 74 | default_path = legacy_path |
| 75 | else: |
| 76 | default_path = Path(platformdirs.user_data_dir()).joinpath('.keeper') |
| 77 | |
| 78 | default_path.mkdir(parents=True, exist_ok=True) |
| 79 | return default_path |
| 80 | |
| 81 | |
| 82 | def generate_uid(): # type: () -> str |
nothing calls this directly
no test coverage detected