Added more

fengsp · fengsp · commit be4f1f4ac15f · 2014-07-10T23:06:39.000+08:00
diff --git a/docs/basic.rst b/docs/basic.rst
@@ -0,0 +1,28 @@
+Basic
+=====
+
+Snippets on basic things.
+
+
+`ternary conditional operator`_
+-------------------------------
+
+::
+    
+    >>> 'true' if True else 'false'
+    'true'
+    >>> 'true' if False else 'false'
+    'false'
+
+
+`accessing the index in for loops`_
+-----------------------------------
+
+::
+
+    for idx, val in enumerate(ints):
+        print idx, val
+
+
+.. _ternary conditional operator: http://stackoverflow.com/questions/394809/does-python-have-a-ternary-conditional-operator
+.. _accessing the index in for loops: http://stackoverflow.com/questions/522563/accessing-the-index-in-python-for-loops
diff --git a/docs/datetime.rst b/docs/datetime.rst
@@ -0,0 +1,17 @@
+Datetime
+========
+
+Snippets about datetime.
+
+
+`converting string into datetime`_
+----------------------------------
+
+::
+    
+    from datetime import datetime
+
+    date_object = datetime.strptime('Jun 1 2005  1:33PM', '%b %d %Y %I:%M%p')
+
+
+.. _converting string into datetime: http://stackoverflow.com/questions/466345/converting-string-into-datetime
diff --git a/docs/decorator.rst b/docs/decorator.rst
@@ -4,7 +4,7 @@ Decorator
 Snippets about decorators.
 
 
-Decorators 101
+decorators 101
 --------------
 
 Let's begin with syntactic sugar::
@@ -30,7 +30,7 @@ Let's begin with syntactic sugar::
     add = EXPR(ARG)(add)
 
 
-Good Decorator
+good decorator
 --------------
 
 We want to run a function for certain times::
@@ -52,7 +52,7 @@ We want to run a function for certain times::
         print word
 
 
-Method Decorator
+method decorator
 ----------------
 
 We need one decorator that makes function to method decorators::
diff --git a/docs/descriptor.rst b/docs/descriptor.rst
@@ -4,7 +4,7 @@ Descriptor
 Snippets about descriptors.
 
 
-Descriptors 101
+descriptors 101
 ---------------
 
 What is descriptor:
@@ -33,7 +33,7 @@ Demo::
     <bound method Demo.hello of <__main__.Demo object at 0x102b285d0>>
 
 
-Data And Non-data Descriptors
+data and non-data descriptors
 -----------------------------
 
 If an object defines both ``__get__`` and ``__set__``, it is considered a data
@@ -96,7 +96,7 @@ Now we add ``__set__``::
     'demo3'
 
 
-Better Way To Write Property
+better way to write property
 ----------------------------
 
 Let's just see the code::
@@ -114,7 +114,7 @@ Let's just see the code::
         del _get_thing, _set_thing
 
 
-Cached Property
+cached property
 ---------------
 
 Just grab it from django source::
diff --git a/docs/dict.rst b/docs/dict.rst
@@ -0,0 +1,32 @@
+Dictionary
+==========
+
+Snippets on dict manipulation.
+
+
+`merge (union) two Python dictionaries`_
+----------------------------------------
+
+::
+    
+    >>> x = {'a':1, 'b': 2}
+    >>> y = {'b':10, 'c': 11}
+    >>> z = dict(x.items() + y.items())
+    >>> z
+    {'a': 1, 'c': 11, 'b': 10}
+
+
+`create a dictionary with list comprehension`_
+----------------------------------------------
+
+In Python 2.6 (or earlier), use the dict constructor::
+
+    d = dict((key, value) for (key, value) in sequence)
+
+In Python 2.7+ or 3, you can just use the dict comprehension syntax directly::
+
+    d = {key: value for (key, value) in sequence}
+
+
+.. _merge (union) two Python dictionaries: http://stackoverflow.com/questions/38987/how-can-i-merge-union-two-python-dictionaries-in-a-single-expression
+.. _create a dictionary with list comprehension: http://stackoverflow.com/questions/1747817/python-create-a-dictionary-with-list-comprehension
diff --git a/docs/email.rst b/docs/email.rst
@@ -4,7 +4,7 @@ Email
 Snippets about email.
 
 
