cinemasdk 0.0.4

Software Development Kit (SDK) for MovieLens API Analyst et Scientists

MovieLens SDK - cinemasdk

Un SDK Python simple pour interagir avec l’API REST MovieLens. Il est conçu pour les Data Analysts et Data Scientists, avec une prise en charge native de Pydantic, dictionnaires et DataFrames Pandas.

---

Créé et maintenu par

• Attemene Kouassi

Installation

pip install cinemasdk

---

Configuration

from filmsdk import MovieClient, MovieConfig

# Configuration avec l’URL de votre API (Render ou locale)
config = MovieConfig(movie_base_url="https://movie-backend-xelv.onrender.com")
client = MovieClient(config=config)

---

Tester le SDK

1. Health check

client.health_check()
# Retourne : {"status": "ok"}

2. Récupérer un film

movie = client.get_movie(1)
print(movie.title)

3. Liste de films au format DataFrame

df = client.list_movies(limit=5, output_format="pandas")
print(df.head())

---

Modes de sortie disponibles

Toutes les méthodes de liste (list_movies, list_ratings, etc.) peuvent retourner :

• des objets Pydantic (défaut)
• des dictionnaires
• des DataFrames Pandas

Exemple :

client.list_movies(limit=10, output_format="dict")
client.list_ratings(limit=10, output_format="pandas")

---

Tester en local

Vous pouvez aussi utiliser une API locale :

config = MovieConfig(movie_base_url="http://localhost:8000")
client = MovieClient(config=config)

---

Public cible

• Data Analysts
• Data Scientists
• Développeurs Python

---

Licence

MIT License

---

Liens utiles

• API Render : https://movie-backend-xelv.onrender.com
• PyPI : https://pypi.org/project/filmsdk