History Page Raw
Overview

Artifact ID: e89c4d57a4a48b9333f963ef59d6d3c9d2f2a0cc3c38f8ae97128fb8dbe48fc5
Page Name:api
Date: 2018-07-03 20:06:27
Original User: mario
Mimetype:text/x-markdown
Parent: 7ccf61855f0fa1a82970a92075b225027f533d0a812028da239fcadb636d8c1a (diff)
Next 9f3ab66ff6fdb61d0ec4ef0922a469a4db0fd5078824dafe83e1eeaff44345cd
Content

# api:

An optional field to precise which application a script/plugin belongs to:

# api: streamtuner2

Which is a vanity tag foremost. You wouldn't normally mix scripts from different applications or languages and expect them to behave or work at all.

  • Nonetheless it makes sense for installation management, or filtering in plugin download repositories.

  • Additionally you still want to do some verification, such as

    $meta.api ~= /^(|myapi|altname|python)$/

  • Usually you'd allow # api: language for generic plugins (not bound to specific API).

  • And you might very well combine scripts from different APIs (in the same language, that is). For instance if one plugin implemented a stub API:

    # provide: api:archnemesis

  • Essentially # api: NAME is a shortcut for # depends: api:NAME. See also depends