-`Sending-email-with-python`_
+`sending email with python`_
 ----------------------------
 
 I recommend that you use the standard packages email and smtplib together::
@@ -65,7 +65,7 @@ For multiple destinations::
     s.quit()
 
 
-`Sending mail via sendmail from python`_
+`sending mail via sendmail from python`_
 ----------------------------------------
 
 If I want to send mail not via SMTP, but rather via sendmail::
@@ -81,5 +81,5 @@ If I want to send mail not via SMTP, but rather via sendmail::
     p.communicate(msg.as_string())
 
 
-.. _Sending-email-with-python: http://stackoverflow.com/questions/6270782/sending-email-with-python
-.. _Sending mail via sendmail from python: http://stackoverflow.com/questions/73781/sending-mail-via-sendmail-from-python
+.. _sending email with python: http://stackoverflow.com/questions/6270782/sending-email-with-python
+.. _sending mail via sendmail from python: http://stackoverflow.com/questions/73781/sending-mail-via-sendmail-from-python
diff --git a/docs/file.rst b/docs/file.rst
@@ -4,7 +4,16 @@ File
 Snippets about files manipulation.
 
 
-`Unicode (utf8) reading and writing to files`_
+`check if file exists`_
+-----------------------
+
+If you need to be sure it's a file::
+    
+    import os.path
+    os.path.isfile(filename)
+
+
+`unicode (utf8) reading and writing to files`_
 -----------------------------------------------
 
 It is easier to use the open method from the codecs module::
@@ -14,4 +23,15 @@ It is easier to use the open method from the codecs module::
     >>> f.read()
 
 
-.. _Unicode (utf8) reading and writing to files: http://stackoverflow.com/questions/491921/unicode-utf8-reading-and-writing-to-files-in-python
+`extracting extension from filename`_
+-------------------------------------
+
+::
+    
+    import os
+    filename, ext = os.path.splitext('/path/to/somefile.ext')
+
+
+.. _check if file exists: http://stackoverflow.com/questions/82831/how-do-i-check-if-a-file-exists-using-python
+.. _unicode (utf8) reading and writing to files: http://stackoverflow.com/questions/491921/unicode-utf8-reading-and-writing-to-files-in-python
+.. _extracting extension from filename: http://stackoverflow.com/questions/541390/extracting-extension-from-filename-in-python
diff --git a/docs/index.rst b/docs/index.rst
@@ -7,14 +7,22 @@ Python-Snippets is a basket of Python snippets.
 .. toctree::
    :maxdepth: 2
 
+   basic
+   string
+   list
+   dict
    decorator
    iterator
    descriptor
    with
    method
    metaclass
+   performance
+   io
    file
    email
+   datetime
+   subprocess
 
 
 Contribute
diff --git a/docs/io.rst b/docs/io.rst
@@ -0,0 +1,27 @@
+Input and Ouput
+===============
+
+Snippets about input and output.
+
+
+`read from stdin`_
+------------------
+
+::
+    
+    import sys
+
+    for line in sys.stdin:
+        print line
+
+
+`print to stderr`_
+------------------
+
+::
+    
+    print >> sys.stderr, 'spam'
+
+
+.. _read from stdin: http://stackoverflow.com/questions/1450393/how-do-you-read-from-stdin-in-python
+.. _print to stderr: http://stackoverflow.com/questions/5574702/how-to-print-to-stderr-in-python
diff --git a/docs/iterator.rst b/docs/iterator.rst
@@ -4,7 +4,7 @@ Iterator And Generator
 Snippets about iterators and generators.
 
 
