skit-cli 0.0.1__py3-none-any.whl

skit_cli-0.0.1.dist-info/METADATA

@@ -0,0 +1,199 @@
+Metadata-Version: 2.4
+Name: skit-cli
+Version: 0.0.1
+Summary: Script launcher and parameter manager: pick a script, fill in a form, run — no more opening an IDE just to tweak constants.
+Keywords: script,launcher,uv,tui,pep723,script-manager
+Author: Yi-Ting Chiu
+Author-email: Yi-Ting Chiu <mytim710@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Environment :: Console :: Curses
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Build Tools
+Classifier: Topic :: Utilities
+Requires-Dist: typer>=0.26,<1
+Requires-Dist: platformdirs>=4.10,<5
+Requires-Dist: tomli-w>=1.2,<2
+Requires-Dist: textual>=8.2,<9
+Requires-Dist: rich>=15,<16
+Requires-Python: >=3.12
+Project-URL: Repository, https://github.com/t41372/skit
+Project-URL: Issues, https://github.com/t41372/skit/issues
+Description-Content-Type: text/markdown
+
+![skit — script launcher and parameter manager](https://raw.githubusercontent.com/t41372/skit/main/docs/assets/banner.png)
+
+[![CI](https://github.com/t41372/skit/actions/workflows/ci.yml/badge.svg)](https://github.com/t41372/skit/actions/workflows/ci.yml)
+[![codecov](https://codecov.io/gh/t41372/skit/branch/main/graph/badge.svg)](https://codecov.io/gh/t41372/skit)
+[![Mutation tested: mutmut](https://img.shields.io/badge/mutation%20tested-mutmut-blue)](https://github.com/boxed/mutmut)
+[![PyPI](https://img.shields.io/pypi/v/skit-cli)](https://pypi.org/project/skit-cli/)
+[![Python 3.12+](https://img.shields.io/badge/python-3.12%2B-blue)](https://www.python.org/)
+[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
+[![Types: ty](https://img.shields.io/badge/types-ty-261230.svg)](https://github.com/astral-sh/ty)
+[![License: MIT](https://img.shields.io/badge/license-MIT-yellow.svg)](LICENSE)
+
+**English** | [繁體中文](./README.zh-TW.md) | [简体中文](./README.zh-CN.md)
+
+**skit is a launcher and a home for your Python scripts.**
+
+skit stores your Python scripts in one place and makes them painless to launch.
+
+**AI writes the scripts. skit gives them a home.**
+
+<video src="https://github.com/user-attachments/assets/65c9eed8-d6fa-4a16-836c-7017eb08bb9c" controls></video>
+
+## What it does
+
+- **One home for your scripts.** `skit add` collects scattered scripts into a searchable library — keep a copy in the library, or reference the original file.
+- **Parameters without the pain.** Flags, `input()` calls, and the constants you tick become form fields (choices → pickers, booleans → checkboxes, types enforced).
+- **It remembers.** Last-used values come back automatically; save favorites as named presets. Parameters marked secret never touch disk. Tokens like `{cwd}` and `{today}` keep presets portable.
+- **No environment mess.** skit declares each script's dependencies in the script itself (PEP 723) and runs it through uv in an isolated, cached environment — no venvs to manage, nothing installed globally.
+- **Mouse or keyboard.** Plain `skit` opens the full TUI; every key hint on screen is also a clickable button.
+- **Automation-ready.** Every TUI action is also a CLI command with `--json` output and meaningful exit codes — for shell scripts, CI, and AI agents.
+- **Speaks your language.** English, 繁體中文, and 简体中文, with more to come. See [Languages](#languages).
+
+| Problem | What skit does |
+| --- | --- |
+| Scripts scattered all over the place | One central menu, with search |
+| Scripts with weird external dependencies | An isolated environment per script — dependencies declared in the file (PEP 723), resolved by uv |
+| CLI flags you forget ten minutes later, `input()` prompts, hard-coded constants meant to be edited by hand | Static analysis extracts them all into an interactive form — no code changes. Last-used values come prefilled; favorites save as presets. |
+
+Nothing to set up per script — no refactoring, no config to maintain. The script an AI wrote last week and the one you barely remember from last year launch the same way.
+
+| ![The library menu](https://raw.githubusercontent.com/t41372/skit/main/docs/assets/tui-library-en.png) | ![The run form](https://raw.githubusercontent.com/t41372/skit/main/docs/assets/tui-form-en.png) |
+|:--:|:--:|
+| **The library** — every action on screen, mouse or keyboard | **The run form** — generated from the script's own parameters |
+| ![Adding a script](https://raw.githubusercontent.com/t41372/skit/main/docs/assets/tui-add-en.png) | ![Script settings](https://raw.githubusercontent.com/t41372/skit/main/docs/assets/tui-settings-en.png) |
+| **Adding a script** — parameters detected statically, tick to manage | **Script settings** — parameters, secrets, presets, dependencies |
+
+<p align="center">
+  <img width="480" alt="Driving skit with the mouse alone — every control on screen is a click target" src="https://raw.githubusercontent.com/t41372/skit/main/docs/assets/demo-mouse.gif"><br>
+  <em>Fully mouse operable — every key hint on screen is also a button.</em>
+</p>
+
+## Install
+
+skit is built on [uv](https://docs.astral.sh/uv/) (tested against 0.11.26). Don't have it? skit asks first, then downloads a pinned uv into its own private directory — your `PATH` and global environment stay untouched. A system-wide [install](https://docs.astral.sh/uv/getting-started/installation/) is still preferred.
+
+```bash
+# Install skit with uv tool from PyPI (the package is named skit-cli; the command is skit)
+uv tool install skit-cli
+```
+
+
+> **In mainland China?** Set the mirror by hand for this one command (details in [Mainland China (中国大陆)](#mainland-china-中国大陆)):
+>
+> ```bash
+> export UV_DEFAULT_INDEX=https://pypi.tuna.tsinghua.edu.cn/simple
+> uv tool install skit-cli
+> ```
+
+Or install the latest dev version from the main branch.
+
+```bash
+uv tool install git+https://github.com/t41372/skit          # latest development version
+uvx --from git+https://github.com/t41372/skit skit --help   # try it without installing
+```
+
+## Uninstall
+
+```bash
+uv tool uninstall skit-cli
+```
+
+That removes skit and its `PATH` shim. Your library and settings live **outside** the package, so they survive on purpose — reinstall and you're right back where you left off. To erase those too, delete skit's own directories:
+
+| OS | Directories |
+| --- | --- |
+| **macOS** | `~/Library/Application Support/skit` |
+| **Linux** | `~/.local/share/skit` · `~/.local/state/skit` · `~/.config/skit` |
+| **Windows** | `%LOCALAPPDATA%\skit` |
+
+They hold your script library, config, presets, and last-used values — plus, if skit ever bootstrapped its own uv, the private `uv` binary (in `…/skit/bin`, deleted along with the rest).
+
+```bash
+# macOS
+rm -rf ~/Library/Application\ Support/skit
+
+# Linux — honors XDG_DATA_HOME / XDG_STATE_HOME / XDG_CONFIG_HOME if you've set them
+rm -rf ~/.local/share/skit ~/.local/state/skit ~/.config/skit
+```
+
+```powershell
+# Windows (PowerShell)
+Remove-Item -Recurse -Force $env:LOCALAPPDATA\skit
+```
+
+Not sure where yours landed? `skit doctor` prints the resolved library path (and respects any `SKIT_DATA_DIR` / `SKIT_STATE_DIR` / `SKIT_CONFIG_DIR` overrides). That's everything skit owns — it never writes to your `PATH`, shell, or global uv config, so nothing else needs undoing. The uv download cache and any Python builds uv fetched are shared with the rest of your uv setup, not skit's to remove; if you don't use uv elsewhere and want the space back, `uv cache clean` clears the cache.
+
+## Usage
+
+Two commands are the whole interface:
+
+```bash
+skit add my_script.py   # add a script
+skit                    # open the menu, pick it, fill in the form, run
+```
+
+Everything else happens inside the TUI — on screen, mouse or keyboard, nothing to memorize.
+
+The rest of the CLI exists for automation and AI agents — every TUI action, scriptable:
+
+```bash
+skit run my_script -p fast    # run with a saved preset
+skit run my_script --dry-run  # print the exact command, don't run it
+skit params my_script         # show managed parameters and last-used values
+skit list --json              # machine-readable listing
+skit config                   # settings: language, editor, mirror, form style
+skit --help                   # everything else
+```
+
+## Languages
+
+| Language | Status |
+| --- | --- |
+| English | ✅ 100%, human-reviewed |
+| 繁體中文 (zh-TW) | ✅ 100%, human-reviewed |
+| 简体中文 (zh-CN) | ✅ 100%, human-reviewed |
+
+skit follows your system language; switch it in the TUI preferences (for automation: `skit config lang zh-TW`, or `SKIT_LANG=zh-CN skit` for one run).
+
+## Mainland China (中国大陆)
+
+Three downloads tend to fail in mainland China: PyPI packages, the Python builds uv fetches from GitHub, and skit's own uv bootstrap. skit can route all three through domestic mirrors.
+
+Mirror settings live inside skit only: your global uv config is never touched, and existing mirror settings (`UV_DEFAULT_INDEX`, `uv.toml`, …) are respected.
+
+- **First run**: if PyPI/GitHub look unreachable, skit offers to turn mirrors on — just press Enter.
+- **Any time**: TUI Preferences → mirror, or:
+
+```bash
+skit config mirror tsinghua   # or: aliyun / ustc / custom / off
+```
+
+Defaults: PyPI via Tsinghua / Aliyun / USTC; Python builds and the uv binary via NJU. Pick `custom` to swap any URL.
+
+## Why skit exists
+
+skit began as an answer to [a linux.do forum thread](https://linux.do/t/topic/2512255) (in Chinese).
+
+## Development
+
+Development runs entirely on uv — see [CONTRIBUTING.md](./CONTRIBUTING.md) for the full workflow and quality gates (ruff, ty strict, 100% test coverage, mutation testing with mutmut, zizmor-audited workflows).
+
+```bash
+uv sync --dev
+uv run pytest -q
+uv run python scripts/serve_preview.py   # TUI web preview (textual-serve, localhost:8000)
+```
+
+## License
+
+[MIT](LICENSE)

skit_cli-0.0.1.dist-info/RECORD

@@ -0,0 +1,37 @@
+skit/__init__.py,sha256=YJ23aWI8fJwlKp41zZyoFdHDujfJCVVI_zStiBevY34,89
+skit/analyzer.py,sha256=qlZHOWXS3cEgglsGANTA4S_d9CTOjuhDtdrSc5FacOM,19191
+skit/argspec.py,sha256=15ZCQzz2P2WHJCwutbfISimXboqBAtKojB5OSqDDDh4,21677
+skit/argstate.py,sha256=N3qZiBcbLAAwhNd8-tu_xxVNFGG87D8bBHUxHLC-LlI,6311
+skit/atomic.py,sha256=2uWybRSOTUlrjmy1EzgXv3EBNXoAZqaCypoxdkqzrbM,4258
+skit/cli.py,sha256=RUCFTzQOBMKlfNZj05sbOs6Mj8xHQxYneBxUdpXRtzs,62218
+skit/config.py,sha256=EQPcJuLv-KHfsAxebxF9ZTDA0R22QU2nvp9tUHngTzU,10294
+skit/editor.py,sha256=_erqoKbudXak59sOSVKGzkaW0ggzCtljLi5C0sMq8z0,3378
+skit/flows.py,sha256=dQwzUkpMCYjCCdUEorMGp-TiYGinIG4xfd-oBKWGBsQ,24695
+skit/i18n.py,sha256=g9DbO_p61HkRZcgA-IAo6OeSDSo2euHUNE885B6XYCw,13027
+skit/inlineform.py,sha256=HpwXjZx9oiFUwiv7ZhEhvx8U1Rd4xxAfMGMjpNcMUPg,2163
+skit/launcher.py,sha256=Tsod4-_HbePssHnABs3rGkSDipwFW_M6kfx7Ew69xWw,13721
+skit/locales/zh_CN/LC_MESSAGES/skit.mo,sha256=vKcsuueDHZyXyG6k_57tocqvfhKCFgOQIXqCvbpCMls,39342
+skit/locales/zh_TW/LC_MESSAGES/skit.mo,sha256=3r2nMkF7Z9k9VuzsEYpxjzdLClGYzrLriRVnvB-QHi0,39296
+skit/metawriter.py,sha256=wHAvZMrhDec2F54Q57hLh3rnRuBRQdRgmtfjEdQJ-g0,11041
+skit/models.py,sha256=sbbHoG6SFiKoveyccrQYjZaNNeEViGynpCzYEx5oYJw,5572
+skit/paths.py,sha256=rt483_rMSkTi-U8dw7V_3a-pRFCUNoNofyOd-0NaBQI,1047
+skit/pep723.py,sha256=Lv0elvSXakocTIXyEJ5IvepttXU7NSikuVYYcGfozVM,12347
+skit/promptform.py,sha256=iNkBIBbBUbybxkDWR8jjuwKnZQjE93zOI3z7mXpjZeE,2494
+skit/reconcile.py,sha256=oYmJs25pKB6Tr3qEjpURvokgHc6Abl0dotSBRb0ly0M,13747
+skit/shim.py,sha256=xdn1cb-j9crUzWf9JNpibBH0sRG783dfpdA7-7ekIfE,19445
+skit/store.py,sha256=pug6b5NO25AEJ6M3ba918Dy3YYl1h_5gNtMFbDqvIWY,22026
+skit/theme.py,sha256=ICYiHtdvv54XC9HAam2rpYO4puUMRm-8JEaXtPIPo1I,5711
+skit/tokens.py,sha256=8mdTEeSsFQm0g5JM0mcFLBw5T_9fh97Nu8vRzwqQ8X8,3661
+skit/tui.py,sha256=ePQoFvageE2WDPEgluN3B68hISyiJt5xru5PWC2E61I,32266
+skit/tui_add.py,sha256=Ljrx_DQJUv1cv7f0uuSnpX7wUnhIeXVXSh7bMgpbST4,16029
+skit/tui_footer.py,sha256=PeKdvp0nADkHzeq24qqFkNLJVxovwk0dwQJATvFm5uE,1745
+skit/tui_form.py,sha256=xgGZgzPT5fdh9HmrowAwHo2iQqFmqTBODAa3_ml6XRI,25049
+skit/tui_health.py,sha256=at1OJwJCP0_PkQkPD65AkNJuY9HMbokBhIi-EIXR-X0,5832
+skit/tui_prefs.py,sha256=ZDZt0T1QKIrOoKLwWow0ojUURAF7_WiIzZRx2XT1ffM,7233
+skit/tui_settings.py,sha256=QoXgzxUYpkpSZEzj2cWYA8dZFyOgQPS_qnGxhkERSvY,16114
+skit/uvman.py,sha256=QkEHR3wR8aquFXuMMOHAU820NfJuvhFKbYcD_GBAsU4,14379
+skit_cli-0.0.1.dist-info/licenses/LICENSE,sha256=5ejThDd-KAn5uMko8s4LhK4nTwqbgXgnWb-JQCKpSxQ,1074
+skit_cli-0.0.1.dist-info/WHEEL,sha256=CoDSoyhtC_eO_tlxRYzsTraPv1fPJRXFx91k6ISeAvA,81
+skit_cli-0.0.1.dist-info/entry_points.txt,sha256=FYgSm0ZknaO2FpnYfyP_kVzXlL7gmMilzrC5XgmeekA,39
+skit_cli-0.0.1.dist-info/METADATA,sha256=cFm_WYMYU4ixaMBJTKu-Lqx4mPg_RmMyQbumSVOgp5Q,10222
+skit_cli-0.0.1.dist-info/RECORD,,

skit_cli-0.0.1.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: uv 0.11.28
+Root-Is-Purelib: true
+Tag: py3-none-any

skit_cli-0.0.1.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+skit = skit.cli:app
+

skit_cli-0.0.1.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 skit contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.