Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

The version attribute is required. This attribute is used in the generation of dependency package file names for a given extension.

api_level

The api_level attribute is required. This attribute is used to specify the Universal Extension API level required by the extension. There are two important things controlled by the api_level.

Note

The Universal Controller will only run a Universal Extension task on an agent that supports

...

the specified api_level.

The extension developer should

...

choose the target API level carefully in order to prevent unnecessarily restricting the compatibility of the extension

...

For example, specifying the latest API level

...

available

...

at the

...

time of extension development would restrict the extension to only running on the latest agents that support that API level.  Unless the extension was explicitly using functionality introduced with that API level, it would be unnecessarily restricting the compatibility.

In general, an extension should not specify an API level higher than what is required by the extension.  Doing so only

...

serves to restrict the range of agent versions it can run on.

requires_python

The requires_python attribute is optional. This attribute allows the extension to specify the versions of Python it can work with. The syntax and semantics are a subset of PEP 440 version specifiers. Its value consists of one or more version specifier clauses delimited by commas. A specifier clause consists of a comparison operator and a version number. if not specified, a default value of >=2.7 will be used.  Valid comparison operators are as follows:

...