devstuff 2.23.0__py3-none-any.whl → 2.24.0__py3-none-any.whl

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.
@@ -38,6 +38,41 @@ def _select(prompt: str, choices: list, current: object) -> str:
38
38
  return ui.select(prompt, choices, default=default) or str(current)
39
39
 
40
40
 
41
+ class _DeltaGate:
42
+ """At most one install offer per wizard run (same reasoning as starship's _FontGate).
43
+
44
+ The pager question and the presets can be revisited from the review menu; a
45
+ declined offer should not come back every time, and a second look at a missing
46
+ delta gets the install hint without the prompt.
47
+ """
48
+
49
+ def __init__(self) -> None:
50
+ self._offered = False
51
+
52
+ def check(self, cfg: LazygitConfig) -> None:
53
+ if not cfg.pager or cfg.pager.split()[0] != "delta" or shutil.which("delta"):
54
+ return
55
+ ui.console.print()
56
+ ui.warn("delta is not on your PATH — diffs would fail to render until it is.")
57
+ if self._offered:
58
+ ui.dim(" Install it with: devstuff install delta")
59
+ return
60
+ self._offered = True
61
+
62
+ from dev_setup import registry
63
+ from dev_setup.commands.install_cmd import install_by_key
64
+
65
+ if registry.get("delta") is None: # pragma: no cover — the key is built in
66
+ ui.dim(" Install it with: devstuff install delta")
67
+ return
68
+ if not ui.confirm("Install delta now?", default=True):
69
+ ui.dim(" You can install it later: devstuff install delta")
70
+ return
71
+ if not install_by_key("delta", yes=True) or shutil.which("delta") is None:
72
+ ui.warn("delta still is not on your PATH.")
73
+ ui.dim(" You can install it later: devstuff install delta")
74
+
75
+
41
76
  def _ask_preset(cfg: LazygitConfig, found: detect.Lazygit) -> None:
