elva-cli 0.0.1__py3-none-any.whl

elva_cli/__init__.py

@@ -0,0 +1,8 @@
+from importlib.metadata import PackageNotFoundError, version
+
+try:
+    __version__ = version("elva-cli")
+except PackageNotFoundError:  # pragma: no cover - running from a source tree
+    __version__ = "0.0.0+unknown"
+
+__all__ = ["__version__"]

elva_cli/__main__.py

@@ -0,0 +1,4 @@
+from elva_cli.main import main
+
+if __name__ == "__main__":
+    main()

elva_cli/_version.py

@@ -0,0 +1,24 @@
+# file generated by vcs-versioning
+# don't change, don't track in version control
+from __future__ import annotations
+
+__all__ = [
+    "__version__",
+    "__version_tuple__",
+    "version",
+    "version_tuple",
+    "__commit_id__",
+    "commit_id",
+]
+
+version: str
+__version__: str
+__version_tuple__: tuple[int | str, ...]
+version_tuple: tuple[int | str, ...]
+commit_id: str | None
+__commit_id__: str | None
+
+__version__ = version = '0.0.1'
+__version_tuple__ = version_tuple = (0, 0, 1)
+
+__commit_id__ = commit_id = None

elva_cli/auth/__init__.py

@@ -0,0 +1,8 @@
+"""Credentials and the login flow.
+
+Token storage sits behind a Protocol (keyring, with a 0600 file fallback for
+headless Linux and containers). ELVA_TOKEN overrides both in CI.
+
+The browser handoff needs a /auth/cli endpoint on the JWT side of the backend.
+The cookie-session auth used by the catalog and GitHub routes is deliberately
+out of scope: a CLI has no cookie jar."""

elva_cli/commands/__init__.py

@@ -0,0 +1,4 @@
+"""Command modules: one per top-level command.
+
+Each module owns a `typer.Typer` app named `app`, parses its own arguments, calls
+exactly one service, and hands the returned Result to `ctx.out`. No logic here."""

elva_cli/context.py

@@ -0,0 +1,5 @@
+"""The Ctx object, built once in the root callback and injected into every command.
+
+Carries resolved settings, the API client, output and logging. Commands never
+import global state, which is what makes them testable. Everything expensive is a
+cached_property so `elva --version` pays for none of it."""

elva_cli/core/__init__.py

@@ -0,0 +1,4 @@
+"""Domain logic. Nothing in this package may print, prompt, or exit.
+
+Pure and injectable, so it is unit-testable without a terminal. The rule is
+enforced by tests/test_boundary.py rather than by convention."""

elva_cli/core/api/__init__.py

@@ -0,0 +1,5 @@
+"""The Elva API client.
+
+`generated/` holds openapi-python-client output built from the backend's
+/api/docs and is regenerated in CI. `client.py` wraps it with auth, retry,
+timeouts and HTTP-status-to-ElvaError mapping."""

elva_cli/core/services/__init__.py

@@ -0,0 +1,4 @@
+"""Use cases: one function per thing the CLI can do.
+
+Each returns a frozen dataclass (a "Result"). Results are plain data and know
+nothing about Rich; rendering happens in ui/renderables."""

elva_cli/core/spec/__init__.py

@@ -0,0 +1 @@
+"""OpenAPI handling: load, validate, diff."""

elva_cli/errors.py

@@ -0,0 +1,9 @@
+"""Error taxonomy and the exit-code contract.
+
+Exit codes are a public API that pipelines branch on: 0 ok, 1 unexpected, 2 usage,
+3 auth, 4 spec failed validation, 5 network/API, 130 interrupted. Never renumber a
+shipped code, and never collapse 4 into 1 -- callers rely on the difference
+between "your spec is wrong" and "the tool broke".
+
+Every ElvaError carries a stable machine code, a message, and where one exists,
+the next action to take."""

elva_cli/logging.py

@@ -0,0 +1 @@
+"""Library logging to stderr, at a level chosen by -v repetition."""

elva_cli/main.py

@@ -0,0 +1,55 @@
+"""Typer root and the single error boundary.
+
+Nothing here does work. It resolves global options into a Ctx, dispatches, and
+turns whatever comes back into an exit code. Every user-visible failure path in
+the CLI funnels through here.
+
+Currently wired: --version and --help. Global flags, the Ctx and the error
+boundary land next.
+"""
+
+from __future__ import annotations
+
+import platform
+
+import typer
+
+app = typer.Typer(
+    name="elva",
+    help="Elva - CLI for Theneo Elva.",
+    no_args_is_help=True,
+    pretty_exceptions_enable=False,
+    context_settings={"help_option_names": ["-h", "--help"]},
+)
+
+
+def _version_callback(value: bool) -> None:
+    if not value:
+        return
+    from elva_cli import __version__
+
+    machine = f"{platform.system().lower()}-{platform.machine()}"
+    typer.echo(f"elva {__version__} (python {platform.python_version()}, {machine})")
+    raise typer.Exit(0)
+
+
+@app.callback()
+def root(
+    version: bool = typer.Option(
+        False,
+        "--version",
+        "-V",
+        callback=_version_callback,
+        is_eager=True,
+        help="Show the current build version.",
+    ),
+) -> None:
+    pass
+
+
+def main() -> None:
+    app()
+
+
+if __name__ == "__main__":
+    main()

