~ubuntu-branches/ubuntu/trusty/python-boto/trusty

« back to all changes in this revision

Viewing changes to README.markdown

  • Committer: Package Import Robot
  • Author(s): Eric Evans
  • Date: 2012-04-15 20:21:21 UTC
  • mfrom: (1.1.9)
  • Revision ID: package-import@ubuntu.com-20120415202121-3fpf6q355s0xqpyu
Tags: 2.3.0-1
* New upstream release (Closes: #664478)
* Update debian/watch for Boto's move to Github.  Thanks Scott
  Moser. (Closes: #650480)

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
# boto
 
2
boto 2.3.0
 
3
18-Mar-2012
 
4
 
 
5
## Introduction
 
6
 
 
7
Boto is a Python package that provides interfaces to Amazon Web Services.
 
8
At the moment, boto supports:
 
9
 
 
10
 * Simple Storage Service (S3)
 
11
 * SimpleQueue Service (SQS)
 
12
 * Elastic Compute Cloud (EC2)
 
13
 * Mechanical Turk
 
14
 * SimpleDB
 
15
 * CloudFront
 
16
 * CloudWatch
 
17
 * AutoScale
 
18
 * Elastic Load Balancer (ELB)
 
19
 * Virtual Private Cloud (VPC)
 
20
 * Elastic Map Reduce (EMR)
 
21
 * Relational Data Service (RDS) 
 
22
 * Simple Notification Server (SNS)
 
23
 * Google Storage
 
24
 * Identity and Access Management (IAM)
 
25
 * Route53 DNS Service (route53)
 
26
 * Simple Email Service (SES)
 
27
 * Flexible Payment Service (FPS)
 
28
 * CloudFormation
 
29
 * Amazon DynamoDB
 
30
 * Amazon SimpleWorkflow
 
31
 
 
32
The goal of boto is to support the full breadth and depth of Amazon
 
33
Web Services.  In addition, boto provides support for other public
 
34
services such as Google Storage in addition to private cloud systems
 
35
like Eucalyptus, OpenStack and Open Nebula.
 
36
 
 
37
Boto is developed mainly using Python 2.6.6 and Python 2.7.1 on Mac OSX
 
38
and Ubuntu Maverick.  It is known to work on other Linux distributions
 
39
and on Windows.  Boto requires no additional libraries or packages
 
40
other than those that are distributed with Python.  Efforts are made
 
41
to keep boto compatible with Python 2.5.x but no guarantees are made.
 
42
 
 
43
## Finding Out More About Boto
 
44
 
 
45
The main source code repository for boto can be found on
 
46
[github.com](http://github.com/boto/boto)
 
47
 
 
48
[Online documentation](http://docs.pythonboto.org/) is also
 
49
available.  The online documentation includes full API documentation
 
50
as well as Getting Started Guides for many of the boto modules.
 
51
 
 
52
Boto releases can be found on the [Python Cheese Shop](http://pypi.python.org/).
 
53
 
 
54
Join our `IRC channel`_ (#boto on FreeNode).
 
55
    IRC channel: http://webchat.freenode.net/?channels=boto
 
56
 
 
57
## Getting Started with Boto
 
58
 
 
59
Your credentials can be passed into the methods that create 
 
60
connections.  Alternatively, boto will check for the existance of the
 
61
following environment variables to ascertain your credentials:
 
62
 
 
63
AWS_ACCESS_KEY_ID - Your AWS Access Key ID
 
64
AWS_SECRET_ACCESS_KEY - Your AWS Secret Access Key
 
65
 
 
66
Credentials and other boto-related settings can also be stored in a
 
67
boto config file.  See
 
68
[this](http://code.google.com/p/boto/wiki/BotoConfig) for details.
 
69
 
 
70
Copyright (c) 2006-2012 Mitch Garnaat <mitch@garnaat.com>
 
71
Copyright (c) 2010-2011, Eucalyptus Systems, Inc.
 
72
Copyright (c) 2012 Amazon.com, Inc. or its affiliates.
 
73
All rights reserved.