DOC: How to handle / customize log records emitted by pypdf

(8 commentaires) (0 réaction) (0 personne assignée)Python (1 258 forks)batch import

Easyhelp wantednf-documentation

Métriques du dépôt

logger_warning is advertised to allow overwriting, but doing so proves to be more complicated than expected.

There basically are two reasons for this:

The implementation is located at pypdf._utils.logger_warning, which usually marks an internal implementation and thus I would not assume this to be future-proof.
The method usually is imported directly, as can be seen in https://github.com/py-pdf/pypdf/blob/11ee6480a3f795d770da89944f32a977e3c110e2/pypdf/filters.py#L46 for example. This requires patching each import separately.

Direction de recherche: Examinez la fonction logger warning dans pypdf/ utils.py (lignes 433-449) et ses importations directes dans la base de code, par exemple pypdf/filters.py (ligne 46). Consultez les 8 commentaires de l'issue #2020 pour les solutions proposées et les retours des mainteneurs. Créez une page de documentation expliquant comment les utilisateurs peuvent personnaliser les enregistrements de journal en remplaçant logger warning, incluant les étapes pour patcher les importations et en abordant la mise en garde liée à l'implémentation interne.
Stack technique: python
Domaine: documentation
Type d'issue: Documentation
Difficulté: 2
Temps estimé: 1-3 heures
Statut d'activité: Active
Clarté: Claire
Prérequis: Python
Accessibilité débutant: 70