Argument types

A full list of argument types are below;

Table 2. Argument types reference table
Type Rendered as Allowed values

(default)

Textbox

If a type: is not set, and choices: is empty, then ascii will be used, and a warning will be logged. It is recommended that you set the type explicitly, rather than relying on defaults.

ascii

Textbox

a-z (case insensitive), 0-9, but no spaces or punctuation

ascii_identifier

Textbox

Like a DNS name, a-Z (case insensitive), 0-9, -, ., and _.

ascii_sentence

Textbox

a-z (case insensitive), 0-9, with spaces, . and ,.

email

Textbox

An email address.

very_dangerous_raw_string

Textbox

Anything. This is incredibly dangerous, as effectively people can type anything they like, including executing additional commands beyond what you specify. Absolutely should not be used unless your OliveTin instance can only be used by people you trust entirely.

regex:…​

Textbox

Version 2024.03.081 and above support custom regex patterns. See Custom regex arguments.

int

Textbox

Any number, made up of the characters 0 to 9. Negative numbers are not supported.

url

Textbox

A url, e.g. https://github.com/OliveTin

confirmation

Confirmation

A "hidden" argument that makes the action require a confirmation before launching. See confirmation arguments.

n/a, but choices used

Dropdown

A "hidden" argument that makes the action require a confirmation before launching.