elva_cli/registry.py

@@ -0,0 +1,5 @@
+"""Lazy command dispatch.
+
+Maps command name to module path so that the command a user typed is the only
+command module imported. Declaring a command here is the only way to add one, so
+the startup cost of the tree stays visible in one file."""

elva_cli/settings/__init__.py

@@ -0,0 +1,5 @@
+"""Configuration schema and precedence resolution.
+
+Order, highest first: command flags, ELVA_* environment, project elva.toml, user
+config.toml, defaults. Resolved once in the root callback and frozen onto the Ctx;
+nothing downstream re-reads the environment or the filesystem."""

elva_cli/telemetry.py

@@ -0,0 +1 @@
+"""Opt-out usage telemetry. Off until the privacy note lands in the README."""

elva_cli/ui/__init__.py

@@ -0,0 +1,4 @@
+"""The only package permitted to write to a stream or read from stdin.
+
+Holds the Rich consoles (data on stdout, chrome on stderr), the human/JSON output
+chokepoint, prompt wrappers, the theme, and the Textual views."""

elva_cli/ui/prompts.py

@@ -0,0 +1,9 @@
+"""Prompts that always have a non-interactive equivalent.
+
+Every helper takes the flag value first. If it was supplied, no question is ever
+asked. If it was not and there is no TTY, the result is a usage error rather than
+a hang -- a CLI that blocks waiting for input in CI is the worst failure mode
+there is.
+
+These live in ui/ so that nothing under core/ can reach them.
+"""

elva_cli/ui/renderables/__init__.py

@@ -0,0 +1,4 @@
+"""Rich renderers for Result objects, dispatched on type.
+
+Keeping the data-to-presentation mapping here is what stops --json from drifting
+from human output: both start from the same dataclass."""

elva_cli/ui/views/__init__.py

@@ -0,0 +1 @@
+"""Full-screen Textual apps. Async; everything else in the CLI is sync."""

elva_cli/update.py

@@ -0,0 +1 @@
+"""Stale-version notifier."""

elva_cli-0.0.1.dist-info/METADATA

