← Back to branch summary

~justin-fathomdb/nova/justinsb-openstack-api-volumes

« back to all changes in this revision

Viewing changes to vendor/boto/README

  • Committer: Jesse Andrews
  • Date: 2010-05-28 06:05:26 UTC
  • Revision ID: git-v1:bf6e6e718cdc7488e2da87b21e258ccc065fe499
initial commit

Show diffs side-by-side

added added

removed removed

Lines of Context:
vendor/boto/README
 
1
boto 1.9a
 
2
22-Dec-2009
 
3
 
 
4
Copyright (c) 2006-2009 Mitch Garnaat <mitch@garnaat.org>
 
5
 
 
6
http://code.google.com/p/boto
 
7
 
 
8
Boto is a Python package that provides interfaces to Amazon Web Services.
 
9
At the moment, boto supports:
 
10
 
 
11
 * S3 (Simple Storage Service) via the REST API
 
12
 * SQS (SimpleQueue Service) via the Query API
 
13
 * EC2 (Elastic Compute Cloud) via the Query API
 
14
 * Mechanical Turk via the Query API
 
15
 * SimpleDB via the Query API.
 
16
 * CloudFront via the REST API
 
17
 * CloudWatch via the Query API
 
18
 * AutoScale via the Query API
 
19
 * Elastic Load Balancer via the Query API
 
20
 
 
21
The intent is to support additional services in the future.
 
22
 
 
23
The goal of boto is to provide a very simple, easy to use, lightweight
 
24
wrapper around the Amazon services.  Not all features supported by the
 
25
Amazon Web Services will be supported in boto.  Basically, those
 
26
features I need to do what I want to do are supported first.  Other
 
27
features and requests are welcome and will be accomodated to the best
 
28
of my ability.  Patches and contributions are welcome!
 
29
 
 
30
Boto was written using Python 2.5.1 on Mac OSX.  It has also been tested
 
31
on Linux Ubuntu using Python 2.5.1.  Boto requires no additional
 
32
libraries or packages other than those that are distributed with Python 2.5.1.
 
33
Efforts are made to keep boto compatible with Python 2.4.x but no
 
34
guarantees are made.  Boto should also run on Python 2.6, albeit with
 
35
a few deprecation warnings.
 
36
 
 
37
There is some documentation for boto, mainly in the form of tutorials.
 
38
Check in the doc directory of the distribution.  You can also check out
 
39
the unit tests in the tests directory of the distribution for examples of use.
 
40
 
 
41
You AWS credentials can be passed into the methods that create S3 and SQS
 
42
connections.  Alternatively, boto will check for the existance of the
 
43
following environment variables to ascertain your credentials:
 
44
 
 
45
AWS_ACCESS_KEY_ID - Your AWS Access Key ID
 
46
AWS_SECRET_ACCESS_KEY - Your AWS Secret Access Key
 
47
 
 
48
Changes
 
49
 
 
50
Rather than list changes in the README file, I have decided to refer people to the
 
51
excellent subversion browsing available on googlecode.
 
52
 
 
53
http://code.google.com/p/boto/source/browse