Warning
This document is for an old release of Galaxy. You can alternatively view this page in the latest release if it exists or view the top of the latest release's documentation.
galaxy.tools.deps.resolvers package¶
The module defines the abstract interface for dealing tool dependency resolution plugins.
-
class
galaxy.tools.deps.resolvers.
DependencyResolver
[source]¶ Bases:
galaxy.util.dictifiable.Dictifiable
Abstract description of a technique for resolving container images for tool execution.
-
dict_collection_visible_keys
= ['resolver_type', 'resolves_simple_dependencies', 'can_uninstall_dependencies']¶
-
disabled
= False¶
-
resolves_simple_dependencies
= True¶
-
can_uninstall_dependencies
= False¶
-
config_options
= {}¶
-
resolve
(requirement, **kwds)[source]¶ Given inputs describing dependency in the abstract yield a Dependency object.
The Dependency object describes various attributes (script, bin, version) used to build scripts with the dependency availble. Here script is the env.sh file to source before running a job, if that is not found the bin directory will be appended to the path (if it is not
None
). Finally, version is the resolved tool dependency version (which may differ from requested version for instance if the request version is ‘default’.)
-
-
class
galaxy.tools.deps.resolvers.
MultipleDependencyResolver
[source]¶ Bases:
object
Variant of DependencyResolver that can optionally resolve multiple dependencies together.
-
resolve_all
(requirements, **kwds)[source]¶ Given multiple requirements yields a list of Dependency objects if and only if they may all be resolved together.
Unsuccessfull attempts should return an empty list.
Parameters: - requirements – list of tool requirements
- type – [ToolRequirement] or ToolRequirements
Returns: list of resolved dependencies
Return type:
-
-
class
galaxy.tools.deps.resolvers.
ListableDependencyResolver
[source]¶ Bases:
object
Mix this into a
DependencyResolver
and implement to indicate the dependency resolver can iterate over its dependencies and generate requirements.
-
class
galaxy.tools.deps.resolvers.
MappableDependencyResolver
[source]¶ Bases:
object
Mix this into a
DependencyResolver
to allow mapping files.Mapping files allow adapting generic requirements to specific local implementations.
-
class
galaxy.tools.deps.resolvers.
RequirementMapping
(from_name, from_version, to_name, to_version)[source]¶ Bases:
object
-
matches_requirement
(requirement)[source]¶ Check if supplied ToolRequirement matches this mapping description.
For it to match - the names must match. Additionally if the requirement is created with a version or with unversioned being set to True additional checks are needed. If a version is specified, it must match the supplied version exactly. If
unversioned
is True, then the supplied requirement must be unversioned (i.e. its version must be set toNone
).
-
-
class
galaxy.tools.deps.resolvers.
SpecificationAwareDependencyResolver
[source]¶ Bases:
object
Mix this into a
DependencyResolver
to implement URI specification matching.Allows adapting generic requirements to more specific URIs - to tailor name or version to specified resolution system.
-
class
galaxy.tools.deps.resolvers.
SpecificationPatternDependencyResolver
[source]¶ Bases:
galaxy.tools.deps.resolvers.SpecificationAwareDependencyResolver
Implement the
SpecificationAwareDependencyResolver
with a regex pattern.
-
class
galaxy.tools.deps.resolvers.
InstallableDependencyResolver
[source]¶ Bases:
object
Mix this into a
DependencyResolver
and implement to indicate the dependency resolver can attempt to install new dependencies.
-
class
galaxy.tools.deps.resolvers.
Dependency
[source]¶ Bases:
galaxy.util.dictifiable.Dictifiable
-
dict_collection_visible_keys
= ['dependency_type', 'exact', 'name', 'version', 'cacheable']¶
-
cacheable
= False¶
-
exact
¶ Return true if version information wasn’t discarded to resolve the dependency.
-
resolver_msg
¶ Return a message describing this dependency
-
-
class
galaxy.tools.deps.resolvers.
NullDependency
(version=None, name=None)[source]¶ Bases:
galaxy.tools.deps.resolvers.Dependency
-
dependency_type
= None¶
-
exact
= True¶
-
resolver_msg
¶ Return a message describing this dependency
-
-
exception
galaxy.tools.deps.resolvers.
DependencyException
[source]¶ Bases:
exceptions.Exception
Submodules¶
galaxy.tools.deps.resolvers.brewed_tool_shed_packages module¶
This dependency resolver resolves tool shed dependencies (those defined tool_dependencies.xml) installed using Platform Homebrew and converted via shed2tap (e.g. https://github.com/jmchilton/homebrew-toolshed).
-
class
galaxy.tools.deps.resolvers.brewed_tool_shed_packages.
HomebrewToolShedDependencyResolver
(dependency_manager, **kwds)[source]¶ Bases:
galaxy.tools.deps.resolvers.DependencyResolver
,galaxy.tools.deps.resolvers.resolver_mixins.UsesHomebrewMixin
,galaxy.tools.deps.resolvers.resolver_mixins.UsesToolDependencyDirMixin
,galaxy.tools.deps.resolvers.resolver_mixins.UsesInstalledRepositoriesMixin
-
resolver_type
= 'tool_shed_tap'¶
-
galaxy.tools.deps.resolvers.conda module¶
This is still an experimental module and there will almost certainly be backward incompatible changes coming.
-
class
galaxy.tools.deps.resolvers.conda.
CondaDependencyResolver
(dependency_manager, **kwds)[source]¶ Bases:
galaxy.tools.deps.resolvers.DependencyResolver
,galaxy.tools.deps.resolvers.MultipleDependencyResolver
,galaxy.tools.deps.resolvers.ListableDependencyResolver
,galaxy.tools.deps.resolvers.InstallableDependencyResolver
,galaxy.tools.deps.resolvers.SpecificationPatternDependencyResolver
,galaxy.tools.deps.resolvers.MappableDependencyResolver
-
dict_collection_visible_keys
= ['resolver_type', 'resolves_simple_dependencies', 'can_uninstall_dependencies', 'conda_prefix', 'versionless', 'ensure_channels', 'auto_install']¶
-
resolver_type
= 'conda'¶
-
config_options
= {'auto_init': True, 'auto_install': False, 'copy_dependencies': False, 'debug': None, 'ensure_channels': 'iuc,conda-forge,bioconda,defaults', 'exec': None, 'prefix': None, 'use_local': False}¶
-
uninstall
(requirements)[source]¶ Uninstall requirements installed by install_all or multiple install statements.
-
resolve_all
(requirements, **kwds)[source]¶ Some combinations of tool requirements need to be resolved all at once, so that Conda can select a compatible combination of dependencies. This method returns a list of MergedCondaDependency instances (one for each requirement) if all requirements have been successfully resolved, or an empty list if any of the requirements could not be resolved.
Parameters specific to this resolver are:
- preserve_python_environment: Boolean, controls whether the python environment should be maintained during job creation for tools
- that rely on galaxy being importable.
- install: Controls if requirements should be installed. If install is True and the requirements are not installed
- an attempt is made to install the requirements. If install is None requirements will only be installed if conda_auto_install has been activated and the requirements are not yet installed. If install is False will not install requirements.
-
unused_dependency_paths
(toolbox_requirements_status)[source]¶ Identify all local environments that are not needed to build requirements_status.
We try to resolve the requirements, and we note every environment_path that has been taken.
-
install_dependency
(name, version, type, **kwds)[source]¶ Returns True on (seemingly) successfull installation
-
prefix
¶
-
galaxy.tools.deps.resolvers.galaxy_packages module¶
-
class
galaxy.tools.deps.resolvers.galaxy_packages.
GalaxyPackageDependency
(script, path, name, type, version, exact=True)[source]¶ Bases:
galaxy.tools.deps.resolvers.Dependency
-
dict_collection_visible_keys
= ['dependency_type', 'exact', 'name', 'version', 'cacheable', 'script', 'path', 'version', 'name']¶
-
dependency_type
= 'galaxy_package'¶
-
exact
¶
-
-
class
galaxy.tools.deps.resolvers.galaxy_packages.
ToolShedDependency
(script, path, name, type, version, exact=True)[source]¶ Bases:
galaxy.tools.deps.resolvers.galaxy_packages.GalaxyPackageDependency
-
dependency_type
= 'tool_shed_package'¶
-
-
class
galaxy.tools.deps.resolvers.galaxy_packages.
GalaxyPackageDependencyResolver
(dependency_manager, **kwds)[source]¶ Bases:
galaxy.tools.deps.resolvers.galaxy_packages.BaseGalaxyPackageDependencyResolver
,galaxy.tools.deps.resolvers.ListableDependencyResolver
,galaxy.tools.deps.resolvers.MappableDependencyResolver
-
resolver_type
= 'galaxy_packages'¶
-
galaxy.tools.deps.resolvers.homebrew module¶
This file implements a brew resolver for Galaxy requirements. In order for Galaxy to pick up on recursively defined and versioned brew dependencies recipes should be installed using the experimental brew-vinstall external command.
More information here:
https://github.com/jmchilton/brew-tests https://github.com/Homebrew/homebrew-science/issues/1191
This is still an experimental module and there will almost certainly be backward incompatible changes coming.
-
class
galaxy.tools.deps.resolvers.homebrew.
HomebrewDependencyResolver
(dependency_manager, **kwds)[source]¶ Bases:
galaxy.tools.deps.resolvers.DependencyResolver
,galaxy.tools.deps.resolvers.resolver_mixins.UsesHomebrewMixin
-
resolver_type
= 'homebrew'¶
-
galaxy.tools.deps.resolvers.lmod module¶
This is a prototype dependency resolver to be able to use the “LMOD environment modules system” from TACC to solve package requirements
LMOD official website: https://www.tacc.utexas.edu/research-development/tacc-projects/lmod
LMOD @ Github: https://github.com/TACC/Lmod
-
class
galaxy.tools.deps.resolvers.lmod.
LmodDependencyResolver
(dependency_manager, **kwds)[source]¶ Bases:
galaxy.tools.deps.resolvers.DependencyResolver
,galaxy.tools.deps.resolvers.MappableDependencyResolver
Dependency resolver based on the LMOD environment modules system
-
dict_collection_visible_keys
= ['resolver_type', 'resolves_simple_dependencies', 'can_uninstall_dependencies', 'base_path', 'modulepath']¶
-
resolver_type
= 'lmod'¶
-
galaxy.tools.deps.resolvers.modules module¶
This file contains the outline of an implementation to load environment modules (http://modules.sourceforge.net/).
This is a community contributed feature and the core Galaxy team does utilize it, hence support for it will be minimal. The Galaxy team eagerly welcomes community contribution and maintenance however.
-
class
galaxy.tools.deps.resolvers.modules.
ModuleDependencyResolver
(dependency_manager, **kwds)[source]¶ Bases:
galaxy.tools.deps.resolvers.DependencyResolver
,galaxy.tools.deps.resolvers.MappableDependencyResolver
-
dict_collection_visible_keys
= ['resolver_type', 'resolves_simple_dependencies', 'can_uninstall_dependencies', 'base_path', 'modulepath']¶
-
resolver_type
= 'modules'¶
-
galaxy.tools.deps.resolvers.resolver_mixins module¶
galaxy.tools.deps.resolvers.tool_shed_packages module¶
-
class
galaxy.tools.deps.resolvers.tool_shed_packages.
ToolShedPackageDependencyResolver
(dependency_manager, **kwds)[source]¶ Bases:
galaxy.tools.deps.resolvers.galaxy_packages.BaseGalaxyPackageDependencyResolver
,galaxy.tools.deps.resolvers.resolver_mixins.UsesInstalledRepositoriesMixin
-
resolver_type
= 'tool_shed_packages'¶
-
dependency_type
¶ alias of
galaxy.tools.deps.resolvers.galaxy_packages.ToolShedDependency
-
resolves_simple_dependencies
= False¶
-
galaxy.tools.deps.resolvers.unlinked_tool_shed_packages module¶
Backup resolvers for when dependencies can not be loaded from the database. Mainly suited for testing stage.
- Ideally all dependencies will be stored in the database
- when a tool is added from a Tool Shed.
That should remain the preferred way of locating dependencies.
- In cases where that is not possible
- for example during testing this resolver can act as a backup.
- This resolver looks not just for manually added dependencies
- but also ones added from a Tool Shed.
This tool is still under development so the default behaviour could change. It has been tested when placed in the same directory as galaxy_packages.py
At the time of writing July 3 2015 this resolver has to be plugged in. See bottom for instructions on how to add this resolver.
-
class
galaxy.tools.deps.resolvers.unlinked_tool_shed_packages.
UnlinkedToolShedPackageDependencyResolver
(dependency_manager, **kwds)[source]¶ Bases:
galaxy.tools.deps.resolvers.galaxy_packages.BaseGalaxyPackageDependencyResolver
-
dict_collection_visible_keys
= ['resolver_type', 'resolves_simple_dependencies', 'can_uninstall_dependencies', 'base_path', 'versionless', 'preferred_owners', 'select_by_owner']¶
-
resolver_type
= 'unlinked_tool_shed_packages'¶
-