asciidoc/ivyfile/dependencies.adoc

////
   Licensed to the Apache Software Foundation (ASF) under one
   or more contributor license agreements.  See the NOTICE file
   distributed with this work for additional information
   regarding copyright ownership.  The ASF licenses this file
   to you under the Apache License, Version 2.0 (the
   "License"); you may not use this file except in compliance
   with the License.  You may obtain a copy of the License at

     https://www.apache.org/licenses/LICENSE-2.0

   Unless required by applicable law or agreed to in writing,
   software distributed under the License is distributed on an
   "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
   KIND, either express or implied.  See the License for the
   specific language governing permissions and limitations
   under the License.
////

*Tag:* dependencies *Parent:* link:../ivyfile{outfilesuffix}[ivy-module]

Container for dependency elements, used to describe the dependencies of this module. If this container is not present, it is assumed that the module has no dependencies at all.

This container provides two similar behaviors described below. (See link:configurations{outfilesuffix}[configurations doc page] for more details about these behaviors).

(*__since 1.1__*) `defaultconf` defines the `conf` attribute to use when no conf is defined for a dependency in this Ivy file. It is only used when no conf mapping is defined, and has no influence in other cases.

(*__since 1.3__*) `defaultconfmapping` influences the way that a conf mapping with no mapped conf is interpreted.

(*__since 2.2__*) Attributes `defaultconf` and `defaultconfmapping` can be used together. In earlier versions, if both `defaultconf` and `defaultconfmapping` are defined, it's the `defaultconfmapping` that is used.

(*__since 1.4__*) You can activate a `confmappingoverride` mode for all configurations, in which case the extending configurations will override the mappings of the configurations they extend from.

(*__since 2.5__*) Attributes inherited via link:extends{outfilesuffix}[`extends`] are added to `dependencies` only on link:../use/deliver{outfilesuffix}[delivery] and override attributes inherited from `configurations`.

== Attributes

[options="header",cols="15%,50%,35%"]
|=======
|Attribute|Description|Required
|defaultconf|the default configuration to use when none is specified in a dependency. (*__since 1.1__*)|No, defaults to `$$*->*$$`
|defaultconfmapping|the default configuration mapping to use in this Ivy file. (*__since 1.3__*)|No, defaults to no default conf mapping
|confmappingoverride|`true` to activate configuration mapping override, `false` otherwise. (*__since 1.4__*)|No, defaults to `false`
|=======


== Child elements


Note: as specified by the ivy.xsd, the children elements are ordered; first must come the `link:dependency{outfilesuffix}[dependency]` elements, then the `link:exclude{outfilesuffix}[exclude]` elements, then the `link:override{outfilesuffix}[override]` elements, and then the `link:conflict{outfilesuffix}[conflict]` elements.


[options="header",cols="20%,60%,20%"]
|=======
|Element|Description|Cardinality
|link:dependency{outfilesuffix}[dependency]|declares a dependency for this module|0..n
|link:exclude{outfilesuffix}[exclude]|excludes artifacts, modules or whole organizations from the set of dependencies of this module (*__since 2.0__*)|0..n
|link:override{outfilesuffix}[override]|specifies an override mediation rule, overriding the revision and/or branch requested for a transitive dependency (*__since 2.0__*)|0..n
|link:conflict{outfilesuffix}[conflict]|specifies a conflict manager for one or several dependencies (*__since 2.0__*)|0..n
|=======