filmsdk-ibrahim 0.0.2

Python SDK to access API MovieLens

MovieLens SDK - filmsdk-ibrahim

A simple Python SDK to interact with the MovieLens REST API. It is designed for Data Analysts and Data Scientists, with native support for Pydantic, dictionaries, and Pandas DataFrames.

---

Installation

pip install filmsdk-ibrahim

---

Configuration

from filmsdk-ibrahim import MovieClient, MovieConfig

# Configuration with your API URL (Render or local)
config = MovieConfig(movie_base_url="https://backend-cinema-96tw.onrender.com")
client = MovieClient(config=config)

---

Test SDK

1. Health check

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

2. Get a film

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

3. List of films in DataFrame format

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

---

Available output modes

All listing methods (list_movies, list_ratings, etc.) can return:

Pydantic objects (default)

Dictionaries

Pandas DataFrames

Example :

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

---

Test on local machine

You can also use a local API :

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

---

Liens utiles

• API Render : https://backend-cinema-96tw.onrender.com
• PyPI : https://pypi.org/project/filmsdk-ibrahim/0.0.1/