schoolmospy 0.2.5

A lightweight async Python wrapper for school.mos.ru APIs

📕 SchoolMosPy

SchoolMosPy is a lightweight async Python wrapper for school.mos.ru APIs. It provides a simple and intuitive interface to interact with the Moscow School Electronic Diary platform.

✨ Features

• Async architecture - built on aiohttp and httpx for high performance
• Type safety - uses pydantic for data validation
• Simple API - intuitive interface for working with data
• Full-featured - access to marks, homeworks, events, meals, and profile data

📋 Requirements

• Python 3.12+
• aiohttp >= 3.12.15
• pydantic >= 2.11.9
• httpx >= 0.28.1

📦 Installation

pip install schoolmospy

🚀 Quick Start

import asyncio
from schoolmospy import StudentClient

async def main():
    # Create client
    client = StudentClient(
        token="your_token",
        profile_id=12345
    )

    # Get profile
    profile = await client.get_me()
    print(f"Name: {profile.name}")

    # Get marks
    marks = await client.marks.get(
        from_date="2024-01-01",
        to_date="2024-12-31"
    )

    # Get homeworks
    homeworks = await client.homeworks.get(
        from_date="2024-01-01",
        to_date="2024-12-31"
    )

    # Get events/schedule
    events = await client.events.get(
        from_date="2024-01-01",
        to_date="2024-12-31"
    )

    await client.close()

asyncio.run(main())

🧪 Live Test Script

Run the live script for new endpoint:

python test.py

Fill values in test.py first:

• TOKEN
• PROFILE_ID
• PERSON_ID (contingent GUID)

📝 License

This project is licensed under the GPL-3.0 License. See the LICENSE file for details.

🔗 Links

• Documentation
• Report an Issue

👨‍💻 Author

Ivan Kriventsev - [e-mail]

---