yahoo-photos(1) - Linux man page

Name

yahoo-photos - Yahoo Photos frontend for mass uploading

Version

This document describes yahoo-photos version 0.0.2

Usage

yahoo-photos -v -u FOO -p BAR -n "Visiting the zoo" -m *.jpg

Description

This is a frontend to Yahoo::Photos for easy mass uploading.

Required Arguments

Specify either "-u/-p" or "-c" or "-b", or set up the default credentials file.
action: Specify either "-a" or "-m" or "-f".
other: With "-m" or "-f", specify either "-h" or "-V".

Options

"--user", "--pass"

Specify user and password. Mutually exclusive with "--credentials" and "--browser-cookie".
"--credentials": Specify path to a credentials file, see " CONFIGURATION " for the format description. Mutually exclusive with "--user"/"--pass" and "--browser-cookie".
"--browser-cookie": Specify path to a Netscape compatible cookie file. Mutually exclusive with "--user"/"--pass" and "--credentials".
If none of the three above are given, then "--credentials" with the default location is assumed. Program aborts if that file does not exist.
"--albums": Prints the album ids and names. Mutually exclusive with "--file-list" and "--mass-upload".
"--file-list": Specify the path to a newline seperated file of filenames to upload. Mutually exclusive with "--albums" and "--mass-upload".
"--mass-upload": Specify the paths of files to upload. Mutually exclusive with "--albums" and "--file-list".
If "--file-list" or "--mass-upload" are given, also one of "--name" or "--id" need to be specified.
"--name": Specify an album name to upload to. If the album does not exist, it is created.
"--id": Specify an album id to upload to. If the album does not exist, the program aborts.
"--id" takes precedence over "--name".
"--verbose": Specify whether uploading status is displayed.
"--help": Usage summary.
"--Version": Program version.
All long options can be abbreviated, see "Case and abbreviations" in Getopt::Long.

Diagnostics

fatal

"give one of -n or -i to specify an album"
"invalid album id": No album with such an id exists. Use "--albums" for an overview.
"give one of -u/-p or -c or -b; or set up a credentials file"
"could not open %s for reading"
"could not close %s"
"give one of -a or -f or -m"
From YAML : dies if it cannot read the YAML file.
From HTTP::Request::Common: dies if it cannot read photo files.
warnings
"album does not exist, creating a new one"

Exit Status

Non-zero if a fatal error occured.

Configuration

Credentials is a YAML file that looks like this:

---
user: SUPERHAPPYFUNUSER
pass: SUPERHAPPYFUNPASS

Dependencies

Core modules: Getopt::Long, List::Util

CPAN modules: Perl::Version, Yahoo::Photos

Incompatibilities

None reported.

Bugs And Limitations

No bugs have been reported.

Please report any bugs or feature requests to "bug-yahoo-photos@rt.cpan.org", or through the web interface at <https://rt.cpan.org/>.

Todo

* change album name, description, title, access

* rename, delete, sort, move, copy photos
Suggest more future plans by filing a bug.

Author

Lars DÉªá´ á´á´á´á´¡ "<daxim@cpan.org>"

Licence And Copyright

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

Disclaimer Of Warranty

BECAUSE THIS SOFTWARE IS LICENSED FREE OF CHARGE , THERE IS NO WARRANTY FOR THE SOFTWARE , TO THE EXTENT PERMITTED BY APPLICABLE LAW . EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE SOFTWARE Â»AS ISÂ« WITHOUT WARRANTY OF ANY KIND , EITHER EXPRESSED OR IMPLIED , INCLUDING , BUT NOT LIMITED TO , THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE . THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE SOFTWARE IS WITH YOU . SHOULD THE SOFTWARE PROVE DEFECTIVE , YOU ASSUME THE COST OF ALL NECESSARY SERVICING , REPAIR , OR CORRECTION .

IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER , OR ANY OTHER PARTY WHO MAY MODIFY AND/OR REDISTRIBUTE THE SOFTWARE AS PERMITTED BY THE ABOVE LICENCE , BE LIABLE TO YOU FOR DAMAGES , INCLUDING ANY GENERAL , SPECIAL , INCIDENTAL , OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE SOFTWARE ( INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE SOFTWARE TO OPERATE WITH ANY OTHER SOFTWARE ), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES .