hmoviessdk 0.0.2

Python SDK for accessing the MovieLens API (Data Analysts/Data Scientists friendly)

MovieLens SDK - hmoviessdk

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, dictionnary and Pandas DataFrames.

---

Installation

pip install hmoviessdk

---

Configuration

from hmoviessdk import MovieClient, MovieConfig

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

---

Test the SDK

1. Health check

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

2. Retrieve a movie

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

3. List of movies in DataFrame format

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

---

Output mode available

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

• Pydantic object (défaut)
• dictionnary
• Pandas DataFrames

Example :

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

---

Local test

You can also use local API :

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

---

Target audience

• Data Analysts
• Data Scientists
• Students in Data
• Python Developers

---

Licence

MIT License

---

Useful Links

• API Render : https://api-architecture.onrender.com
• PyPI : https://pypi.org/project/hmoviessdk/