Scroll to navigation

Pithub::GitData::Blobs(3pm) User Contributed Perl Documentation Pithub::GitData::Blobs(3pm)
 

NAME

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

VERSION

version 0.01025

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 software is copyright (c) 2011 by Johannes Plunien.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.
2014-05-18 perl v5.18.2