Package org.jenkinsci.test.acceptance.po
Class PluginManager
-
- All Implemented Interfaces:
CapybaraPortingLayer
public class PluginManager extends ContainerPageObject
Page object for plugin manager.- Author:
- Kohsuke Kawaguchi
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description static class
PluginManager.InstallationStatus
-
Nested classes/interfaces inherited from class org.jenkinsci.test.acceptance.po.CapybaraPortingLayerImpl
CapybaraPortingLayerImpl.Finder<R>, CapybaraPortingLayerImpl.Resolver
-
-
Field Summary
Fields Modifier and Type Field Description boolean
forceRestart
Jenkins
jenkins
MockUpdateCenter
mockUpdateCenter
boolean
uploadPlugins
Deprecated.Blocks use ofMockUpdateCenter
.-
Fields inherited from class org.jenkinsci.test.acceptance.po.PageObject
jsonParser, url
-
Fields inherited from class org.jenkinsci.test.acceptance.po.CapybaraPortingLayerImpl
driver, injector, LABEL_TO_INPUT_XPATH, time
-
Fields inherited from interface org.jenkinsci.test.acceptance.po.CapybaraPortingLayer
by
-
-
Constructor Summary
Constructors Constructor Description PluginManager(Jenkins jenkins)
-
Method Summary
All Methods Instance Methods Concrete Methods Deprecated Methods Modifier and Type Method Description void
checkForUpdates()
Force update the plugin update center metadata.void
enablePlugin(String pluginName, boolean state)
Enable oder disable the specified plugin.hudson.util.VersionNumber
getAvailableVersionForPlugin(String pluginName)
PluginManager.InstallationStatus
installationStatus(String spec)
PluginManager.InstallationStatus
installationStatus(PluginSpec spec)
void
installPlugin(File localFile)
Deprecated.Not used when runningMockUpdateCenter
.boolean
installPlugins(PluginSpec... specs)
Deprecated.Please be encouraged to useWithPlugins
annotations to statically declare the required plugins you need.boolean
isInstalled(String... specs)
Deprecated.boolean
isInstalled(PluginSpec... specs)
-
Methods inherited from class org.jenkinsci.test.acceptance.po.ContainerPageObject
action, action, equals, getConfigUrl, getJson, getJson, getJsonApiUrl, getNavigationLinks, hashCode
-
Methods inherited from class org.jenkinsci.test.acceptance.po.ConfigurablePageObject
apply, configure, configure, configure, configure, ensureConfigPage, getFormName, getSubmitButtonText, save
-
Methods inherited from class org.jenkinsci.test.acceptance.po.PageObject
control, control, createPageArea, createRandomName, getContext, getJenkins, open, toString, url, url, visit
-
Methods inherited from class org.jenkinsci.test.acceptance.po.CapybaraPortingLayerImpl
all, blur, check, check, check, choose, clickButton, clickLink, confirmAlert, elasticSleep, executeScript, fillIn, find, findCaption, findCaption, findIfNotVisible, getCurrentUrl, getCurrentUrlWithFragment, getElement, getPageContent, getPageSource, getPageSource, getPath, handleAlert, isStale, last, lastIfNotVisible, newInstance, resource, runThenConfirmAlert, runThenConfirmAlert, runThenHandleAlert, runThenHandleAlert, sleep, visit, waitFor, waitFor, waitFor, waitFor, waitFor, waitForCond, waitForCond
-
-
-
-
Field Detail
-
jenkins
public final Jenkins jenkins
-
uploadPlugins
@Inject(optional=true) @Named("uploadPlugins") @Deprecated public boolean uploadPlugins
Deprecated.Blocks use ofMockUpdateCenter
.Optional configuration value that selects whether to resolve plugins locally and upload to Jenkins (better performing when Jenkins is closer to the test execution), or install plugins from within Jenkins (more accurate testing.)
-
forceRestart
@Inject(optional=true) @Named("forceRestartAfterPluginInstallation") public boolean forceRestart
-
mockUpdateCenter
@Inject public MockUpdateCenter mockUpdateCenter
-
-
Constructor Detail
-
PluginManager
public PluginManager(Jenkins jenkins)
-
-
Method Detail
-
checkForUpdates
public void checkForUpdates()
Force update the plugin update center metadata.
-
installationStatus
public PluginManager.InstallationStatus installationStatus(String spec)
-
installationStatus
public PluginManager.InstallationStatus installationStatus(PluginSpec spec)
- Returns:
- whether the plugin (in version greater or equal than specified) is installed
-
isInstalled
@Deprecated public boolean isInstalled(String... specs)
Deprecated.
-
isInstalled
public boolean isInstalled(PluginSpec... specs)
- Parameters:
specs
- plugin ids with optional version (e.g. "ldap" or "ldap@1.8")- Returns:
- true, if plugin (in version greater or equal than specified) is installed
-
installPlugins
@Deprecated public boolean installPlugins(PluginSpec... specs) throws UpdateCenterMetadata.UnableToResolveDependencies, IOException
Deprecated.Please be encouraged to useWithPlugins
annotations to statically declare the required plugins you need. If you really do need to install plugins in the middle of a test, as opposed to be in the beginning, then this is the right method.The deprecation marker is to call attention to
WithPlugins
. This method is not really deprecated.Installs specified plugins.- Returns:
- Always false.
- Throws:
UpdateCenterMetadata.UnableToResolveDependencies
IOException
-
getAvailableVersionForPlugin
public hudson.util.VersionNumber getAvailableVersionForPlugin(String pluginName)
-
installPlugin
@Deprecated public void installPlugin(File localFile) throws IOException
Deprecated.Not used when runningMockUpdateCenter
.Installs a plugin by uploading the *.jpi image. Can be use for corner cases to verify some behavior when very specific plugin versions are needed, for example to verify that a warning message is displayed when a risky and outdated plugin is installed on Jenkins.- Throws:
IOException
-
enablePlugin
public void enablePlugin(String pluginName, boolean state)
Enable oder disable the specified plugin.- Parameters:
pluginName
- plugin id (e.g. "ldap")state
- enable plugin if true, disable plugin if false
-
-