vinopilot 0.1.0__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.
@@ -0,0 +1,29 @@
1
+ # Generated by Cargo
2
+ # will have compiled files and executables
3
+ debug
4
+ target
5
+
6
+ # These are backup files generated by rustfmt
7
+ **/*.rs.bk
8
+
9
+ # MSVC Windows builds of rustc generate these, which store debugging information
10
+ *.pdb
11
+
12
+ # Generated by cargo mutants
13
+ # Contains mutation testing data
14
+ **/mutants.out*/
15
+
16
+ # rustc will dump stack traces when hitting an internal compiler error to PWD
17
+ rustc-ice-*.txt
18
+
19
+ # RustRover
20
+ # JetBrains specific template is maintained in a separate JetBrains.gitignore that can
21
+ # be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
22
+ # and can be added to the global gitignore or merged into this file. For a more nuclear
23
+ # option (not recommended) you can uncomment the following to ignore the entire idea folder.
24
+ #.idea/
25
+
26
+ # The Python TUI (tui/)
27
+ .venv
28
+ __pycache__
29
+ tui/dist
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 Karan Shukla
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
@@ -0,0 +1,62 @@
1
+ Metadata-Version: 2.5
2
+ Name: vinopilot
3
+ Version: 0.1.0
4
+ Summary: Terminal UI for vinoPilot: install, update and uninstall the vinoPilot apps
5
+ Project-URL: Homepage, https://vinopilot.ca/
6
+ Project-URL: Repository, https://github.com/karanshukla/vinopilot
7
+ Project-URL: Issues, https://github.com/karanshukla/vinopilot/issues
8
+ Project-URL: Changelog, https://github.com/karanshukla/vinopilot/blob/main/CHANGELOG.md
9
+ Author: Karan Shukla
10
+ License-Expression: MIT
11
+ License-File: LICENSE
12
+ Keywords: installer,linux,textual,tui,vinopilot
13
+ Classifier: Development Status :: 4 - Beta
14
+ Classifier: Environment :: Console
15
+ Classifier: Intended Audience :: End Users/Desktop
16
+ Classifier: Operating System :: POSIX :: Linux
17
+ Classifier: Programming Language :: Python :: 3
18
+ Classifier: Programming Language :: Python :: 3.11
19
+ Classifier: Programming Language :: Python :: 3.12
20
+ Classifier: Programming Language :: Python :: 3.13
21
+ Classifier: Programming Language :: Python :: 3.14
22
+ Classifier: Topic :: System :: Installation/Setup
23
+ Requires-Python: >=3.11
24
+ Requires-Dist: textual<9,>=8
25
+ Description-Content-Type: text/markdown
26
+
27
+ # vinoPilot in a terminal
28
+
29
+ The [vinoPilot](https://github.com/karanshukla/vinopilot) window, for a terminal: a table of the vinoPilot apps with their version, how each is installed and whether there's something newer, the installer's output underneath, and one key per action.
30
+
31
+ It's a thin frontend. Everything it knows comes from the `vinopilot` command's `--json` output, and every action is a `vinopilot` run, so what the window does and what the table does can't drift apart. If the command isn't there, the first screen offers to fetch it from the latest release with the same hash-checked installer the README gives.
32
+
33
+ ## Install
34
+
35
+ ```sh
36
+ uv tool install vinopilot
37
+ vinopilot-tui
38
+ ```
39
+
40
+ or `pipx install vinopilot`. The command is `vinopilot-tui`, not `vinopilot`: that name is the Rust command this drives, and `uv tool` would otherwise overwrite it in `~/.local/bin`.
41
+
42
+ ## Keys
43
+
44
+ | Key | Does |
45
+ |---|---|
46
+ | `c` | Check for updates (the only thing that goes online, besides the actions themselves) |
47
+ | `i` | Install the selected app; asks which way when there's more than one |
48
+ | `u` | Update it, the way it's installed |
49
+ | `a` | Update everything that has an update, vinoPilot included |
50
+ | `x` | Uninstall it, after a yes |
51
+ | `s` | Show the shell an action would run, without running it |
52
+ | `r` | Change where source checkouts go |
53
+ | `Esc` | Stop the running action |
54
+ | `q` | Quit |
55
+
56
+ After an action the table is rescanned: offline, or online again if you had checked for updates.
57
+
58
+ ## Limits
59
+
60
+ - vinoAuthFace's steps run through `pkexec`. On a desktop the polkit agent asks for your password in a dialog. Over ssh with no agent, pkexec has no way to ask and the step fails.
61
+ - Stopping an action ends the `vinopilot` run, but a `pkexec` child is root's and runs on.
62
+ - `VINOPILOT_BIN=/path/to/vinopilot` picks the command to drive, for a checkout build.
@@ -0,0 +1,36 @@
1
+ # vinoPilot in a terminal
2
+
3
+ The [vinoPilot](https://github.com/karanshukla/vinopilot) window, for a terminal: a table of the vinoPilot apps with their version, how each is installed and whether there's something newer, the installer's output underneath, and one key per action.
4
+
5
+ It's a thin frontend. Everything it knows comes from the `vinopilot` command's `--json` output, and every action is a `vinopilot` run, so what the window does and what the table does can't drift apart. If the command isn't there, the first screen offers to fetch it from the latest release with the same hash-checked installer the README gives.
6
+
7
+ ## Install
8
+
9
+ ```sh
10
+ uv tool install vinopilot
11
+ vinopilot-tui
12
+ ```
13
+
14
+ or `pipx install vinopilot`. The command is `vinopilot-tui`, not `vinopilot`: that name is the Rust command this drives, and `uv tool` would otherwise overwrite it in `~/.local/bin`.
15
+
16
+ ## Keys
17
+
18
+ | Key | Does |
19
+ |---|---|
20
+ | `c` | Check for updates (the only thing that goes online, besides the actions themselves) |
21
+ | `i` | Install the selected app; asks which way when there's more than one |
22
+ | `u` | Update it, the way it's installed |
23
+ | `a` | Update everything that has an update, vinoPilot included |
24
+ | `x` | Uninstall it, after a yes |
25
+ | `s` | Show the shell an action would run, without running it |
26
+ | `r` | Change where source checkouts go |
27
+ | `Esc` | Stop the running action |
28
+ | `q` | Quit |
29
+
30
+ After an action the table is rescanned: offline, or online again if you had checked for updates.
31
+
32
+ ## Limits
33
+
34
+ - vinoAuthFace's steps run through `pkexec`. On a desktop the polkit agent asks for your password in a dialog. Over ssh with no agent, pkexec has no way to ask and the step fails.
35
+ - Stopping an action ends the `vinopilot` run, but a `pkexec` child is root's and runs on.
36
+ - `VINOPILOT_BIN=/path/to/vinopilot` picks the command to drive, for a checkout build.
@@ -0,0 +1,56 @@
1
+ [project]
2
+ name = "vinopilot"
3
+ version = "0.1.0"
4
+ description = "Terminal UI for vinoPilot: install, update and uninstall the vinoPilot apps"
5
+ readme = "README.md"
6
+ license = "MIT"
7
+ license-files = ["LICENSE"]
8
+ authors = [{ name = "Karan Shukla" }]
9
+ keywords = ["vinopilot", "installer", "tui", "textual", "linux"]
10
+ classifiers = [
11
+ "Development Status :: 4 - Beta",
12
+ "Environment :: Console",
13
+ "Intended Audience :: End Users/Desktop",
14
+ "Operating System :: POSIX :: Linux",
15
+ "Programming Language :: Python :: 3",
16
+ "Programming Language :: Python :: 3.11",
17
+ "Programming Language :: Python :: 3.12",
18
+ "Programming Language :: Python :: 3.13",
19
+ "Programming Language :: Python :: 3.14",
20
+ "Topic :: System :: Installation/Setup",
21
+ ]
22
+ requires-python = ">=3.11"
23
+ dependencies = ["textual>=8,<9"]
24
+
25
+ [project.urls]
26
+ Homepage = "https://vinopilot.ca/"
27
+ Repository = "https://github.com/karanshukla/vinopilot"
28
+ Issues = "https://github.com/karanshukla/vinopilot/issues"
29
+ Changelog = "https://github.com/karanshukla/vinopilot/blob/main/CHANGELOG.md"
30
+
31
+ # Not `vinopilot`: that's the Rust command, and `uv tool install` writes its
32
+ # scripts to the same ~/.local/bin the release installer puts it in.
33
+ [project.scripts]
34
+ vinopilot-tui = "vinopilot_tui.app:main"
35
+
36
+ [build-system]
37
+ requires = ["hatchling"]
38
+ build-backend = "hatchling.build"
39
+
40
+ [tool.hatch.build.targets.wheel]
41
+ packages = ["src/vinopilot_tui"]
42
+
43
+ [dependency-groups]
44
+ dev = ["pytest", "pytest-asyncio", "ruff"]
45
+
46
+ [tool.pytest.ini_options]
47
+ asyncio_mode = "auto"
48
+ asyncio_default_fixture_loop_scope = "function"
49
+ testpaths = ["tests"]
50
+
51
+ [tool.ruff]
52
+ line-length = 100
53
+ target-version = "py311"
54
+
55
+ [tool.ruff.lint]
56
+ select = ["E", "F", "I", "UP", "B"]
@@ -0,0 +1,3 @@
1
+ """vinoPilot's terminal UI: a thin frontend over the `vinopilot` command's `--json` API."""
2
+
3
+ __version__ = "0.1.0"
@@ -0,0 +1,3 @@
1
+ from vinopilot_tui.app import main
2
+
3
+ main()