The Command-line interface (CLI) for Arcsecond. It can be used as Python module too. The CLI makes it easy to login/register and access Arcsecond resources, public and private ones.
Credentials and settings live in ~/.config/arcsecond/, alongside the list of
registered cameras and the live-image proxy's runtime files.
Set ARCSECOND_CONFIG_DIR to put them somewhere else:
$ ARCSECOND_CONFIG_DIR=~/.config/arcsecond-observatory arcsecond loginUseful for keeping a personal account and an observatory's apart, and for
containers or CI jobs that should not touch a home directory. Child processes
the CLI starts — such as the background proxy from arcsecond proxy start —
inherit it.
The project uses uv for environment and dependency management. After forking and cloning:
$ cd ~/arcsecond-cli
$ uv sync --extra webcam --group dev
$ uv run arcsecond --help
$ uv run pytestuv sync creates .venv/ and installs the project with its webcam extra
and the dev dependency group (pytest, black, flake8, isort). Prefix
commands with uv run or activate the venv with source .venv/bin/activate.
The test suite writes nothing to your own configuration: an autouse fixture in
tests/conftest.py points ARCSECOND_CONFIG_DIR at a temporary directory for
the whole run. Several tests save real-looking credentials, so if you add one
that touches ArcsecondConfig, leave that fixture in place.
