Initial version of "api"





























1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
## # 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)