Andrew Sterling Hanenkamp > Net-Google-PicasaWeb-0.11 > picasa-list

Download:
Net-Google-PicasaWeb-0.11.tar.gz

Annotate this POD

CPAN RT

New  3
Open  4
View/Report Bugs
Source   Latest Release: Net-Google-PicasaWeb-0.12

NAME ^

picasa-list - list albums, photos, tags, or comments from Google Picasa Web

VERSION ^

version 0.11

SYNOPSIS ^

  picasa-list [options]

  Options:
    --username <username>    the username to login as
    --password <password>    the password to login with

    --kind <kind>            "album", "photo", "tag", or "comment"
    --featured               list featured photos (implies --kind photo)
    --user-id <user-id>      the user ID to look for albums or photos in 
    --album-id <album-id>    album ID to look in for photos, comments, or tags
    --photo-id <photo-id>    photo ID to look at for comments or tags

    --find <field>=<value>   Limit to items just matching this rule
    --find <field>=<regex>   Limit to items just matching the Perl regex

    --option <key>=<value>   special options: q, location, etc.

    --long                   show more information on each item
    --human                  show byte values in human consumable abbreviations
    --quiet                  suppress messages
    
    --help                   get some help
    --man                    get lots of help

DESCRIPTION ^

This script will list information about albums, photos, tags, or comments found to match the arguments given.

NAME ^

picasa-list - list albums, photos, tags, or comments from Google Picasa Web

OPTIONS ^

--username

This is the Google username to use when logging in. This is generally a GMail address or another email address used to login to Google services.

--password

This is the Google password to use when loggin in.

--kind

This is the kind of information to pull. There are four possible settings:

album

This is the default. This will list all the albums matching the authenticated user or user ID given with the --user-id option.

photo

This will list all the photos matching the authenticated user or user ID given with the --user-id option.

tag

This will list all the tags matching the authenticated user or user ID given with the --user-id option.

comment

This will list all the comments made on the authenticated user's account or the one given by --user-id.

--featured

This fetches the list of current featured photos. This must not be used with --user-id and implies that --kind is set to "photo". (Setting --kind to something other than "photo" is an error.)

--user-id

This is the Google user ID to list from.

--album-id

This is the ID of the album to use when listing photos, tags, or comments.

--photo-id

This is the ID of the photo to use when listing tags or comments.

--find

This option allows you to specify additional rules to match items by. This option can be used more than once to require additional rules. Each rule is given with a field name followed by either "=" to specify and exact match or "=~" to specify a Perl regular expression match, finally with the value to match. For example, to match only those albums containing "2008" in the name, you could run:

  picasa-list --kind album --username example --find title=~2008

Here is a list of fields you can compare against:

  • id
  • url
  • title
  • summary
  • author_name
  • author_uri
  • entry_id
  • user_id
  • content (only available on comments)
--option

This option allows you to specify arbitrary options on the Picasa Web query. To see a list of available options, check "STANDARD LIST OPTIONS" in Net::Google::PicasaWeb.

--long

Show the long view. On albums this will add the album size and number of photos to the list. On photos this will add the width, height, and byte size of each photo.

--human

Show byte values in a human readable form. So it will show byte values in the thousands will be shown in kilobytes, anything in the millions in Megabytes, etc. These use divisions based on powers of 2, not powers of 10 (i.e., always in kibibytes, Mebibytes, gibibytes, etc.)

--quiet

Suppresses the headings and footer usually given and also doesn't print anything if no results are found.

--help

Show some of this help stuff.

--man

Show lots of help.

AUTHOR ^

Andrew Sterling Hanenkamp, <hanenkamp at cpan.org>

COPYRIGHT & LICENSE ^

Copyright 2008 Andrew Sterling Hanenkamp

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

AUTHOR ^

Andrew Sterling Hanenkamp <hanenkamp@cpan.org>

COPYRIGHT AND LICENSE ^

This software is copyright (c) 2011 by Andrew Sterling Hanenkamp.

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

syntax highlighting: