]> git.proxmox.com Git - pve-client.git/blobdiff - pveclient
update pve-api-definition.dat
[pve-client.git] / pveclient
index d8d4d15da682bc772558e0099d75761dd46b6d12..cbcc113778ed75611be6baf7248df2cbaa257575 100755 (executable)
--- a/pveclient
+++ b/pveclient
 #!/usr/bin/perl
 
+package PVE::CLI::pveclient;
+
 use strict;
 use warnings;
-use lib '/usr/share/pve-client';
-use lib '.';
+use Cwd 'abs_path';
 use Data::Dumper;
 
-use PVE::JSONSchema;
-use PVE::CLIHandler;
+use PVE::APIClient::JSONSchema qw(register_standard_option get_standard_option);
+use PVE::APIClient::RESTHandler;
+use PVE::APIClient::CLIFormatter;
+use PVE::APIClient::CLIHandler;
+use PVE::APIClient::PTY;
 
 use PVE::APIClient::LWP;
 use PVE::APIClient::Helpers;
+use PVE::APIClient::Config;
+use PVE::APIClient::Commands::config;
 use PVE::APIClient::Commands::remote;
+use PVE::APIClient::Commands::list;
 use PVE::APIClient::Commands::lxc;
+use PVE::APIClient::Commands::GuestStatus;
 
 use JSON;
 
