use Data::Dumper;
use PVE::APIClient::JSONSchema qw(register_standard_option get_standard_option);
+use PVE::APIClient::CLIFormatter;
use PVE::APIClient::CLIHandler;
use PVE::APIClient::PTY;
use JSON;
sub call_api_method {
- my ($method, $param) = @_;
+ my ($method, $param, $options) = @_;
my $path = PVE::APIClient::Tools::extract_param($param, 'api_path');
die "missing API path\n" if !defined($path);
my $remote = PVE::APIClient::Tools::extract_param($param, 'remote');
die "missing remote\n" if !defined($remote);
- my $format = PVE::APIClient::Tools::extract_param($param, 'format');
- PVE::APIClient::Helpers::set_output_format($format);
-
my $config = PVE::APIClient::Config->load();
my $uri_param = {};
use base qw(PVE::APIClient::CLIHandler);
sub read_password {
- return PVE::APIClient::PTY::read_password("Remote password: ")
+ return PVE::APIClient::PTY::read_password("Remote password: ")
}
my $path_properties = {};
my $path_returns = { type => 'null' };
+my $api_path_property = {
+ description => "API path.",
+ type => 'string',
+ completion => sub {
+ my ($cmd, $pname, $cur, $args) = @_;
+ return PVE::APIClient::Helpers::complete_api_path($cur);
+ },
+};
+
# dynamically update schema definition for direct API call
# like: pveclient api <get|set|create|delete|help> <remote> <path>
my $uri_param = {};
$path_returns = $info->{returns};
}
-$path_properties->{format} = get_standard_option('pveclient-output-format'),
$path_properties->{remote} = get_standard_option('pveclient-remote-name');
-$path_properties->{api_path} = {
- description => "API path.",
- type => 'string',
- completion => sub {
- my ($cmd, $pname, $cur, $args) = @_;
- return PVE::APIClient::Helpers::complete_api_path($cur);
- },
-};
-
+$path_properties->{api_path} = $api_path_property;
my $format_result = sub {
- my ($data) = @_;
+ my ($data, $schema, $options) = @_;
- PVE::APIClient::Helpers::print_result($data, $path_returns);
+ # NOTE; we need to use $path_returns instead of $schema
+ PVE::APIClient::CLIFormatter::print_api_result($data, $path_returns, undef, $options);
};
__PACKAGE__->register_method ({
name => 'pveclient_get',
path => 'pveclient_get',
method => 'GET',
- description => "call API GET on <path>.",
+ description => "Call API GET on <api_path>.",
parameters => {
additionalProperties => 0,
properties => $path_properties,
},
returns => $path_returns,
code => sub {
- my ($param) = @_;
+ my ($param, $options) = @_;
- return call_api_method('GET', $param);
+ return call_api_method('GET', $param, $options);
}});
__PACKAGE__->register_method ({
name => 'pveclient_set',
path => 'pveclient_set',
method => 'PUT',
- description => "call API PUT on <path>.",
+ description => "Call API PUT on <api_path>.",
parameters => {
additionalProperties => 0,
properties => $path_properties,
},
returns => $path_returns,
code => sub {
- my ($param) = @_;
+ my ($param, $options) = @_;
- return call_api_method('PUT', $param);
+ return call_api_method('PUT', $param, $options);
}});
__PACKAGE__->register_method ({
name => 'pveclient_create',
path => 'pveclient_create',
- method => 'PUSH',
- description => "call API PUSH on <path>.",
+ method => 'POST',
+ description => "Call API POST on <api_path>.",
parameters => {
additionalProperties => 0,
properties => $path_properties,
},
returns => $path_returns,
code => sub {
- my ($param) = @_;
+ my ($param, $options) = @_;
- return call_api_method('PUSH', $param);
+ return call_api_method('PUSH', $param, $options);
}});
__PACKAGE__->register_method ({
name => 'pveclient_delete',
path => 'pveclient_delete',
method => 'DELETE',
- description => "call API DELETE on <path>.",
+ description => "Call API DELETE on <api_path>.",
parameters => {
additionalProperties => 0,
properties => $path_properties,
},
returns => $path_returns,
code => sub {
- my ($param) = @_;
+ my ($param, $options) = @_;
- return call_api_method('DELETE', $param);
+ return call_api_method('DELETE', $param, $options);
}});
+__PACKAGE__->register_method ({
+ name => 'pveclient_usage',
+ path => 'pveclient_usage',
+ method => 'GET',
+ description => "print API usage information for <api_path>.",
+ parameters => {
+ additionalProperties => 0,
+ properties => {
+ api_path => $api_path_property,
+ verbose => {
+ description => "Verbose output format.",
+ type => 'boolean',
+ optional => 1,
+ },
+ returns => {
+ description => "Including schema for returned data.",
+ type => 'boolean',
+ optional => 1,
+ },
+ command => {
+ description => "API command.",
+ type => 'string',
+ enum => [ keys %$PVE::APIClient::Helpers::method_map ],
+ optional => 1,
+ },
+ },
+ },
+ returns => { type => 'null' },
+ code => sub {
+ my ($param) = @_;
+
+ my $path = $param->{api_path};
+
+ my $found = 0;
+ foreach my $cmd (qw(get set create delete)) {
+ next if $param->{command} && $cmd ne $param->{command};
+ my $method = $PVE::APIClient::Helpers::method_map->{$cmd};
+ my $uri_param = {};
+ my $info = PVE::APIClient::Helpers::find_method_info($path, $method, $uri_param, 1);
+ next if !$info;
+ $found = 1;
+
+ my $prefix = "pveclient api $cmd <remote> $path";
+ if ($param->{verbose}) {
+ print PVE::APIClient::RESTHandler::getopt_usage(
+ $info, $prefix, undef, $uri_param, 'full');
+
+ } else {
+ print "USAGE: " . PVE::APIClient::RESTHandler::getopt_usage(
+ $info, $prefix, undef, $uri_param, 'short');
+ }
+ if ($param-> {returns}) {
+ my $schema = to_json($info->{returns}, {utf8 => 1, canonical => 1, pretty => 1 });
+ print "RETURNS: $schema\n";
+ }
+ }
+
+ if (!$found) {
+ if ($param->{command}) {
+ die "no '$param->{command}' handler for '$path'\n";
+ } else {
+ die "no such resource '$path'\n"
+ }
+ }
+
+ return undef;
+ }});
our $cmddef = {
config => $PVE::APIClient::Commands::config::cmddef,
suspend => [ 'PVE::APIClient::Commands::GuestStatus', 'suspend', ['remote', 'vmid']],
api => {
+ usage => [ __PACKAGE__, 'pveclient_usage', ['api_path']],
get => [ __PACKAGE__, 'pveclient_get', ['remote', 'api_path'], {}, $format_result ],
set => [ __PACKAGE__, 'pveclient_set', ['remote', 'api_path'], {}, $format_result ],
create => [ __PACKAGE__, 'pveclient_create', ['remote', 'api_path'], {}, $format_result ],
};
+if ($cmd && $cmd eq 'printsynopsis') {
+
+ print __PACKAGE__->generate_asciidoc_synopsis();
+
+ exit(0);
+}
+
__PACKAGE__->run_cli_handler();