Added python-magic for smarter MIME type detection and a new document field: file_mime_encoding

modules/python_magic/README

@@ -0,0 +1,57 @@
+= python-magic =
+
+Adam Hupp <adam at hupp.org>
+
+Distributed under the PSF License: http://www.python.org/psf/license/
+
+python-magic is a simple wrapper for libmagic.  libmagic identifies
+file types according to their headers.  It is the core of the Unix
+"file" command.
+
+= Installation =
+
+To build and install run:
+
+# python setup.py install
+
+= Installation on Win32 =
+
+You need magic1.dll from http://gnuwin32.sourceforge.net/, grab the
+binaries and dependencies ZIP-file, extract magic1.dll, regex2.dll
+and zlib1.dll and put it in C:\Windows\System32. You also need a 
+magic file from Linux, compatible with file version 5.0.
+
+To build and install run:
+
+# python setup.py install
+
+= Example Usage =
+
+>>> import magic
+>>> m = magic.Magic()
+>>> m.from_file("testdata/test.pdf")
+'PDF document, version 1.2'
+>>> m.from_buffer(open("testdata/test.pdf").read(1024))
+'PDF document, version 1.2'
+
+# For MIME types
+>>> mime = magic.Magic(mime=True)
+>>> mime.from_file("testdata/test.pdf")
+'application/pdf'
+>>>
+
+# For MIME encoding
+>>> mime_encoding = magic.Magic(mime_encoding=True)
+>>> mime_encoding.from_file("testdata/text-iso8859-1.txt")
+'iso-8859-1'
+>>>
+
+= Contributors =
+
+Thanks to these folks on github who submitted features and bugfixes.
+
+NicolasDelaby
+lukenowak
+FlaPer87
+SimpleSeb
+tehmaze