LockCommand class

dialect lock <key>... — mark translations as human-approved so nothing rewrites them, and record what was approved.

A lock is the answer to "this value is deliberate, leave it alone" — most often a translation that is intentionally identical to the source (a brand name, an abbreviation, a term this locale genuinely borrows), which source_equality would otherwise flag on every run, and which dialect translate would otherwise keep offering to re-translate.

The lock is only meaningful with provenance: locked: true alone cannot say what a human approved, so lock_integrity rejects a bare lock. This command therefore always writes the pair — locked: true plus the current source_hash — which is exactly the two-part gesture that previously required hand-editing @key blocks inside a file the CLI otherwise owns. That hand-edit was the last routine manual touch in the workflow.

Re-running on an already-locked key whose English has since moved re-locks it against the current source — the "I re-reviewed it and it still holds" gesture that clears a locked + stale entry. That is the same motion AcceptCommand performs for unlocked translations; the difference is only whether the entry stays pinned afterwards.

--remove is the inverse (unlock), keeping the hash so the entry's freshness is still tracked.

The subject is a set, not a key: hand-authored copy arrives as a page or a screen, so dialect lock a b c and dialect lock --namespace web both work. Locale selection is --locale (see resolveSelection).

Inheritance

Constructors

LockCommand()

Properties

aliases → List<String>
Alternate names for this command.
no setterinherited
argParser → ArgParser
The argument parser for this command.
no setterinherited
argResults → ArgResults?
The parsed argument results for this command.
no setterinherited
category → String
The command's category.
no setterinherited
description → String
A description of this command, included in usage.
no setteroverride
globalResults → ArgResults?
The parsed global argument results.
no setterinherited
hashCode → int
The hash code for this object.
no setterinherited
hidden → bool
Whether or not this command should be hidden from help listings.
no setterinherited
invocation → String
A single-line template for how to invoke this command (e.g. "pub get package").
no setteroverride
name → String
The name of this command.
no setteroverride
parent → Command<int>?
The command's parent command, if this is a subcommand.
no setterinherited
runner → CommandRunner<int>?
The command runner for this command.
no setterinherited
runtimeType → Type
A representation of the runtime type of the object.
no setterinherited
subcommands → Map<String, Command<int>>
An unmodifiable view of all sublevel commands of this command.
no setterinherited
suggestionAliases → List<String>
Alternate non-functional names for this command.
no setterinherited
summary → String
A short description of this command, included in parent's CommandRunner.usage.
no setterinherited
takesArguments → bool
Whether or not this command takes positional arguments in addition to options.
no setterinherited
usage → String
Generates a string displaying usage information for this command.
no setterinherited
usageFooter → String?
An optional footer for usage.
no setterinherited

Methods

addSubcommand(Command<int> 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() → Future<int>
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