Non official Python wrapper for allocine.fr
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github First commit Dec 11, 2018
allocine Improved coverage Dec 27, 2018
tests Improved coverage (changed to a cinema with 3D and 4DX) Dec 27, 2018
.gitignore First commit Dec 11, 2018
.travis.yml Updated .travis.yml to test with Python 3.5 Dec 27, 2018
Dockerfile Updated Dockerfile to reduce image size even more Jan 1, 2019
LICENSE First commit Dec 11, 2018
MANIFEST.in First commit Dec 11, 2018
README.md Added Docker image size badge (docker build badge was erratic) Dec 31, 2018
capture.svg Renamed allocine_cli.py in seances.py and changed --id-cinema to an a… Dec 27, 2018
cinema.jpg Update README Dec 26, 2018
pytest.ini
requirements.txt Improved README.md and added PTableUnicode Pypi package to fix proble… Dec 27, 2018
seances Update with Docker info Dec 31, 2018
seances.py Renamed allocine_cli.py in seances.py and changed --id-cinema to an a… Dec 27, 2018
setup.cfg First commit Dec 11, 2018
setup.py Updated .travis.yml to test with Python 3.5 Dec 27, 2018
snapshot_theater_id.png Update with Docker info Dec 31, 2018

README.md

Allociné

Travis Coveralls github PyPI Docker Image size License

Cinéma

Description

Avec cet outil, vous récupérez les horaires des séances ciné directement dans le terminal.

Requirements

  • Python 3.5
  • pip3

Installation

pip3 install -U allocine

You can also use it with Docker. Have a look at this section

CLI tool usage

You just need to look for your theater identifier on allocine.fr.

Just search for your theater, and take note of the identifier in the URL. Here, it is P0645.

Theater identifier

Capture terminal

Help

seances.py --help
Usage: seances.py [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.

Basic usage

seances.py P2235

MJC Ciné 113, le 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 │
└──────────────────────────────────────────────────────────┴──────┴───────┴───────┴───────┴───────┘

For tomorrow, with interlines

seances.py P2235 -j+1 --entrelignes

MJC Ciné 113, le 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 │       │       │
└────────────────────────────────────────────────────┴──────┴───────┴───────┴───────┘

For a specific date

seances.py P2235 --jour 29/12/2018

For the full week

seances.py P2235 --semaine

Package usage

# -*- coding: utf-8 -*-
from allocine import Allocine

a = Allocine(theater_id="P2235")

for showtime in a.theater.program.showtimes:
    print(showtime)

Example output :

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)
[...]

Docker

You can use the seances tool with the Docker image

You may execute :

docker run -it --rm thibdct/seances P2235

The Docker image is built on top of Google Distroless image, so it is tiny :)

🤘 The easy way 🤘

I also built a bash wrapper to execute the Docker container easily.

Install it with :

curl -s https://raw.githubusercontent.com/tducret/allocine-python/master/seances \
> /usr/local/bin/seances && chmod +x /usr/local/bin/seances

You may replace /usr/local/bin with another folder that is in your $PATH

Check that it works :

On the first execution, the script will download the Docker image, so please be patient

seances --help
seances P2235 -j+1 --entrelignes

You can upgrade the app with :

seances --upgrade

and even uninstall with :

seances --uninstall