diff options
Diffstat (limited to 'COMPAT.md')
-rw-r--r-- | COMPAT.md | 16 |
1 files changed, 16 insertions, 0 deletions
diff --git a/COMPAT.md b/COMPAT.md new file mode 100644 index 0000000..4928170 --- /dev/null +++ b/COMPAT.md @@ -0,0 +1,16 @@ +There are two python modules named 'magic' that do the same thing, but +with incompatible APIs. One of these ships with libmagic, and (this one) is +distributed through pypi. Both have been around for many years and have +substantial user bases. This incompatability is a major source of pain for +users, and bug reports for me. + +To mitigate this pain, python-magic has added a compatability layer to export +the libmagic python API parallel to the existing one. + +The mapping between the libmagic and python-magic functions is: + + detect_from_filename => from_file + detect_from_content => from_buffer + detect_from_fobj => from_descriptor(f.fileno())') + open => Magic() + |