curryer.kernels.path_utils¶

Kernel utilities for path handling and temp directory management.

This module provides utility functions used across the kernels package, particularly for handling SPICE’s 80-character path limitation.

Attributes¶

logger

Functions¶

`get_short_temp_dir`(→ pathlib.Path)	Get a short base directory for temporary files.
`create_short_symlink`(→ pathlib.Path \| None)	Create a symlink in a short temp directory.
`get_path_strategy_config`(→ dict)	Read path shortening configuration from environment variables.
`_is_file_property`(→ bool)	Check if a property key likely contains file paths.
`_convert_paths_to_strings`(obj)	Recursively convert all Path objects to strings in a data structure.
`copy_to_short_path`(→ pathlib.Path \| None)	Copy file to temp directory with short path.
`update_invalid_paths`(configs[, max_len, try_copy, ...])	Update invalid paths (too long) by creating symlinks or copying to short temp paths.

Module Contents¶

curryer.kernels.path_utils.logger¶

curryer.kernels.path_utils.get_short_temp_dir() → pathlib.Path¶

Get a short base directory for temporary files.

Returns a platform-appropriate short path that respects environment variables for customization. This avoids SPICE’s 80-character path limit by using short base directories.

Returns:: A short base path for temporary directories.
Return type:: Path
Raises:: ValueError – If CURRYER_TEMP_DIR is set to an invalid path (too long).

Notes

Priority order: 1. CURRYER_TEMP_DIR environment variable (if set and validated) 2. /tmp on Unix (bypasses macOS TMPDIR which can be longer by default) 3. C:Temp on Windows (shorter than default AppData path) 4. Python’s tempfile.gettempdir() (fallback, could be 40 characters)

Why not just use tempfile.gettempdir()? - On macOS, TMPDIR is set to /var/folders/…/T (~49 chars) - This leaves only ~30 chars for filenames - We prefer /tmp (4 chars) to maximize filename space (75 chars) - Users can still override with CURRYER_TEMP_DIR if needed

Examples

>>> import os
>>> os.environ["CURRYER_TEMP_DIR"] = "/custom/path"
>>> get_short_temp_dir()
PosixPath('/custom/path')

curryer.kernels.path_utils.create_short_symlink(source_path: pathlib.Path, temp_dir: pathlib.Path) → pathlib.Path | None¶

Create a symlink in a short temp directory.

Uses a simple naming scheme since symlinks are cheap to create/replace. If a symlink already exists, it’s replaced (idempotent operation).

Parameters:

source_path (Path) – Original file path
temp_dir (Path) – Short base directory for symlink (e.g., /tmp)

Returns:

Path to symlink if successful, None if creation failed

Return type:

Path | None

Notes

Works on Linux/macOS by default
May fail on Windows or restricted environments
Failures are logged but don’t raise exceptions
Idempotent: reusing the same symlink name is safe

curryer.kernels.path_utils.get_path_strategy_config() → dict¶

Read path shortening configuration from environment variables.

Supported variables: - CURRYER_DISABLE_COPY: “true” to disable file copying (default: “false”) - CURRYER_TEMP_DIR: Custom short temp directory (handled by get_short_temp_dir())

Returns:: Configuration with keys: disable_copy, try_symlink, try_copy
Return type:: dict

Examples

>>> import os
>>> os.environ["CURRYER_DISABLE_COPY"] = "true"
>>> config = get_path_strategy_config()
>>> config["try_copy"]
False

curryer.kernels.path_utils._is_file_property(key: str) → bool¶

Check if a property key likely contains file paths.

Parameters:: key (str) – Property key name
Returns:: True if the property likely contains file paths
Return type:: bool

Notes

Two matching strategies (either one triggers processing): 1. Regex: Matches keys ending in _FILE or _FILE_NAME (e.g., LEAPSECONDS_FILE, INPUT_DATA_FILE)

This handles most SPICE tool config files which follow this naming convention

Explicit list: Known meta-kernel properties that don’t follow the _FILE convention (clock_kernel, frame_kernel, etc.) - these are standard SPICE meta-kernel keys

This dual approach covers both user configs and meta-kernel properties

curryer.kernels.path_utils._convert_paths_to_strings(obj)¶

Recursively convert all Path objects to strings in a data structure.

Parameters:: obj (any) – Object to convert (dict, list, Path, or other)
Returns:: Object with all Path instances converted to strings
Return type:: any

curryer.kernels.path_utils.copy_to_short_path(source_path: pathlib.Path, temp_dir: pathlib.Path, max_len: int) → pathlib.Path | None¶

Copy file to temp directory with short path.

Returns Path object for consistency with create_short_symlink().

Parameters:

source_path (Path) – Original file path
temp_dir (Path) – Temporary directory base
max_len (int) – Maximum path length (default: 80 for SPICE)

Returns:

Path to copied file if successful, None if copy failed

Return type:

Path | None

Notes

Uses tempfile.mkstemp() for unique naming. Warns if temp directory base path is too long.

curryer.kernels.path_utils.update_invalid_paths(configs, max_len=80, try_copy=True, parent_dir=None, temp_dir=None)¶

Update invalid paths (too long) by creating symlinks or copying to short temp paths.

Attempts to fix paths that exceed the maximum length by trying strategies in order: 1. Symlink to temp directory with short path (always tried first - zero cost) 2. Copy file to temp directory with short path (fallback if symlink fails)

Parameters:

configs (dict) – Configuration dictionary to update
max_len (int) – Maximum path length (default: 80 for SPICE string values)
try_copy (bool) – Try to copy file to temp directory with short path (default: True)
parent_dir (Path) – Parent directory for resolving relative paths
temp_dir (Path) – Base directory for temp copies (default: uses tempfile.gettempdir())

Returns:

(updated_config_dict, list_of_temp_files) - updated_config_dict: Configuration with shortened paths - list_of_temp_files: List of temp file paths created (for cleanup)

Return type:

tuple