-sub print_usage {
+sub call_api_method {
+    my ($method, $param) = @_;
+
+    my $path = PVE::APIClient::Tools::extract_param($param, 'api_path');
+    die "missing API path\n" if !defined($path);
+
+    my $stdopts = PVE::APIClient::RESTHandler::extract_standard_output_properties($param);
+    PVE::APIClient::CLIFormatter::query_terminal_options($stdopts);
+
+    my $remote = PVE::APIClient::Tools::extract_param($param, 'remote');
+    die "missing remote\n" if !defined($remote);
 
-    my $text = "pveclient usage:\n\n";
+    my $config = PVE::APIClient::Config->load();
 
-    $text .= "pveclient remote <help|add|remove> {options}\n\n";
+    my $uri_param = {};
+    my $info = PVE::APIClient::Helpers::find_method_info($path, $method, $uri_param);
 
-    $text .= "pveclient lxc <help|create|destroy|...> {options}\n\n";
+    my $conn = PVE::APIClient::Config->remote_conn($config, $remote);
 
-    $text .= "pveclient <get/set/create/delete> <path> {options}\n\n";
+    my $res = $conn->call($method, "api2/json/$path", $param);
+    die "undefined result" if !defined($res);
+    die "undefined result data" if !exists($res->{data});
 
-    print STDERR $text;
+    my $data = $res->{data};
 
+    PVE::APIClient::CLIFormatter::print_api_result($data, $info->{returns}, undef, $stdopts);
 }
 
-sub call_method {
-    my ($path, $method, $args) = @_;
+use base qw(PVE::APIClient::CLIHandler);
 
-    die "missing API path\n" if !defined($path);
+sub read_password {
+    return PVE::APIClient::PTY::read_password("Remote password: ")
+}
+
+
+my $cmd = $ARGV[0];
 
-    my $info = PVE::APIClient::Helpers::lookup_api_method($path, $method);
-    my $param = PVE::JSONSchema::get_options($info->{parameters}, $args);
-    print Dumper($param);
+if ($cmd && $cmd eq 'packagedepends') {
+    # experimental code to print required perl packages
+    my $packages = {};
+    my $dir = Cwd::getcwd;
+
+    foreach my $k (keys %INC) {
+       my $file = abs_path($INC{$k});
+       next if $file =~ m/^\Q$dir\E/;
+       my $res = `dpkg -S '$file'`;
+       if ($res && $res =~ m/^(\S+): $file$/) {
+           my $debian_package = $1;
+           $debian_package =~ s/:amd64$//;
+           $packages->{$debian_package} = 1;
+       } else {
+           die "unable to find package for '$file'\n";
+       }
+    }
+    print join("\n", sort(keys %$packages)) . "\n";
 
-    die "implement me";
+    exit(0);
 }
 
-# NOTE: This binary is just a placeholer - nothing implemented so far!
-
-#my $hostname = 'localhost';
-#my $username = 'root@pam';
-#
-#my $conn = PVE::APIClient::LWP->new(
-#    username => $username,
-#    #password => 'yourpassword',
-#    #ticket => $ticket,
-#    #csrftoken => $csrftoken,
-#    host => $hostname,
-#    # allow manual fingerprint verification
-#    manual_verification => 1,
-#    );
-
-#my $res = $conn->get("/", {});
-#print to_json($res, { pretty => 1, canonical => 1});
-
-my $cmd = shift || (print_usage() && exit(-1));
-
-if ($cmd eq 'get') {
-    my $method = 'GET';
-    my $path;
-    if (scalar(@ARGV) && $ARGV[0] !~ m/^\-/)  {
-       $path = shift @ARGV;
+my $path_properties = {};
+
+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 = {};
+if (my $info = PVE::APIClient::Helpers::extract_path_info($uri_param)) {
+    foreach my $key (keys %{$info->{parameters}->{properties}}) {
+       next if defined($uri_param->{$key});
+       $path_properties->{$key} = $info->{parameters}->{properties}->{$key};
     }
-    my $res = call_method($path, $method, \@ARGV);
-    die "implement me";
-} elsif ($cmd eq 'set') {
-    die "implement me";
-} elsif ($cmd eq 'create') {
-    die "implement me";
-} elsif ($cmd eq 'delete') {
-    die "implement me";
-} elsif ($cmd eq 'lxc') {
-    PVE::APIClient::Commands::lxc->run_cli_handler();
-} elsif ($cmd eq 'remote') {
-    PVE::APIClient::Commands::remote->run_cli_handler();
-} elsif ($cmd eq 'bashcomplete') {
-
-    my $cmdline = substr($ENV{COMP_LINE}, 0, $ENV{COMP_POINT});
-    $cmdline =~ s/$cur$//;
-
-    my ($bash_command, $cur, $prev) = @ARGV;
-
-    my $args = [split(/\s+/, $cmdline)];
-
-    if (scalar(@$args) == 1) {
-       foreach my $p (qw(get set create delete lxc remote)) {
-           print "$p\n" if $p =~ m/^$cur/;
+}
+
+$path_properties->{remote} = get_standard_option('pveclient-remote-name');
+$path_properties->{api_path} = $api_path_property;
+
+__PACKAGE__->register_method ({
+    name => 'pveclient_get',
+    path => 'pveclient_get',
+    method => 'GET',
+    description => "Call API GET on <api_path>.",
+    parameters => {
+       additionalProperties => 0,
+       properties => PVE::APIClient::RESTHandler::add_standard_output_properties($path_properties),
+    },
+    returns => { type => 'null' },
+    code => sub {
+       my ($param) = @_;
+
+       call_api_method('GET', $param);
+
+       return undef;
+    }});
+
+__PACKAGE__->register_method ({
+    name => 'pveclient_set',
+    path => 'pveclient_set',
+    method => 'PUT',
+    description => "Call API PUT on <api_path>.",
+    parameters => {
+       additionalProperties => 0,
+       properties => PVE::APIClient::RESTHandler::add_standard_output_properties($path_properties),
+    },
+    returns => { type => 'null' },
+    code => sub {
+       my ($param) = @_;
+
+       call_api_method('PUT', $param);
+
+       return undef;
+    }});
+
+__PACKAGE__->register_method ({
+    name => 'pveclient_create',
+    path => 'pveclient_create',
+    method => 'POST',
+    description => "Call API POST on <api_path>.",
+    parameters => {
+       additionalProperties => 0,
+       properties => PVE::APIClient::RESTHandler::add_standard_output_properties($path_properties),
+    },
+    returns => { type => 'null' },
+    code => sub {
+       my ($param) = @_;
+
+       call_api_method('PUSH', $param);
+
+       return undef;
+    }});
+
+__PACKAGE__->register_method ({
+    name => 'pveclient_delete',
+    path => 'pveclient_delete',
+    method => 'DELETE',
+    description => "Call API DELETE on <api_path>.",
+    parameters => {
+       additionalProperties => 0,
+       properties => PVE::APIClient::RESTHandler::add_standard_output_properties($path_properties),
+    },
+    returns => { type => 'null' },
+    code => sub {
+       my ($param) = @_;
+
+       call_api_method('DELETE', $param);
+
+       return undef;
+    }});
+
+__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";
+           }
        }
-    }
 
-} else {
-    print_usage();
+       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,
+    list => $PVE::APIClient::Commands::list::cmddef,
+    lxc => $PVE::APIClient::Commands::lxc::cmddef,
+    remote => $PVE::APIClient::Commands::remote::cmddef,
+
+    resume => [ 'PVE::APIClient::Commands::GuestStatus', 'resume', ['remote', 'vmid']],
+    shutdown => [ 'PVE::APIClient::Commands::GuestStatus', 'shutdown', ['remote', 'vmid']],
+    spice => [ 'PVE::APIClient::Commands::GuestStatus', 'spice', ['remote', 'vmid']],
+    start => [ 'PVE::APIClient::Commands::GuestStatus', 'start', ['remote', 'vmid']],
+    stop => [ 'PVE::APIClient::Commands::GuestStatus', 'stop', ['remote', 'vmid']],
+    suspend => [ 'PVE::APIClient::Commands::GuestStatus', 'suspend', ['remote', 'vmid']],
+
+    api => {
+       usage => [ __PACKAGE__, 'pveclient_usage', ['api_path']],
+       get => [ __PACKAGE__, 'pveclient_get', ['remote', 'api_path']],
+       set => [ __PACKAGE__, 'pveclient_set', ['remote', 'api_path']],
+       create => [ __PACKAGE__, 'pveclient_create', ['remote', 'api_path']],
+       delete => [ __PACKAGE__, 'pveclient_delete', ['remote', 'api_path']],
+    },
+};
+
+
+if ($cmd && $cmd eq 'printsynopsis') {
+
+    print __PACKAGE__->generate_asciidoc_synopsis();
+
+    exit(0);
 }
 
-exit(0);
+__PACKAGE__->run_cli_handler();