MovieLens SDK - alimiji_filmns_sdk

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.

Installation

pip install alimiji_filmns_sdk

Configuration

from alimiji_filmns_sdk import MovieClient, MovieConfig

# Configuration avec l’URL de votre API (Render ou locale)
config = MovieConfig(movie_base_url="https://datascience-movie-backend.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
• Étudiants et curieux en Data
• Développeurs Python

Licence

MIT License

Liens utiles

• API Render : https://datascience-movie-backend.onrender.com
• PyPI : https://pypi.org/project/alimiji-filmns-sdk