Initial commit

1 files changed, 28 insertions, 0 deletions

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..ea65ed7
--- /dev/null
+++ b/README.md
@@ -0,0 +1,28 @@
+#S3 using python-requests
+
+Authentication module for the wonderful [pyhon requests library](http://python-requests.org)
+
+Tested with python 2.6
+
+
+## Usage
+
+
+```python
+import requests
+from awsauth import S3Auth
+
+    ACCESS_KEY = 'ACCESSKEYXXXXXXXXXXXX'

+    SECRET_KEY = 'AWSSECRETKEYXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX'        
+    
+    # Creating a file
+    r = requests.put('http://mybucket.s3.amazonaws.com/myfile.txt', data='Sam is sweet', auth=S3Auth(ACCESS_KEY, SECRET_KEY))
+    
+    # Downloading a file
+    r = requests.get('http://mybucket.s3.amazonaws.com/myfile.txt', auth=S3Auth(ACCESS_KEY, SECRET_KEY))
+    if r.content == 'Sam is sweet':
+        print 'Hala Madrid!'
+    
+    # Removing a file
+    r = requests.delete('http://mybucket.s3.amazonaws.com/myfile.txt', auth=S3Auth(ACCESS_KEY, SECRET_KEY))
+```
\ No newline at end of file