Command-line reference

ltd

ltd is a command-line client for LSST the Docs.

Use ltd to upload new site builds, and to work with the LTD Keeper API.

ltd [OPTIONS] COMMAND [ARGS]...

Options

--log-level <log_level>

Logging level (for first-party messages). Default: warning.

--host <keeper_hostname>

Hostname of the LTD Keeper API (or $LTD_HOST). Default: https://keeper.lsst.codes.

-u, --user <username>

Username for LTD Keeper (or $LTD_USERNAME).

-p, --password <password>

Password for LTD Keeper (or $LTD_PASSWORD).

--version

Show the version and exit.

Environment variables

LTD_HOST

Provide a default for --host

LTD_USERNAME

Provide a default for -u

LTD_PASSWORD

Provide a default for -p

help

Show help for any command.

ltd help [OPTIONS] [TOPIC]

Arguments

TOPIC

Optional argument

upload

Upload a new site build to LSST the Docs.

ltd upload [OPTIONS]

Options

--product <product>

Product name. [required]

--git-ref <git_ref>

Git ref, or space-delimited list of git refs. This versions the build and helps LTD Keeper assign the build to an edition. Alternatively, version information can be auto-discovered by setting –travis in a Travis CI job.

--dir <dirname>

Directory with files to upload. Default: (current working directory).

--aws-id <aws_id>

AWS ID (or $LTD_AWS_ID). [required]

--aws-secret <aws_secret>

AWS secret access key (or $LTD_AWS_SECRET). [required]

--travis

Use environment variables from a Travis CI environment to set the –git-ref option.

--on-travis-push, --no-travis-push

Upload on a Travis CI push (enabled by default). Must be used with –travis.

--on-travis-pr, --no-travis-pr

Upload on a Travis CI pull request event (disabled by default). Must be used with –travis.

--on-travis-api, --no-travis-api

Upload on a Travis CI API event (enabled by default). Must be used with –travis.

--on-travis-cron, --no-travis-cron

Upload on a Travis CI cron event (enabled by default). Must be used with –travis.

--skip

Skip the upload, making the command a no-op. Useful in CI environments to disable a site upload just by setting this option or the environment variable $LTD_SKIP_UPLOAD=true.

Environment variables

LTD_AWS_ID

Provide a default for --aws-id

LTD_AWS_SECRET

Provide a default for --aws-secret

LTD_SKIP_UPLOAD

Provide a default for --skip