chore: Remove python-magic dependency

It relies on the libmagic module which is not necessarily installed
everywhere. Most of the functionality that we need for our purposes can
be recreated with lighter-weight methods.
This commit is contained in:
Marty Oehme 2025-09-12 09:47:41 +02:00
parent 30bc8452fa
commit 7459fbeb0b
Signed by: Marty
GPG key ID: 4E535BC19C61886E
5 changed files with 33 additions and 12 deletions

View file

@ -2,13 +2,15 @@
import re
from pathlib import Path
import magic
import papis.logging
from papis_extract.annotation import Annotation
logger = papis.logging.get_logger(__name__)
ACCEPTED_EXTENSIONS = [".txt", ".md", ".qmd", ".rmd"]
TEXTCHARS = bytearray({7, 8, 9, 10, 12, 13, 27} | set(range(0x20, 0x100)) - {0x7F})
class ReadestExtractor:
"""Extracts exported annotations from the FOSS Readest book reading app.
@ -17,7 +19,7 @@ class ReadestExtractor:
"""
def can_process(self, filename: Path) -> bool:
if magic.from_file(filename, mime=True) != "text/plain":
if not self._is_readable_text(filename):
return False
content = self._read_file(filename)
@ -33,6 +35,22 @@ class ReadestExtractor:
logger.debug(f"Found processable annotation file: {filename}")
return True
def _is_readable_text(self, filename: Path) -> bool:
"""Checks whether a file has a valid text extension and is not a binary file.
A file is considered a valid text file if its extension is in
:data:`ACCEPTED_EXTENSIONS` and does not contain any non-text characters.
:returns: A boolean indicating whether the file is a valid text file.
"""
if filename.suffix not in ACCEPTED_EXTENSIONS:
return False
try:
with filename.open("rb") as rb:
return not bool(rb.read(1024).translate(None, TEXTCHARS))
except (FileNotFoundError, PermissionError):
return False
def run(self, filename: Path) -> list[Annotation]:
"""Extract annotations from readest txt file.