Releases · closient/cli

Repository navigation

Release list

closient 0.2.0 Latest

Latest

closient-cli-release released this 18 Oct 08:16

v0.2.0

a3e6d87

Install or upgrade: https://docs.closient.com/cli

Breaking: `--format` is now `--output-format`

The global switch between json and table output is now --output-format, and its environment variable is CLOSIENT_OUTPUT_FORMAT. --format now names the API's own format field, the file format a barcode or label is written in:

closient products barcode 09506000134352 --format png --output product.png
closient --output-format json auth status

The 0.1.x field flags --body-format and --query-format are now plain --format.

Old spellings fail with a pointer to the new one:

--format json or --format table exits 2 with unknown_argument (or invalid_value on a command whose --format takes file formats), naming --output-format.
--body-format and --query-format exit 2, naming --format.

Deprecated: `CLOSIENT_FORMAT`

CLOSIENT_FORMAT is still honoured until 0.3.0 when neither --output-format nor CLOSIENT_OUTPUT_FORMAT is given. Every run that sees it writes a warning to stderr naming CLOSIENT_OUTPUT_FORMAT: a warning: line in table mode, or a one-line {"warning": {"code": "deprecated_environment_variable", ...}} object in json mode. Rename the variable to silence it.

Breaking: barcodes come from stored records

The 0.1.x commands that encoded whatever you typed are gone: qr generate, qr generate-bulk, qr view-bulk-status, codes generate-barcode-1d and codes generate-datamatrix. Each kind of record your organization stores now has its own barcode command. It encodes only what that record holds, and a record that does not exist, or that your organization does not own, is a 404:

products barcode <gtin>
lots barcode <gtin> <lot-id> and serials barcode <gtin> <serial-id>
product-models, logistic-units, returnable-assets, individual-assets and brand-glns
link-type-coupons, link-type-documents and link-type-service-relations

Choose the symbol with --symbology: qr (the default), datamatrix, gs1_128 or gs1_databar_expanded. Products can also use ean13, ean8, upca or itf14. Choose the file with --format (svg, png, pdf, eps or tif). With -o/--output, the file's extension picks --format when you don't give one, and --force overwrites an existing file. Sizing options are --size, --xdim-mm, --dpi and --bar-height-mm. --hri-preset adds a saved human-readable text layout.

closient products barcode 09506000134352 --symbology datamatrix --output product.svg
closient lots barcode 09506000134352 <lot-id> --output lot.pdf

For many lots or serials at once, products bulk-barcodes <gtin> --json-input items.json queues one ZIP, and products view-bulk-barcodes <gtin> <job> polls it.

Logins belong to one organization

When you approve closient auth login in the browser, you choose the organization the login is for, and the CLI prints it: Logged in to <host> as <email> for <organization>.
closient auth status shows an organization row for an OAuth login.
A login from an earlier version isn't tied to an organization. If you belong to more than one, a request that needs one is refused with HTTP 409: "This login is not tied to an organization, and you belong to more than one. Log in again (closient auth login) and choose the organization it is for." Run closient auth login once to fix it. To switch organizations later, log in again.