Gecko [ naturenectar.co.uk ]

Name	Size	Permission	Date
__pycache__	[ DIR ]	drwxr-xr-x	2025-08-15 19:31
asyncio	[ DIR ]	drwxr-xr-x	2025-08-15 19:31
collections	[ DIR ]	drwxr-xr-x	2025-08-15 19:31
concurrent	[ DIR ]	drwxr-xr-x	2025-08-15 19:31
config-3.12-x86_64-linux-gnu	[ DIR ]	drwxr-xr-x	2025-08-15 19:32
ctypes	[ DIR ]	drwxr-xr-x	2025-08-15 19:31
curses	[ DIR ]	drwxr-xr-x	2025-08-15 19:31
dbm	[ DIR ]	drwxr-xr-x	2025-08-15 19:31
email	[ DIR ]	drwxr-xr-x	2025-08-15 19:31
encodings	[ DIR ]	drwxr-xr-x	2025-08-15 19:31
ensurepip	[ DIR ]	drwxr-xr-x	2025-08-15 19:31
html	[ DIR ]	drwxr-xr-x	2025-08-15 19:31
http	[ DIR ]	drwxr-xr-x	2025-08-15 19:31
importlib	[ DIR ]	drwxr-xr-x	2025-08-15 19:31
json	[ DIR ]	drwxr-xr-x	2025-08-15 19:31
lib-dynload	[ DIR ]	drwxr-xr-x	2025-08-15 19:31
lib2to3	[ DIR ]	drwxr-xr-x	2025-08-15 19:31
logging	[ DIR ]	drwxr-xr-x	2025-08-15 19:31
multiprocessing	[ DIR ]	drwxr-xr-x	2025-08-15 19:31
pydoc_data	[ DIR ]	drwxr-xr-x	2025-08-15 19:31
re	[ DIR ]	drwxr-xr-x	2025-08-15 19:31
site-packages	[ DIR ]	drwxr-xr-x	2025-08-15 19:31
sqlite3	[ DIR ]	drwxr-xr-x	2025-08-15 19:31
tomllib	[ DIR ]	drwxr-xr-x	2025-08-15 19:31
unittest	[ DIR ]	drwxr-xr-x	2025-08-15 19:31
urllib	[ DIR ]	drwxr-xr-x	2025-08-15 19:31
venv	[ DIR ]	drwxr-xr-x	2025-08-15 19:31
wsgiref	[ DIR ]	drwxr-xr-x	2025-08-15 19:31
xml	[ DIR ]	drwxr-xr-x	2025-08-15 19:31
xmlrpc	[ DIR ]	drwxr-xr-x	2025-08-15 19:31
zipfile	[ DIR ]	drwxr-xr-x	2025-08-15 19:31
zoneinfo	[ DIR ]	drwxr-xr-x	2025-08-15 19:31
LICENSE.txt	13.61 KB	-rw-r--r--	2025-06-03 15:41
__future__.py	5.1 KB	-rw-r--r--	2025-06-23 14:37
__hello__.py	227 B	-rw-r--r--	2025-06-23 14:37
_aix_support.py	3.93 KB	-rw-r--r--	2025-06-23 14:37
_collections_abc.py	31.34 KB	-rw-r--r--	2025-06-23 14:36
_compat_pickle.py	8.56 KB	-rw-r--r--	2025-06-23 14:37
_compression.py	5.55 KB	-rw-r--r--	2025-06-23 14:36
_markupbase.py	14.31 KB	-rw-r--r--	2025-06-23 14:36
_osx_support.py	21.51 KB	-rw-r--r--	2025-06-23 14:37
_py_abc.py	6.04 KB	-rw-r--r--	2025-06-23 14:37
_pydatetime.py	89.93 KB	-rw-r--r--	2025-06-23 14:37
_pydecimal.py	221.96 KB	-rw-r--r--	2025-06-23 14:36
_pyio.py	91.4 KB	-rw-r--r--	2025-06-23 14:36
_pylong.py	10.54 KB	-rw-r--r--	2025-06-23 14:36
_sitebuiltins.py	3.05 KB	-rw-r--r--	2025-06-23 14:36
_strptime.py	27.73 KB	-rw-r--r--	2025-06-23 14:37
_sysconfigdata__linux_x86_64-linux-gnu.py	75.67 KB	-rw-r--r--	2025-06-23 14:49
_sysconfigdata_d_linux_x86_64-linux-gnu.py	75.67 KB	-rw-r--r--	2025-06-23 14:39
_threading_local.py	7.05 KB	-rw-r--r--	2025-06-23 14:36
_weakrefset.py	5.75 KB	-rw-r--r--	2025-06-23 14:36
abc.py	6.38 KB	-rw-r--r--	2025-06-23 14:36
aifc.py	33.41 KB	-rw-r--r--	2025-06-23 14:37
antigravity.py	500 B	-rw-r--r--	2025-06-23 14:36
argparse.py	98.78 KB	-rw-r--r--	2025-06-23 14:37
ast.py	62.94 KB	-rw-r--r--	2025-06-23 14:37
base64.py	20.16 KB	-rwxr-xr-x	2025-06-23 14:36
bdb.py	32.79 KB	-rw-r--r--	2025-06-23 14:37
bisect.py	3.34 KB	-rw-r--r--	2025-06-23 14:36
bz2.py	11.57 KB	-rw-r--r--	2025-06-23 14:37
cProfile.py	6.42 KB	-rwxr-xr-x	2025-06-23 14:36
calendar.py	25.26 KB	-rw-r--r--	2025-06-23 14:37
cgi.py	33.63 KB	-rwxr-xr-x	2025-06-23 14:37
cgitb.py	12.13 KB	-rw-r--r--	2025-06-23 14:37
chunk.py	5.37 KB	-rw-r--r--	2025-06-23 14:36
cmd.py	14.52 KB	-rw-r--r--	2025-06-23 14:36
code.py	10.71 KB	-rw-r--r--	2025-06-23 14:36
codecs.py	36.01 KB	-rw-r--r--	2025-06-23 14:36
codeop.py	5.77 KB	-rw-r--r--	2025-06-23 14:36
colorsys.py	3.97 KB	-rw-r--r--	2025-06-23 14:36
compileall.py	20.03 KB	-rw-r--r--	2025-06-23 14:36
configparser.py	52.53 KB	-rw-r--r--	2025-06-23 14:36
contextlib.py	26.99 KB	-rw-r--r--	2025-06-23 14:36
contextvars.py	129 B	-rw-r--r--	2025-06-23 14:37
copy.py	8.21 KB	-rw-r--r--	2025-06-23 14:36
copyreg.py	7.44 KB	-rw-r--r--	2025-06-23 14:37
crypt.py	3.82 KB	-rw-r--r--	2025-06-23 14:36
csv.py	16 KB	-rw-r--r--	2025-06-23 14:36
dataclasses.py	60.63 KB	-rw-r--r--	2025-06-23 14:37
datetime.py	268 B	-rw-r--r--	2025-06-23 14:37
decimal.py	2.74 KB	-rw-r--r--	2025-06-23 14:37
difflib.py	81.41 KB	-rw-r--r--	2025-06-23 14:36
dis.py	29.52 KB	-rw-r--r--	2025-06-23 14:36
doctest.py	104.25 KB	-rw-r--r--	2025-06-23 14:36
enum.py	79.63 KB	-rw-r--r--	2025-06-23 14:36
filecmp.py	10.14 KB	-rw-r--r--	2025-06-23 14:36
fileinput.py	15.35 KB	-rw-r--r--	2025-06-23 14:36
fnmatch.py	5.86 KB	-rw-r--r--	2025-06-23 14:36
fractions.py	37.25 KB	-rw-r--r--	2025-06-23 14:36
ftplib.py	33.92 KB	-rw-r--r--	2025-06-23 14:36
functools.py	37.05 KB	-rw-r--r--	2025-06-23 14:37
genericpath.py	5.44 KB	-rw-r--r--	2025-06-23 14:37
getopt.py	7.31 KB	-rw-r--r--	2025-06-23 14:37
getpass.py	5.85 KB	-rw-r--r--	2025-06-23 14:36
gettext.py	20.82 KB	-rw-r--r--	2025-06-23 14:37
glob.py	8.53 KB	-rw-r--r--	2025-06-23 14:36
graphlib.py	9.42 KB	-rw-r--r--	2025-06-23 14:36
gzip.py	24.81 KB	-rw-r--r--	2025-06-23 14:37
hashlib.py	9.13 KB	-rw-r--r--	2025-06-23 14:37
heapq.py	22.48 KB	-rw-r--r--	2025-06-23 14:36
hmac.py	7.54 KB	-rw-r--r--	2025-06-23 14:36
imaplib.py	52.77 KB	-rw-r--r--	2025-06-23 14:37
imghdr.py	4.29 KB	-rw-r--r--	2025-06-23 14:37
inspect.py	124.15 KB	-rw-r--r--	2025-06-23 14:37
io.py	3.5 KB	-rw-r--r--	2025-06-23 14:36
ipaddress.py	79.51 KB	-rw-r--r--	2025-06-23 14:37
keyword.py	1.05 KB	-rw-r--r--	2025-06-23 14:37
linecache.py	5.66 KB	-rw-r--r--	2025-06-23 14:36
locale.py	76.76 KB	-rw-r--r--	2025-06-23 14:37
lzma.py	12.97 KB	-rw-r--r--	2025-06-23 14:37
mailbox.py	77.06 KB	-rw-r--r--	2025-06-23 14:37
mailcap.py	9.11 KB	-rw-r--r--	2025-06-23 14:36
mimetypes.py	22.5 KB	-rw-r--r--	2025-06-23 14:37
modulefinder.py	23.14 KB	-rw-r--r--	2025-06-23 14:36
netrc.py	6.76 KB	-rw-r--r--	2025-06-23 14:36
nntplib.py	40.12 KB	-rw-r--r--	2025-06-23 14:36
ntpath.py	31.57 KB	-rw-r--r--	2025-06-23 14:36
nturl2path.py	2.32 KB	-rw-r--r--	2025-06-23 14:37
numbers.py	11.2 KB	-rw-r--r--	2025-06-23 14:37
opcode.py	12.87 KB	-rw-r--r--	2025-06-23 14:37
operator.py	10.71 KB	-rw-r--r--	2025-06-23 14:37
optparse.py	58.95 KB	-rw-r--r--	2025-06-23 14:37
os.py	39.86 KB	-rw-r--r--	2025-06-23 14:36
pathlib.py	49.86 KB	-rw-r--r--	2025-06-23 14:37
pdb.py	68.66 KB	-rwxr-xr-x	2025-06-23 14:36
pickle.py	65.34 KB	-rw-r--r--	2025-06-23 14:36
pickletools.py	91.85 KB	-rw-r--r--	2025-06-23 14:36
pipes.py	8.77 KB	-rw-r--r--	2025-06-23 14:37
pkgutil.py	17.85 KB	-rw-r--r--	2025-06-23 14:36
platform.py	42.38 KB	-rwxr-xr-x	2025-06-23 14:36
plistlib.py	27.68 KB	-rw-r--r--	2025-06-23 14:36
poplib.py	14.28 KB	-rw-r--r--	2025-06-23 14:36
posixpath.py	17.07 KB	-rw-r--r--	2025-06-23 14:36
pprint.py	23.59 KB	-rw-r--r--	2025-06-23 14:36
profile.py	22.56 KB	-rwxr-xr-x	2025-06-23 14:36
pstats.py	28.6 KB	-rw-r--r--	2025-06-23 14:36
pty.py	5.99 KB	-rw-r--r--	2025-06-23 14:36
py_compile.py	7.65 KB	-rw-r--r--	2025-06-23 14:37
pyclbr.py	11.13 KB	-rw-r--r--	2025-06-23 14:36
pydoc.py	110.86 KB	-rwxr-xr-x	2025-06-23 14:36
queue.py	11.23 KB	-rw-r--r--	2025-06-23 14:37
quopri.py	7.03 KB	-rwxr-xr-x	2025-06-23 14:37
random.py	33.88 KB	-rw-r--r--	2025-06-23 14:36
reprlib.py	6.98 KB	-rw-r--r--	2025-06-23 14:36
rlcompleter.py	7.64 KB	-rw-r--r--	2025-06-23 14:37
runpy.py	12.58 KB	-rw-r--r--	2025-06-23 14:36
sched.py	6.2 KB	-rw-r--r--	2025-06-23 14:37
secrets.py	1.94 KB	-rw-r--r--	2025-06-23 14:36
selectors.py	19.21 KB	-rw-r--r--	2025-06-23 14:36
shelve.py	8.36 KB	-rw-r--r--	2025-06-23 14:37
shlex.py	13.04 KB	-rw-r--r--	2025-06-23 14:37
shutil.py	55.43 KB	-rw-r--r--	2025-06-23 14:37
signal.py	2.44 KB	-rw-r--r--	2025-06-23 14:37
site.py	22.65 KB	-rw-r--r--	2025-06-23 14:37
smtplib.py	42.52 KB	-rwxr-xr-x	2025-06-23 14:36
sndhdr.py	7.27 KB	-rw-r--r--	2025-06-23 14:37
socket.py	36.93 KB	-rw-r--r--	2025-06-23 14:37
socketserver.py	27.41 KB	-rw-r--r--	2025-06-23 14:37
sre_compile.py	231 B	-rw-r--r--	2025-06-23 14:36
sre_constants.py	232 B	-rw-r--r--	2025-06-23 14:36
sre_parse.py	229 B	-rw-r--r--	2025-06-23 14:36
ssl.py	49.71 KB	-rw-r--r--	2025-06-23 14:37
stat.py	5.36 KB	-rw-r--r--	2025-06-23 14:37
statistics.py	49.05 KB	-rw-r--r--	2025-06-23 14:36
string.py	11.51 KB	-rw-r--r--	2025-06-23 14:37
stringprep.py	12.61 KB	-rw-r--r--	2025-06-23 14:36
struct.py	257 B	-rw-r--r--	2025-06-23 14:36
subprocess.py	86.67 KB	-rw-r--r--	2025-06-23 14:36
sunau.py	18.04 KB	-rw-r--r--	2025-06-23 14:36
symtable.py	12.18 KB	-rw-r--r--	2025-06-23 14:37
sysconfig.py	31.1 KB	-rw-r--r--	2025-06-23 14:37
tabnanny.py	11.27 KB	-rwxr-xr-x	2025-06-23 14:37
tarfile.py	109.82 KB	-rwxr-xr-x	2025-06-23 14:36
telnetlib.py	22.79 KB	-rw-r--r--	2025-06-23 14:36
tempfile.py	31.63 KB	-rw-r--r--	2025-06-23 14:36
textwrap.py	19.26 KB	-rw-r--r--	2025-06-23 14:36
this.py	1003 B	-rw-r--r--	2025-06-23 14:36
threading.py	58.79 KB	-rw-r--r--	2025-06-23 14:37
timeit.py	13.16 KB	-rwxr-xr-x	2025-06-23 14:36
token.py	2.45 KB	-rw-r--r--	2025-06-23 14:36
tokenize.py	21.06 KB	-rw-r--r--	2025-06-23 14:37
trace.py	28.68 KB	-rwxr-xr-x	2025-06-23 14:36
traceback.py	45.31 KB	-rw-r--r--	2025-06-23 14:37
tracemalloc.py	17.62 KB	-rw-r--r--	2025-06-23 14:37
tty.py	1.99 KB	-rw-r--r--	2025-06-23 14:36
types.py	10.74 KB	-rw-r--r--	2025-06-23 14:36
typing.py	116.05 KB	-rw-r--r--	2025-06-23 14:37
uu.py	7.17 KB	-rw-r--r--	2025-06-23 14:50
uuid.py	28.96 KB	-rw-r--r--	2025-06-23 14:36
warnings.py	21.4 KB	-rw-r--r--	2025-06-23 14:36
wave.py	22.24 KB	-rw-r--r--	2025-06-23 14:36
weakref.py	21.01 KB	-rw-r--r--	2025-06-23 14:37
webbrowser.py	23.19 KB	-rwxr-xr-x	2025-06-23 14:37
xdrlib.py	5.8 KB	-rw-r--r--	2025-06-23 14:37
zipapp.py	7.37 KB	-rw-r--r--	2025-06-23 14:36
zipimport.py	27.19 KB	-rw-r--r--	2025-06-23 14:37

