sefaria.py

import requests, json

SEFARIA_API_BASE_URL = "https://sefaria.org"

def _get_request_json_data(endpoint, ref=None, param=None):
    """
    Helper function to make GET requests to the Sefaria API and parse the JSON response.
    """
    url = f"{SEFARIA_API_BASE_URL}/{endpoint}"

    if ref:
        url += f"{ref}"

    if param:
        url += f"?{param}"

    try:
        response = requests.get(url)
        response.raise_for_status()  # Raise an exception for bad status codes
        data = response.json()
        return data
    except requests.exceptions.RequestException as e:
        print(f"Error during API request: {e}")
        return None
    

def get_text(reference: str) -> str:
    """
    Retrieves the text for a given reference.
    """
    return str(_get_hebrew_text(reference))


def get_weekly_parasha():
    """
    Retrieves the weekly Parasha data using the Calendars API.
    """
    data = _get_request_json_data("api/calendars")

    if data:
        calendar_items = data.get('calendar_items', [])
        for item in calendar_items:
            if item.get('title', {}).get('en') == 'Parashat Hashavua':
                parasha_ref = item.get('ref')
                parasha_description = item.get('description', {}).get('he')
                parasha_name_he = item.get('displayValue', {}).get('he')
                return {
                    "ref": parasha_ref,
                    "description": parasha_description,
                    "name_he": parasha_name_he
                }
    
    print("Could not retrieve Parasha data.")
    return None


def _get_hebrew_text(parasha_ref):
    """
    Retrieves the Hebrew text and version title for the given verse.
    """
    data = _get_request_json_data("api/v3/texts/", parasha_ref)

    if data and "versions" in data and len(data['versions']) > 0:
        he_pasuk = data['versions'][0]['text']
        return  he_pasuk
    else:
        print(f"Could not retrieve Hebrew text for {parasha_ref}")
        return "Text Not Found"


def get_commentaries(parasha_ref)-> list[str]:
    """
    Retrieves and filters commentaries on the given verse.
    """
    data = _get_request_json_data("api/related/", parasha_ref)

    commentaries = []
    if data and "links" in data:
        for linked_text in data["links"]:
            if linked_text.get('type') == 'commentary':
                commentaries.append(linked_text.get('sourceHeRef'))

    return commentaries