Artifact 7ccf61855f0fa1a82970a92075b225027f533d0a812028da239fcadb636d8c1a:

Wiki page [api] by mario on 2018-07-03 20:06:02.
D 2018-07-03T20:06:02.564
L api
U mario
W 886
## # 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](wiki/depends)



Z 115161ff69a67ccbbf420361b2e666ce