[python plugin] How to sort actions by frequency

[tomsquest]

Here is an example:

When triggering the emoji plugin, I often use the thumb_up emoji (:+1: ), but the plugin keeps putting this emoji below in the list.
Concretely, the plugin does not rely on frequency/frecency to sort entries.

How one could achieve that? Does Albert provide a way to let the plugin provide "Actions" and Albert would sort them in the appropriate order?

[ManuelSchneid3r]

An overview:

TriggerQueryHandler:

• requires a non-empty trigger
• is guaranteed to be run exclusively
• can add items asynchronously (items are displayed instantly)
• therefore the sequence of added items define the display order
• can display an inline synopsis
• can prohibit users to change the default trigger (e.g. file browsers triggers / and ~)

GlobalQueryHandler

• does not require a trigger
• ran in a batch with other handlers (the global query)
• has to score items such that they can be sorted before they are displayed to the user
• return items in a batch

QueryHandler

• subclasses TriggerQueryHandler and GlobalQueryHandler
• implements the query handling of TriggerQueryHandler::handleTriggerQuery
• redirects calls to handleTriggerQuery to handleGlobalQuery sorts and adds items

IndexQueryHandler (not exposed to python yet)

• subclasses QueryHandler
• implements the global query handling of QueryHandler::handleGlobalQuery
• maintains an (two-gram fuzzy) index which handles matching and scoring for clients.
• most convenient (also fast because most stuf happens in c++) approach for clients providing static items (sure you can change the items but you should not rebuild the index that often, for performance reasons)

keeps putting this emoji below in the list

the above overview should sort out the question why.

How one could achieve that?

try QueryHandler. you need to score the items though.

Does Albert provide a way to let the plugin provide "Actions" and Albert would sort them in the appropriate order?

is this question really about actions (hold alt, see #499) or result items?