From 7199abb53019632469dbd3dca8261aa9f8b8ca85 Mon Sep 17 00:00:00 2001 From: Adam Hupp Date: Fri, 15 Jan 2021 15:17:11 -0800 Subject: document libmagic compat layer --- COMPAT.md | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) create mode 100644 COMPAT.md (limited to 'COMPAT.md') 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() + -- cgit v1.2.1