NAME

Podman::Client - Podman service client.

SYNOPSIS

    # Send service requests
    my $client = Podman::Client->new;
    my $res = $client->delete('images/docker.io/library/hello-world');
    my $res = $client->get('version');
    my $res = $client->post('containers/prune');

DESCRIPTION

Inheritance

    Podman::Client
        wrap Mojo::UserAgent

Podman::Client is a HTTP client (user agent) with the needed support to connect to and query the Podman service.

ATTRIBUTES

connection_url

    $client->connection_url('https://127.0.0.1:1234');

URL to connect to Podman service, defaults to user UNIX domain socket in rootless mode e.g. http+unix://run/user/1000/podman/podman.sock otherwise http+unix:///run/podman/podman.sock. Customize via the value of PODMAN_CONNECTION_URL environment variable.

METHODS

Podman::Client provides the valid HTTP requests to query the Podman service. All methods take a relative endpoint path, optional header parameters and path parameters. if the response has a HTTP code unequal 2xx a Podman::Exception is raised.

delete

    my $res = $client->delete('images/docker.io/library/hello-world');

Perform DELETE request and return resulting content.

get

    my $res = $client->get('version');

Perform GET request and return resulting content.

post

    my $res = $client->post(
        'build',
        data       => $archive_file, # Mojo::File object
        parameters => {
            'file' => 'Dockerfile',
            't'    => 'localhost/goodbye',
        },
        headers => {
            'Content-Type' => 'application/x-tar'
        },
    );

Perform POST request and return resulting content, takes additional optional request data.

AUTHORS

Tobias Schäfer, <tschaefer@blackox.org>

COPYRIGHT AND LICENSE

Copyright (C) 2022-2022, Tobias Schäfer.

This program is free software, you can redistribute it and/or modify it under the terms of the Artistic License version 2.0.