API Versions
Dealing with new versions
Over time, adding new capabilities to the plugins will require the interface to be enhanced. Most of the time, this would have no impact on your plugins, but it is not exclude that some interfaces will change to ensure a better overall coherence and consistency. In this case, it can break your plugin and make it unusable with new PrestoPlot versions.
To prevent this risk, the API is versionned, that means a plugin will be connected to PrestoPlot through a specific API version. It is guaranted that a given API version will never been altered, and so your plugin will continue to work, even with new PrestoPlot version.
Determining the version to use
You have two options when creating a plugin. You can bind your plugin against a specific API version, or against the latest one. Use the former to ensure the plugin stability, but without taking benefits of future possibilities (even if you can at any time change the API version you use). Use the latter to stay up-to-date with API features and updates.
Start your plugin with this line to choose stability over time :
package require PrestoPlotAPI 1
Start your plugin with this line if you prefer being always up-to-date :
package require PrestoPlotAPI
Available versions
This is the table of all API versions currently available in PrestoPlot :
| API Version |
|---|
| 1 (Latest) |