Rename

"""Recognize image file formats based on their first few bytes."""

from os import PathLike
import warnings

__all__ = ["what"]

warnings._deprecated(__name__, remove=(3, 13))

#-------------------------#
# Recognize image headers #
#-------------------------#

def what(file, h=None):
    """Return the type of image contained in a file or byte stream."""
    f = None
    try:
        if h is None:
            if isinstance(file, (str, PathLike)):
                f = open(file, 'rb')
                h = f.read(32)
            else:
                location = file.tell()
                h = file.read(32)
                file.seek(location)
        for tf in tests:
            res = tf(h, f)
            if res:
                return res
    finally:
        if f: f.close()
    return None

#---------------------------------#
# Subroutines per image file type #
#---------------------------------#

tests = []

def test_jpeg(h, f):
    """Test for JPEG data with JFIF or Exif markers; and raw JPEG."""
    if h[6:10] in (b'JFIF', b'Exif'):
        return 'jpeg'
    elif h[:4] == b'\xff\xd8\xff\xdb':
        return 'jpeg'

tests.append(test_jpeg)

def test_png(h, f):
    """Verify if the image is a PNG."""
    if h.startswith(b'\211PNG\r\n\032\n'):
        return 'png'

tests.append(test_png)

def test_gif(h, f):
    """Verify if the image is a GIF ('87 or '89 variants)."""
    if h[:6] in (b'GIF87a', b'GIF89a'):
        return 'gif'

