Stashall

This page will exist for a while to note proposals for stash/unstash/stashlist syntax.

Ideas, moved from general todo page:

• Implement best|worst qualifier for types.
• Implement quantifiers 'unstash 3 best eye of flame'

Proposals:

1) syntax supported: stash <item>, stash <number> <specifier>, stash all <specifier>, stash any <specifier>, stash all, unstash <quality> <item>, unstash <number> <specifier>, unstash any <specifier>, unstash all <specifier>, unstash <best/worst specifier>, unstash all, stashlist, stashlist <specifier>.

<item> refers to any exact identifier for the item in question. "stash fragment 2"

<number> is [0-9]*, like "1" or "25". This means we want that many things.

<specifier> is any string that does not start with "all", "any", or a number. specifiers have some special forms: First, if the specifier starts with 'best' or 'worst', then this means we should interpret the rest of the specifier, then select the highest- or lowest-quality items. Second, if the specifier includes the word 'fragments', then the search should be run as if this word was "fragment|essence|heart".

A specifier matches an item if it is an exact substring of any ID string of the item. For instance, "ary je" is going to match any 'legendary jewel' (and not anything else in crafting that I can think of). "frag" will match any 'fragment of <whatever>', "poor fragments" will match poor fragment of x, poor essence of x, poor heart of x. If the specifier matches a jewel, the jewel will have precedence over the dust. ("unstash all poor morg" means unstash all poor morganite, not poor morganite dust too.

'any' and '1' are functionally equivalent.

Possible add-on: in specifiers, the exact words 'l', 'w', 's', 'g', 'a', 'p', and 'c' will be interpreted as the quality types. Note this would get messy if there were crafting items with the word 'a', which I don't think there are. But we could say that one is 'av' or 'avg' instead.

Various usage: stash all crude, unstash 12 morg, stashlist fragments, unstash all poor dust, stash all fragments, unstash worst beryl, unstash 12 best tourmaline dust unstash all crude jewel, stashlist gem of, stashlist jewel