slurp-ui 0.8.1__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (157) hide show
  1. slurp_ui-0.8.1/.gitignore +224 -0
  2. slurp_ui-0.8.1/CHANGELOG.md +192 -0
  3. slurp_ui-0.8.1/LICENSE +674 -0
  4. slurp_ui-0.8.1/PKG-INFO +88 -0
  5. slurp_ui-0.8.1/README.md +37 -0
  6. slurp_ui-0.8.1/docs/changelog.md +1 -0
  7. slurp_ui-0.8.1/docs/development.md +107 -0
  8. slurp_ui-0.8.1/docs/guide/checks.md +95 -0
  9. slurp_ui-0.8.1/docs/guide/copying.md +16 -0
  10. slurp_ui-0.8.1/docs/guide/files.md +21 -0
  11. slurp_ui-0.8.1/docs/guide/job-list.md +82 -0
  12. slurp_ui-0.8.1/docs/guide/job-window.md +45 -0
  13. slurp_ui-0.8.1/docs/guide/keyboard.md +24 -0
  14. slurp_ui-0.8.1/docs/guide/overview.md +26 -0
  15. slurp_ui-0.8.1/docs/guide/settings.md +39 -0
  16. slurp_ui-0.8.1/docs/guide/ssh.md +83 -0
  17. slurp_ui-0.8.1/docs/guide/storage.md +18 -0
  18. slurp_ui-0.8.1/docs/guide/tabs.md +50 -0
  19. slurp_ui-0.8.1/docs/images/files.svg +266 -0
  20. slurp_ui-0.8.1/docs/images/job-details.svg +270 -0
  21. slurp_ui-0.8.1/docs/images/jobs.svg +273 -0
  22. slurp_ui-0.8.1/docs/images/logo-256.png +0 -0
  23. slurp_ui-0.8.1/docs/images/logo-plain.svg +1 -0
  24. slurp_ui-0.8.1/docs/images/logo-wordmark.svg +1 -0
  25. slurp_ui-0.8.1/docs/images/logo.ico +0 -0
  26. slurp_ui-0.8.1/docs/images/logo.svg +1 -0
  27. slurp_ui-0.8.1/docs/images/overview.svg +259 -0
  28. slurp_ui-0.8.1/docs/index.md +50 -0
  29. slurp_ui-0.8.1/docs/install.md +84 -0
  30. slurp_ui-0.8.1/docs/remote/browser.md +55 -0
  31. slurp_ui-0.8.1/docs/remote/helper.md +96 -0
  32. slurp_ui-0.8.1/docs/remote/links.md +106 -0
  33. slurp_ui-0.8.1/docs/remote/web-access.md +64 -0
  34. slurp_ui-0.8.1/mkdocs.yml +91 -0
  35. slurp_ui-0.8.1/pyproject.toml +88 -0
  36. slurp_ui-0.8.1/src/slurp/__init__.py +11 -0
  37. slurp_ui-0.8.1/src/slurp/__main__.py +4 -0
  38. slurp_ui-0.8.1/src/slurp/checks/__init__.py +6 -0
  39. slurp_ui-0.8.1/src/slurp/checks/engine.py +1323 -0
  40. slurp_ui-0.8.1/src/slurp/checks/environment.py +112 -0
  41. slurp_ui-0.8.1/src/slurp/checks/fixes.py +124 -0
  42. slurp_ui-0.8.1/src/slurp/checks/guides.py +185 -0
  43. slurp_ui-0.8.1/src/slurp/checks/packs/cscs-alps.toml +21 -0
  44. slurp_ui-0.8.1/src/slurp/checks/packs/juelich-jedi.toml +5 -0
  45. slurp_ui-0.8.1/src/slurp/checks/packs/juelich-jureca.toml +5 -0
  46. slurp_ui-0.8.1/src/slurp/checks/packs/juelich-jusuf.toml +5 -0
  47. slurp_ui-0.8.1/src/slurp/checks/packs/juelich-juwels.toml +5 -0
  48. slurp_ui-0.8.1/src/slurp/checks/placement.py +152 -0
  49. slurp_ui-0.8.1/src/slurp/checks/rulepacks.py +85 -0
  50. slurp_ui-0.8.1/src/slurp/checks/rules.py +1562 -0
  51. slurp_ui-0.8.1/src/slurp/checks/templates.py +110 -0
  52. slurp_ui-0.8.1/src/slurp/cli.py +146 -0
  53. slurp_ui-0.8.1/src/slurp/cluster/__init__.py +1 -0
  54. slurp_ui-0.8.1/src/slurp/cluster/categories.py +279 -0
  55. slurp_ui-0.8.1/src/slurp/cluster/details.py +375 -0
  56. slurp_ui-0.8.1/src/slurp/cluster/jobcache.py +108 -0
  57. slurp_ui-0.8.1/src/slurp/cluster/jobs.py +790 -0
  58. slurp_ui-0.8.1/src/slurp/cluster/paths.py +169 -0
  59. slurp_ui-0.8.1/src/slurp/cluster/remote.py +741 -0
  60. slurp_ui-0.8.1/src/slurp/cluster/slurm.py +54 -0
  61. slurp_ui-0.8.1/src/slurp/cluster/storage.py +167 -0
  62. slurp_ui-0.8.1/src/slurp/config.py +41 -0
  63. slurp_ui-0.8.1/src/slurp/launch.py +14 -0
  64. slurp_ui-0.8.1/src/slurp/links/__init__.py +1 -0
  65. slurp_ui-0.8.1/src/slurp/links/cloudflare.py +126 -0
  66. slurp_ui-0.8.1/src/slurp/links/holder.py +1042 -0
  67. slurp_ui-0.8.1/src/slurp/links/linux/__init__.py +88 -0
  68. slurp_ui-0.8.1/src/slurp/links/linux/slurp_helper.py +809 -0
  69. slurp_ui-0.8.1/src/slurp/links/mounts.py +318 -0
  70. slurp_ui-0.8.1/src/slurp/links/share.py +1239 -0
  71. slurp_ui-0.8.1/src/slurp/links/windows/__init__.py +1 -0
  72. slurp_ui-0.8.1/src/slurp/links/windows/windrive.ps1 +442 -0
  73. slurp_ui-0.8.1/src/slurp/links/windows/windrive.py +99 -0
  74. slurp_ui-0.8.1/src/slurp/links/windows/winhelper.cs +266 -0
  75. slurp_ui-0.8.1/src/slurp/links/windows/winhelper.ps1 +1534 -0
  76. slurp_ui-0.8.1/src/slurp/links/windows/winhelper.py +150 -0
  77. slurp_ui-0.8.1/src/slurp/scripts/memory_probe.sh +35 -0
  78. slurp_ui-0.8.1/src/slurp/scripts/placement.sh +27 -0
  79. slurp_ui-0.8.1/src/slurp/state.py +113 -0
  80. slurp_ui-0.8.1/src/slurp/ui/__init__.py +1 -0
  81. slurp_ui-0.8.1/src/slurp/ui/app.py +2337 -0
  82. slurp_ui-0.8.1/src/slurp/ui/fonts/LICENSE.txt +29 -0
  83. slurp_ui-0.8.1/src/slurp/ui/fonts/slurp-icons.ttf +0 -0
  84. slurp_ui-0.8.1/src/slurp/ui/icons.py +146 -0
  85. slurp_ui-0.8.1/src/slurp/ui/logo.py +189 -0
  86. slurp_ui-0.8.1/src/slurp/ui/screens/__init__.py +1 -0
  87. slurp_ui-0.8.1/src/slurp/ui/screens/array.py +394 -0
  88. slurp_ui-0.8.1/src/slurp/ui/screens/base.py +105 -0
  89. slurp_ui-0.8.1/src/slurp/ui/screens/categories.py +597 -0
  90. slurp_ui-0.8.1/src/slurp/ui/screens/checks.py +274 -0
  91. slurp_ui-0.8.1/src/slurp/ui/screens/clusterinfo.py +281 -0
  92. slurp_ui-0.8.1/src/slurp/ui/screens/connection.py +477 -0
  93. slurp_ui-0.8.1/src/slurp/ui/screens/core.py +192 -0
  94. slurp_ui-0.8.1/src/slurp/ui/screens/dialogs.py +550 -0
  95. slurp_ui-0.8.1/src/slurp/ui/screens/files.py +603 -0
  96. slurp_ui-0.8.1/src/slurp/ui/screens/hdf5.py +629 -0
  97. slurp_ui-0.8.1/src/slurp/ui/screens/help.py +560 -0
  98. slurp_ui-0.8.1/src/slurp/ui/screens/job.py +795 -0
  99. slurp_ui-0.8.1/src/slurp/ui/screens/links.py +897 -0
  100. slurp_ui-0.8.1/src/slurp/ui/screens/main.py +114 -0
  101. slurp_ui-0.8.1/src/slurp/ui/screens/menu.py +80 -0
  102. slurp_ui-0.8.1/src/slurp/ui/screens/options.py +166 -0
  103. slurp_ui-0.8.1/src/slurp/ui/screens/overview.py +236 -0
  104. slurp_ui-0.8.1/src/slurp/ui/screens/placement.py +127 -0
  105. slurp_ui-0.8.1/src/slurp/ui/screens/script.py +516 -0
  106. slurp_ui-0.8.1/src/slurp/ui/screens/shell.py +224 -0
  107. slurp_ui-0.8.1/src/slurp/ui/screens/storage.py +349 -0
  108. slurp_ui-0.8.1/src/slurp/ui/screens/wizard.py +171 -0
  109. slurp_ui-0.8.1/src/slurp/ui/terminal.py +591 -0
  110. slurp_ui-0.8.1/src/slurp/ui/widgets.py +185 -0
  111. slurp_ui-0.8.1/tests/conftest.py +63 -0
  112. slurp_ui-0.8.1/tests/e2e/conftest.py +96 -0
  113. slurp_ui-0.8.1/tests/e2e/lab/__init__.py +195 -0
  114. slurp_ui-0.8.1/tests/e2e/lab/bin/lfs +9 -0
  115. slurp_ui-0.8.1/tests/e2e/lab/bin/quota +3 -0
  116. slurp_ui-0.8.1/tests/e2e/lab/bin/srun +16 -0
  117. slurp_ui-0.8.1/tests/e2e/lab/bin/stat +5 -0
  118. slurp_ui-0.8.1/tests/e2e/lab/fakeslurm.py +159 -0
  119. slurp_ui-0.8.1/tests/e2e/linkkit.py +97 -0
  120. slurp_ui-0.8.1/tests/e2e/test_holder.py +207 -0
  121. slurp_ui-0.8.1/tests/e2e/test_links_linux.py +173 -0
  122. slurp_ui-0.8.1/tests/e2e/test_links_share.py +162 -0
  123. slurp_ui-0.8.1/tests/e2e/test_links_web.py +98 -0
  124. slurp_ui-0.8.1/tests/e2e/test_links_windows.py +568 -0
  125. slurp_ui-0.8.1/tests/e2e/test_ui_arrays.py +36 -0
  126. slurp_ui-0.8.1/tests/e2e/test_ui_categories.py +14 -0
  127. slurp_ui-0.8.1/tests/e2e/test_ui_connection.py +34 -0
  128. slurp_ui-0.8.1/tests/e2e/test_ui_drive.py +6 -0
  129. slurp_ui-0.8.1/tests/e2e/test_ui_help.py +30 -0
  130. slurp_ui-0.8.1/tests/e2e/test_ui_jobs.py +52 -0
  131. slurp_ui-0.8.1/tests/e2e/test_ui_links.py +26 -0
  132. slurp_ui-0.8.1/tests/e2e/test_ui_scripts.py +18 -0
  133. slurp_ui-0.8.1/tests/e2e/test_ui_settings.py +10 -0
  134. slurp_ui-0.8.1/tests/e2e/test_ui_storage.py +14 -0
  135. slurp_ui-0.8.1/tests/e2e/ui_scenarios.py +2686 -0
  136. slurp_ui-0.8.1/tests/ui/conftest.py +24 -0
  137. slurp_ui-0.8.1/tests/ui/test_connect_button.py +45 -0
  138. slurp_ui-0.8.1/tests/ui/test_dir_subtabs.py +60 -0
  139. slurp_ui-0.8.1/tests/ui/test_helper_ui.py +53 -0
  140. slurp_ui-0.8.1/tests/ui/test_icons_ui.py +66 -0
  141. slurp_ui-0.8.1/tests/ui/test_job_rows.py +22 -0
  142. slurp_ui-0.8.1/tests/ui/test_loading.py +52 -0
  143. slurp_ui-0.8.1/tests/ui/test_menu.py +65 -0
  144. slurp_ui-0.8.1/tests/ui/test_no_slurm.py +42 -0
  145. slurp_ui-0.8.1/tests/ui/test_open_on_client.py +14 -0
  146. slurp_ui-0.8.1/tests/ui/test_overview.py +91 -0
  147. slurp_ui-0.8.1/tests/unit/test_categories.py +65 -0
  148. slurp_ui-0.8.1/tests/unit/test_checks.py +260 -0
  149. slurp_ui-0.8.1/tests/unit/test_icons.py +56 -0
  150. slurp_ui-0.8.1/tests/unit/test_jobcache.py +61 -0
  151. slurp_ui-0.8.1/tests/unit/test_linux_helper.py +86 -0
  152. slurp_ui-0.8.1/tests/unit/test_logo.py +37 -0
  153. slurp_ui-0.8.1/tests/unit/test_progress_pattern.py +32 -0
  154. slurp_ui-0.8.1/tests/unit/test_ui_style.py +20 -0
  155. slurp_ui-0.8.1/tools/make_icon_font.py +76 -0
  156. slurp_ui-0.8.1/tools/make_logo_files.py +9 -0
  157. slurp_ui-0.8.1/tools/make_screenshots.py +187 -0