tests.append(test_gif)

def test_tiff(h, f):
    """Verify if the image is a TIFF (can be in Motorola or Intel byte order)."""
    if h[:2] in (b'MM', b'II'):
        return 'tiff'

tests.append(test_tiff)

def test_rgb(h, f):
    """test for the SGI image library."""
    if h.startswith(b'\001\332'):
        return 'rgb'

tests.append(test_rgb)

def test_pbm(h, f):
    """Verify if the image is a PBM (portable bitmap)."""
    if len(h) >= 3 and \
        h[0] == ord(b'P') and h[1] in b'14' and h[2] in b' \t\n\r':
        return 'pbm'

tests.append(test_pbm)

def test_pgm(h, f):
    """Verify if the image is a PGM (portable graymap)."""
    if len(h) >= 3 and \
        h[0] == ord(b'P') and h[1] in b'25' and h[2] in b' \t\n\r':
        return 'pgm'

tests.append(test_pgm)

def test_ppm(h, f):
    """Verify if the image is a PPM (portable pixmap)."""
    if len(h) >= 3 and \
        h[0] == ord(b'P') and h[1] in b'36' and h[2] in b' \t\n\r':
        return 'ppm'

tests.append(test_ppm)

def test_rast(h, f):
    """test for the Sun raster file."""
    if h.startswith(b'\x59\xA6\x6A\x95'):
        return 'rast'

