UpgradeDependencyCommand class

Upgrades package dependencies to their latest versions.

The UpgradeDependencyCommand provides options to upgrade dependencies across different scopes: the entire project, specific core packages, or individual modules. It ensures dependencies are updated safely while maintaining compatibility.

Usage

Upgrade morpheme_library dependencies (default):

morpheme upgrade-dependency

Upgrade all project dependencies:

morpheme upgrade-dependency --all

Upgrade dependency_manager package:

morpheme upgrade-dependency --dependency

Upgrade with custom configuration:

morpheme upgrade-dependency --all --morpheme-yaml custom/path/morpheme.yaml

Options

• --all, -a: Upgrade all project package dependencies
• --dependency, -d: Upgrade dependency_manager package dependencies
• --morpheme, -g: Upgrade morpheme_library package dependencies (default)
• --morpheme-yaml: Path to morpheme.yaml configuration

Safety

• Prompts for confirmation before major upgrades
• Validates package integrity after upgrades
• Supports rollback guidance if issues occur

Dependencies

• Requires valid morpheme.yaml configuration (for --all)
• Uses ModularHelper for multi-package operations
• Requires Flutter SDK for pub operations

Exceptions

Throws FileSystemException if target packages don't exist. Throws ProcessException if dependency upgrade fails.

Inheritance

• Object
• Command
• UpgradeDependencyCommand

Constructors

UpgradeDependencyCommand()

Creates a new instance of UpgradeDependencyCommand.

Properties

aliases → List<String>

Alternate names for this command.

no setter, inherited

argParser → ArgParser

The argument parser for this command.

no setter, inherited

argResults → ArgResults?

The parsed argument results for this command.

no setter, inherited

category → String

The command's category.

no setter, override

description → String

A description of this command, included in usage.

no setter, override

globalResults → ArgResults?

The parsed global argument results.

no setter, inherited

hashCode → int

The hash code for this object.

no setter, inherited

hidden → bool

Whether or not this command should be hidden from help listings.

no setter, inherited

invocation → String

A single-line template for how to invoke this command (e.g. "pub get package").

no setter, inherited

name → String

The name of this command.

no setter, override

parent → Command?

The command's parent command, if this is a subcommand.

no setter, inherited

runner → CommandRunner?

The command runner for this command.

no setter, inherited

runtimeType → Type

A representation of the runtime type of the object.

no setter, inherited

subcommands → Map<String, Command>

An unmodifiable view of all sublevel commands of this command.

no setter, inherited

suggestionAliases → List<String>

Alternate non-functional names for this command.

no setter, inherited

summary → String

A short description of this command, included in parent's CommandRunner.usage.

no setter, inherited

takesArguments → bool

Whether or not this command takes positional arguments in addition to options.

no setter, inherited

usage → String

Generates a string displaying usage information for this command.

no setter, inherited

usageFooter → String?

An optional footer for usage.

no setter, inherited

Methods

addSubcommand(Command command) → void

Adds Command as a subcommand of this.

inherited

noSuchMethod(Invocation invocation) → dynamic

Invoked when a nonexistent method or property is accessed.

inherited

printUsage() → void

Prints the usage information for this command.

inherited

run() → void

Runs this command.

override

toString() → String

A string representation of this object.

inherited

usageException(String message) → Never

Throws a UsageException with message.

inherited

Operators

operator ==(Object other) → bool

The equality operator.

inherited