geopic-tag-reader 1.1.1__py3-none-any.whl → 1.1.3__py3-none-any.whl

geopic_tag_reader/__init__.py

@@ -2,4 +2,4 @@
 GeoPicTagReader
 """
 
-__version__ = "1.1.1"
+__version__ = "1.1.3"

geopic_tag_reader/camera.py

@@ -39,11 +39,22 @@ def is_360(make: Optional[str] = None, model: Optional[str] = None, width: Optio
     True
     >>> is_360("GoPro", "Max 360", "1024", "768")
     False
+    >>> is_360("RICOH", "THETA S", "5376", "2688")
+    True
     """
 
+    # Check make and model are defined
     if not make or not model:
         return False
 
-    return any(model.startswith(potentialModel) for potentialModel in EQUIRECTANGULAR_MODELS.get(make, [])) and (
-        (width is None or height is None) or int(width) == 2 * int(height)
-    )
+    # Check width and height are equirectangular
+    if not ((width is None or height is None) or int(width) == 2 * int(height)):
+        return False
+
+    # Find make
+    matchMake = next((m for m in EQUIRECTANGULAR_MODELS.keys() if make.lower() == m.lower()), None)
+    if matchMake is None:
+        return False
+
+    # Find model
+    return any(model.lower().startswith(m.lower()) for m in EQUIRECTANGULAR_MODELS[matchMake])

geopic_tag_reader/i18n.py

@@ -0,0 +1,11 @@
+import gettext
+import os
+from typing import Callable
+
+localedir = os.path.join(os.path.abspath(os.path.dirname(__file__)), "translations")
+
+
+def init(lang_code: str = "en") -> Callable[[str], str]:
+    lang = gettext.translation("geopic_tag_reader", localedir, languages=[lang_code], fallback=True)
+    lang.install()
+    return lang.gettext

geopic_tag_reader/main.py

@@ -4,6 +4,7 @@ from geopic_tag_reader import reader
 from geopic_tag_reader.model import PictureType
 from typing import Optional
 import pyexiv2  # type: ignore
+from geopic_tag_reader.i18n import init as i18n_init
 
 app = typer.Typer(help="GeoPicTagReader")
 
@@ -12,28 +13,30 @@ app = typer.Typer(help="GeoPicTagReader")
 def read(
     image: Path = typer.Option(..., help="Path to your JPEG image file"),
     ignore_exiv2_errors: bool = typer.Option(False, "--ignore-exiv2-errors", help="Do not stop execution even if Exiv2 throws errors"),
+    lang: str = typer.Option("en", help="Lang code (2 letters) to use for printing messages"),
 ):
     """Reads EXIF metadata from a picture file, and prints results"""
 
     with open(image, "rb") as img:
         pyexiv2.set_log_level(4 if ignore_exiv2_errors else 2)
 
-        metadata = reader.readPictureMetadata(img.read())
+        metadata = reader.readPictureMetadata(img.read(), lang)
 
-        print("Latitude:", metadata.lat)
-        print("Longitude:", metadata.lon)
-        print("Timestamp:", metadata.ts.isoformat())
-        print("Heading:", metadata.heading)
-        print("Type:", metadata.type)
-        print("Make:", metadata.make)
-        print("Model:", metadata.model)
-        print("Focal length:", metadata.focal_length)
-        print("Crop parameters:", metadata.crop)
-        print("Pitch:", metadata.pitch)
-        print("Roll:", metadata.roll)
+        _ = i18n_init(lang)
+        print(_("Latitude:"), metadata.lat)
+        print(_("Longitude:"), metadata.lon)
+        print(_("Timestamp:"), metadata.ts.isoformat())
+        print(_("Heading:"), metadata.heading)
+        print(_("Type:"), metadata.type)
+        print(_("Make:"), metadata.make)
+        print(_("Model:"), metadata.model)
+        print(_("Focal length:"), metadata.focal_length)
+        print(_("Crop parameters:"), metadata.crop)
+        print(_("Pitch:"), metadata.pitch)
+        print(_("Roll:"), metadata.roll)
 
         if len(metadata.tagreader_warnings) > 0:
-            print("Warnings raised by reader:")
+            print(_("Warnings raised by reader:"))
             for w in metadata.tagreader_warnings:
                 print(" - " + w)
 
@@ -60,6 +63,7 @@ def write(
         default=None,
         help="type of picture, `equirectangular` for 360° pictures, `flat` otherwise",
     ),
+    lang: str = typer.Option("en", help="Lang code (2 letters) to use for printing messages"),
 ):
     """Override certain exiftags of a picture and write a new picture in another file"""
     from geopic_tag_reader import writer
