boto 0.8a
26-Jan-2007

Copyright (c) 2006,2007 Mitch Garnaat <mitch@garnaat.org>

http://code.google.com/p/boto

Boto is a Python package that provides interfaces to Amazon Web Services.
At the moment, boto supports S3 (Simple Storage Service) and SQS (Simple
Queue Service) via the REST API's provided by those services and EC2
(Elastic Compute Cloud) via the Query API.  The intent is to support
additional services in the future.

The goal of boto is to provide a very simple, easy to use, lightweight
wrapper around the Amazon services.  Not all features supported by the
Amazon Web Services will be supported in boto.  Basically, those
features I need to do what I want to do are supported first.  Other
features and requests are welcome and will be accomodated to the best
of my ability.  Patches and contributions are welcome!

Boto was written using Python 2.4.1 on Mac OSX.  It has also been tested
on Linux Fedora Core 4 using Python 2.4.1.  Boto requires no additional
libraries or packages other than those that are distributed with Python 2.4.1.

There is some documentation for boto, mainly in the form of tutorials.
Check in the doc directory of the distribution.  You can also check out
the unit tests in the tests directory of the distribution for examples of use.

You AWS credentials can be passed into the methods that create S3 and SQS
connections.  Alternatively, boto will check for the existance of the
following environment variables to ascertain your credentials:

AWS_ACCESS_KEY_ID - Your AWS Access Key ID
AWS_SECRET_ACCESS_KEY - Your AWS Secret Access Key

Changes
-------
[boto 0.8a changes]
------------------------------------------------------------------------
r105 | Mitch.Garnaat | 2007-01-26 15:44:30 -0500 (Fri, 26 Jan 2007) | 1 line

Added support for enabling bucket logging in S3.  Also added a sleep delay in unit test for SQS.
------------------------------------------------------------------------
r97 | Mitch.Garnaat | 2007-01-19 15:32:39 -0500 (Fri, 19 Jan 2007) | 1 line

Some fixes to try to enable support for logging.  Also, first cut at a generate_url method for S3 connection.
------------------------------------------------------------------------

[boto 0.7a changes]
------------------------------------------------------------------------
r91 | Mitch.Garnaat | 2007-01-17 19:39:28 -0500 (Wed, 17 Jan 2007) | 1 line

Bumping version number.
------------------------------------------------------------------------
r90 | Mitch.Garnaat | 2007-01-17 19:13:08 -0500 (Wed, 17 Jan 2007) | 1 line

Completed basic EC2 functionality.  Includes reasonable unit tests and tutorial.
------------------------------------------------------------------------
r89 | Mitch.Garnaat | 2007-01-17 11:35:39 -0500 (Wed, 17 Jan 2007) | 1 line

Added explicit mimetype override for uploaded files, Fixes Issue-25.  Also fleshing out EC2 implementation.
------------------------------------------------------------------------
r88 | Mitch.Garnaat | 2007-01-13 15:45:06 -0500 (Sat, 13 Jan 2007) | 1 line

key.get_file now properly checks the HTTP status code rather than silently ignore it.  Fixes Issue-21
------------------------------------------------------------------------
r87 | Mitch.Garnaat | 2007-01-13 15:36:50 -0500 (Sat, 13 Jan 2007) | 1 line

Added get_bucket method.  Fixes Issue-22
------------------------------------------------------------------------
r86 | Mitch.Garnaat | 2007-01-11 06:19:11 -0500 (Thu, 11 Jan 2007) | 1 line

key.py was referencing S3DataError exception but wasn't importing it.  Fixes Issue-19.
------------------------------------------------------------------------
r85 | Mitch.Garnaat | 2007-01-09 18:27:24 -0500 (Tue, 09 Jan 2007) | 1 line

Working on tutorial for EC2 and adding additional capabilities.
------------------------------------------------------------------------
r84 | Mitch.Garnaat | 2007-01-07 20:13:27 -0500 (Sun, 07 Jan 2007) | 1 line

Left a bunch of debug print statements in last version
------------------------------------------------------------------------
r83 | Mitch.Garnaat | 2007-01-07 20:10:55 -0500 (Sun, 07 Jan 2007) | 1 line

Modified copyright on all files.  Also fixed a bug in the EC2 SecurityGroup response parsing.
------------------------------------------------------------------------
r82 | Mitch.Garnaat | 2006-12-30 11:18:52 -0500 (Sat, 30 Dec 2006) | 1 line

Added ability to dump messages in a queue to a file
------------------------------------------------------------------------
r81 | Mitch.Garnaat | 2006-12-28 09:42:03 -0500 (Thu, 28 Dec 2006) | 1 line

A small command line utility to count messages in queues and, optionally, clear them out
------------------------------------------------------------------------
r80 | Mitch.Garnaat | 2006-12-26 23:25:08 -0500 (Tue, 26 Dec 2006) | 1 line

Adding more unit tests for EC2.
------------------------------------------------------------------------
r79 | Mitch.Garnaat | 2006-12-26 23:24:28 -0500 (Tue, 26 Dec 2006) | 1 line