@@ -0,0 +1,96 @@
+Metadata-Version: 2.5
+Name: elva-cli
+Version: 0.0.1
+Summary: Elva - CLI for Theneo Elva
+Project-URL: Homepage, https://getelva.ai
+Project-URL: Source, https://github.com/Theneo-Inc/theneo-elva-cli
+Project-URL: Issues, https://github.com/Theneo-Inc/theneo-elva-cli/issues
+Author-email: Theneo <support@theneo.io>
+Keywords: api,cli,documentation,elva,openapi,theneo
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Documentation
+Classifier: Typing :: Typed
+Requires-Python: >=3.11
+Requires-Dist: typer<1.0,>=0.15
+Provides-Extra: dev
+Requires-Dist: mypy>=1.11; extra == 'dev'
+Requires-Dist: pytest>=8.2; extra == 'dev'
+Requires-Dist: ruff>=0.6; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# Elva CLI
+
+CLI for Theneo Editor
+
+...i will update soon
+
+## Quick start
+
+Requires Python 3.11 or newer.
+
+```bash
+git clone https://github.com/Theneo-Inc/theneo-elva-cli.git
+cd theneo-elva-cli
+
+python3 -m venv .venv
+source .venv/bin/activate          # Windows: .venv\Scripts\activate
+pip install -e ".[dev]"
+```
+
+`-e` installs in editable mode, so your source edits take effect immediately with
+no reinstall.
+
+Run it:
+
+```bash
+elva --version
+elva --help
+```
+
+```
+$ elva --version
+elva 0.1.0 (python 3.12.3, linux-x86_64)
+```
+
+`python -m elva_cli --version` runs the same entry point, if you prefer that form.
+
+
+### With uv (faster)
+
+If you have [uv](https://docs.astral.sh/uv/), it replaces the venv and pip steps:
+
+```bash
+uv sync --extra dev
+uv run elva --version
+```
+
+#### Running `elva` from any directory (development)
+
+To activate everywhere locally:
+
+```bash
+uv tool install --editable ~/Desktop/theneo-elva-cli
+```
+
+### Checks
+
+```bash
+ruff check .        # lint
+ruff format .       # format
+mypy                # types, strict
+```
+
+### Version numbers
+
+The version comes from the git tag via `hatch-vcs` — there is nothing to bump by hand. An untagged checkout reports something like
+`0.0.post1.dev1+g5aaf07a.d20260812`; tag a release and it becomes clean:
+
+```bash
+git tag v0.1.0
+```
+

elva_cli-0.0.1.dist-info/RECORD

@@ -0,0 +1,25 @@
+elva_cli/__init__.py,sha256=Bj7nUzAI-YsVpubyK_BYZDcGmRfw1MaIEPreL6eCvAI,244
+elva_cli/__main__.py,sha256=22xZiL1z0CSRzOBe_dXuIeObKeInImcPlAqjiQ2a6Jw,70
+elva_cli/_version.py,sha256=8OsTLsIVB9D0HdPTmt5rVwyVUBe9xTVGkRslXicxzkM,520
+elva_cli/context.py,sha256=gualsuA6X3MczDkUh_oMrpAmdSo26xyeIhkH4gguPV8,305
+elva_cli/errors.py,sha256=GlJnqR9NKbXx1tUsOQIsrVuRKfD0XRoIUdR7eRnvl6s,449
+elva_cli/logging.py,sha256=bveQ-ULrgM0wg5GPTFO5AA6UfFeVAoV3mgL-QPX9nHA,69
+elva_cli/main.py,sha256=cs5JPaDYqPYxA2qVkSg-U87clQiWfCMXrIG5pgKHEX8,1216
+elva_cli/registry.py,sha256=Pw1GZDGXv3hmjj_BBDtdr7lsDOiISLHXJzFSPVMvUHU,245
+elva_cli/telemetry.py,sha256=fJWGMbMb36f_D9XdpFAiFglFlE_h2--2tEeGnPhX5Qc,79
+elva_cli/update.py,sha256=DsUCBF61TPIkthK70nP6xKscFtzZQNHgsRIZmTZsAf4,30
+elva_cli/auth/__init__.py,sha256=khFOTzl6mJyv2hd9Y1Yl1OV7_xOLyPwPZocY69lyW-U,378
+elva_cli/commands/__init__.py,sha256=R95HhKM2s1BqdhuMgS6QT5ZAmCxXuBsqU_te3rzSe9s,213
+elva_cli/core/__init__.py,sha256=KotlLaueRU-7B34bLBGIXGwWcSFB2_opTVSVIv_Za-I,211
+elva_cli/core/api/__init__.py,sha256=s9WzwIOsIgA4lJk1XbaiEq-xjUqpKc_w6iwr9eoRyJ0,223
+elva_cli/core/services/__init__.py,sha256=G84vUGpwZET7e4xRH9u34N5u5gJSGId0UO45lwoXlfc,192
+elva_cli/core/spec/__init__.py,sha256=MzDtit5PHljy3dyAN2_r2CzSdQwhiwwREv1oRv8KvTo,46
+elva_cli/settings/__init__.py,sha256=bQ3pDMx4-ikTQwT4zsJPJBrratkuem0hX8n7-XYU27Y,282
+elva_cli/ui/__init__.py,sha256=BziJdFvNO7InnbUOgN_CGZYkaXnFOck9NITfBSIamrg,220
+elva_cli/ui/prompts.py,sha256=FQlQ0lobLWQ2lB0b5NNySWpcEZVbfwmtP-Da971Ja28,377
+elva_cli/ui/renderables/__init__.py,sha256=Zt4OWsxoSgW0Wv2C8N4npRlB7vO3fdJwj7Hfo-auLqo,198
+elva_cli/ui/views/__init__.py,sha256=iRcmc4uq4a6W3pChzbtdnO6iyrp0W2UQ1IN31L5RGf4,75
+elva_cli-0.0.1.dist-info/METADATA,sha256=4X2LlboM6z5xdo6GGV1Euh0F0WDSEgfuJjA_nr6OHJc,2268
+elva_cli-0.0.1.dist-info/WHEEL,sha256=zOwg4jB6zX2kU910N-cMawjivD6tO8NEWvE12je1bVk,87
+elva_cli-0.0.1.dist-info/entry_points.txt,sha256=M3VIGtg24aEhUgTrNGwh4b6uHjDGok4_8dHWQ56RQw4,74
+elva_cli-0.0.1.dist-info/RECORD,,

elva_cli-0.0.1.dist-info/WHEEL

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

elva_cli-0.0.1.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+elva = elva_cli.main:main
+elva-cli = elva_cli.main:main