elva-cli 0.0.1__tar.gz

elva_cli-0.0.1/.gitignore

@@ -0,0 +1,223 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[codz]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#   Usually these files are written by a python script from a template
+#   before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py.cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+# .python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+# Pipfile.lock
+
+# UV
+#   Similar to Pipfile.lock, it is generally recommended to include uv.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+# uv.lock
+
+# poetry
+#   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
+# poetry.lock
+# poetry.toml
+
+# pdm
+#   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
+#   pdm recommends including project-wide configuration in pdm.toml, but excluding .pdm-python.
+#   https://pdm-project.org/en/latest/usage/project/#working-with-version-control
+# pdm.lock
+# pdm.toml
+.pdm-python
+.pdm-build/
+
+# pixi
+#   Similar to Pipfile.lock, it is generally recommended to include pixi.lock in version control.
+# pixi.lock
+#   Pixi creates a virtual environment in the .pixi directory, just like venv module creates one
+#   in the .venv directory. It is recommended not to include this directory in version control.
+.pixi
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# Redis
+*.rdb
+*.aof
+*.pid
+
+# RabbitMQ
+mnesia/
+rabbitmq/
+rabbitmq-data/
+
+# ActiveMQ
+activemq-data/
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.envrc
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# PyCharm
+#   JetBrains specific template is maintained in a separate JetBrains.gitignore that can
+#   be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
+#   and can be added to the global gitignore or merged into this file.  For a more nuclear
+#   option (not recommended) you can uncomment the following to ignore the entire idea folder.
+# .idea/
+
+# Abstra
+#   Abstra is an AI-powered process automation framework.
+#   Ignore directories containing user credentials, local state, and settings.
+#   Learn more at https://abstra.io/docs
+.abstra/
+
+# Visual Studio Code
+#   Visual Studio Code specific template is maintained in a separate VisualStudioCode.gitignore 
+#   that can be found at https://github.com/github/gitignore/blob/main/Global/VisualStudioCode.gitignore
+#   and can be added to the global gitignore or merged into this file. However, if you prefer, 
+#   you could uncomment the following to ignore the entire vscode folder
+# .vscode/
+# Temporary file for partial code execution
+tempCodeRunnerFile.py
+
+# Ruff stuff:
+.ruff_cache/
+
+# PyPI configuration file
+.pypirc
+
+# Marimo
+marimo/_static/
+marimo/_lsp/
+__marimo__/
+
+# Streamlit
+.streamlit/secrets.toml
+
+# Elva
+.venv/
+src/elva_cli/_version.py
+.ruff_cache/

elva_cli-0.0.1/PKG-INFO

@@ -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/README.md

@@ -0,0 +1,71 @@
+# 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/pyproject.toml

@@ -0,0 +1,106 @@
+[build-system]
+requires = ["hatchling>=1.24", "hatch-vcs>=0.4"]
+build-backend = "hatchling.build"
+
+[project]
+name = "elva-cli"
+dynamic = ["version"]
+description = "Elva - CLI for Theneo Elva"
+readme = "README.md"
+requires-python = ">=3.11"
+authors = [{ name = "Theneo", email = "support@theneo.io" }]
+keywords = ["openapi", "api", "documentation", "cli", "elva", "theneo"]
+classifiers = [
+  "Development Status :: 3 - Alpha",
+  "Environment :: Console",
+  "Intended Audience :: Developers",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
+  "Topic :: Software Development :: Documentation",
+  "Typing :: Typed",
+]
+
+dependencies = [
+  "typer>=0.15,<1.0",
+]
+
+[project.optional-dependencies]
+dev = [
+  "ruff>=0.6",
+  "mypy>=1.11",
+  "pytest>=8.2",
+]
+
+[project.urls]
+Homepage = "https://getelva.ai"
+Source = "https://github.com/Theneo-Inc/theneo-elva-cli"
+Issues = "https://github.com/Theneo-Inc/theneo-elva-cli/issues"
+
+[project.scripts]
+elva = "elva_cli.main:main"
+elva-cli = "elva_cli.main:main"
+
+
+[tool.hatch.version]
+source = "vcs"
+raw-options = { version_scheme = "no-guess-dev" }
+
+[tool.hatch.build.hooks.vcs]
+version-file = "src/elva_cli/_version.py"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/elva_cli"]
+
+[tool.hatch.build.targets.sdist]
+include = ["src", "tests", "README.md", "CHANGELOG.md"]
+
+
+[tool.ruff]
+line-length = 100
+target-version = "py311"
+src = ["src", "tests"]
+
+[tool.ruff.lint]
+select = [
+  "E", "F", "W",      # pycodestyle, pyflakes
+  "I",                # isort
+  "N",                # pep8-naming
+  "UP",               # pyupgrade
+  "B",                # bugbear
+  "A",                # builtin shadowing
+  "C4",               # comprehensions
+  "SIM",              # simplify
+  "PTH",              # use pathlib
+  "RET",              # return
+  "TC",               # move type-only imports into TYPE_CHECKING
+  "TID",              # tidy imports
+  "RUF",
+]
+ignore = [
+  "B008",  # typer relies on function calls in argument defaults
+]
+
+[tool.ruff.lint.per-file-ignores]
+"tests/*" = ["A002"]
+
+[tool.ruff.lint.flake8-tidy-imports]
+ban-relative-imports = "all"
+
+
+[tool.mypy]
+python_version = "3.11"
+strict = true
+files = ["src"]
+warn_unreachable = true
+enable_error_code = ["ignore-without-code", "redundant-expr"]
+
+[[tool.mypy.overrides]]
+module = ["questionary.*", "trogon.*"]
+ignore_missing_imports = true
+
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+addopts = "-q --strict-markers --strict-config"
+xfail_strict = true

elva_cli-0.0.1/src/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-0.0.1/src/elva_cli/__main__.py

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

elva_cli-0.0.1/src/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-0.0.1/src/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-0.0.1/src/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-0.0.1/src/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-0.0.1/src/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-0.0.1/src/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-0.0.1/src/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-0.0.1/src/elva_cli/core/spec/__init__.py

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

elva_cli-0.0.1/src/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-0.0.1/src/elva_cli/logging.py

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

elva_cli-0.0.1/src/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-0.0.1/src/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-0.0.1/src/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-0.0.1/src/elva_cli/telemetry.py

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

elva_cli-0.0.1/src/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-0.0.1/src/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-0.0.1/src/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-0.0.1/src/elva_cli/ui/views/__init__.py

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

elva_cli-0.0.1/src/elva_cli/update.py

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