new¶

    my $dropbox = File::Dropbox->new(
        access_secret => $access_secret,
        access_token  => $access_token,
        app_secret    => $app_secret,
        app_key       => $app_key,
        chunk         => 8 * 1024 * 1024,
        root          => 'dropbox',
        furlopts      => {
            timeout => 20
        }
    );
    my $dropbox = File::Dropbox->new(
        access_token => $access_token,
        oauth2       => 1
    );

Constructor, takes key-value pairs list

access_secret

OAuth 1.0 access secret

access_token

OAuth 1.0 access token or OAuth 2.0 access token

app_secret

OAuth 1.0 app secret

app_key

OAuth 1.0 app key

oauth2

OAuth 2.0 switch, defaults to false.

chunk

Upload chunk size in bytes. Also buffer size for "readline". Optional. Defaults to 4MB.

root

Access type, "sandbox" for app-folder only access and "dropbox" for full access.

furlopts

Parameter hash, passed to Furl constructor directly. Default options

    timeout   => 10,
    inet_aton => \&Net::DNS::Lite::inet_aton,
    ssl_opts  => {
        SSL_verify_mode => SSL_VERIFY_PEER(),
    }
    

contents¶

Arguments: $dropbox [, $path]

Function returns list of hashrefs representing directory content. Hash fields described in Dropbox API docs <https://www.dropbox.com/developers/core/docs#metadata>. $path defaults to "/". If there is unfinished chunked upload on handle, it will be committed.

    foreach my $file (contents($dropbox, '/data')) {
        next if $file->{'is_dir'};
        say $file->{'path'}, ' - ', $file->{'bytes'};
    }

metadata¶

Arguments: $dropbox

Function returns stored metadata for read-only handle, closed write handle or after call to "contents" or "putfile".

    open $dropbox, '<', '/data/2013.dat' or die $!;
    my $meta = metadata($dropbox);
    if ($meta->{'bytes'} > 1024) {
        # Do something
    }

putfile¶

Arguments: $dropbox, $path, $data

Function is useful for uploading small files (up to 150MB possible) in one request (at least two API requests required for chunked upload, used in open-write-close sequence). If there is unfinished chunked upload on handle, it will be committed.

    local $/;
    open my $data, '<', '2012.dat' or die $!;
    putfile($dropbox, '/data/2012.dat', <$data>) or die $!;
    say 'Uploaded ', metadata($dropbox)->{'bytes'}, ' bytes';
    close $data;

copyfile¶

Arguments: $dropbox, $source, $target

Function copies file or directory from one location to another. Metadata for copy can be accessed using "metadata" function.

    copyfile($dropbox, '/data/2012.dat', '/data/2012.dat.bak') or die $!;
    say 'Created backup with revision ', metadata($dropbox)->{'revision'};

movefile¶

Arguments: $dropbox, $source, $target

Function moves file or directory from one location to another. Metadata for moved file can be accessed using "metadata" function.

    movefile($dropbox, '/data/2012.dat', '/data/2012.dat.bak') or die $!;
    say 'Created backup with size ', metadata($dropbox)->{'size'};

deletefile¶

Arguments: $dropbox, $path

Function deletes file or folder at specified path. Metadata for deleted item is accessible via "metadata" function.

    deletefile($dropbox, '/data/2012.dat.bak') or die $!;
    say 'Deleted backup with last modification ', metadata($dropbox)->{'modification'};

createfolder¶

Arguments: $dropbox, $path

Function creates folder at specified path. Metadata for created folder is accessible via "metadata" function.

    createfolder($dropbox, '/data/backups') or die $!;
    say 'Created folder at path ', metadata($dropbox)->{'path'};