aboutsummaryrefslogtreecommitdiff
path: root/python/python-magic/README.md
diff options
context:
space:
mode:
authorLarry Hajali <larryhaja[at]gmail[dot]com>2012-12-21 12:05:45 +0100
committerMatteo Bernardini <ponce@slackbuilds.org>2012-12-21 21:27:24 +0100
commita0c8747e511eb02e1b7e38c24d8110f8a49f1550 (patch)
tree287c4ca59df4cd09057aad5ae9022ddfb0756d00 /python/python-magic/README.md
parent56d7d5c20203bad5ce5109405f8b83ad020f8c60 (diff)
python/python-magic: Updated for version 0.4.3.
Signed-off-by: Matteo Bernardini <ponce@slackbuilds.org>
Diffstat (limited to 'python/python-magic/README.md')
-rw-r--r--python/python-magic/README.md64
1 files changed, 64 insertions, 0 deletions
diff --git a/python/python-magic/README.md b/python/python-magic/README.md
new file mode 100644
index 0000000000000..abfc4748f24d5
--- /dev/null
+++ b/python/python-magic/README.md
@@ -0,0 +1,64 @@
+# python-magic
+
+python-magic is a python interface to the libmagic file type
+identification library. libmagic identifies file types by checking
+their headers according to a predefined list of file types. This
+functionality is exposed to the command line by the Unix command
+`file`.
+
+## Example Usage
+
+ >>> import magic
+ >>> magic.from_file("testdata/test.pdf")
+ 'PDF document, version 1.2'
+ >>> magic.from_buffer(open("testdata/test.pdf").read(1024))
+ 'PDF document, version 1.2'
+ >>> magic.from_file("testdata/test.pdf", mime=True)
+ 'application/pdf'
+
+## Installation
+
+The current stable version of python-magic is available on pypi and
+can be installed by running `pip install python-magic`.
+
+Other sources:
+
+- pypi: http://pypi.python.org/pypi/python-magic/
+- github: https://github.com/ahupp/python-magic
+
+### Dependencies on Windows
+
+On Windows, you need to download and save the following libraries under
+`C:\Windows\System32`:
+
+- `regex2.dll` from [sourceforge.net/projects/gnuwin32/files/regex/](http://sourceforge.net/projects/gnuwin32/files/regex/)
+- `zlib1.dll` from [sourceforge.net/projects/gnuwin32/files/zlib/](http://sourceforge.net/projects/gnuwin32/files/zlib/)
+- `magic1.dll` from [sourceforge.net/projects/gnuwin32/files/file/](http://sourceforge.net/projects/gnuwin32/files/file/)
+
+## Author
+
+Written by Adam Hupp in 2001 for a project that never got off the
+ground. It origionally used SWIG for the C library bindings, but
+switched to ctypes once that was part of the python standard library.
+
+You can contact me via my [website](http://hupp.org/adam) or
+[github](http://github.com/ahupp).
+
+## Contributors
+
+Thanks to these folks on github who submitted features and bugfixes.
+
+- Amit Sethi
+- [bigben87](https://github.com/bigben87)
+- [fallgesetz](https://github.com/fallgesetz)
+- [FlaPer87](https://github.com/FlaPer87)
+- [lukenowak](https://github.com/lukenowak)
+- NicolasDelaby
+- sacha@ssl.co.uk
+- SimpleSeb
+- [tehmaze](https://github.com/tehmaze)
+
+## License
+
+python-magic is distributed under the [PSF License](http://www.python.org/psf/license/).
+