allocine 0.1.0__py3-none-any.whl

allocine-0.1.0.dist-info/METADATA

@@ -0,0 +1,214 @@
+Metadata-Version: 2.4
+Name: allocine
+Version: 0.1.0
+Summary: Non official Python wrapper for allocine.fr
+Author-email: Thibault Ducret <hello@tducret.com>
+License: MIT
+Project-URL: Homepage, https://github.com/tducret/allocine-python
+Keywords: allocine,api,parser,parsing,python-wrapper,scraper,scraping
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: backoff>=2.2.1
+Requires-Dist: click>=8.5.0
+Requires-Dist: diskcache<6,>=5.6
+Requires-Dist: httpx2>=2.13.1
+Requires-Dist: jmespath>=1.1.0
+Requires-Dist: parsel>=1.10.0
+Requires-Dist: platformdirs>=4.3
+Requires-Dist: rich>=14.2.0
+Provides-Extra: dev
+Requires-Dist: freezegun>=1.5.5; extra == "dev"
+Requires-Dist: pre-commit>=4.6.2; extra == "dev"
+Requires-Dist: pytest>=9.1.1; extra == "dev"
+Requires-Dist: pytest-cov>=7.1.0; extra == "dev"
+Requires-Dist: ruff>=0.16.9; extra == "dev"
+Requires-Dist: syrupy>=6.1.1; extra == "dev"
+Requires-Dist: ty>=0.0.84; extra == "dev"
+Requires-Dist: vcrpy>=8.3.0; extra == "dev"
+Dynamic: license-file
+
+# Allociné
+
+[![PyPI](https://img.shields.io/pypi/v/allocine.svg)](https://pypi.org/project/allocine/)
+![License](https://img.shields.io/github/license/tducret/allocine-python.svg)
+
+![Cinéma](cinema.jpg)
+
+## Description
+
+**Avec cet outil, vous récupérez les horaires des séances ciné directement dans le terminal**.
+
+## Prérequis
+
+- Python 3.10 ou une version ultérieure
+- [uv](https://docs.astral.sh/uv/)
+
+## Installation
+
+```bash
+uv tool install --upgrade allocine
+```
+
+## Utilisation en ligne de commande
+
+Commencez par rechercher l’identifiant de votre cinéma sur [allocine.fr](https://www.allocine.fr/).
+
+Recherchez votre cinéma et relevez son identifiant dans l’URL. Dans cet exemple, il s’agit de `P0645`.
+
+![Identifiant du cinéma](snapshot_theater_id.png)
+
+![Capture terminal](demo.gif)
+
+#### Aide
+
+```bash
+seances --help
+Usage: seances [OPTIONS] ID_CINEMA
+
+  Les séances de votre cinéma dans le terminal, avec ID_CINEMA : identifiant
+  du cinéma sur Allociné, ex: C0159 pour l’UGC Ciné Cité Les Halles. Se
+  trouve dans l’url :
+  http://allocine.fr/seance/salle_gen_csalle=<ID_CINEMA>.html
+
+Options:
+  -j, --jour TEXT    jour des séances souhaitées (au format DD/MM/YYYY ou +1
+                     pour demain), par défaut : aujourd’hui
+  -s, --semaine      affiche les séance pour les 7 prochains jours
+  -e, --entrelignes  ajoute une ligne entre chaque film pour améliorer la
+                     lisibilité
+  --help             Show this message and exit.
+```
+
+#### Utilisation simple
+
+```bash
+seances P2235
+
+27/12/2018
+┌──────────────────────────────────────────────────────────┬──────┬───────┬───────┬───────┬───────┐
+│ Astérix - Le Secret de la Potion Magique... (VF) - 01h25 │ 4.1* │ 10:15 │       │       │       │
+│ L’Empereur de Paris (VF) - 01h50                         │ 3.4* │       │       │ 17:15 │       │
+│ Ma mère est folle (VF) - 01h35                           │ 3.0* │       │ 14:15 │       │       │
+│ Marche ou crève (VF) - 01h25                             │ 3.6* │       │       │       │ 20:15 │
+└──────────────────────────────────────────────────────────┴──────┴───────┴───────┴───────┴───────┘
+```
+
+#### Pour demain, avec des interlignes
+
+```bash
+seances P2235 -j+1 --entrelignes
+
+28/12/2018
+┌────────────────────────────────────────────────────┬──────┬───────┬───────┬───────┐
+│ Casse-noisette et les quatre royaumes (VF) - 01h39 │ 3.1* │       │       │ 20:15 │
+├────────────────────────────────────────────────────┼──────┼───────┼───────┼───────┤
+│ Ma mère est folle (VF) - 01h35                     │ 3.0* │       │ 17:15 │       │
+├────────────────────────────────────────────────────┼──────┼───────┼───────┼───────┤
+│ Marche ou crève (VF) - 01h25                       │ 3.6* │ 14:15 │       │       │
+└────────────────────────────────────────────────────┴──────┴───────┴───────┴───────┘
+```
+
+#### Pour une date précise
+
+```bash
+seances P2235 --jour 29/12/2018
+```
+
+#### Pour toute la semaine
+
+```bash
+seances P2235 --semaine
+```
+
+## Utilisation de la bibliothèque
+
+```python
+from allocine import Allocine
+
+with Allocine() as allocine:
+    showtimes = allocine.get_showtimes("P2235")
+
+for showtime in showtimes:
+    print(showtime)
+```
+
+Exemple de sortie :
+
+```bash
+27/12/2018 10:15 : Astérix - Le Secret de la Potion Magique [244560] (VF) (01h25)
+27/12/2018 14:15 : Ma mère est folle [260370] (VF) (01h35)
+27/12/2018 17:15 : L’Empereur de Paris [258914] (VF) (01h50)
+27/12/2018 20:15 : Marche ou crève [258052] (VF) (01h25)
+28/12/2018 14:15 : Marche ou crève [258052] (VF) (01h25)
+28/12/2018 17:15 : Ma mère est folle [260370] (VF) (01h35)
+28/12/2018 20:15 : Casse-noisette et les quatre royaumes [245656] (VF) (01h39)
+29/12/2018 14:15 : Astérix - Le Secret de la Potion Magique [244560] (VF) (01h25)
+[...]
+```
+
+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`
+- Linux: `${XDG_CACHE_HOME:-~/.cache}/allocine`
+- Windows: `%LOCALAPPDATA%\\allocine\\Cache`
+
+Videz le cache en ligne de commande (aucun identifiant de cinéma n’est nécessaire) :
+
+```bash
+seances --clear-cache
+```
+
+## Développement
+
+Créez l’environnement virtuel et installez le paquet avec ses dépendances de développement :
+
+```bash
+uv sync --extra dev
+```
+
+Installez les hooks pre-commit une première fois, puis utilisez `make check` pour analyser, formater et vérifier les types
+de l’ensemble du code :
+
+```bash
+uv run pre-commit install
+make check
+```
+
+Exécutez chaque vérification sans modifier les fichiers :
+
+```bash
+uv run ruff check .
+uv run ruff format --check .
+uv run ty check
+```
+
+Exécutez manuellement tous les hooks pre-commit avec :
+
+```bash
+uv run pre-commit run --all-files
+```
+
+Les utilisateurs de VS Code doivent accepter les recommandations d’extensions de l’espace de travail afin d’activer les
+diagnostics Ruff et ty en temps réel, ainsi que le formatage Ruff à l’enregistrement.
+
+## Publication
+
+Le workflow de publication publie sur PyPI les tags de version tels que `0.0.13` grâce à Trusted Publishing, sans
+stocker de jeton d’API. Avant la première publication :
+
+1. Créez un environnement GitHub nommé `pypi`. Il est recommandé d’exiger une approbation avant tout déploiement.
+2. Dans les paramètres de publication PyPI du projet `allocine`, ajoutez un Trusted Publisher GitHub avec le
+   propriétaire `tducret`, le dépôt `allocine-python`, le workflow `release.yml` et l’environnement `pypi`.
+
+Le tag Git définit la version du paquet ; aucun fichier de version ne doit être mis à jour. Ajoutez le tag au commit à
+publier. Le workflow rejette les distributions dont la version ne correspond pas au tag et effectue un test rapide du
+wheel et de la distribution source avant leur publication :
+
+```bash
+VERSION=0.0.13
+git tag -a ${VERSION} -m ${VERSION}
+git push origin ${VERSION}
+```

allocine-0.1.0.dist-info/RECORD

@@ -0,0 +1,14 @@
+allocine/__init__.py,sha256=WsOc4DWBQGjjoOFWbXnIGi4kDOvV8GBhOawjhfWAf5s,1290
+allocine/api.py,sha256=MZ9w1BvpbbEkK3Vp6GtIcx9aItOADCoCyvxk6XPBZZ8,4525
+allocine/cache.py,sha256=hd7CYf6e7WxSBDaucZLVe6ZtBz_fhdiZBOb6pd2X2L8,4686
+allocine/cli.py,sha256=VwCetHf_SH_dJe1Sn3eR3Ya1oGFTlb99RyhJvDKtnto,4792
+allocine/client.py,sha256=Rg3TqTdhpw_ZIrrjn3nyTpl0aPoMI7OgWMV08QiPyrA,9884
+allocine/models.py,sha256=yXAXm1ku1q-8jv2JM98mizVbu9EA_6ow3G1tMC5LYsk,6073
+allocine/nationalities.py,sha256=gfU69Hft-ZggQZf2JIvMYryNvDu1cc6M0s8OSiYqlZM,14326
+allocine/schedules.py,sha256=FPo-pkGT3UW5g5KGZdnShUtvnjLMbmpk9g9PcqGQxiM,6455
+allocine-0.1.0.dist-info/licenses/LICENSE,sha256=Aykk6ZMnaLof0ZIHRluKuojQaDaiD_PVNjaKxptcD2Q,1074
+allocine-0.1.0.dist-info/METADATA,sha256=2ufrjBtGdzqzczfxNgi8MtqQZVAcIon4WEqXn2A2VGY,8237
+allocine-0.1.0.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+allocine-0.1.0.dist-info/entry_points.txt,sha256=uiNMPpR-BFKUkk2MVR_EMf86DRVyLTGvctzYoOnPCB0,46
+allocine-0.1.0.dist-info/top_level.txt,sha256=q6b2qxRU5tp6X1LZ6cX9_v-b9JUV1Mqx1pak_wMVy8c,9
+allocine-0.1.0.dist-info/RECORD,,

allocine-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

allocine-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+seances = allocine.cli:main

allocine-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2018, Thibault Ducret
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

allocine-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+allocine