@@ -71,6 +75,7 @@ def write(
         updated_pic = writer.writePictureMetadata(
             raw_input.read(),
             writer.PictureMetadata(capture_time=capture_dt, longitude=longitude, latitude=latitude, picture_type=picture_type),
+            lang,
         )
 
         out = output or input

geopic_tag_reader/reader.py

@@ -2,13 +2,14 @@ import xmltodict
 import pyexiv2  # type: ignore
 import datetime
 from dataclasses import dataclass, field
-from typing import Dict, List, Optional, Any, Set, Tuple
+from typing import Dict, List, Optional, Any, Set, Tuple, Callable
 import re
 import json
 from fractions import Fraction
 from geopic_tag_reader import camera
 import timezonefinder  # type: ignore
 import pytz
+from geopic_tag_reader.i18n import init as i18n_init
 
 # This is a fix for invalid MakerNotes leading to picture not read at all
 # https://github.com/LeoHsiao1/pyexiv2/issues/58
@@ -85,6 +86,10 @@ class InvalidExifException(Exception):
         super().__init__(msg)
 
 
+class InvalidFractionException(Exception):
+    """Exception for invalid list of fractions"""
+
+
 @dataclass
 class PartialGeoPicTags:
     """Tags associated to a geolocated picture when not all tags have been found
@@ -121,16 +126,18 @@ class PartialExifException(Exception):
         self.tags = partial_tags
 
 
-def readPictureMetadata(picture: bytes) -> GeoPicTags:
+def readPictureMetadata(picture: bytes, lang_code: str = "en") -> GeoPicTags:
     """Extracts metadata from picture file
 
     Args:
         picture (bytes): Picture file
+        lang_code (str): Language code for translating error labels
 
     Returns:
         GeoPicTags: Extracted metadata from picture
     """
 
+    _ = i18n_init(lang_code)
     warnings = []
     img = pyexiv2.ImageData(picture)
     data = {}
@@ -158,12 +165,12 @@ def readPictureMetadata(picture: bytes) -> GeoPicTags:
             data[k] = re.sub(r"charset=[^\s]+", "", v).strip()
 
     # Parse latitude/longitude
-    lat, lon, llw = decodeLatLon(data, "Exif.GPSInfo")
+    lat, lon, llw = decodeLatLon(data, "Exif.GPSInfo", _)
     if len(llw) > 0:
         warnings.extend(llw)
 
     if lat is None:
-        lat, lon, llw = decodeLatLon(data, "Xmp.exif")
+        lat, lon, llw = decodeLatLon(data, "Xmp.exif", _)
         if len(llw) > 0:
             warnings.extend(llw)
 
@@ -173,18 +180,18 @@ def readPictureMetadata(picture: bytes) -> GeoPicTags:
 
     # Check coordinates validity
     if lat is not None and (lat < -90 or lat > 90):
-        raise InvalidExifException("Read latitude is out of WGS84 bounds (should be in [-90, 90])")
+        raise InvalidExifException(_("Read latitude is out of WGS84 bounds (should be in [-90, 90])"))
     if lon is not None and (lon < -180 or lon > 180):
-        raise InvalidExifException("Read longitude is out of WGS84 bounds (should be in [-180, 180])")
+        raise InvalidExifException(_("Read longitude is out of WGS84 bounds (should be in [-180, 180])"))
 
     # Parse date/time
-    d, llw = decodeGPSDateTime(data, "Exif.GPSInfo", lat, lon)
+    d, llw = decodeGPSDateTime(data, "Exif.GPSInfo", _, lat, lon)
 
     if len(llw) > 0:
         warnings.extend(llw)
 
     if d is None:
-        d, llw = decodeGPSDateTime(data, "Xmp.exif", lat, lon)
+        d, llw = decodeGPSDateTime(data, "Xmp.exif", _, lat, lon)
         if len(llw) > 0:
             warnings.extend(llw)
 
@@ -195,7 +202,7 @@ def readPictureMetadata(picture: bytes) -> GeoPicTags:
         "Xmp.GPano.SourceImageCreateTime",
     ]:
         if d is None:
-            d, llw = decodeDateTimeOriginal(data, exifField, lat, lon)
+            d, llw = decodeDateTimeOriginal(data, exifField, _, lat, lon)
             if len(llw) > 0:
                 warnings.extend(llw)
 
@@ -217,7 +224,7 @@ def readPictureMetadata(picture: bytes) -> GeoPicTags:
             )
 
         except Exception as e:
-            warnings.append("Skipping Mapillary date/time as it was not recognized:\n\t" + str(e))
+            warnings.append(_("Skipping Mapillary date/time as it was not recognized: {v}").format(v=data["MAPGpsTime"]))
 
     # Heading/Yaw
     heading = None
@@ -230,7 +237,7 @@ def readPictureMetadata(picture: bytes) -> GeoPicTags:
             heading = gpanoHeading
         else:
             if gpsDir != gpanoHeading:
-                warnings.append("Contradicting heading values found, GPSImgDirection value is used")
+                warnings.append(_("Contradicting heading values found, GPSImgDirection value is used"))
             heading = gpsDir
 
     elif isExifTagUsable(data, "Xmp.GPano.PoseHeadingDegrees", float):
@@ -341,18 +348,25 @@ def readPictureMetadata(picture: bytes) -> GeoPicTags:
     errors = []
     missing_fields = set()
     if not lat or not lon:
-        errors.append("No GPS coordinates or broken coordinates in picture EXIF tags")
+        errors.append(_("No GPS coordinates or broken coordinates in picture EXIF tags"))
         if not lat:
             missing_fields.add("lat")
         if not lon:
             missing_fields.add("lon")
     if d is None:
-        errors.append("No valid date in picture EXIF tags")
+        errors.append(_("No valid date in picture EXIF tags"))
         missing_fields.add("datetime")
 
     if errors:
+        if len(errors) > 1:
+            listOfErrors = _("The picture is missing mandatory metadata:")
+            errorSep = "\n\t- "
+            listOfErrors += errorSep + errorSep.join(errors)
+        else:
+            listOfErrors = errors[0]
+
         raise PartialExifException(
-            " and ".join(errors),
+            listOfErrors,
             missing_fields,
             PartialGeoPicTags(
                 lat,
@@ -415,14 +429,14 @@ def decodeManyFractions(value: str) -> List[Fraction]:
     try:
         vals = [Fraction(v.strip()) for v in value.split(" ")]
         if len([True for v in vals if v.denominator == 0]) > 0:
-            raise ValueError()
+            raise InvalidFractionException()
         return vals
 
     except:
-        raise ValueError("Not a valid list of fractions")
+        raise InvalidFractionException()
 
 
-def decodeLatLon(data: dict, group: str) -> Tuple[Optional[float], Optional[float], List[str]]:
+def decodeLatLon(data: dict, group: str, _: Callable[[str], str]) -> Tuple[Optional[float], Optional[float], List[str]]:
     """Reads GPS info from given group to get latitude/longitude as float coordinates"""
 
     lat, lon = None, None
@@ -432,7 +446,7 @@ def decodeLatLon(data: dict, group: str) -> Tuple[Optional[float], Optional[floa
         latRaw = decodeManyFractions(data[f"{group}.GPSLatitude"])
         if len(latRaw) == 3:
             if not isExifTagUsable(data, f"{group}.GPSLatitudeRef"):
-                warnings.append("GPSLatitudeRef not found, assuming GPSLatitudeRef is North")
+                warnings.append(_("GPSLatitudeRef not found, assuming GPSLatitudeRef is North"))
                 latRef = 1
             else:
                 latRef = -1 if data[f"{group}.GPSLatitudeRef"].startswith("S") else 1
@@ -440,10 +454,10 @@ def decodeLatLon(data: dict, group: str) -> Tuple[Optional[float], Optional[floa
 
             lonRaw = decodeManyFractions(data[f"{group}.GPSLongitude"])
             if len(lonRaw) != 3:
-                raise InvalidExifException("Broken GPS coordinates in picture EXIF tags")
+                raise InvalidExifException(_("Broken GPS coordinates in picture EXIF tags"))
 
             if not isExifTagUsable(data, f"{group}.GPSLongitudeRef"):
-                warnings.append("GPSLongitudeRef not found, assuming GPSLongitudeRef is East")
+                warnings.append(_("GPSLongitudeRef not found, assuming GPSLongitudeRef is East"))
                 lonRef = 1
             else:
                 lonRef = -1 if data[f"{group}.GPSLongitudeRef"].startswith("W") else 1
@@ -461,13 +475,13 @@ def decodeLatLon(data: dict, group: str) -> Tuple[Optional[float], Optional[floa
         if rawLat and rawLon:
             latRef = 1
             if not isExifTagUsable(data, f"{group}.GPSLatitudeRef"):
-                warnings.append("GPSLatitudeRef not found, assuming GPSLatitudeRef is North")
+                warnings.append(_("GPSLatitudeRef not found, assuming GPSLatitudeRef is North"))
             else:
                 latRef = -1 if data[f"{group}.GPSLatitudeRef"].startswith("S") else 1
 
             lonRef = 1
             if not isExifTagUsable(data, f"{group}.GPSLongitudeRef"):
-                warnings.append("GPSLongitudeRef not found, assuming GPSLongitudeRef is East")
+                warnings.append(_("GPSLongitudeRef not found, assuming GPSLongitudeRef is East"))
             else:
                 lonRef = -1 if data[f"{group}.GPSLongitudeRef"].startswith("W") else 1
 
@@ -478,7 +492,7 @@ def decodeLatLon(data: dict, group: str) -> Tuple[Optional[float], Optional[floa
 
 
 def decodeDateTimeOriginal(
-    data: dict, datetimeField: str, lat: Optional[float] = None, lon: Optional[float] = None
+    data: dict, datetimeField: str, _: Callable[[str], str], lat: Optional[float] = None, lon: Optional[float] = None
 ) -> Tuple[Optional[datetime.datetime], List[str]]:
     d = None
     warnings = []
@@ -490,7 +504,9 @@ def decodeDateTimeOriginal(
             hourRaw = int(timeRaw[0])
             minutesRaw = int(timeRaw[1])
             secondsRaw, microsecondsRaw, msw = decodeSecondsAndMicroSeconds(
-                timeRaw[2], data["Exif.Photo.SubSecTimeOriginal"] if isExifTagUsable(data, "Exif.Photo.SubSecTimeOriginal", float) else "0"
+                timeRaw[2],
+                data["Exif.Photo.SubSecTimeOriginal"] if isExifTagUsable(data, "Exif.Photo.SubSecTimeOriginal", float) else "0",
+                _,
             )
             warnings += msw
 
@@ -518,15 +534,19 @@ def decodeDateTimeOriginal(
                 # Otherwise, default to UTC + warning
                 else:
                     d = d.replace(tzinfo=datetime.timezone.utc)
-                    warnings.append("Precise timezone information not found, fallback to UTC")
+                    warnings.append(_("Precise timezone information not found, fallback to UTC"))
 
             # Otherwise, default to UTC + warning
             else:
                 d = d.replace(tzinfo=datetime.timezone.utc)
-                warnings.append("Precise timezone information not found (and no GPS coordinates to help), fallback to UTC")
+                warnings.append(_("Precise timezone information not found (and no GPS coordinates to help), fallback to UTC"))
 
         except ValueError as e:
-            warnings.append("Skipping original date/time (from " + datetimeField + ") as it was not recognized:\n\t" + str(e))
+            warnings.append(
+                _("Skipping original date/time (from {datefield}) as it was not recognized: {v}").format(
+                    datefield=datetimeField, v=data[datetimeField]
+                )
+            )
 
     return (d, warnings)
 
@@ -538,7 +558,7 @@ def decodeTimeOffset(data: dict, offsetTimeField: str) -> Optional[datetime.tzin
 
 
 def decodeGPSDateTime(
-    data: dict, group: str, lat: Optional[float] = None, lon: Optional[float] = None
+    data: dict, group: str, _: Callable[[str], str], lat: Optional[float] = None, lon: Optional[float] = None
 ) -> Tuple[Optional[datetime.datetime], List[str]]:
     d = None
     warnings = []
@@ -555,16 +575,20 @@ def decodeGPSDateTime(
             elif isExifTagUsable(data, f"{group}.GPSDateTime", List[Fraction]):
                 timeRaw = decodeManyFractions(data[f"{group}.GPSDateTime"])
             else:
-                raise ValueError(f"GPSTimeStamp and GPSDateTime don't contain supported time format (in {group} group)")
+                timeRaw = None
+                warnings.append(
+                    _("GPSTimeStamp and GPSDateTime don't contain supported time format (in {group} group)").format(group=group)
+                )
 
-            seconds, microseconds, msw = decodeSecondsAndMicroSeconds(
-                str(float(timeRaw[2])),
-                data["Exif.Photo.SubSecTimeOriginal"] if isExifTagUsable(data, "Exif.Photo.SubSecTimeOriginal", float) else "0",
-            )
+            if timeRaw:
+                seconds, microseconds, msw = decodeSecondsAndMicroSeconds(
+                    str(float(timeRaw[2])),
+                    data["Exif.Photo.SubSecTimeOriginal"] if isExifTagUsable(data, "Exif.Photo.SubSecTimeOriginal", float) else "0",
+                    _,
+                )
 
-            warnings += msw
+                warnings += msw
 
-            if timeRaw:
                 d = datetime.datetime.combine(
                     datetime.date.fromisoformat(dateRaw),
                     datetime.time(
@@ -583,12 +607,16 @@ def decodeGPSDateTime(
                         d = d.astimezone(pytz.timezone(tz_name))
 
         except ValueError as e:
-            warnings.append(f"Skipping GPS date/time ({group} group) as it was not recognized:\n\t{str(e)}")
+            warnings.append(
+                _("Skipping GPS date/time ({group} group) as it was not recognized: {v}").format(
+                    group=group, v=data[f"{group}.GPSDateStamp"]
+                )
+            )
 
     return (d, warnings)
 
 
-def decodeSecondsAndMicroSeconds(secondsRaw: str, microsecondsRaw: str) -> Tuple[int, int, List[str]]:
+def decodeSecondsAndMicroSeconds(secondsRaw: str, microsecondsRaw: str, _: Callable[[str], str]) -> Tuple[int, int, List[str]]:
     warnings = []
 
     # Read microseconds from SubSecTime field
@@ -605,7 +633,9 @@ def decodeSecondsAndMicroSeconds(secondsRaw: str, microsecondsRaw: str) -> Tuple
         # Check if microseconds from decimal seconds is not mismatching microseconds from SubSecTime field
         if microseconds != microsecondsFromSeconds and microseconds > 0 and microsecondsFromSeconds > 0:
             warnings.append(
-                f"Microseconds read from decimal seconds value ({microsecondsFromSeconds}) is not matching value from EXIF field ({microseconds}). Max value will be kept."
+                _(
+                    "Microseconds read from decimal seconds value ({microsecondsFromSeconds}) is not matching value from EXIF field ({microseconds}). Max value will be kept."
+                ).format(microsecondsFromSeconds=microsecondsFromSeconds, microseconds=microseconds)
             )
         microseconds = max(microseconds, microsecondsFromSeconds)
     else:

geopic_tag_reader/translations/fr/LC_MESSAGES/geopic_tag_reader.po

@@ -0,0 +1,114 @@
+# French translations for PACKAGE package.
+# Copyright (C) 2024 THE PACKAGE'S COPYRIGHT HOLDER
+# This file is distributed under the same license as the PACKAGE package.
+# Adrien <panieravide@riseup.net>, 2024.
+#
+msgid ""
+msgstr ""
+"Project-Id-Version: PACKAGE VERSION\n"
+"Report-Msgid-Bugs-To: \n"
+"POT-Creation-Date: 2024-06-18 09:12+0200\n"
+"PO-Revision-Date: 2024-06-18 09:09+0000\n"
+"Last-Translator: PanierAvide <adrien@pavie.info>\n"
+"Language-Team: French <http://weblate.panoramax.xyz/projects/panoramax/"
+"tag-reader/fr/>\n"
+"Language: fr\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Plural-Forms: nplurals=2; plural=n > 1;\n"
+"X-Generator: Weblate 5.4.3\n"
+
+#: geopic_tag_reader/reader.py:177
+msgid "Read latitude is out of WGS84 bounds (should be in [-90, 90])"
+msgstr ""
+"La latitude est hors des limites du WGS84 (devrait être entre [-90, 90])"
+
+#: geopic_tag_reader/reader.py:179
+msgid "Read longitude is out of WGS84 bounds (should be in [-180, 180])"
+msgstr ""
+"La longitude est hors des limites du WGS84 (devrait être entre [-180, 180])"
+
+#: geopic_tag_reader/reader.py:221
+msgid "Skipping Mapillary date/time as it was not recognized:"
+msgstr "La date/heure de Mapillary est ignorée car non-reconnue :"
+
+#: geopic_tag_reader/reader.py:234
+msgid "Contradicting heading values found, GPSImgDirection value is used"
+msgstr ""
+"Valeurs d'orientation contradictoires, la valeur de GPSImgDirection est "
+"utilisée"
+
+#: geopic_tag_reader/reader.py:345
+msgid "No GPS coordinates or broken coordinates in picture EXIF tags"
+msgstr "Coordonnees GPS absentes ou invalides dans les attributs EXIF de l'image"
+
+#: geopic_tag_reader/reader.py:351
+msgid "No valid date in picture EXIF tags"
+msgstr "Aucune date valide dans les attributs EXIF de l'image"
+
+#: geopic_tag_reader/reader.py:356
+msgid " and "
+msgstr " et "
+
+#: geopic_tag_reader/reader.py:423
+msgid "Not a valid list of fractions"
+msgstr "Liste de fractions invalide"
+
+#: geopic_tag_reader/reader.py:436 geopic_tag_reader/reader.py:465
+msgid "GPSLatitudeRef not found, assuming GPSLatitudeRef is North"
+msgstr "GPSLatitudeRef non-trouvé, utilisation du Nord par défaut"
+
+#: geopic_tag_reader/reader.py:444
+msgid "Broken GPS coordinates in picture EXIF tags"
+msgstr "Coordonnées GPS invalides dans les attributs EXIF de l'image"
+
+#: geopic_tag_reader/reader.py:447 geopic_tag_reader/reader.py:471
+msgid "GPSLongitudeRef not found, assuming GPSLongitudeRef is East"
+msgstr "GPSLongitudeRef non-trouvé, utilisation de l'Est par défaut"
+
+#: geopic_tag_reader/reader.py:522
+msgid "Precise timezone information not found, fallback to UTC"
+msgstr ""
+"Aucune information précise de fuseau horaire trouvée, UTC utilisé par défaut"
+
+#: geopic_tag_reader/reader.py:527
+msgid ""
+"Precise timezone information not found (and no GPS coordinates to help), "
+"fallback to UTC"
+msgstr ""
+"Aucune information précise de fuseau horaire trouvée (ni de coordonnées GPS "
+"pour aider), UTC utilisé par défaut"
+
+#: geopic_tag_reader/reader.py:530
+#, python-brace-format
+msgid ""
+"Skipping original date/time (from {datefield}) as it was not recognized:"
+msgstr ""
+"Date/heure originale (issue de {datefield}) ignorée car elle n'a pas été "
+"reconnue :"
+
+#: geopic_tag_reader/reader.py:559
+#, python-brace-format
+msgid ""
+"GPSTimeStamp and GPSDateTime don't contain supported time format (in {group} "
+"group)"
+msgstr ""
+"GPSTimeStamp et GPSDateTime ne contiennent pas un format d'heure valide ("
+"dans le groupe {group})"
+
+#: geopic_tag_reader/reader.py:587
+#, python-brace-format
+msgid "Skipping GPS date/time ({group} group) as it was not recognized:"
+msgstr ""
+"Date/heure du GPS (groupe {group}) ignorée car elle n'a pas été reconnue :"
+
+#: geopic_tag_reader/reader.py:609
+#, python-brace-format
+msgid ""
+"Microseconds read from decimal seconds value ({microsecondsFromSeconds}) is "
+"not matching value from EXIF field ({microseconds}). Max value will be kept."
+msgstr ""
+"La valeur de micro-secondes lue à partir des secondes en valeurs décimales "
+"({microsecondsFromSeconds}) ne correspond pas au champ EXIF dédié "
+"({microseconds}). La valeur la plus élevée est conservée."

geopic_tag_reader/translations/geopic_tag_reader.pot

@@ -0,0 +1,147 @@
+# SOME DESCRIPTIVE TITLE.
+# Copyright (C) YEAR THE PACKAGE'S COPYRIGHT HOLDER
+# This file is distributed under the same license as the PACKAGE package.
+# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
+#
+#, fuzzy
+msgid ""
+msgstr ""
+"Project-Id-Version: PACKAGE VERSION\n"
+"Report-Msgid-Bugs-To: \n"
+"POT-Creation-Date: 2024-07-10 08:17+0200\n"
+"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
+"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
+"Language-Team: LANGUAGE <LL@li.org>\n"
+"Language: \n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=CHARSET\n"
+"Content-Transfer-Encoding: 8bit\n"
+
+#: geopic_tag_reader/main.py:26
+msgid "Latitude:"
+msgstr ""
+
+#: geopic_tag_reader/main.py:27
+msgid "Longitude:"
+msgstr ""
+
+#: geopic_tag_reader/main.py:28
+msgid "Timestamp:"
+msgstr ""
+
+#: geopic_tag_reader/main.py:29
+msgid "Heading:"
+msgstr ""
+
+#: geopic_tag_reader/main.py:30
+msgid "Type:"
+msgstr ""
+
+#: geopic_tag_reader/main.py:31
+msgid "Make:"
+msgstr ""
+
+#: geopic_tag_reader/main.py:32
+msgid "Model:"
+msgstr ""
+
+#: geopic_tag_reader/main.py:33
+msgid "Focal length:"
+msgstr ""
+
+#: geopic_tag_reader/main.py:34
+msgid "Crop parameters:"
+msgstr ""
+
+#: geopic_tag_reader/main.py:35
+msgid "Pitch:"
+msgstr ""
+
+#: geopic_tag_reader/main.py:36
+msgid "Roll:"
+msgstr ""
+
+#: geopic_tag_reader/main.py:39
+msgid "Warnings raised by reader:"
+msgstr ""
+
+#: geopic_tag_reader/reader.py:183
+msgid "Read latitude is out of WGS84 bounds (should be in [-90, 90])"
+msgstr ""
+
+#: geopic_tag_reader/reader.py:185
+msgid "Read longitude is out of WGS84 bounds (should be in [-180, 180])"
+msgstr ""
+
+#: geopic_tag_reader/reader.py:227
+#, python-brace-format
+msgid "Skipping Mapillary date/time as it was not recognized: {v}"
+msgstr ""
+
+#: geopic_tag_reader/reader.py:240
+msgid "Contradicting heading values found, GPSImgDirection value is used"
+msgstr ""
+
+#: geopic_tag_reader/reader.py:351
+msgid "No GPS coordinates or broken coordinates in picture EXIF tags"
+msgstr ""
+
+#: geopic_tag_reader/reader.py:357
+msgid "No valid date in picture EXIF tags"
+msgstr ""
+
+#: geopic_tag_reader/reader.py:362
+msgid "The picture is missing mandatory metadata:"
+msgstr ""
+
+#: geopic_tag_reader/reader.py:449 geopic_tag_reader/reader.py:478
+msgid "GPSLatitudeRef not found, assuming GPSLatitudeRef is North"
+msgstr ""
+
+#: geopic_tag_reader/reader.py:457
+msgid "Broken GPS coordinates in picture EXIF tags"
+msgstr ""
+
+#: geopic_tag_reader/reader.py:460 geopic_tag_reader/reader.py:484
+msgid "GPSLongitudeRef not found, assuming GPSLongitudeRef is East"
+msgstr ""
+
+#: geopic_tag_reader/reader.py:537
+msgid "Precise timezone information not found, fallback to UTC"
+msgstr ""
+
+#: geopic_tag_reader/reader.py:542
+msgid ""
+"Precise timezone information not found (and no GPS coordinates to help), "
+"fallback to UTC"
+msgstr ""
+
+#: geopic_tag_reader/reader.py:546
+#, python-brace-format
+msgid ""
+"Skipping original date/time (from {datefield}) as it was not recognized: {v}"
+msgstr ""
+
+#: geopic_tag_reader/reader.py:580
+#, python-brace-format
+msgid ""
+"GPSTimeStamp and GPSDateTime don't contain supported time format (in {group} "
+"group)"
+msgstr ""
+
+#: geopic_tag_reader/reader.py:611
+#, python-brace-format
+msgid "Skipping GPS date/time ({group} group) as it was not recognized: {v}"
+msgstr ""
+
+#: geopic_tag_reader/reader.py:637
+#, python-brace-format
+msgid ""
+"Microseconds read from decimal seconds value ({microsecondsFromSeconds}) is "
+"not matching value from EXIF field ({microseconds}). Max value will be kept."
+msgstr ""
+
+#: geopic_tag_reader/writer.py:132
+#, python-brace-format
+msgid "Unsupported key in additional tags ({k})"
+msgstr ""

geopic_tag_reader/writer.py

@@ -5,6 +5,7 @@ from geopic_tag_reader.model import PictureType
 from enum import Enum
 import timezonefinder  # type: ignore
 import pytz
+from geopic_tag_reader.i18n import init as i18n_init
 
 try:
     import pyexiv2  # type: ignore
@@ -72,10 +73,13 @@ def _fraction(value: float):
     return f"{int(value * FLOAT_PRECISION)}/{FLOAT_PRECISION}"
 
 
-def writePictureMetadata(picture: bytes, metadata: PictureMetadata) -> bytes:
+def writePictureMetadata(picture: bytes, metadata: PictureMetadata, lang_code: str = "en") -> bytes:
     """
     Override exif metadata on raw picture and return updated bytes
     """
+
+    _ = i18n_init(lang_code)
+
     if not metadata.has_change():
         return picture
 
@@ -125,7 +129,7 @@ def writePictureMetadata(picture: bytes, metadata: PictureMetadata) -> bytes:
             elif k.startswith("Exif."):
                 updated_exif.update({k: v})
             else:
-                raise UnsupportedExifTagException(f"Unsupported key in additional tags ({k})")
+                raise UnsupportedExifTagException(_("Unsupported key in additional tags ({k})").format(k=k))
 
     if updated_exif:
         img.modify_exif(updated_exif)

{geopic_tag_reader-1.1.1.dist-info → geopic_tag_reader-1.1.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: geopic-tag-reader
-Version: 1.1.1
+Version: 1.1.3
 Summary: GeoPicTagReader
 Author-email: Adrien PAVIE <panieravide@riseup.net>
 Requires-Python: >=3.8
@@ -17,39 +17,26 @@ Requires-Dist: black ~= 24.3 ; extra == "dev"
 Requires-Dist: mypy ~= 1.9 ; extra == "dev"
 Requires-Dist: pytest ~= 7.2.0 ; extra == "dev"
 Requires-Dist: pytest-datafiles ~= 3.0 ; extra == "dev"
-Requires-Dist: lazydocs ~= 0.4.8 ; extra == "dev"
 Requires-Dist: types-xmltodict ~= 0.13 ; extra == "dev"
 Requires-Dist: pre-commit ~= 3.3.3 ; extra == "dev"
+Requires-Dist: mkdocs-material ~= 9.5.21 ; extra == "docs"
+Requires-Dist: mkdocstrings[python] ~= 0.25.1 ; extra == "docs"
 Requires-Dist: python-dateutil ~= 2.8.2 ; extra == "write-exif"
-Project-URL: Home, https://gitlab.com/geovisio/geo-picture-tag-reader
+Requires-Dist: types-python-dateutil ~= 2.9.0.20240316 ; extra == "write-exif"
+Project-URL: Home, https://gitlab.com/panoramax/server/geo-picture-tag-reader
 Provides-Extra: build
 Provides-Extra: dev
+Provides-Extra: docs
 Provides-Extra: write-exif
 
-# ![GeoVisio](https://gitlab.com/geovisio/api/-/raw/develop/images/logo_full.png)
+# ![Panoramax](https://upload.wikimedia.org/wikipedia/commons/thumb/a/a9/Panoramax.svg/40px-Panoramax.svg.png) Panoramax
 
-__GeoVisio__ is a complete solution for storing and __serving your own 📍📷 geolocated pictures__ (like [StreetView](https://www.google.com/streetview/) / [Mapillary](https://mapillary.com/)).
-
-➡️ __Give it a try__ at [panoramax.ign.fr](https://panoramax.ign.fr/) or [geovisio.fr](https://geovisio.fr/viewer) !
-
-## 📦 Components
-
-GeoVisio is __modular__ and made of several components, each of them standardized and ♻️ replaceable.
-
-![GeoVisio architecture](https://gitlab.com/geovisio/api/-/raw/develop/images/big_picture.png)
-
-All of them are 📖 __open-source__ and available online:
-
-|                               🌐 Server                                 |                      💻 Client                       |
-|:-----------------------------------------------------------------------:|:----------------------------------------------------:|
-|                 [API](https://gitlab.com/geovisio/api)                  |    [Website](https://gitlab.com/geovisio/website)    |
-|            [Blur API](https://gitlab.com/geovisio/blurring)             | [Web viewer](https://gitlab.com/geovisio/web-viewer) |
-| [GeoPic Tag Reader](https://gitlab.com/geovisio/geo-picture-tag-reader) |   [Command line](https://gitlab.com/geovisio/cli)    |
+__Panoramax__ is a digital resource for sharing and exploiting 📍📷 field photos. Anyone can take photographs of places visible from the public streets and contribute them to the Panoramax database. This data is then freely accessible and reusable by all. More information available at [gitlab.com/panoramax](https://gitlab.com/panoramax) and [panoramax.fr](https://panoramax.fr/).
 
 
 # 📷 GeoPic Tag Reader
 
-This repository only contains the Python library to __read and write standardized metadata__ from geolocated pictures EXIF metadata.
+This repository only contains the Python library to __read and write standardized metadata__ from geolocated pictures EXIF metadata. It can be used completely apart from all GeoVisio/Panoramax components for your own projects and needs.
 
 ## Features
 
@@ -71,7 +58,7 @@ geopic-tag-reader --help
 
 To know more about install and other options, see [install documentation](./docs/Install.md).
 
-If at some point you're lost or need help, you can contact us through [issues](https://gitlab.com/geovisio/geo-picture-tag-reader/-/issues) or by [email](mailto:panieravide@riseup.net).
+If at some point you're lost or need help, you can contact us through [issues](https://gitlab.com/panoramax/server/geo-picture-tag-reader/-/issues) or by [email](mailto:panieravide@riseup.net).
 
 
 ## Usage
@@ -137,26 +124,12 @@ editedImg.close()
 
 ## Contributing
 
-Pull requests are welcome. For major changes, please open an [issue](https://gitlab.com/geovisio/geo-picture-tag-reader/-/issues) first to discuss what you would like to change.
+Pull requests are welcome. For major changes, please open an [issue](https://gitlab.com/panoramax/server/geo-picture-tag-reader/-/issues) first to discuss what you would like to change.
 
 More information about developing is available in [documentation](./docs/Develop.md).
 
 
-## 🤗 Special thanks
-
-![Sponsors](https://gitlab.com/geovisio/api/-/raw/develop/images/sponsors.png)
-
-GeoVisio was made possible thanks to a group of ✨ __amazing__ people ✨ :
-
-- __[GéoVélo](https://geovelo.fr/)__ team, for 💶 funding initial development and for 🔍 testing/improving software
-- __[Carto Cité](https://cartocite.fr/)__ team (in particular Antoine Riche), for 💶 funding improvements on viewer (map browser, flat pictures support)
-- __[La Fabrique des Géocommuns (IGN)](https://www.ign.fr/institut/la-fabrique-des-geocommuns-incubateur-de-communs-lign)__ for offering long-term support and funding the [Panoramax](https://panoramax.fr/) initiative and core team (Camille Salou, Mathilde Ferrey, Christian Quest, Antoine Desbordes, Jean Andreani, Adrien Pavie)
-- Many _many_ __wonderful people__ who worked on various parts of GeoVisio or core dependencies we use : 🧙 Stéphane Péneau, 🎚 Albin Calais & Cyrille Giquello, 📷 [Damien Sorel](https://www.strangeplanet.fr/), Pascal Rhod, Nick Whitelegg...
-- __[Adrien Pavie](https://pavie.info/)__, for ⚙️ initial development of GeoVisio
-- And you all ✨ __GeoVisio users__ for making this project useful !
-
-
 ## ⚖️ License
 
-Copyright (c) GeoVisio team 2022-2023, [released under MIT license](https://gitlab.com/geovisio/geo-picture-tag-reader/-/blob/main/LICENSE).
+Copyright (c) Panoramax team 2022-2024, [released under MIT license](https://gitlab.com/panoramax/server/geo-picture-tag-reader/-/blob/main/LICENSE).
 

geopic_tag_reader-1.1.3.dist-info/RECORD

@@ -0,0 +1,15 @@
+geopic_tag_reader/__init__.py,sha256=5U9FfeZGkInbD3H9zaqteUjP5wK3mmNATj3vZPy31pE,47
+geopic_tag_reader/camera.py,sha256=Nw6dQjnrUCCOXujjk8Y7IwjJPMuDf4DAGCmHk0LDfEg,1975
+geopic_tag_reader/i18n.py,sha256=LOLBj7eB_hpHTc5XdMP97EoWdD2kgmkP_uvJJDKEVsU,342
+geopic_tag_reader/main.py,sha256=NJFDdPlyj0HvBcPABTVPqdSPm0SP3lnW4HF1fmhONY4,3550
+geopic_tag_reader/model.py,sha256=rsWVE3T1kpNsKXX8iv6xb_3PCVY6Ea7iU9WOqUgXklU,129
+geopic_tag_reader/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+geopic_tag_reader/reader.py,sha256=4tk-qvN-mBryp8FbtG9smQkSlWDjWZU1CDedm07MqP0,25746
+geopic_tag_reader/writer.py,sha256=HdZenoY_5Qv1Kq0jedCJhVFDYsv0iQaCzB6necU_LrY,8793
+geopic_tag_reader/translations/geopic_tag_reader.pot,sha256=1myoxYDZfHh7R_Iiyn9VFdz5T6nbYR3S_jxFhkrw0GI,3590
+geopic_tag_reader/translations/fr/LC_MESSAGES/geopic_tag_reader.po,sha256=QxuV0AYxOAVCI4xaKDDCvgUfeym6oRQC2YeRJpI9i9c,4223
+geopic_tag_reader-1.1.3.dist-info/entry_points.txt,sha256=c9YwjCNhxveDf-61_aSRlzcpoutvM6KQCerlzaVt_JU,64
+geopic_tag_reader-1.1.3.dist-info/LICENSE,sha256=oHWDwXkJJb9zJzThMN3F9Li4yFhz1qxOUByouY7L3bI,1070
+geopic_tag_reader-1.1.3.dist-info/WHEEL,sha256=EZbGkh7Ie4PoZfRQ8I0ZuP9VklN_TvcZ6DSE5Uar4z4,81
+geopic_tag_reader-1.1.3.dist-info/METADATA,sha256=UWeERQ-wFwg-URJUXsRaGJLzcuJq8BkQNmw-3jSpcJ0,4578
+geopic_tag_reader-1.1.3.dist-info/RECORD,,

geopic_tag_reader-1.1.1.dist-info/RECORD

@@ -1,12 +0,0 @@
-geopic_tag_reader/__init__.py,sha256=7hT1At7Ce4FtNeMuBZa7cDah_cJoIhJrnQWbEAF0BE8,47
-geopic_tag_reader/camera.py,sha256=2Sr0jAt3RXUWazYMnkwF6J6lVnKvSp7Ac8g7yOHehVA,1643
-geopic_tag_reader/main.py,sha256=ZEZaZEeaDxRjrVMwhR5lUYJWKkUcjd8avjqm7JxJdhM,3219
-geopic_tag_reader/model.py,sha256=rsWVE3T1kpNsKXX8iv6xb_3PCVY6Ea7iU9WOqUgXklU,129
-geopic_tag_reader/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-geopic_tag_reader/reader.py,sha256=4yoQU-ljOgLmaH_hc1m4o1YkSNgaPfM38NVmiM7rpbE,24543
-geopic_tag_reader/writer.py,sha256=QmQqQpWgb6AL3Y0Kuzy7PF1asUsTVDq9buwJXfFSRq8,8672
-geopic_tag_reader-1.1.1.dist-info/entry_points.txt,sha256=c9YwjCNhxveDf-61_aSRlzcpoutvM6KQCerlzaVt_JU,64
-geopic_tag_reader-1.1.1.dist-info/LICENSE,sha256=oHWDwXkJJb9zJzThMN3F9Li4yFhz1qxOUByouY7L3bI,1070
-geopic_tag_reader-1.1.1.dist-info/WHEEL,sha256=EZbGkh7Ie4PoZfRQ8I0ZuP9VklN_TvcZ6DSE5Uar4z4,81
-geopic_tag_reader-1.1.1.dist-info/METADATA,sha256=iMhClAI5r1h2jpB_o-dwcSP3QVz4PuBPf4jWmZ_10Ks,6303
-geopic_tag_reader-1.1.1.dist-info/RECORD,,