Cleaning up some of the EC2 support classes to support new capabilities and to fix some bugs.
------------------------------------------------------------------------
r78 | Mitch.Garnaat | 2006-12-26 23:23:20 -0500 (Tue, 26 Dec 2006) | 1 line

Cleaning up some of the EC2 methods and adding some new ones.
------------------------------------------------------------------------
r77 | Mitch.Garnaat | 2006-12-26 23:22:03 -0500 (Tue, 26 Dec 2006) | 1 line

Added a MHMessage class which handles RFC821-like mail headers to store name/value pairs.
------------------------------------------------------------------------
r76 | Mitch.Garnaat | 2006-12-26 23:20:46 -0500 (Tue, 26 Dec 2006) | 1 line

SQSExceptions now print out the body of the response since that usually contains the vital info.
------------------------------------------------------------------------
r75 | Mitch.Garnaat | 2006-12-26 23:19:41 -0500 (Tue, 26 Dec 2006) | 1 line

Fixed an anamoly with the md5 attribute.  This was getting wrapped in double-quotes for no good reason so those ahve been removed.
------------------------------------------------------------------------
r74 | Mitch.Garnaat | 2006-12-15 14:20:59 -0500 (Fri, 15 Dec 2006) | 2 lines

fixing import statements for new package structure.

------------------------------------------------------------------------
r73 | Mitch.Garnaat | 2006-12-15 14:15:17 -0500 (Fri, 15 Dec 2006) | 2 lines

new unit tests.

------------------------------------------------------------------------
r72 | Mitch.Garnaat | 2006-12-15 14:11:59 -0500 (Fri, 15 Dec 2006) | 2 lines

Added unit test for EC2.

------------------------------------------------------------------------
r71 | Mitch.Garnaat | 2006-12-15 14:10:06 -0500 (Fri, 15 Dec 2006) | 2 lines

Creating subpackages for each  service.

------------------------------------------------------------------------
r70 | Mitch.Garnaat | 2006-12-15 14:07:38 -0500 (Fri, 15 Dec 2006) | 2 lines

Subpackage for EC2.

------------------------------------------------------------------------
r69 | Mitch.Garnaat | 2006-12-15 14:06:36 -0500 (Fri, 15 Dec 2006) | 2 lines

Adding subpackage for SQS.

------------------------------------------------------------------------
r68 | Mitch.Garnaat | 2006-12-15 14:05:47 -0500 (Fri, 15 Dec 2006) | 3 lines

Subpackage for S3


------------------------------------------------------------------------
r67 | Mitch.Garnaat | 2006-12-15 13:35:34 -0500 (Fri, 15 Dec 2006) | 2 lines

Added some info for other response.

------------------------------------------------------------------------
r66 | Mitch.Garnaat | 2006-12-14 22:18:12 -0500 (Thu, 14 Dec 2006) | 2 lines

Adding additional ec2 functionality.

------------------------------------------------------------------------
r65 | Mitch.Garnaat | 2006-12-14 18:09:59 -0500 (Thu, 14 Dec 2006) | 4 lines

Rewrote the whole XML handling mechanism.  This is much simpler and also more powerful.

First cut at some EC2 capabilities.  Using new Query interface.  Only a few commands are implemented thus far.

------------------------------------------------------------------------
r64 | Mitch.Garnaat | 2006-12-12 09:42:03 -0500 (Tue, 12 Dec 2006) | 2 lines

fixing a bug introduced with last check in.

------------------------------------------------------------------------
r63 | Mitch.Garnaat | 2006-12-11 15:10:42 -0500 (Mon, 11 Dec 2006) | 2 lines

Added base64 encoding/decoding of messages going into and out of SQS.  This is to accomodate a recent change in SQS behavior that rejects messages containing non-ASCII characters.


[boto 0.6c changes]
------------------------------------------------------------------------
r60 | Mitch.Garnaat | 2006-11-22 07:29:43 -0500 (Wed, 22 Nov 2006) | 3 lines

Refactored some of the S3 code to eliminate circular dependencies.

[boto 0.6b changes]
------------------------------------------------------------------------
r56 | Mitch.Garnaat | 2006-11-21 10:13:24 -0500 (Tue, 21 Nov 2006) | 2 lines

Making sure all paths are properly escaped in S3 requests.  Fixes Issue-16.

[boto 0.6a changes]
------------------------------------------------------------------------
r53 | Mitch.Garnaat | 2006-11-19 11:22:16 -0500 (Sun, 19 Nov 2006) | 2 lines

Updated to S3 tutorial with a simple example of metadata usage.

------------------------------------------------------------------------
r52 | Mitch.Garnaat | 2006-11-19 11:15:22 -0500 (Sun, 19 Nov 2006) | 3 lines

Added ability to set/get metadata values on Key objects.  Also updated unit tests to test new capability.  Fixes Issue-15.

------------------------------------------------------------------------
r51 | Mitch.Garnaat | 2006-11-14 17:03:55 -0500 (Tue, 14 Nov 2006) | 3 lines

Added support for MD5 verification on upload.  Incorporated contributed code from Giao Phan.  Fixes Issue-14.


[boto 0.5a changes]
------------------------------------------------------------------------

