kivy / kivy / 21880842821

56%

Build Type

push

github

Committed by web-flow

Commit Message

Add `user_cache_dir` property and fix Linux `user_data_dir` (#9255)

* Add user_cache_dir and KIVY_DESKTOP_PATH_ID for desktop platforms

This adds support for user cache directories and application-specific
configuration paths on desktop platforms (Windows, macOS, Linux).

New Features:
- Add App.user_cache_dir property for cache data
- Add KIVY_DESKTOP_PATH_ID environment variable for app-specific paths
- Enhance normalize_path_id with Unicode NFC normalization
- Add length limiting (120 chars) to normalize_path_id
- Remove control and format characters including zero-width chars
- Collapse consecutive underscores for cleaner paths

Platform Paths:
- Windows: %APPDATA%\<app_name>\Cache
- macOS: ~/Library/Caches/<app_name>
- Linux: ~/.cache/<app_name> (respects $XDG_CACHE_HOME)

Key Feature:
Setting KIVY_DESKTOP_PATH_ID creates application-specific locations
for .kivy directories (config and logs). Without it, config and logs
are placed in a single global .kivy directory shared by all apps.

Tests:
- Add 12 comprehensive tests for normalize_path_id
- All tests passing (43 total in test_utils.py)
- Tests cover Unicode normalization, emoji, edge cases

Documentation:
- Update migration.rst with key feature highlights
- Update environment.rst with detailed KIVY_DESKTOP_PATH_ID docs
- Add examples and platform-specific path information

Co-authored-by: Cursor <cursoragent@cursor.com>

* Removed useless tests prior to makedirs calls with exists_ok=True.

* updated to read kivy_home_dir

Co-authored-by: Cursor <cursoragent@cursor.com>

---------

Co-authored-by: Cursor <cursoragent@cursor.com>

Run Details

2878 of 6074 branches covered (47.38%)

122 of 153 new or added lines in 5 files covered. (79.74%)

1 existing line in 1 file now uncovered.

24097 of 43206 relevant lines covered (55.77%)

1.1 hits per line