Skip to content

Commit 172de1f

Browse files
committed
docs(MIGRATION) Note move of test helpers
1 parent 7550295 commit 172de1f

File tree

1 file changed

+35
-0
lines changed

1 file changed

+35
-0
lines changed

MIGRATION

+35
Original file line numberDiff line numberDiff line change
@@ -25,6 +25,41 @@ _Detailed migration steps for the next version will be posted here._
2525

2626
<!-- To the maintainers and contributors: please add migration details for the upcoming release here -->
2727

28+
## libtmux 0.45.x (Yet to be released)
29+
30+
### Test helpers: Module moves
31+
32+
Test helper functionality has been split into focused modules (#XXX):
33+
34+
- `libtmux.test` module split into:
35+
- `libtmux.test.constants`: Test-related constants (`TEST_SESSION_PREFIX`, etc.)
36+
- `libtmux.test.environment`: Environment variable mocking
37+
- `libtmux.test.random`: Random string generation utilities
38+
- `libtmux.test.temporary`: Temporary session/window management
39+
40+
**Breaking**: Import paths have changed. Update imports:
41+
42+
```python
43+
# Old (0.45.x and earlier)
44+
from libtmux.test import (
45+
TEST_SESSION_PREFIX,
46+
get_test_session_name,
47+
get_test_window_name,
48+
namer,
49+
temp_session,
50+
temp_window,
51+
EnvironmentVarGuard,
52+
)
53+
```
54+
55+
```python
56+
# New (0.46.0+)
57+
from libtmux.test.constants import TEST_SESSION_PREFIX
58+
from libtmux.test.environment import EnvironmentVarGuard
59+
from libtmux.test.random import get_test_session_name, get_test_window_name, namer
60+
from libtmux.test.temporary import temp_session, temp_window
61+
```
62+
2863
## 0.35.0: Commands require explicit targets (2024-03-17)
2964

3065
### Commands require explicit targets (#535)

0 commit comments

Comments
 (0)