Skip to content

Latest commit

 

History

History
21 lines (12 loc) · 1.61 KB

cli.md

File metadata and controls

21 lines (12 loc) · 1.61 KB
Raw
uid
command-line-interface

Command-line interface

The xref:ZeroInstall.Commands namespace provides a command-line interface for Zero Install. This both implements an actual command-line executable and provides a library for building other clients.

Processing arguments

ProgramUtils.Init() should be called by all clients right after startup to initialize process-wide state.

Afterwards ProgramUtils.Run() can be called with the command-line arguments to be parsed along with an xref:ZeroInstall.Commands.ICommandHandler. ICommandHandler extends the xref:NanoByte.Common.Tasks.ITaskHandler interface with various UI interactions that commands can use to display intermediate results, ask for user input, etc..

ProgramUtils.Run() parses the provided command-line arguments and selects the appropriate xref:ZeroInstall.Commands.CliCommand to handle them.

Inheritance hierarchy

Each command (e.g., 0install run) is represented by a class derived from xref:ZeroInstall.Commands.CliCommand (e.g., xref:ZeroInstall.Commands.Basic.Run).

CliCommand derives from xref:ZeroInstall.Commands.ScopedOperation. This provides a more basic starting point, for any operation that requires scoped dependency resolution. It provides this by itself deriving from xref:ZeroInstall.Services.ServiceProvider.