private-assistant-picture-display-skill 0.4.1__py3-none-any.whl

private_assistant_picture_display_skill/utils/metadata_builder.py

@@ -0,0 +1,135 @@
+"""Natural language metadata builder for images."""
+
+from datetime import datetime
+
+# Constants for name formatting
+_PAIR_COUNT = 2
+
+
+class MetadataBuilder:
+    """Build natural language metadata from image data.
+
+    Generates human-readable title and description strings from structured
+    metadata like people names, location, date, and album information.
+    """
+
+    @staticmethod
+    def build_title(
+        people: list[str] | None = None,
+        city: str | None = None,
+        country: str | None = None,
+        date: datetime | None = None,
+    ) -> str | None:
+        """Build short title for voice responses.
+
+        Priority: People > Location > Date
+        Examples: "John and Sarah, Berlin" or "Berlin, August 2023"
+
+        Args:
+            people: List of recognized person names
+            city: City name from EXIF
+            country: Country name from EXIF
+            date: Date photo was taken
+
+        Returns:
+            Short title string or None if no data available
+        """
+        parts: list[str] = []
+
+        # People names (max 2 shown)
+        if people:
+            parts.append(_format_names_short(people))
+
+        # Location (city preferred, country as fallback if no people)
+        if city:
+            parts.append(city)
+        elif country and not people:
+            parts.append(country)
+
+        # Date (only if no people, to keep title short)
+        if date and not people:
+            parts.append(date.strftime("%B %Y"))
+
+        return ", ".join(parts) if parts else None
+
+    @staticmethod
+    def build_description(  # noqa: PLR0913
+        people: list[str] | None = None,
+        city: str | None = None,
+        state: str | None = None,
+        country: str | None = None,
+        date: datetime | None = None,
+        album_names: list[str] | None = None,
+    ) -> str | None:
+        """Build full description combining all metadata.
+
+        Examples:
+        - "John and Sarah in Berlin, Germany - August 2023. From album: Summer Vacation"
+        - "Photo from San Francisco, California - March 2024"
+        - "Photo of Emma and Michael. From album: Family"
+
+        Args:
+            people: List of recognized person names
+            city: City name from EXIF
+            state: State/region from EXIF
+            country: Country name from EXIF
+            date: Date photo was taken
+            album_names: List of album names containing this image
+
+        Returns:
+            Full description string or None if no data available
+        """
+        sentences: list[str] = []
+
+        # Main sentence: people + location
+        location = _build_location(city, state, country)
+        if people and location:
+            names = _format_names_full(people)
+            sentences.append(f"{names} in {location}")
+        elif people:
+            sentences.append(f"Photo of {_format_names_full(people)}")
+        elif location:
+            sentences.append(f"Photo from {location}")
+
+        # Append date to last sentence
+        if date:
+            date_str = date.strftime("%B %Y")
+            if sentences:
+                sentences[-1] += f" - {date_str}"
+            else:
+                sentences.append(f"Photo from {date_str}")
+
+        # Album info as separate sentence
+        if album_names:
+            albums = ", ".join(album_names[:2])  # Max 2 albums
+            sentences.append(f"From album: {albums}")
+
+        return ". ".join(sentences) if sentences else None
+
+
+def _format_names_short(names: list[str]) -> str:
+    """Format names for short title (max 2 shown)."""
+    if len(names) == 1:
+        return names[0]
+    if len(names) == _PAIR_COUNT:
+        return f"{names[0]} and {names[1]}"
+    return f"{names[0]} and others"
+
+
+def _format_names_full(names: list[str]) -> str:
+    """Format names for full description."""
+    if len(names) == 1:
+        return names[0]
+    if len(names) == _PAIR_COUNT:
+        return f"{names[0]} and {names[1]}"
+    return f"{names[0]}, {names[1]}, and {len(names) - _PAIR_COUNT} others"
+
+
+def _build_location(
+    city: str | None,
+    state: str | None,
+    country: str | None,
+) -> str | None:
+    """Build location string from components."""
+    parts = [p for p in [city, state, country] if p]
+    return ", ".join(parts) if parts else None

private_assistant_picture_display_skill-0.4.1.dist-info/METADATA

