TagCommand Class

Summary

This class implements the "hg tag" command (): add one or more tags for the current or given revision.
Assembly
Mercurial.Net.dll
Namespace
Mercurial
Interfaces
Base Types
graph TD Base0["MercurialCommandBase<T>"]-->Type click Base0 "/Cake.Hg/api/Mercurial/MercurialCommandBase_1" Base1["CommandBase<T>"]-->Base0 click Base1 "/Cake.Hg/api/Mercurial/CommandBase_1" Base2["object"]-->Base1 Interface0["IMercurialCommand"]-.->Type click Interface0 "/Cake.Hg/api/Mercurial/IMercurialCommand" Interface1["ICommand"]-.->Type click Interface1 "/Cake.Hg/api/Mercurial/ICommand" Type["TagCommand"] class Type type-node

Syntax

public sealed class TagCommand : MercurialCommandBase<TagCommand>, IMercurialCommand, ICommand

Constructors

Name Summary
TagCommand() Initializes a new instance of the TagCommand class.

Properties

Name Value Summary
Action TagAction
Gets or sets a value indicating whether to add or remove the tag. Default is Add.
AdditionalArguments Collection<T>
Gets the collection which additional arguments can be added into. This collection is exposed for extensions, so that they have a place to add all their extra arguments to the Mercurial command line client.
Inherited from CommandBase<T>
Arguments IEnumerable<T>
Gets all the arguments to the Command, or an empty array if there are none.
Inherited from CommandBase<T>
Command string
Gets the command to execute with the Mercurial command line client.
Inherited from CommandBase<T>
DebugOutput bool
Gets or sets a value indicating whether to enable debug output on the command. This should only be used by the command code itself, never by the user.
Inherited from CommandBase<T>
IsLocal bool
Gets or sets a value indicating whether to add or remove a local tag. If false, a changeset will be committed that edits the .hgtags file accordingly. Default is false.
Message string
Gets or sets the commit message to use when committing the tag.
Name string
Gets or sets the name of the tag to add or remove.
Observer IMercurialCommandObserver
Gets or sets the object that will act as an observer of command execution.
Inherited from CommandBase<T>
OverrideAuthor string
Gets or sets the username to use when committing; or System.String.Empty to use the username configured in the repository or by the current user. Default is System.String.Empty.
OverrideTimestamp Nullable<T>
Gets or sets the timestamp DateTime to use when committing; or null which means use the current date and time. Default is null.
RawExitCode int
Gets the raw exit code from executing the command line client.
Inherited from CommandBase<T>
RawStandardErrorOutput string
Gets the raw standard error output from executing the command line client.
Inherited from CommandBase<T>
RawStandardOutput string
Gets the raw standard output from executing the command line client.
Inherited from CommandBase<T>
ReplaceExisting bool
Gets or sets a value indicating whether to replace an existing tag, in effect moving the tag to a different changeset. Without this flag, adding a tag that already exists will result in a MercurialExecutionException being thrown. Default is false.
Revision RevSpec
Gets or sets which revision to tag, or null for the parent of the working folder. Default is null.
Timeout int
Gets or sets the timeout to use when executing Mercurial commands, in seconds. Default is 60.
Inherited from CommandBase<T>

Methods

Name Value Summary
AddArgument(string) void
Adds the specified argument to the AdditionalArguments collection, unless it is already present.
Inherited from CommandBase<T>
After(int, string, string) void
This method is called after the command has been executed. You can use this to clean up after the command execution (like removing temporary files), and to react to the exit code from the command line client. If the exit code is considered a failure, this method should throw the correct exception.
Inherited from CommandBase<T>
Before() void
This method is called before the command is executed. You can use this to store temporary files (like a commit message or similar) that the Arguments refer to, before the command is executed.
Inherited from CommandBase<T>
Cleanup() void
Override this method to implement code that will execute after command line execution.
Inherited from CommandBase<T>
ParseStandardOutputForResults(int, string) void
This method should parse and store the appropriate execution result output according to the type of data the command line client would return for the command.
Inherited from CommandBase<T>
Prepare() void
Override this method to implement code that will execute before command line execution.
Inherited from CommandBase<T>
RequiresVersion(Version, string) void
This method will check the current client version and throw a System.NotSupportedException if the current client version is older than the required one.
ThrowOnUnsuccessfulExecution(int, string) void
This method should throw the appropriate exception depending on the contents of the exitCode and standardErrorOutput parameters, or simply return if the execution is considered successful.
Inherited from CommandBase<T>
Validate() void
Validates the command configuration. This method should throw the necessary exceptions to signal missing or incorrect configuration (like attempting to add files to the repository without specifying which files to add.)
WithAction(TagAction) TagCommand
Sets the Action property to the specified value and returns this TagCommand instance.
WithAdditionalArgument(string) T
Adds the value to the AdditionalArguments collection property and returns this instance.
Inherited from CommandBase<T>
WithConfigurationOverride(string, string, string) void
Adds a configuration override specification to the AdditionalArguments collection in the form of section.name=value.
WithIsLocal(bool) TagCommand
Sets the IsLocal property to the specified value and returns this TagCommand instance.
WithMessage(string) TagCommand
Sets the Message property to the specified value and returns this TagCommand instance.
WithName(string) TagCommand
Sets the Name property to the specified value and returns this TagCommand instance.
WithObserver(IMercurialCommandObserver) T
Sets the Observer property to the specified value and returns this instance.
Inherited from CommandBase<T>
WithOverrideAuthor(string) TagCommand
Sets the OverrideAuthor property to the specified value and returns this TagCommand instance.
WithOverrideTimestamp(DateTime) TagCommand
Sets the OverrideTimestamp property to the specified value and returns this TagCommand instance.
WithReplaceExisting(bool) TagCommand
Sets the ReplaceExisting property to the specified value and returns this TagCommand instance.
WithRevision(RevSpec) TagCommand
Sets the Revision property to the specified value and returns this TagCommand instance.
WithTimeout(int) T
Sets the Timeout property to the specified value and returns this instance.
Inherited from CommandBase<T>

Extension Methods

Name Value Summary
OperateOnPatchRepository<TagCommand>() T
Makes the command operate on the patch repository instead of the main repository.