tests.append(test_rast)

def test_xbm(h, f):
    """Verify if the image is a X bitmap (X10 or X11)."""
    if h.startswith(b'#define '):
        return 'xbm'

tests.append(test_xbm)

def test_bmp(h, f):
    """Verify if the image is a BMP file."""
    if h.startswith(b'BM'):
        return 'bmp'

tests.append(test_bmp)

def test_webp(h, f):
    """Verify if the image is a WebP."""
    if h.startswith(b'RIFF') and h[8:12] == b'WEBP':
        return 'webp'

tests.append(test_webp)

def test_exr(h, f):
    """verify is the image ia a OpenEXR fileOpenEXR."""
    if h.startswith(b'\x76\x2f\x31\x01'):
        return 'exr'

tests.append(test_exr)

#--------------------#
# Small test program #
#--------------------#

def test():
    import sys
    recursive = 0
    if sys.argv[1:] and sys.argv[1] == '-r':
        del sys.argv[1:2]
        recursive = 1
    try:
        if sys.argv[1:]:
            testall(sys.argv[1:], recursive, 1)
        else:
            testall(['.'], recursive, 1)
    except KeyboardInterrupt:
        sys.stderr.write('\n[Interrupted]\n')
        sys.exit(1)

def testall(list, recursive, toplevel):
    import sys
    import os
    for filename in list:
        if os.path.isdir(filename):
            print(filename + '/:', end=' ')
            if recursive or toplevel:
                print('recursing down:')
                import glob
                names = glob.glob(os.path.join(glob.escape(filename), '*'))
                testall(names, recursive, 0)
            else:
                print('*** directory (use -r) ***')
        else:
            print(filename + ':', end=' ')
            sys.stdout.flush()
            try:
                print(what(filename))
            except OSError:
                print('*** not found ***')

if __name__ == '__main__':
    test()