matlab.mpm.Dependency

R2026b

Package dependency

Since R2024b

Description

A dependency is a package that a different package depends on. Use matlab.mpm.Dependency objects to specify package dependencies for matlab.mpm.Package or matlab.addons.toolbox.ToolboxOptions objects.

Creation

Syntax

dep = matlab.mpm.Dependency(name,verRange,id)

Description

dep = matlab.mpm.Dependency(name,verRange,id) creates a dependency object using the specified package name, version, and identifier.

Input Arguments

name — Dependency name

string scalar | character vector

Dependency name, specified as a string scalar or character vector containing the name of the dependency.

This argument sets the Name property.

Example: "MyOtherPackage"

verRange — Version range

string scalar | character vector | matlab.mpm.Version object

Version range, specified as a string scalar, character vector, or matlab.mpm.Version object. This option limits the output to only packages whose Version property is within the specified version range.

Version syntax follows the Semantic Versioning 2.0.0 format: <major version>.<minor version>.<patch version>, where each version number must be a nonnegative integer, for example 1.2.3. You can optionally specify a pre-release version by adding -<pre-release version> to the end of the version, for example 1.2.3-alpha. Optionally specify a build version by adding +<build version>.

Specify a range of versions by including the <, <=, >, or >= operators in front of a version number. For example, >2.1.13 specifies all versions greater than 2.1.13. Specify more than one range separated by white space to further limit matches. For example, >2.1.13 <=2.1.15 includes versions 2.1.14 and 2.1.15, but not 2.1.13 or 2.1.16. Use the || operator to designate multiple acceptable version ranges. For example, <2.1.13 || >2.1.15 includes versions less than 2.1.13 and greater than 2.1.15, but not 2.1.14.

Example: "1.2.3"

Example: "1.2.3-alpha"

Example: "1.2.3-alpha+exp"

Example: ">2.1.13"

Example: ">2.1.13 <=2.1.15"

Example: "<2.1.13 || >2.1.15"

id — Package UUID

string scalar | character vector

Package UUID, specified as a string scalar or character vector containing a universally unique identifier (UUID) of the dependency.

This argument sets the ID property.

Example: "9ecfea6b-1710-4fb9-aa66-e4750f0e8251"

Properties

Name — Dependency name

string scalar | character vector

Dependency name, specified as a string scalar or character vector containing the name of the dependency.

VersionRange — Version range

"*" (default) | string scalar | character vector | matlab.mpm.Version object

Version range, specified as a string scalar, character vector, or matlab.mpm.Version object. By default, this property is "*", which represents all versions.

Version syntax follows the Semantic Versioning 2.0.0 format: <major version>.<minor version>.<patch version>, where each version number must be a nonnegative integer, for example 1.2.3. You can optionally specify a pre-release version by adding -<pre-release version> to the end of the version, for example 1.2.3-alpha. Optionally specify a build version by adding +<build version>.

Specify a range of versions by including the <, <=, >, or >= operators in front of a version number. For example, >2.1.13 specifies all versions greater than 2.1.13. Specify more than one range separated by white space to further limit matches. For example, >2.1.13 <=2.1.15 includes versions 2.1.14 and 2.1.15, but not 2.1.13 or 2.1.16. Use the || operator to designate multiple acceptable version ranges. For example, <2.1.13 || >2.1.15 includes versions less than 2.1.13 and greater than 2.1.15, but not 2.1.14.

ID — Package UUID

string scalar

Package UUID, returned as a string scalar containing a universally unique identifier (UUID) of the dependency.

ResolvedVersion — Resolved dependency version

matlab.mpm.Version object

Resolved dependency version, returned as a matlab.mpm.Version object. When installing the dependency package, MATLAB sets this property using the installed version of the dependency.

Example: matlab.mpm.Version("1.2.3")

Examples

Create Package Dependency

Create a package dependency using a package named MyPackageDependency.

dep = matlab.mpm.Dependency("MyPackageDependency","1.2.3","4ca03e45-70d0-44b3-b0e5-ac18cf32d534")

dep = 

  Dependency with properties:

               Name: "MyPackageDependency"
       VersionRange: "1.2.3"
                 ID: "4ca03e45-70d0-44b3-b0e5-ac18cf32d534"
    ResolvedVersion: <missing>

Extended Capabilities

Thread-Based Environment

Run code in the background using MATLAB® backgroundPool or accelerate code with Parallel Computing Toolbox™ ThreadPool.

The matlab.mpm.Dependency function fully supports thread-based environments. For more information, see Run MATLAB Functions in Thread-Based Environment.

Version History

Introduced in R2024b