@@ -0,0 +1,224 @@
1
+ # Byte-compiled / optimized / DLL files
2
+ __pycache__/
3
+ *.py[codz]
4
+ *$py.class
5
+
6
+ # C extensions
7
+ *.so
8
+
9
+ # Distribution / packaging
10
+ .Python
11
+ build/
12
+ develop-eggs/
13
+ dist/
14
+ downloads/
15
+ eggs/
16
+ .eggs/
17
+ lib/
18
+ lib64/
19
+ parts/
20
+ sdist/
21
+ var/
22
+ wheels/
23
+ share/python-wheels/
24
+ *.egg-info/
25
+ .installed.cfg
26
+ *.egg
27
+ MANIFEST
28
+
29
+ # PyInstaller
30
+ # Usually these files are written by a python script from a template
31
+ # before PyInstaller builds the exe, so as to inject date/other infos into it.
32
+ *.manifest
33
+ *.spec
34
+
35
+ # Installer logs
36
+ pip-log.txt
37
+ pip-delete-this-directory.txt
38
+
39
+ # Unit test / coverage reports
40
+ htmlcov/
41
+ .tox/
42
+ .nox/
43
+ .coverage
44
+ .coverage.*
45
+ .cache
46
+ nosetests.xml
47
+ coverage.xml
48
+ *.cover
49
+ *.py.cover
50
+ *.lcov
51
+ .hypothesis/
52
+ .pytest_cache/
53
+ cover/
54
+
55
+ # Translations
56
+ *.mo
57
+ *.pot
58
+
59
+ # Django stuff:
60
+ *.log
61
+ local_settings.py
62
+ db.sqlite3
63
+ db.sqlite3-journal
64
+
65
+ # Flask stuff:
66
+ instance/
67
+ .webassets-cache
68
+
69
+ # Scrapy stuff:
70
+ .scrapy
71
+
72
+ # Sphinx documentation
73
+ docs/_build/
74
+
75
+ # PyBuilder
76
+ .pybuilder/
77
+ target/
78
+
79
+ # Jupyter Notebook
80
+ .ipynb_checkpoints
81
+
82
+ # IPython
83
+ profile_default/
84
+ ipython_config.py
85
+
86
+ # pyenv
87
+ # For a library or package, you might want to ignore these files since the code is
88
+ # intended to run in multiple environments; otherwise, check them in:
89
+ # .python-version
90
+
91
+ # pipenv
92
+ # According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
93
+ # However, in case of collaboration, if having platform-specific dependencies or dependencies
94
+ # having no cross-platform support, pipenv may install dependencies that don't work, or not
95
+ # install all needed dependencies.
96
+ # Pipfile.lock
97
+
98
+ # uv
99
+ # Similar to Pipfile.lock, it is generally recommended to include uv.lock in version control.
100
+ # This is especially recommended for binary packages to ensure reproducibility, and is more
101
+ # commonly ignored for libraries.
102
+ # uv.lock
103
+
104
+ # poetry
105
+ # Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
106
+ # This is especially recommended for binary packages to ensure reproducibility, and is more
107
+ # commonly ignored for libraries.
108
+ # https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
109
+ # poetry.lock
110
+ # poetry.toml
111
+
112
+ # pdm
113
+ # Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
114
+ # pdm recommends including project-wide configuration in pdm.toml, but excluding .pdm-python.
115
+ # https://pdm-project.org/en/latest/usage/project/#working-with-version-control
116
+ # pdm.lock
117
+ # pdm.toml
118
+ .pdm-python
119
+ .pdm-build/
120
+
121
+ # pixi
122
+ # Similar to Pipfile.lock, it is generally recommended to include pixi.lock in version control.
123
+ # pixi.lock
124
+ # Pixi creates a virtual environment in the .pixi directory, just like venv module creates one
125
+ # in the .venv directory. It is recommended not to include this directory in version control.
126
+ .pixi/*
127
+ !.pixi/config.toml
128
+
129
+ # PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
130
+ __pypackages__/
131
+
132
+ # Celery stuff
133
+ celerybeat-schedule*
134
+ celerybeat.pid
135
+
136
+ # Redis
137
+ *.rdb
138
+ *.aof
139
+ *.pid
140
+
141
+ # RabbitMQ
142
+ mnesia/
143
+ rabbitmq/
144
+ rabbitmq-data/
145
+
146
+ # ActiveMQ
147
+ activemq-data/
148
+
149
+ # SageMath parsed files
150
+ *.sage.py
151
+
152
+ # Environments
153
+ .env
154
+ .envrc
155
+ .venv
156
+ env/
157
+ venv/
158
+ ENV/
159
+ env.bak/
160
+ venv.bak/
161
+
162
+ # Spyder project settings
163
+ .spyderproject
164
+ .spyproject
165
+
166
+ # Rope project settings
167
+ .ropeproject
168
+
169
+ # mkdocs/Zensical documentation
170
+ /site
171
+
172
+ # mypy
173
+ .mypy_cache/
174
+ .dmypy.json
175
+ dmypy.json
176
+
177
+ # Pyre type checker
178
+ .pyre/
179
+
180
+ # pytype static type analyzer
181
+ .pytype/
182
+
183
+ # Cython debug symbols
184
+ cython_debug/
185
+
186
+ # PyCharm
187
+ # JetBrains specific template is maintained in a separate JetBrains.gitignore that can
188
+ # be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
189
+ # and can be added to the global gitignore or merged into this file. For a more nuclear
190
+ # option (not recommended) you can uncomment the following to ignore the entire idea folder.
191
+ # .idea/
192
+
193
+ # Abstra
194
+ # Abstra is an AI-powered process automation framework.
195
+ # Ignore directories containing user credentials, local state, and settings.
196
+ # Learn more at https://abstra.io/docs
197
+ .abstra/
198
+
199
+ # Visual Studio Code
200
+ # Visual Studio Code specific template is maintained in a separate VisualStudioCode.gitignore that
201
+ # can be found at https://github.com/github/gitignore/blob/main/Global/VisualStudioCode.gitignore
202
+ # and can be added to the global gitignore or merged into this file. However, if you prefer, you
203
+ # could uncomment the following to ignore the entire vscode folder
204
+ # .vscode/
205
+ # Temporary file for partial code execution
206
+ tempCodeRunnerFile.py
207
+
208
+ # Ruff stuff:
209
+ .ruff_cache/
210
+
211
+ # PyPI configuration file
212
+ .pypirc
213
+
214
+ # Marimo
215
+ marimo/_static/
216
+ marimo/_lsp/
217
+ __marimo__/
218
+
219
+ # Streamlit
220
+ .streamlit/secrets.toml
221
+
222
+ # Sublime Text: project and workspace files are personal
223
+ *.sublime-project
224
+ *.sublime-workspace
@@ -0,0 +1,192 @@
1
+ # Changelog
2
+
3
+ slurp and its Windows helper share one version number. Beta: settings, link
4
+ formats and the helper may still change between versions (a link from one
5
+ version may need the helper of the same version).
6
+
7
+ ## Unreleased
8
+
9
+ ## 0.8.1 (beta), 2026-11-17
10
+
11
+ - On PyPI as `slurp-ui`: `pip install "slurp-ui[all]"` (or `pipx install`); the
12
+ command stays `slurp`. A tag `v<version>` publishes a release.
13
+ - Files and directories always open in a subtab of their own, wherever they
14
+ are opened (the files of a job, a path in a file, a file in a directory);
15
+ where they were opened stays as it was. Opening one again shows its
16
+ subtab. A folder entered in a directory view stays in that subtab (`←`
17
+ goes back).
18
+ - A plain button (Close, Cancel, a tab not shown, …) has a box of its own, a
19
+ shade lighter than the window, like the coloured ones: before, only its
20
+ word showed, and the coloured button next to it looked much bigger.
21
+ - Icons in front of tabs, buttons, menu items, the states of jobs and the
22
+ files of a folder: the Material Design icons of Nerd Fonts, every one a
23
+ cell wide. A terminal draws them from slurp's icon font (8 KB): install it
24
+ once on the machine of the terminal you look through with
25
+ `slurp --install-font` (a Nerd Font works too); the browser view loads it
26
+ itself. **Options** → **Icons**: icons (the
27
+ default), Unicode symbols (no font, but uneven in most fonts), or none.
28
+ - The header (slurp and its version) is the top line, above the tabs, and has
29
+ **☰ Menu** at its left, in every window (it was in the job list's toolbar
30
+ and the overview).
31
+ - **Quota** and **Health** are windows again, not subtabs: they open over the
32
+ job list or the overview, `Esc` or **Close** closes them.
33
+ - Quota, Health, Categories and the window of a job array no longer cover the
34
+ whole screen while they load (Textual's loading indicator took every click
35
+ until they were done).
36
+ - The menu (`F10`) has **Job list** (`j`), so it opens from the overview's
37
+ menu too.
38
+ - slurp no longer logs in at the start: a cluster tab shows **Connect** in its
39
+ overview. Only a tab added with `+` logs in right away. Connected, the
40
+ overview has **Disconnect**.
41
+ - The job list shows only **Done: current pace**; the *same pace* column is
42
+ gone (the job window still shows both estimates).
43
+ - The `--ssh` option is gone: `+` adds a tab for a cluster, and slurp starts
44
+ with the tabs of the last run.
45
+ - Without Slurm on the machine of a tab (no `squeue`), the job list says so
46
+ in its middle, with what to do (a tab for a cluster with `+`), instead of an error notification for every Slurm command at
47
+ each load. `r` looks again.
48
+ - The documentation is a website now, <https://chaoos.github.io/slurp/>
49
+ (Material for MkDocs): the manual is split into pages (the overview, the
50
+ job list, the job window, …, shells and drives, the helper, web access,
51
+ development), with search and the changelog. GitHub Actions builds it for
52
+ every push and pull request (`mkdocs build --strict`: a broken link fails)
53
+ and publishes it from main. The README is a short start page; `.[docs]`
54
+ installs MkDocs.
55
+ - A tab starts with no subtab open, and then shows its **overview**: in its
56
+ middle the cluster in a line (site, Slurm version, nodes and partitions),
57
+ its health (healthy, degraded or unhealthy, and why), the SSH session, and
58
+ **Jobs** (with how many run and wait; *No Slurm available* where there is
59
+ none), **Quota** and **Health**; not connected, **Connect** with what
60
+ happened to the connection. The job list is a subtab like the others, with
61
+ a `✕` (and `Ctrl-W`); when the last subtab closes, the overview shows again.
62
+ Cluster info is called **Health** (`C`). *At the start a tab shows* in
63
+ Options keeps the job list open from the start (`"start_page": "jobs"`).
64
+ - The buttons of the job list's toolbar are a menu now: **☰ Menu** (`F10`)
65
+ has cluster overview, quota, scratch, shells, the login directory and drive,
66
+ interactive job, new job script, categories, web access, guides, rule
67
+ catalogue, options, about and quit, each with its key. The toolbar keeps
68
+ Reload and the choices of the list. Textual's command palette (and its ⭘ at
69
+ the top left) is gone; themes are chosen in Options (`F3`).
70
+ - Web links (this slurp in a browser) belong to no tab: the connection
71
+ window of every tab lists them, not only that of the tab they were made in.
72
+ - The slurp helper for Linux: **Open on my computer** in a link window, the
73
+ password, and a drive is mounted (sshfs, `~/slurp/<link>/<folder>`) and
74
+ opened in the file manager, a web view opens in the browser, or a terminal
75
+ window opens with the shell, as the Windows helper does. One Python script
76
+ (only python3 needed), set up once from **Set up the helper…** (tab Linux):
77
+ a setup to download or one line to paste; dialogs with zenity or kdialog,
78
+ desktop notifications, `slurp-helper list` / `stop`.
79
+ - Helper links of an own relay given as `user@host` were refused by the
80
+ Windows helper ("no valid 'rh'"): the link now carries only the host there.
81
+ - Switching to a tab without an SSH session no longer logs in right away:
82
+ its job list shows a **Connect** button in the middle (a bar above the jobs
83
+ from last time, if it has some). A click on the active tab logs in, too.
84
+ - Back on a tab with jobs after one without Slurm, the job list has the focus
85
+ again (it was drawn in the unfocused colours).
86
+ - In a browser (`slurp --serve`, or the browser view of the session holder),
87
+ a web page (a site's status page, a link in the help or the checks) opens in
88
+ a new tab, so the page with slurp stays. The links in the help and the checks
89
+ open in that browser now, not on the machine slurp runs on.
90
+ - All buttons are compact (one line, as wide as their label): the toolbar of
91
+ the job list, the job window, the dialogs and the other windows had a mix of
92
+ three-line and one-line ones. The toolbar of the job list fits in one row
93
+ with its choices.
94
+ - The tagline is "All of slurm in one slurp" (was "Slurm at a glance").
95
+ - slurp could end right at its start with an error (no attribute "main")
96
+ when its 0.25 s timer came before the job list was shown.
97
+ - Save to a file (the copy window) uses the cache directory as it is when
98
+ saving ($XDG_CACHE_HOME), not as it was when slurp started.
99
+ - An array task's progress file: when the files of the other tasks are
100
+ guessed from it, a number in the directory that happens to equal the task's
101
+ index (`run1/`, `pytest-1/`) is no longer taken for it, when the file name
102
+ has the index or the job id.
103
+ - slurp has its own repository (https://github.com/chaoos/slurp); it no
104
+ longer needs `slurm.py` and the other modules of the scripts repository it
105
+ started in.
106
+ - slurp is a Python package to install (`pyproject.toml`): `pip install
107
+ ".[all]"` gives the `slurp` command (and `python -m slurp`); `pipx install`
108
+ works without a clone. The optional features are extras: `links`, `hdf5`,
109
+ `web`, `all`. `requirements.txt` is gone, and `python3 slurp` from the
110
+ checkout no longer works without installing. slurp starts itself again (the
111
+ session holder, the app under it, `--serve`) as exactly the same copy,
112
+ installed or not.
113
+ - The changelog is at the top of the repository (`CHANGELOG.md`), the manual
114
+ is `docs/manual.md` and its images are in `docs/images/` (they were in the
115
+ package directory); `python tools/make_logo_files.py` writes the logo files
116
+ (was `python -m slurp.logo`). The About window links both.
117
+ - The code is in `src/slurp/`, in subpackages by what it does: `cluster/`
118
+ (Slurm, the jobs and their files), `checks/` (the checks of batch scripts;
119
+ the built-in rule packs are `checks/packs/`), `links/` (shells, drives and
120
+ web views on your own machine, the session holder) and `ui/` (the app and
121
+ its windows). Your own rule packs stay in `~/.config/slurp/rules/`.
122
+ - The tests are in the repository (`tests/`, run with `pytest`), with a
123
+ GitHub Actions workflow: the unit tests, and the lab tests that drive slurp
124
+ against a fake Slurm cluster behind a local sshd.
125
+ - The job list is kept on this machine after each load: a start shows it at
126
+ once, and when the cluster cannot be reached it can still be browsed and
127
+ categorized (the changes reach the cluster with the next load); the status
128
+ line says it may be outdated.
129
+
130
+ - When the login to a cluster fails (or the connection is lost), slurp says to
131
+ check its site's status page, as a link: for CSCS https://status.cscs.ch,
132
+ for JSC https://status.jsc.fz-juelich.de/ (the rule pack's new key
133
+ "status"); in the status at the bottom right and in the connection window.
134
+ - Rule packs for JSC's JURECA, JUWELS, JUSUF and JEDI: their documentation
135
+ (for the guides) and the status page.
136
+
137
+ - Categories of jobs, like folders (`project X/production runs`): mark jobs
138
+ in the job list (`m`), put them in a category (`c`, a new one is made); a
139
+ Category column, `cat:` in the filter; the Categories window (`K`): the
140
+ tree, each one's numbers (jobs by state, node, CPU and GPU hours, when,
141
+ where) and its jobs, also old ones; new, rename/move, delete; "not
142
+ categorized" (the jobs of the job list in none, `cat:-` in the filter). Kept
143
+ on the cluster, per Slurm cluster.
144
+
145
+ - Web links through Cloudflare: a quick tunnel (cloudflared, no account; slurp
146
+ asks, then downloads it once, and the link window shows downloading and
147
+ installing it) gives the web view a public https address that opens in any
148
+ browser, with nothing to install on your side and no password.
149
+ - The web view needs the token in the URL every time; no cookie from an
150
+ earlier visit opens it (each page load gets a one-use ticket).
151
+ - In the connection window, the web session of the browser you are on is
152
+ marked "this view"; disconnecting or revoking it warns first.
153
+ - The links list has a health column for every link and session (as for the
154
+ SSH login: a heartbeat, reconnects); a drive lists the folders its clients
155
+ mounted, with their reconnects.
156
+ - **? slurp** at the top right: slurp in general, its version, the machine it
157
+ runs on (Copy details for a bug report); also "About slurp" in the palette.
158
+ - The Windows helper has one window: the connections, and below them the one
159
+ selected with its settings and steps (no window per connection any more); a
160
+ right click on a row: open, map another folder, unmap one, open another
161
+ shell, reconnect, disconnect, logs, copy the details, remove. The
162
+ "Helper ..." button is gone (the tray's menu has the helper's settings).
163
+
164
+ - In the browser, a download (Download the setup of the Windows helper)
165
+ opens in a new tab: slurp's page stays; if the browser blocks the tab, a
166
+ banner has the download to click.
167
+ - Closed links say which way they went: "closed, was via ssh-j.com".
168
+
169
+ ## 0.8.0 (beta), 2026-11-15
170
+
171
+ The first version with a number. What slurp has at this point:
172
+
173
+ - Jobs: the list (queued, running, finished) with filters and state, the job
174
+ window (details, steps, logs that follow as they grow, progress with
175
+ estimates), cancel and restart (as submitted, or edited), arrays run again
176
+ with another range, interactive jobs.
177
+ - Files and nodes: the directory browser, Markdown, HDF5 and text views,
178
+ shells and commands in slurp on login nodes and on the nodes of running
179
+ jobs.
180
+ - Clusters over SSH: one tab per cluster, and the local machine; storage
181
+ (quota, old files in scratch).
182
+ - Checks: batch scripts and jobs against the rule catalogue (`slurp check`
183
+ without the UI).
184
+ - One slurp, several views: the session holder keeps slurp running, terminals
185
+ and a browser attach to it; remote web access through a link.
186
+ - Shells and drives from your own terminal: one-time links (a password or a
187
+ key, uses, expiry) through a relay of your choice: direct (no relay),
188
+ ssh-j.com, serveo.net, pinggy.io, sshreach.me or your own SSH server.
189
+ - The Windows helper (tray): opens slurp links with one click and the
190
+ password; shells (the terminal opens by itself), drives (SSHFS-Win, several
191
+ folders: $HOME, $SCRATCH, $PROJECT or typed in), the web view; its window
192
+ shows the connections, with reconnect and disconnect.