42
77
  choices = [
43
78
  questionary.Choice(title=preset.label, value=preset.key, description=preset.description)
@@ -83,8 +118,8 @@ def _ask_icons(cfg: LazygitConfig, found: detect.Lazygit) -> None:
83
118
 
84
119
  def _ask_pager(cfg: LazygitConfig) -> None:
85
120
  ui.console.print()
86
- ui.dim(" An external pager renders diffs. delta is the usual choice; it must be")
87
- ui.dim(" installed separately and needs --paging=never so it does not open its own.")
121
+ ui.dim(" An external pager renders diffs. delta is the usual choice (the wizard offers")
122
+ ui.dim(" to install it if it is missing) and needs --paging=never so it does not open its own.")
88
123
  choices = [
89
124
  questionary.Choice(title=label, value=command) for command, label in PAGERS.items()
90
125
  ]
@@ -94,7 +129,7 @@ def _ask_pager(cfg: LazygitConfig) -> None:
94
129
  cfg.pager = chosen
95
130
  if cfg.pager:
96
131
  tool = cfg.pager.split()[0]
97
- if shutil.which(tool) is None:
132
+ if tool != "delta" and shutil.which(tool) is None:
98
133
  ui.warn(f"{tool} is not on your PATH — diffs would fail to render until it is.")
99
134
  cfg.color_arg = "always"
100
135
 
@@ -347,8 +382,10 @@ def run(*, target: Path | None = None) -> LazygitConfig | None:
347
382
  _report(found)
348
383
 
349
384
  ui.console.print()
385
+ delta = _DeltaGate()
350
386
  _ask_preset(cfg, found)
351
387
  _ask_icons(cfg, found)
388
+ delta.check(cfg)
352
389
 
353
390
  while True:
354
391
  _show_preview(cfg, found)
@@ -374,10 +411,12 @@ def run(*, target: Path | None = None) -> LazygitConfig | None:
374
411
  if action == "preset":
375
412
  _ask_preset(cfg, found)
376
413
  _ask_icons(cfg, found)
414
+ delta.check(cfg)
377
415
  elif action == "icons":
378
416
  _ask_icons(cfg, found)
379
417
  elif action == "pager":
380
418
  _ask_pager(cfg)
419
+ delta.check(cfg)
381
420
  elif action == "appearance":
382
421
  _ask_appearance(cfg)
383
422
  elif action == "git":
dev_setup/links.yaml CHANGED
@@ -79,6 +79,12 @@ links:
79
79
  category: shell
80
80
  url: https://github.com/tmux/tmux/wiki
81
81
 
82
+ explainshell:
83
+ name: explainshell
84
+ description: Paste a shell command to see what each part and flag does
85
+ category: shell
86
+ url: https://explainshell.com/
87
+
82
88
  conventional-commits:
83
89
  name: Conventional Commits
84
90
  description: The commit message specification used by commitizen
@@ -109,6 +115,18 @@ links:
109
115
  category: reference
110
116
  url: https://devhints.io/
111
117
 
118
+ devdocs:
119
+ name: DevDocs
120
+ description: API documentation for hundreds of languages and libraries in one searchable, offline-capable site
121
+ category: reference
122
+ url: https://devdocs.io/
123
+
124
+ archwiki:
125
+ name: ArchWiki
126
+ description: In-depth Linux reference for system configuration and tools, useful well beyond Arch
127
+ category: reference
128
+ url: https://wiki.archlinux.org/
129
+
112
130
  awesome-open-source:
113
131
  name: Awesome Open Source
114
132
  description: Curated open source projects browsable by topic and language
@@ -121,6 +139,12 @@ links:
121
139
  category: discovery
122
140
  url: https://fmhy.net/developer-tools
123
141
 
142
+ awesome-selfhosted:
143
+ name: Awesome Selfhosted
144
+ description: Curated index of free self-hostable software
145
+ category: discovery
146
+ url: https://awesome-selfhosted.net/
147
+
124
148
  crontab-guru:
125
149
  name: crontab guru
126
150
  description: Editor for cron schedule expressions that explains in plain English when a schedule runs
@@ -210,3 +234,9 @@ links:
210
234
  description: Free and open platform for network and host visibility, honeypots, and log and case management, with a Pro edition
211
235
  category: security
212
236
  url: https://securityonionsolutions.com/software
237
+
238
+ deps-dev:
239
+ name: deps.dev
240
+ description: Open-source package explorer — versions, dependency graphs, advisories and supply-chain signals
241
+ category: security
242
+ url: https://deps.dev/
dev_setup/tools.yaml CHANGED
@@ -207,6 +207,16 @@ tools:
207
207
  requires:
208
208
  - uv
209
209
 
210
+ delta:
211
+ name: delta
212
+ description: Syntax-highlighting pager for git diffs
213
+ category: tools
214
+ type: apt
215
+ apt_packages: git-delta
216
+ check_cmd: delta
217
+ help_cmd: delta --help
218
+ docs_url: https://dandavison.github.io/delta/
219
+
210
220
  devin:
211
221
  name: Devin CLI
212
222
  description: Cognition's AI software engineer, in the terminal
@@ -285,6 +295,59 @@ tools:
285
295
  || sudo yum remove -y docker-ce docker-ce-cli containerd.io docker-compose-plugin 2>/dev/null \
286
296
  || true
287
297
 
298
+ fzf:
299
+ name: fzf
300
+ description: Command-line fuzzy finder, with Ctrl-R/Ctrl-T/Alt-C key bindings in bash
301
+ category: tools
302
+ type: bash
303
+ # The block is half of what this entry installs: an fzf that arrived by other
304
+ # means (apt, a manual build) must not count as installed, or install_cmd
305
+ # would early-return and the key bindings would never reach ~/.bashrc.
306
+ check_cmd: command -v fzf >/dev/null 2>&1 && grep -Fxq '# fzf key bindings' "$HOME/.bashrc" 2>/dev/null
307
+ version_cmd: fzf
308
+ help_cmd: fzf --help
309
+ docs_url: https://junegunn.github.io/fzf/
310
+ install_script: |
311
+ set -euo pipefail
312
+ sudo apt-get update -q
313
+ sudo apt-get install -y fzf
314
+ marker="# fzf key bindings"
315
+ # `fzf --bash` only exists on fzf >= 0.48; Ubuntu 24.04 ships 0.44, whose
316
+ # package carries the bindings as an example file instead. Try the new
317
+ # flag first, fall back to the file, and never let either failure reach
318
+ # the interactive shell that sources this block.
319
+ block='if command -v fzf >/dev/null 2>&1; then
320
+ if _fzf_init="$(fzf --bash 2>/dev/null)"; then eval "$_fzf_init"
321
+ elif [ -r /usr/share/doc/fzf/examples/key-bindings.bash ]; then . /usr/share/doc/fzf/examples/key-bindings.bash
322
+ fi
323
+ unset _fzf_init
324
+ fi'
325
+ touch "$HOME/.bashrc"
326
+ if ! grep -Fxq "$marker" "$HOME/.bashrc"; then
327
+ printf '\n%s\n%s\n' "$marker" "$block" >> "$HOME/.bashrc"
328
+ fi
329
+ remove_script: |
330
+ set -euo pipefail
331
+ if [ -f "$HOME/.bashrc" ]; then
332
+ python3 - "$HOME/.bashrc" <<'PY'
333
+ import sys
334
+ path = sys.argv[1]
335
+ lines = open(path).read().splitlines()
336
+ out = []
337
+ skip = 0
338
+ for line in lines:
339
+ if skip:
340
+ skip -= 1
341
+ continue
342
+ if line == "# fzf key bindings":
343
+ skip = 6
344
+ continue
345
+ out.append(line)
346
+ open(path, "w").write("\n".join(out) + ("\n" if out else ""))
347
+ PY
348
+ fi
349
+ sudo apt-get remove -y fzf
350
+
288
351
  gh:
289
352
  name: GitHub CLI
290
353
  description: GitHub's official CLI - PRs, issues, Actions, and more
@@ -687,6 +750,18 @@ tools:
687
750
  sudo systemctl daemon-reload 2>/dev/null || true
688
751
  echo "Downloaded models in ~/.ollama were left intact."
689
752
 
753
+ opencode:
754
+ name: OpenCode
755
+ description: Open-source AI coding agent for the terminal
756
+ category: ai-tools
757
+ type: npm
758
+ npm_name: opencode-ai
759
+ check_cmd: opencode
760
+ help_cmd: opencode --help
761
+ docs_url: https://opencode.ai/docs
762
+ requires:
763
+ - nvm
764
+
690
765
  php:
691
766
  name: PHP 8.4
692
767
  description: PHP 8.4 + common extensions via ondrej/php PPA
@@ -784,6 +859,16 @@ tools:
784
859
  requires:
785
860
  - nvm
786
861
 
862
+ ripgrep:
863
+ name: ripgrep
864
+ description: Fast recursive code search (rg)
865
+ category: tools
866
+ type: apt
867
+ apt_packages: ripgrep
868
+ check_cmd: rg
869
+ help_cmd: rg --help
870
+ docs_url: https://github.com/BurntSushi/ripgrep/blob/master/GUIDE.md
871
+
787
872
  ruby:
788
873
  name: Ruby (rbenv)
789
874
  description: Ruby via rbenv version manager + ruby-build
@@ -867,6 +952,16 @@ tools:
867
952
  set -euo pipefail
868
953
  sudo rm -f /usr/local/bin/saml2aws
869
954
 
955
+ shellcheck:
956
+ name: ShellCheck
957
+ description: Static analysis and linting for shell scripts
958
+ category: tools
959
+ type: apt
960
+ apt_packages: shellcheck
961
+ check_cmd: shellcheck
962
+ help_cmd: shellcheck --help
963
+ docs_url: https://www.shellcheck.net/wiki/Home
964
+
870
965
  starship:
871
966
  name: Starship
872
967
  description: Fast, cross-shell customizable prompt
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.5
2
2
  Name: devstuff
3
- Version: 2.23.0
3
+ Version: 2.24.0
4
4
  Summary: Development environment setup CLI for Linux
5
5
  Project-URL: Repository, https://github.com/thesawdawg/dev-setup-py
6
6
  Author-email: Sawyer <sawyerksu@gmail.com>
@@ -1648,6 +1648,8 @@ links:
1648
1648
  | `bat` | bat | cat replacement with syntax highlighting and git integration (`devstuff configure bat`) | `bat --help` |
1649
1649
  | `bubblewrap` | bubblewrap + socat | Unprivileged sandbox (bwrap) and network relay (socat) — what Claude Code's /sandbox needs on Linux | `bwrap --help` |
1650
1650
  | `commitizen` | Commitizen | Conventional-commit prompt, semantic version bumping, and changelog generation (`devstuff configure commitizen`) | `cz --help` |
1651
+ | `delta` | delta | Syntax-highlighting pager for git diffs — the `devstuff configure lazygit` wizard can install it for you | `delta --help` |
1652
+ | `fzf` | fzf | Command-line fuzzy finder — installs the apt package and adds Ctrl-R/Ctrl-T/Alt-C key bindings to `~/.bashrc` | `fzf --help` |
1651
1653
  | `gh` | GitHub CLI | GitHub's official CLI | `gh --help` |
1652
1654
  | `ghgrab` | ghgrab | TUI and CLI for downloading files, folders, and release assets from GitHub and other git forges without cloning | `ghgrab --help` |
1653
1655
  | `git-lfs` | Git LFS | Git extension for versioning large files | `git lfs --help` |
@@ -1657,6 +1659,7 @@ links:
1657
1659
  | `ipython` | IPython | Enhanced interactive Python shell with rich tab completion and magic commands | `ipython --help` |
1658
1660
  | `lazygit` | lazygit | TUI git client for fast, keyboard-driven git workflows (`devstuff configure lazygit`) | `lazygit --help` |
1659
1661
  | `reptyr` | reptyr | Move a running process to another terminal (`devstuff configure reptyr` for permissions) | `reptyr -h` |
1662
+ | `ripgrep` | ripgrep | Fast recursive code search (`rg`) | `rg --help` |
1660
1663
  | `llamactl` | llamactl | CLI for managing LlamaDeploy projects and deployments (LlamaIndex) | `llamactl --help` |
1661
1664
  | `llm-checker` | llm-checker | Check LLM compatibility with your hardware | `llm-checker --help` |
1662
1665
  | `lmstudio` | LM Studio | Run large language models locally with a GUI | `lms --help` |
@@ -1669,8 +1672,10 @@ links:
1669
1672
  | `codex` | Codex CLI | OpenAI coding agent for the terminal | `codex --help` |
1670
1673
  | `devin` | Devin CLI | Cognition's AI software engineer, in the terminal | `devin --help` |
1671
1674
  | `hey-dave` | hey-dave | Terminal coding-agent harness that runs D.A.V.E. natively | `dave --help` |
1675
+ | `opencode` | OpenCode | Open-source AI coding agent for the terminal | `opencode --help` |
1672
1676
  | `pre-commit` | pre-commit | Git hook manager for automated code quality checks (`devstuff configure pre-commit`) | `pre-commit --help` |
1673
1677
  | `saml2aws` | saml2aws | SAML → AWS STS credentials CLI (Versent) | `saml2aws --help` |
1678
+ | `shellcheck` | ShellCheck | Static analysis and linting for shell scripts | `shellcheck --help` |
1674
1679
  | `starship` | Starship | Fast, cross-shell customizable prompt (`devstuff configure starship`) | `starship --help` |
1675
1680
  | `syncthing` | Syncthing | Peer-to-peer file sync daemon (`devstuff configure syncthing` to pair devices) | `syncthing --help` |
1676
1681
  | `tmux` | tmux | Terminal multiplexer — persistent sessions, windows and panes | `tmux -h` |
@@ -16,13 +16,13 @@ dev_setup/functions_catalog.py,sha256=YgR2hY9HM1iol1AZcF-_j02EXCP9U4P3e_5eWes9KH
16
16
  dev_setup/functions_registry.py,sha256=YSl-VgNXPf0hj4WgReg-pZUj4fAjFlwvC165dgon_BE,3682
17
17
  dev_setup/generic.py,sha256=Lg0c41TVT4Vj6yT1H9qH1zWYmZN4c_JtA9wtM6bdopc,43921
18
18
  dev_setup/links.schema.json,sha256=V9_1UA8Ejfu0j6-VczH0blW1mlGupXx56NhApLtHHKc,1938
19
- dev_setup/links.yaml,sha256=jFxG3lzATHh-PLNh6cH71UGkMjuVo-gIfS66gTyGwks,6957
19
+ dev_setup/links.yaml,sha256=nBwgCDljLbqY75ebQ9JuZao0-zJEwtJO6GNRV_eG7IM,7896
20
20
  dev_setup/links_catalog.py,sha256=Xe7s9oqiCrfQPUwE-X9o6p5VkU7mH9PjY9NMyn6VbHg,4610
21
21
  dev_setup/links_registry.py,sha256=xyq49oH1u_CX85UcizKSuxuy_pzurNoDwSRg3YftUMY,2439
22
22
  dev_setup/profile.py,sha256=NiSOXXwEPX6IIT8FagnAC-tcg49HWijFDSm2jn3hjts,13632
23
23
  dev_setup/registry.py,sha256=eHEuo4p0O0CHDWatFuOlSFiSAz5L6YFYmv9tAGHYMt4,2510
24
24
  dev_setup/snapshot.py,sha256=A2G_6pHSaGhDT1PJAZ6eW83GdSdCGs2r79yH8FCa0Qs,5330
25
- dev_setup/tools.yaml,sha256=vHrujWSeHw1aQX03gecLIRxmdmnZa82cZTQuGNlabZA,39864
25
+ dev_setup/tools.yaml,sha256=QFhaJOQKo2GBmcQeAaFDcteakil-hvVmIKs6hq4Fofg,42937
26
26
  dev_setup/ui.py,sha256=B0t4hYlZ7jIMIdldMCImLNBJT1NQgZ4ff8ItjfHRNl0,23879
27
27
  dev_setup/updates.py,sha256=p9_nbfaX_73hE71kr5ZDZA5o85T9XTR0mjbo15f950I,6046
28
28
  dev_setup/verbose.py,sha256=N3U9JAYOvFwdd8DT6W7Pqq6RCIUfbcQnPsm0O1TnvQY,5003
@@ -98,7 +98,7 @@ dev_setup/configure/lazygit/detect.py,sha256=DJ0U9QU0Qc-O8jwpllqhcPLB1FPTX7mICDb
98
98
  dev_setup/configure/lazygit/model.py,sha256=8XwQnwuBZVYC3LdqguUG2HJG0Cla9FqZSiMkTT2DVZ8,17697
99
99
  dev_setup/configure/lazygit/render.py,sha256=h5yx4JAaKXuR21jVFW5Y34rXPK1KKnOs7VDmPsaDSA4,8277
100
100
  dev_setup/configure/lazygit/validate.py,sha256=eeiaCUnRZwGQavsFkhuY_VWMtw606qeBX-ALGh5Ek0Q,7454
101
- dev_setup/configure/lazygit/wizard.py,sha256=AgN6WLO7zV408lrhUh1IYPfGiboa2VGa4eMPeMQ3jQs,15328
101
+ dev_setup/configure/lazygit/wizard.py,sha256=EUb4wc09PefKzl9IT8njWBPsJ_KTGOV5k10Vw5uOg-E,16923
102
102
  dev_setup/configure/precommit/__init__.py,sha256=o6gUaCMebR3cQv1dpyVvFKMn7R6A1snopIzpVZlvrIc,216
103
103
  dev_setup/configure/precommit/detect.py,sha256=PynfbhWZfCnN9HN5YGPnIVPMI-vV8HKhiT-dIT-N5NY,9121
104
104
  dev_setup/configure/precommit/model.py,sha256=j-sz0jzbmy66d_l_Glzo0kO5ybuwMY8tx4vJYz0ri4I,28563
@@ -127,7 +127,7 @@ dev_setup/mcp/printconfig.py,sha256=3u_b4UpDwJ95u0_AfZuZuch1_-bOojdAg-08c5l6g28,
127
127
  dev_setup/mcp/process.py,sha256=IV203HLaCelWb89IhV73_8NWNAGglXRtXpwpHk39dD4,4752
128
128
  dev_setup/mcp/stdio.py,sha256=k-s2722_N2j92umkKo_Bq6KijfQGKFRudYVsh2H4xAk,6121
129
129
  dev_setup/mcp/token.py,sha256=Pr7MCY6FtY8g2oQWB291mMooiZY0eu659Qk3mh9auWE,3397
130
- devstuff-2.23.0.dist-info/METADATA,sha256=jfN4q2ohbkmoqHIdbkI9RRNgXctQKmDOwTD7dD8szyo,99564
131
- devstuff-2.23.0.dist-info/WHEEL,sha256=W3fkpkm7-wf9vBI5Z-7s0eWkeM-spu78I8Neb98DeEg,87
132
- devstuff-2.23.0.dist-info/entry_points.txt,sha256=48ITy9ENdXDFrTHwAyVPUpq1MDmgFqcOisOo5mAR6OQ,53
133
- devstuff-2.23.0.dist-info/RECORD,,
130
+ devstuff-2.24.0.dist-info/METADATA,sha256=UUzENOhEnrgZAhW_QPVe2kgHsrYFSztVMgd9lG7cw3M,100122
131
+ devstuff-2.24.0.dist-info/WHEEL,sha256=W3fkpkm7-wf9vBI5Z-7s0eWkeM-spu78I8Neb98DeEg,87
132
+ devstuff-2.24.0.dist-info/entry_points.txt,sha256=48ITy9ENdXDFrTHwAyVPUpq1MDmgFqcOisOo5mAR6OQ,53
133
+ devstuff-2.24.0.dist-info/RECORD,,