venice-cli 0.14.0__tar.gz

venice_cli-0.14.0/.gitignore

@@ -0,0 +1,27 @@
+__pycache__/
+*.pyc
+*.pyo
+*.pyd
+.venv/
+.env
+.DS_Store
+
+# Build artifacts (none expected for stdlib-only, but be safe)
+build/
+dist/
+*.egg-info/
+
+# Local audio outputs -- never commit generated SFX
+venice-sfx-*.mp3
+venice-sfx-*.wav
+venice-sfx-*.flac
+venice-sfx-*.bin
+
+# Editor / IDE
+.vscode/
+.idea/
+*.swp
+
+# Vendored Venice OpenAPI spec -- local dev reference only (large, fast-moving
+# third-party file). Fetch fresh from Venice rather than tracking in history.
+reference/venice-openapi.yaml

venice_cli-0.14.0/CONTRIBUTING.md

@@ -0,0 +1,68 @@
+# Contributing
+
+Thanks for taking a look. This is a small project with a simple rhythm.
+
+## Development setup
+
+Clone, and run from the repo:
+
+```sh
+git clone https://github.com/gobha-me/venice-cli.git
+cd venice-cli
+PYTHONPATH=src python3 -m venice --help
+```
+
+That needs no install at all. For an editable install with the `openai` extra
+(only `venice chat` / `venice embed` need it):
+
+```sh
+pip install -e ".[openai]"
+```
+
+`./install.sh` symlinks `venice` onto your PATH if you want the real command
+without pip. Don't mix the two: both own `~/.local/bin/venice`.
+
+## Before opening a PR
+
+```sh
+make test    # unittest, no network, no API key required
+make lint    # compileall syntax check
+```
+
+Both must be green. Tests are hermetic: `urlopen` is mocked, `subprocess` and
+`shutil.which` are patched, `HOME` is redirected to a tmpdir, and the OpenAI
+SDK is mocked. **No test should ever make a real API call or need a real key.**
+If you find yourself wanting to hit the live API in a test, that's a sign the
+seam is in the wrong place.
+
+## House style
+
+- **Stdlib-only in the base.** `venice chat` and `venice embed` use the OpenAI
+  SDK, lazy-imported inside the handler so a missing `openai` degrades to a
+  hint and exit 2 rather than breaking `venice --help`. Keep it that way: new
+  third-party deps need a good reason and must not be imported at module scope
+  in the base commands.
+- **Shared plumbing lives in `src/venice/commands/_*.py`** (`_shared`, `_queue`,
+  `_models`, `_openai`). These take primitive args -- a label, a model type, a
+  cost -- rather than an argparse namespace, so they stay independent of any one
+  command's argument shape. If you're copy-pasting a helper into a second
+  command, extract it instead.
+- **Exit codes are part of the interface.** See the table in the README; don't
+  change what an existing condition returns without saying so.
+- **Never log, print, or embed the API key**, including in error messages, test
+  fixtures, or partial/redacted form.
+- Adding a subcommand is one import and one entry in
+  `src/venice/commands/__init__.py`.
+
+## Commits and branches
+
+One `feat/<name>` branch per issue. Commit subjects follow
+`vX.Y: short description (#issue)`. Merges into `master` are `--no-ff`.
+
+## Reporting bugs
+
+Include the command you ran, what you expected, what happened, the exit code,
+and your Python version. **Never paste your API key** -- not even partially.
+
+For security issues see [SECURITY.md](SECURITY.md); don't use the public
+issue tracker.

venice_cli-0.14.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Jeffrey Smith
+
+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.

venice_cli-0.14.0/Makefile

@@ -0,0 +1,25 @@
+.PHONY: install uninstall test lint build clean
+
+install:
+	@./install.sh
+
+uninstall:
+	@./uninstall.sh
+
+test:
+	@PYTHONPATH=src python3 -m unittest discover -v -s tests
+
+lint:
+	@python3 -m compileall -q src tests
+	@echo "syntax OK"
+
+build:
+	@rm -rf dist
+	@python3 -m build
+	@python3 -m twine check --strict dist/*
+
+clean:
+	@rm -rf dist build
+	@find . -name '*.egg-info' -type d -exec rm -rf {} + 2>/dev/null || true
+	@find . -name __pycache__ -type d -exec rm -rf {} + 2>/dev/null || true
+	@find . -name '*.pyc' -delete 2>/dev/null || true