filetype.py icon indicating copy to clipboard operation
filetype.py copied to clipboard

Stabilise API

Open xlotlu opened this issue 5 years ago • 2 comments

Release 1.0.7 broke the specialised matchers that are still documented here https://h2non.github.io/filetype.py/v1.0.0/match.m.html

One could make the argument that these functions are internal API since they're not officially documented in the examples, so it's ok to break them without even a minor version bump.

However, given the usefulness of these functions (e.g. for scenarios in which one only looks for images -- something often encountered in web development) please expose them officially in the examples, and keep them stable.

xlotlu avatar May 02 '20 17:05 xlotlu

Definitively, the public interface of those functions should be managed as part of the package's public API contract.

h2non avatar May 03 '20 15:05 h2non

Is there something left to do here?

dosas avatar Dec 27 '20 18:12 dosas