/ 
Net-UpYun-0.001
River stage zero No dependents
/ Net::UpYun

NAME

Net::UpYun - Simple client library for UpYun Restful API.

SYNOPSIS

# Yes, I love modern perl!
use v5.12;
use Net::UpYun;

my $upyun = Net::UpYun->new(
    bucket_account => 'xxxxx',
    bucket_password => 'xxxx',
    bucket => 'bucket_name',
    # optional
    api_domain => 'http://v0.api.upyun.com',
);

# get bucket/folder/file usage
my $usage = $upyun->usage;
# or folder/file
say $upyun->usage('/demo');

# switch bucket
$upyun->use_bucket('bucket_new');
# use different account/password
$upyun->use_bucket('bucket_new',$new_account,$new_password);

# create dir
my $ok = $upyun->mkdir('/demo2');

# list file under the directory
my $files = $upyun->list('/demo2');

# rm dir
my $ok = $upyun->rmdir('/demo2');

# upload file
my $ok = $upyun->put($file_key,$file_bytes);

# get file content
my $bytes = $upyun->get($file_key);

# delete file
$upyun->delete($file_key);

# change api domaim
$upyun->api_domain('http://v1.api.upyun.com');

DESCRIPTION

This module provides very simple interfaces to UpYun Cloud servie,for more details about UpYun storage/CDN clound service, see http://www.upyun.com/.

This module uses WWW::Curl and libcurl for best performance, I just test on Mac Lion and Linux, maybe works on Windows/Cygwin.

METHODS

new()

bucket
bucket_account
bucket_password
api_domain

usage($path)

# whole bucket used storage
$upyun->usage;
# some dir/folder
say $upyun->usage('/dir1');
# some file size
say $upyun->usage('/dir1/demo1.jpg');

List bucket or path(folder or file) used space.

use_bucket($new_bucket_name,$new_account?,$new_password?)

# switch to new bucket,account/password same as current
$upyun->use_bucket('bucket2');
# switch to new bucket, also set new account/password
$upyun->use_bucket('bucket3','new_user','new_password');

Switch to another bucket, if omit new_account,new_password, use previous defined.

mkdir($path)

my $ok = $upyun->mkdir('/path1/path2');

Build directory or path.

rmdir($path)

my $ok = $upyun->rmdir('/path1');

Delete the directory, it must be empty.

list($path)

my $dir_content_str = $upyun->list('/');

List files under the directory.

TODO: $dir_content_str is plain text, need to parse.

put($path,$bytes)

# it will auto mkdir.
my $ok = $upyun->put('/demo/1.txt','okokok');

Upload content to the file, it will auto create directories.

NOTE: According UpYun note, max directories deep level is limited to 10, be careful.

get($path)

say $upyun->get('/demo/1.txt');

Get the file content.

delete($path)

my $ok = $upyun->delete('/demo/1.txt');

Delete the file.

reponse

my $http_response = $upyun->response;

Returns latest response,it's an instance of HTTP::Response.

res_content

Raw response content body.

is_success

is_error

These methods indicate if the response was informational, successful, or an error. If the response code was 2xx code, is_success is true, else is_error is true.

error_code

The code is a 3 digit number that encode the overall outcome of the last HTTP response.

error_message

The message is a short human readable single line string that explains the last response code.

do_request

Internal, send signed request to server.

sign

Private.

TODOS

Much jobs to do.

  • handy client shell.

  • copy/move file under same bucket or between different bucket.

  • simple check file exists on remote ,no need to fetch its content,save bandwidth.

  • display/compare files checksum(MD5) local and remote.

  • streaming upload to save memory.

  • useful utility, like tar/untar to/from upyun on fly.

  • multi operation and performance requests in parallel.

  • code clean and refactory.

AUTHOR

Night Sailer(Pan Fan) <nightsailer{at}gmail_dot_com>

COPYRIGHT

Copyright (C) Pan Fan(nightsailer)

LICENSE

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