boto 0.6b
21 Nov 2006

Copyright (c) 2006 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.  The goal
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, only those
features I need to do what I want to do are supported.  To the extent that
the features I need are the features that you need you may find boto useful.

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.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.

