filmAneesdk 0.0.2

SDK Python pour accéder à l’API Film (Data Analysts/Data Scientists friendly)

MovieLens SDK - filmAneesdk

Un SDK Python simple pour interagir avec l’API REST Films. 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 filmAneesdk

---

Configuration

from filmAneesdk import MovieClient, MovieConfig

# Configuration avec l’URL de votre API (Render ou locale)
config = MovieConfig(movie_base_url="https://moovie-backend-1.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://moovie-backend-1.onrender.com
• PyPI : https://pypi.org/project/filmAneesdk/