Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 6 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -117,6 +117,12 @@ Exemple de sortie :
[...]
```

Chaque film expose également `showtime.movie.release_date` (`datetime.date | None`) : la plus ancienne sortie
cinéma initiale référencée par Allociné (`Released`, type `THEATER`), uniquement si sa date est précise au jour.
Les ressorties, la VOD et les supports physiques sont exclus. Si aucune sortie initiale avec une date complète
n’est disponible, la valeur est `None`. Cette information provient des réponses des séances, sans requête supplémentaire,
et est conservée par `showtime.movie.get_movie()`. L’attribut `year` reste l’année de production.

Le cache est activé par défaut. Les réponses sont enregistrées dans le répertoire de cache utilisateur du système :

- macOS: `~/Library/Caches/allocine`
Expand Down
24 changes: 24 additions & 0 deletions allocine/client.py
Original file line number Diff line number Diff line change
Expand Up @@ -344,6 +344,7 @@ def _parse_showtimes(self, raw_showtimes: list[dict]):
actors.append(name)

genres = ", ".join(genre["translate"] for genre in raw_movie.get("genres") or [] if genre.get("translate"))
release_date = _initial_theatrical_release_date(raw_movie.get("releases") or [])
for showtime_group in (showtime_data.get("showtimes") or {}).values():
for raw_showtime in showtime_group:
tags = raw_showtime.get("tags") or []
Expand Down Expand Up @@ -384,6 +385,7 @@ def _parse_showtimes(self, raw_showtimes: list[dict]):
directors=", ".join(directors),
actors=", ".join(actors),
duration=duration_obj,
release_date=release_date,
)
showtimes.append(
Showtime(
Expand All @@ -394,6 +396,28 @@ def _parse_showtimes(self, raw_showtimes: list[dict]):
return showtimes


def _initial_theatrical_release_date(releases: list[dict]) -> Date | None:
"""Return the earliest day-precise initial theatrical release reported by Allociné."""
dates = []
for release in releases:
tags = release.get("releaseTags") or {}
if release.get("name") != "Released" or "THEATER" not in (tags.get("tagTypes") or []):
continue
if "RERUN" in (tags.get("tagFlags") or []):
continue
release_date = release.get("releaseDate") or {}
if release_date.get("precision") != "day":
continue
value = release_date.get("date")
if not value:
continue
try:
dates.append(Date.fromisoformat(value))
except (ValueError, TypeError):
continue
return min(dates, default=None)


def _person_name(person):
if not person:
return None
Expand Down
4 changes: 3 additions & 1 deletion allocine/models.py
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
import logging
import unicodedata
from dataclasses import dataclass
from dataclasses import dataclass, field
from datetime import date as Date
from datetime import datetime, timedelta
from datetime import time as Time
Expand All @@ -25,6 +25,7 @@ class Movie:
actors: str
synopsis: str
year: int
release_date: Date | None = field(default=None, kw_only=True)

@property
def duration_str(self):
Expand Down Expand Up @@ -102,6 +103,7 @@ def get_movie(self):
directors=self.directors,
actors=self.actors,
synopsis=self.synopsis,
release_date=self.release_date,
)

def __str__(self):
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -15,6 +15,7 @@
"movie_id": 1000028944,
"original_title": "Justin le Juste",
"rating": 3.75,
"release_date": "2026-09-23",
"screen_format": "Numérique",
"synopsis": "Pendant la Première Guerre mondiale, l’histoire d’un paysan naïf enrôlé de force dans l’armée française.",
"title": "Justin le Juste",
Expand All @@ -37,6 +38,7 @@
"movie_id": 1000028944,
"original_title": "Justin le Juste",
"rating": 3.75,
"release_date": "2026-09-23",
"screen_format": "Numérique",
"synopsis": "Pendant la Première Guerre mondiale, l’histoire d’un paysan naïf enrôlé de force dans l’armée française.",
"title": "Justin le Juste",
Expand All @@ -59,6 +61,7 @@
"movie_id": 1000028944,
"original_title": "Justin le Juste",
"rating": 3.75,
"release_date": "2026-09-23",
"screen_format": "Numérique",
"synopsis": "Pendant la Première Guerre mondiale, l’histoire d’un paysan naïf enrôlé de force dans l’armée française.",
"title": "Justin le Juste",
Expand All @@ -80,6 +83,7 @@
"movie_id": 1000000085,
"original_title": "Heart Of The Beast",
"rating": 3.84,
"release_date": "2026-09-23",
"screen_format": "DOLBY_ATMOS F_4K",
"synopsis": "Après un terrible crash d’avion, James Belmont, ancien des forces spéciales, se retrouve perdu au cœur de l’Alaska avec son chien Odin, depuis toujours à ses côtés. Livrés à eux-mêmes dans une nature aussi magnifique qu’impitoyable, ils devront puiser dans leurs dernières forces pour survivre ensemble.",
"title": "Heart Of The Beast",
Expand All @@ -101,6 +105,7 @@
"movie_id": 1000000085,
"original_title": "Heart Of The Beast",
"rating": 3.84,
"release_date": "2026-09-23",
"screen_format": "Numérique",
"synopsis": "Après un terrible crash d’avion, James Belmont, ancien des forces spéciales, se retrouve perdu au cœur de l’Alaska avec son chien Odin, depuis toujours à ses côtés. Livrés à eux-mêmes dans une nature aussi magnifique qu’impitoyable, ils devront puiser dans leurs dernières forces pour survivre ensemble.",
"title": "Heart Of The Beast",
Expand All @@ -122,6 +127,7 @@
"movie_id": 232669,
"original_title": "Avengers: Endgame",
"rating": 4.2,
"release_date": "2019-04-24",
"screen_format": "DOLBY_ATMOS INFINITY_VISION F_4K",
"synopsis": "Thanos ayant anéanti la moitié de l’univers, les Avengers restants resserrent les rangs dans ce vingt-deuxième film des Studios Marvel, grande conclusion d’un des chapitres de l’Univers Cinématographique Marvel.",
"title": "Avengers: Endgame",
Expand All @@ -143,6 +149,7 @@
"movie_id": 232669,
"original_title": "Avengers: Endgame",
"rating": 4.2,
"release_date": "2019-04-24",
"screen_format": "DOLBY_ATMOS INFINITY_VISION F_4K",
"synopsis": "Thanos ayant anéanti la moitié de l’univers, les Avengers restants resserrent les rangs dans ce vingt-deuxième film des Studios Marvel, grande conclusion d’un des chapitres de l’Univers Cinématographique Marvel.",
"title": "Avengers: Endgame",
Expand All @@ -164,6 +171,7 @@
"movie_id": 1000032856,
"original_title": "Tombé du ciel",
"rating": 3.21,
"release_date": "2026-08-12",
"screen_format": "Numérique",
"synopsis": "Ilyes mène une vie joyeuse dans la banlieue de Roubaix. Seul problème : le bac. Après avoir échoué deux fois, c’est sa dernière chance de l’avoir et de rendre enfin fier ses parents. Mais un incendie survient pendant le bac blanc, et on l’accuse d’en être à l’origine... Exclu de son lycée, il doit quitter son quartier et aller dans le seul établissement qui l’accepte : le pensionnat catholique de Saint-Albert-le-Grand, en Bourgogne. Entre choc des cultures et quête de rédemption, Ilyes va devoir surmonter ses préjugés... Et ceux des autres. ",
"title": "Tombé du ciel",
Expand All @@ -185,6 +193,7 @@
"movie_id": 1000032856,
"original_title": "Tombé du ciel",
"rating": 3.21,
"release_date": "2026-08-12",
"screen_format": "Numérique",
"synopsis": "Ilyes mène une vie joyeuse dans la banlieue de Roubaix. Seul problème : le bac. Après avoir échoué deux fois, c’est sa dernière chance de l’avoir et de rendre enfin fier ses parents. Mais un incendie survient pendant le bac blanc, et on l’accuse d’en être à l’origine... Exclu de son lycée, il doit quitter son quartier et aller dans le seul établissement qui l’accepte : le pensionnat catholique de Saint-Albert-le-Grand, en Bourgogne. Entre choc des cultures et quête de rédemption, Ilyes va devoir surmonter ses préjugés... Et ceux des autres. ",
"title": "Tombé du ciel",
Expand All @@ -207,6 +216,7 @@
"movie_id": 294281,
"original_title": "La Bataille de Gaulle - Partie 2 : J’écris ton nom",
"rating": 4.5,
"release_date": "2026-06-26",
"screen_format": "Numérique",
"synopsis": "Juin 1940. La France s'effondre et signe l’armistice. Au milieu du chaos, un homme refuse de céder. Seul contre tous, ce général inconnu s'échappe vers Londres pour sauver ce qu'il reste d'un rêve : la liberté.",
"title": "La Bataille de Gaulle - Partie 2 : J’écris ton nom",
Expand All @@ -228,6 +238,7 @@
"movie_id": 323826,
"original_title": "Les Héros du Louvre",
"rating": 3.18,
"release_date": "2026-09-09",
"screen_format": "Numérique",
"synopsis": "Alors que la Seconde Guerre mondiale éclate et que l'invasion allemande est imminente, Babi Maklouf, gardien de nuit au Musée du Louvre, se voit confier la tâche de transporter certains de ses trésors hors de Paris.",
"title": "Les Héros du Louvre",
Expand All @@ -249,6 +260,7 @@
"movie_id": 1000013045,
"original_title": "The Odyssey",
"rating": 4.3,
"release_date": "2026-07-15",
"screen_format": "Numérique",
"synopsis": "L’Odyssée est une épopée mythique tournée à travers le monde qui suit le retour d'Ulysse vers Ithaque. Pour la première fois, la saga fondatrice d'Homère est portée sur les écrans de manière spectaculaire avec la toute dernière technologie IMAX. ",
"title": "L'Odyssée",
Expand All @@ -270,6 +282,7 @@
"movie_id": 1000013045,
"original_title": "The Odyssey",
"rating": 4.3,
"release_date": "2026-07-15",
"screen_format": "Numérique",
"synopsis": "L’Odyssée est une épopée mythique tournée à travers le monde qui suit le retour d'Ulysse vers Ithaque. Pour la première fois, la saga fondatrice d'Homère est portée sur les écrans de manière spectaculaire avec la toute dernière technologie IMAX. ",
"title": "L'Odyssée",
Expand All @@ -291,6 +304,7 @@
"movie_id": 276608,
"original_title": "Spider-Man: Brand New Day",
"rating": 4.09,
"release_date": "2026-07-29",
"screen_format": "Numérique",
"synopsis": "C’est un tout nouveau jour pour Peter Parker Dans un monde qui ne se souvient plus de lui, il poursuit sans relâche sa lutte contre la criminalité. Mais le sentiment d’avoir été oublié par ses amis qui avancent désormais sans lui provoque un changement chez Peter qu’il n’est peut-être pas en mesure de contrôler. Et pourtant, c’est cette mutation qui pourrait être sa seule chance de s’opposer à un adversaire terrifiant, capable d’agir sans jamais être repéré et prêt à s’attaquer à la ville et à tous les proches de Spider-Man. Car si le monde ne se souvient plus de Peter Parker, lui ne l’a pas oublié...",
"title": "Spider-Man: Brand New Day",
Expand All @@ -312,6 +326,7 @@
"movie_id": 276608,
"original_title": "Spider-Man: Brand New Day",
"rating": 4.09,
"release_date": "2026-07-29",
"screen_format": "Numérique",
"synopsis": "C’est un tout nouveau jour pour Peter Parker Dans un monde qui ne se souvient plus de lui, il poursuit sans relâche sa lutte contre la criminalité. Mais le sentiment d’avoir été oublié par ses amis qui avancent désormais sans lui provoque un changement chez Peter qu’il n’est peut-être pas en mesure de contrôler. Et pourtant, c’est cette mutation qui pourrait être sa seule chance de s’opposer à un adversaire terrifiant, capable d’agir sans jamais être repéré et prêt à s’attaquer à la ville et à tous les proches de Spider-Man. Car si le monde ne se souvient plus de Peter Parker, lui ne l’a pas oublié...",
"title": "Spider-Man: Brand New Day",
Expand All @@ -334,6 +349,7 @@
"movie_id": 1000018854,
"original_title": "Resident Evil",
"rating": 3.85,
"release_date": "2026-09-16",
"screen_format": "Numérique",
"synopsis": "Bryan, coursier médical, s'engage dans une course effrénée pour survivre, alors qu'autour de lui le monde s'enfonce dans un chaos total.",
"title": "Resident Evil",
Expand All @@ -356,6 +372,7 @@
"movie_id": 1000018854,
"original_title": "Resident Evil",
"rating": 3.85,
"release_date": "2026-09-16",
"screen_format": "Numérique",
"synopsis": "Bryan, coursier médical, s'engage dans une course effrénée pour survivre, alors qu'autour de lui le monde s'enfonce dans un chaos total.",
"title": "Resident Evil",
Expand All @@ -378,6 +395,7 @@
"movie_id": 294280,
"original_title": "La Bataille de Gaulle - partie 1 : L'Âge de Fer",
"rating": 4.42,
"release_date": "2026-06-03",
"screen_format": "Numérique",
"synopsis": "Juin 1940. La France s'effondre et signe l’armistice. Au milieu du chaos, un homme refuse de céder. Seul contre tous, ce général inconnu s'échappe vers Londres pour sauver ce qu'il reste d'un rêve : la liberté. ",
"title": "La Bataille de Gaulle - partie 1 : L'Âge de Fer",
Expand All @@ -399,6 +417,7 @@
"movie_id": 1000019874,
"original_title": "The Weight",
"rating": 3.28,
"release_date": "2026-09-16",
"screen_format": "Numérique",
"synopsis": "Oregon, 1933. Après la mort de sa femme, Samuel Murphy est arraché à sa fille et envoyé dans un camp de travail impitoyable. Lorsqu’un surveillant sans scrupule lui promet la liberté contre une périlleuse mission de contrebande d’or, Murphy saisit sa seule chance de rentrer chez lui. Il s’embarque alors dans une expédition de tous les dangers, au cœur d’une nature hostile, où les trahisons se multiplient. Jusqu’où Murphy sera-t-il prêt à aller pour revoir sa fille ?",
"title": "Les Contrebandiers",
Expand All @@ -420,6 +439,7 @@
"movie_id": 1000019874,
"original_title": "The Weight",
"rating": 3.28,
"release_date": "2026-09-16",
"screen_format": "Numérique",
"synopsis": "Oregon, 1933. Après la mort de sa femme, Samuel Murphy est arraché à sa fille et envoyé dans un camp de travail impitoyable. Lorsqu’un surveillant sans scrupule lui promet la liberté contre une périlleuse mission de contrebande d’or, Murphy saisit sa seule chance de rentrer chez lui. Il s’embarque alors dans une expédition de tous les dangers, au cœur d’une nature hostile, où les trahisons se multiplient. Jusqu’où Murphy sera-t-il prêt à aller pour revoir sa fille ?",
"title": "Les Contrebandiers",
Expand All @@ -441,6 +461,7 @@
"movie_id": 1000004679,
"original_title": "Practical Magic 2",
"rating": 2.42,
"release_date": "2026-09-09",
"screen_format": "Numérique",
"synopsis": "Les sœurs Owens affrontent la sombre malédiction qui menace de détruire leur famille une fois pour toutes, dans un événement cinématographique mêlant divertissement, magie et chaos.",
"title": "Les Ensorceleuses 2",
Expand All @@ -462,6 +483,7 @@
"movie_id": 317219,
"original_title": "The Invite",
"rating": 3.23,
"release_date": "2026-09-16",
"screen_format": "Numérique",
"synopsis": "Angela et Joe invitent leurs mystérieux nouveaux voisins du dessus à dîner. La soirée va alors rapidement faire voler en éclats toutes leurs certitudes.",
"title": "L'Invitation",
Expand Down
Loading
Loading