NAME

Pithub::GitData::Blobs - Github v3 Git Data Blobs API

VERSION

version 0.01036

DESCRIPTION

Since blobs can be any arbitrary binary data, the input and responses for the blob api takes an encoding parameter that can be either "utf-8" or "base64". If your data cannot be losslessly sent as a UTF-8 string, you can base64 encode it.

METHODS

create

•

Create a Blob

    POST /repos/:user/:repo/git/blobs

Parameters:

user: mandatory string
repo: mandatory string
data: mandatory hashref, having following keys:

content: mandatory string
encoding: mandatory string, "utf-8" or "base64"

Examples:

    my $b = Pithub::GitData::Blobs->new;
    my $result = $b->create(
        user => 'plu',
        repo => 'Pithub',
        data => {
            content  => 'Content of the blob',
            encoding => 'utf-8',
        }
    );

Response: Status: 201 Created

    {
        "sha": "3a0f86fb8db8eea7ccbb9a95f325ddbedfb25e15"
    }

get

•

Get a Blob

    GET /repos/:user/:repo/git/blobs/:sha

Parameters:

user: mandatory string
repo: mandatory string
sha: mandatory string

Examples:

    my $b = Pithub::GitData::Blobs->new;
    my $result = $b->get(
        user => 'plu',
        repo => 'Pithub',
        sha  => 'b7cdea6830e128bc16c2b75efd99842d971666e2',
    );

Response: Status: 200 OK

    {
        "content": "Content of the blob",
        "encoding": "utf-8"
    }

AUTHOR

Johannes Plunien <plu@cpan.org>

COPYRIGHT AND LICENSE

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.