@@ -0,0 +1,47 @@
+Metadata-Version: 2.4
+Name: private-assistant-picture-display-skill
+Version: 0.4.1
+Summary: Skill to dynamically display images from various sources via external agents.
+Keywords: 
+Author: stkr22
+Author-email: stkr22 <stkr22@github.com>
+License-Expression: GPL-3.0-only
+License-File: LICENSE
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Programming Language :: Python
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Requires-Dist: pydantic
+Requires-Dist: jinja2~=3.1.3
+Requires-Dist: private-assistant-commons~=5.4.0
+Requires-Dist: typer~=0.21.0
+Requires-Dist: httpx~=0.28.0
+Requires-Dist: minio~=7.2.0
+Requires-Dist: pyyaml~=6.0.0
+Requires-Dist: pillow~=12.1.0
+Requires-Dist: pillow-heif~=1.1.1
+Requires-Dist: coloraide~=6.2.1
+Requires-Python: >=3.12, <3.14
+Project-URL: Changelog, https://github.com/stkr22/private-assistant-picture-display-skill-py/blob/main/CHANGELOG.md
+Project-URL: Documentation, https://github.com/stkr22/private-assistant-picture-display-skill-py/tree/main/docs
+Project-URL: Homepage, https://github.com/stkr22/private-assistant-picture-display-skill-py
+Project-URL: Issues, https://github.com/stkr22/private-assistant-picture-display-skill-py/issues
+Project-URL: Repository, https://github.com/stkr22/private-assistant-picture-display-skill-py
+Description-Content-Type: text/markdown
+
+# private-assistant-picture-display-skill
+
+[![Copier](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/copier-org/copier/master/img/badge/badge-grayscale-inverted-border-orange.json)](https://github.com/copier-org/copier)
+[![python](https://img.shields.io/badge/Python-3.12-3776AB.svg?style=flat&logo=python&logoColor=white)](https://www.python.org)
+[![uv](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/uv/main/assets/badge/v0.json)](https://github.com/astral-sh/uv)
+[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/charliermarsh/ruff/main/assets/badge/v0.json)](https://github.com/charliermarsh/ruff)
+[![Checked with mypy](https://www.mypy-lang.org/static/mypy_badge.svg)](https://mypy-lang.org/)
+[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
+[![pre-commit](https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit&logoColor=white)](https://github.com/pre-commit/pre-commit)
+
+Owner: stkr22
+
+**READ THE AGENTS.md**
+
+Skill to dynamically display images from various sources via external agents.

private_assistant_picture_display_skill-0.4.1.dist-info/RECORD

@@ -0,0 +1,32 @@
+private_assistant_picture_display_skill/__init__.py,sha256=QCisYgmEO6tX47aB00xviNK3saJCmishWJ984Ohvmxw,394
+private_assistant_picture_display_skill/config.py,sha256=DjjJxD7uPZWgxS1Xh8w4gdsdJd63NIQ8QyT5aTVmrRI,2235
+private_assistant_picture_display_skill/immich/__init__.py,sha256=n-u-jUMu6SoUnu_lsn9HvrQ2w10XSDdWpJ3LIjl6B1U,612
+private_assistant_picture_display_skill/immich/client.py,sha256=WLcsJE-UECKb0Oi0mbOCKsqON_sw04q-Dsp4r4zcKYg,8632
+private_assistant_picture_display_skill/immich/config.py,sha256=C2uHEgzTuHueD71FQfrrIsRwKyn864Kd9QzGOaHgOVI,3545
+private_assistant_picture_display_skill/immich/models.py,sha256=hrkSvZ3Gw4niRarIjDXbYYBqK1J1iUJfgY7L0n9rf6E,3089
+private_assistant_picture_display_skill/immich/payloads.py,sha256=Ch69ah5mu_zo926um41jLTnbsdlddJNqqrDao6PxRKg,1634
+private_assistant_picture_display_skill/immich/storage.py,sha256=dVF6Fh01h30L6WrfOTJWpiHWcuqtxFC3MPJNYO2HzbE,3535
+private_assistant_picture_display_skill/immich/sync_service.py,sha256=sGsshx-PP_Xv2yDfs7RqdDvKLvwyjaa8GQekLt_ZxLw,19088
+private_assistant_picture_display_skill/main.py,sha256=fHtZQNq17wfiCVmBVIbKxDlPeoNXUCTOI8akHg1JsUE,5295
+private_assistant_picture_display_skill/models/__init__.py,sha256=-gRXRrAhItZFKfBDDPR1owciLsj5KwKpOp4RDoYiIQM,546
+private_assistant_picture_display_skill/models/commands.py,sha256=bJ7qz9Q0qjpVbxKKH8yFepoAiA32oqVa6TShUQRIJ3I,2470
+private_assistant_picture_display_skill/models/device.py,sha256=w30kQw1m-Pe6uoDNWqwurWHAr6HsrB1UXNa_-0PPQII,1263
+private_assistant_picture_display_skill/models/image.py,sha256=yQeM31uFhY4lURTr4ZFfCTRvsYW_P72SiJWLZJff8Pk,3056
+private_assistant_picture_display_skill/models/immich_sync_job.py,sha256=KuXRs2GIH7vGacQrBPTlyNxQOlJtayVEw664GJo1VN8,4439
+private_assistant_picture_display_skill/picture_skill.py,sha256=RmFw1pjUcNyDRDxXuUcSYmZJUzw2D8ZvikaaugfV1x0,21726
+private_assistant_picture_display_skill/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+private_assistant_picture_display_skill/services/__init__.py,sha256=WYEEnCJglZTllt5VpDCzikugTHir8vMoqoTyl2JyKJM,195
+private_assistant_picture_display_skill/services/device_mqtt_client.py,sha256=gu02Y4zxyCe7fmEuAWExXTET1iz2WS9xCIpjDq1ax7k,5744
+private_assistant_picture_display_skill/services/image_manager.py,sha256=UMhlQtfNzpbr3bMm_tFNFrhvoWQthIVZz8dvnFCZOxs,6797
+private_assistant_picture_display_skill/templates/describe_image.j2,sha256=sZ6mZLP_mnQAVXEzBkIoh7tHA82tzvXJ2rbc3WrBBjA,359
+private_assistant_picture_display_skill/templates/help.j2,sha256=8NxNXV3uafSNhMhmxoqEV_f4_V_jlRORHNh7IpmovdA,168
+private_assistant_picture_display_skill/templates/next_picture.j2,sha256=jeKg6ABni_WMW-Qy62G-sx_aSYpkS2jcZmNdH8hpQcQ,310
+private_assistant_picture_display_skill/utils/__init__.py,sha256=B-u7QNTPnE7J-7lBfjcyKeULih0voJKuYzBxg79DIJ8,499
+private_assistant_picture_display_skill/utils/color_analysis.py,sha256=4ZhnnxMWxS1ndV3IWg1Av0kXsJzZZm25Yxs2Xh76hWM,3210
+private_assistant_picture_display_skill/utils/image_processing.py,sha256=BHLAg1yBBszgVR-NB-2kA7FPi8gvmpj4E-3WxPwFidA,3926
+private_assistant_picture_display_skill/utils/metadata_builder.py,sha256=h3Qi4Rvh1A2n0gnAt_UL7-N4s-81uI9TfT7IssmYMgI,4293
+private_assistant_picture_display_skill-0.4.1.dist-info/licenses/LICENSE,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+private_assistant_picture_display_skill-0.4.1.dist-info/WHEEL,sha256=eycQt0QpYmJMLKpE3X9iDk8R04v2ZF0x82ogq-zP6bQ,79
+private_assistant_picture_display_skill-0.4.1.dist-info/entry_points.txt,sha256=dbqQbHKXHoKD8Fex3RgYPNlbumICWM4OUwlnlVfVK74,110
+private_assistant_picture_display_skill-0.4.1.dist-info/METADATA,sha256=2mJjWtVZFyeqT3REOxMlglwc0j87_Bs_7vqNdx1GptU,2566
+private_assistant_picture_display_skill-0.4.1.dist-info/RECORD,,

private_assistant_picture_display_skill-0.4.1.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: uv 0.9.24
+Root-Is-Purelib: true
+Tag: py3-none-any

private_assistant_picture_display_skill-0.4.1.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+private-assistant-picture-display-skill = private_assistant_picture_display_skill.main:app
+