summaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authorTimothy Crosley <timothy.crosley@gmail.com>2013-09-01 16:27:03 -0400
committerTimothy Crosley <timothy.crosley@gmail.com>2013-09-01 16:27:03 -0400
commit9c71e248294f709b14a525e5ed60a2ef24f3ead8 (patch)
tree93954ab6b4393c827df41a125d318da064307527 /README.md
parent7516570e5e9647ecd4bad3baa0189504d2d63662 (diff)
downloadpies-9c71e248294f709b14a525e5ed60a2ef24f3ead8.tar.gz
Updated readme
Diffstat (limited to 'README.md')
-rw-r--r--README.md48
1 files changed, 48 insertions, 0 deletions
diff --git a/README.md b/README.md
index 6f40512..f74c096 100644
--- a/README.md
+++ b/README.md
@@ -1,4 +1,52 @@
+<<<<<<< Updated upstream
pies
====
+=======
+pies!
+====================
+
+The simplest (and tastiest) way to write one program that runs on both Python 2.6+ and Python 3.
+
+
+Let's eat some pies!
+======================
+
+Installing pies
+
+ pip install pies
+
+or if you prefer:
+
+ easy_install pies
+
+
+Integrating pies into your diet
+======================
+
+Using and integrating pies into an existing Python 2.6 code base (to achieve Python 3 dual support) couldn't be simpler:
+
+ from pies import *
+
+You will then simply have to make some simple changes to your Python code:
+
+- u'string' -> u('string')
+- my_iterable.iteritems -> iteritems(my_iterable)
+- my_iterable.itervalues -> itervalues(my_iterable)
+- my_iterable.iterkeys -> iterkeys(my_iterable)
+
+The following will work unchanged in Python 3 after import (using the Python 2 syntax):
+
+- xrange
+- long
+- unicode
+- urllib.quote
+- urllib.quote_plus
+- urllib.unquote
+- urllib.unquote_plus
+- urllib.urlencode
+
+pies will also automatically install and include the most optimal version of OrderedDict for the python environment
+in use, so you should remove any other explicit imports of OrderedDict.
+>>>>>>> Stashed changes
The simplest way to write one program that runs on both Python 2 and Python 3.