-`iterator - The Python yield keyword explained`_
+`iterator - the Python yield keyword explained`_
 ------------------------------------------------
 
 Iterables::
diff --git a/docs/list.rst b/docs/list.rst
@@ -0,0 +1,77 @@
+List
+====
+
+Snippets on list manipulation.
+
+
+`check if a list is empty`_
+---------------------------
+
+::
+    
+    if not a:
+        print "List is empty"
+
+
+`append vs extend`_
+-------------------
+
+append::
+
+    x = [1, 2, 3]
+    x.append([4, 5])
+    # [1, 2, 3, [4, 5]]
+
+extend::
+    
+    x = [1, 2, 3]
+    x.extend([4, 5])
+    # [1, 2, 3, 4, 5]
+
+
+`split a list into evenly sized chunks`_
+----------------------------------------
+
+Here's a generator that yields the chunks you want::
+    
+    def chunks(l, n):
+        """ Yield successive n-sized chunks from l.
+        """
+        for i in xrange(0, len(l), n):
+            yield l[i:i+n]
+
+
+`finding the index of an item`_
+-------------------------------
+
+::
+    
+    >>> ["foo","bar","baz"].index('bar')
+    1
+
+
+`sort a list of dictionaries by values of the dictionary`_
+----------------------------------------------------------
+
+::
+    
+    newlist = sorted(list_to_be_sorted, key=lambda k: k['name'])
+
+
+`randomly select an item from a list`_
+--------------------------------------
+
+::
+    
+    import random
+
+    foo = ['a', 'b', 'c', 'd', 'e']
+    random.choice(foo)
+
+
+.. _check if a list is empty: http://stackoverflow.com/questions/53513/best-way-to-check-if-a-list-is-empty
+.. _append vs extend: http://stackoverflow.com/questions/252703/python-append-vs-extend
+.. _split a list into evenly sized chunks: http://stackoverflow.com/questions/312443/how-do-you-split-a-list-into-evenly-sized-chunks-in-python
+.. _finding the index of an item: http://stackoverflow.com/questions/176918/finding-the-index-of-an-item-given-a-list-containing-it-in-python
+.. _sort a list of dictionaries by values of the dictionary: http://stackoverflow.com/questions/72899/how-do-i-sort-a-list-of-dictionaries-by-values-of-the-dictionary-in-python
+.. _randomly select an item from a list: http://stackoverflow.com/questions/306400/how-do-i-randomly-select-an-item-from-a-list-using-python
diff --git a/docs/metaclass.rst b/docs/metaclass.rst
@@ -4,15 +4,18 @@ Metaclass
 Snippets about metaclasses.
 
 
-Metaclasses 101
+metaclasses 101
 ---------------
 
 In Python, everything is one object.  Take CPython for example, we have
 PyObject, everything else is inherited from it, and each PyObject has one type
 attribute, PyTypeObject, actually PyTypeObject is one PyObject by itself too,
 so PyTypeObject has one type attribute, PyTypeType, PyTypeType has type
 attribute too, which is PyTypeType itself.  So come back to Python, we have
-object, each object has one type, and the type of ``type`` is ``type``. 
+object, each object has one type, and the type of ``type`` is ``type``.
+
+You can also have a look on this stack overflow question
+`What is a metaclass in Python <http://stackoverflow.com/questions/100003/what-is-a-metaclass-in-python>`_.
 
 Ok, in Python, everything is simple, so you can just treat metaclass as the
 class that creates a class.  This is useful for post-processing classes, and
diff --git a/docs/method.rst b/docs/method.rst
@@ -4,7 +4,7 @@ Method
 Snippets about method.
 
 
-Method 101
+method 101
 ----------
 
 Instancemethods take ``self`` argument, classmethods take ``cls`` argument,
diff --git a/docs/performance.rst b/docs/performance.rst
diff --git a/docs/string.rst b/docs/string.rst
diff --git a/docs/subprocess.rst b/docs/subprocess.rst
diff --git a/docs/with.rst b/docs/with.rst