r48 | Mitch.Garnaat | 2006-11-02 20:25:51 -0500 (Thu, 02 Nov 2006) | 3 lines

Added support for some ACL operations in S3.  The canned ACL's can be
set on buckets and keys using the set_acl method.  In addition, the
get_acl method parses the AccessControlPolicy response sent by S3 and
creates corresponding Python objects to represent the ACL, Grants,
Grantees, etc.  At some point in the future we may support the ability
to set arbitrary ACL's but not yet.  Fixes Issue-12 and incorporates
code contributed by benjaminlyu (thanks!).

------------------------------------------------------------------------

[boto 0.4b changes]

------------------------------------------------------------------------
r44 | Mitch.Garnaat | 2006-10-16 15:08:34 -0400 (Mon, 16 Oct 2006) | 3 lines

Changed strftime to use explicit format string rather than %X.  Fixes Issue-11.



[boto 0.4a changes]

r41 | Mitch.Garnaat | 2006-10-16 06:38:24 -0400 (Mon, 16 Oct 2006) | 2 lines

Adding distro file for 0.4a release.

------------------------------------------------------------------------
r40 | Mitch.Garnaat | 2006-10-16 06:37:05 -0400 (Mon, 16 Oct 2006) | 2 lines

bumping version number.

------------------------------------------------------------------------
r39 | Mitch.Garnaat | 2006-10-15 09:11:41 -0400 (Sun, 15 Oct 2006) | 4 lines

Added a load method to queue object, the inverse of the dump method.

Fixed typo in SQS tutorial.  Fixes Issue-9.

------------------------------------------------------------------------
r38 | Mitch.Garnaat | 2006-09-26 11:12:57 -0400 (Tue, 26 Sep 2006) | 3 lines

Added long description entry.  Fixes Issue-7.


------------------------------------------------------------------------
r37 | Mitch.Garnaat | 2006-09-26 08:52:17 -0400 (Tue, 26 Sep 2006) | 3 lines

Added a lookup method to the bucket object.  Uses a HEAD request to determine if a particular key exists in the bucket or not.  Also updated the unit test script to test this feature.


------------------------------------------------------------------------
r36 | Mitch.Garnaat | 2006-09-24 18:59:12 -0400 (Sun, 24 Sep 2006) | 3 lines

Added the release egg.


------------------------------------------------------------------------
r35 | Mitch.Garnaat | 2006-09-24 18:52:06 -0400 (Sun, 24 Sep 2006) | 3 lines

Changed comment about no documentation available.  Now points users to doc directory.


------------------------------------------------------------------------
r34 | Mitch.Garnaat | 2006-09-24 18:50:16 -0400 (Sun, 24 Sep 2006) | 3 lines

Added changes from 2a to 3a.  Bumped version numbers to 0.3a.


------------------------------------------------------------------------
r33 | Mitch.Garnaat | 2006-09-24 18:47:52 -0400 (Sun, 24 Sep 2006) | 3 lines

A start on the tutorial for S3 usage.  Partially fixes Issue-2.

[boto 0.3a changes]

------------------------------------------------------------------------
r32 | Mitch.Garnaat | 2006-09-22 10:52:07 -0400 (Fri, 22 Sep 2006) | 3 lines

Added section to describe get_all_queues method.  Added some section headings.


------------------------------------------------------------------------
r31 | Mitch.Garnaat | 2006-09-20 22:16:24 -0400 (Wed, 20 Sep 2006) | 3 lines

Added a get_contents_as_string method.  Fixes Issue-6.


------------------------------------------------------------------------
r30 | Mitch.Garnaat | 2006-09-20 22:13:04 -0400 (Wed, 20 Sep 2006) | 2 lines

Modified for new integer output of get_timeout method.

------------------------------------------------------------------------
r29 | Mitch.Garnaat | 2006-09-20 16:14:17 -0400 (Wed, 20 Sep 2006) | 2 lines

Fixed stupid bug in last checkin.

------------------------------------------------------------------------
r28 | Mitch.Garnaat | 2006-09-20 15:34:12 -0400 (Wed, 20 Sep 2006) | 3 lines

Now automatically re-establishes HTTP connection with service if keep-alive times out or pipe is broken.  Fixes Issue-4.


------------------------------------------------------------------------
r27 | Mitch.Garnaat | 2006-09-20 15:31:39 -0400 (Wed, 20 Sep 2006) | 3 lines

Added set_body() method, torched parse_body().  Fixed Issue-5.


------------------------------------------------------------------------
r26 | Mitch.Garnaat | 2006-09-20 15:30:35 -0400 (Wed, 20 Sep 2006) | 3 lines

get_timeout method now returns int rather than string.  Fixes Issue-3.


------------------------------------------------------------------------
r25 | Mitch.Garnaat | 2006-09-20 15:29:44 -0400 (Wed, 20 Sep 2006) | 3 lines

Added tutorial for SQS use.  Partially fixes Issue-2.


------------------------------------------------------------------------
r24 | Mitch.Garnaat | 2006-09-20 15:28:24 -0400 (Wed, 20 Sep 2006) | 3 lines

Documented environment variables used.  Fixes Issue-1.