Ecole Directe API
A fully async and easy to use API client for the Ecole Directe API. This package is mainly used by Home Assistant, to offer the Ecole Directe integration. If you want to use this package in your own project, you can look at the Home Assistant Code for more examples.
License: GNU Lesser General Public License v3 or later (LGPL-3.0-or-later)
Documentation: https://ecoledirecte-api.readthedocs.io.
Features
Asynchronous client for authenticating with the Ecole Directe API.
Access to messages, homework, grades, school-life records, and timetables.
Access to account services such as wallet balances, surveys, forms, and workspaces.
Automatic re-authentication for supported operations after session errors.
Installation
$ pip install ecoledirecte
Python compatibility
This package requires Python 3.14 or later, below Python 4.0. This minimum is intentional: the package is primarily used by Home Assistant and follows its Python compatibility requirements.
Getting started
import asyncio
from ecoledirecte_api.client import EDClient
async def main():
async with EDClient("username", "password", {}) as client:
await client.login()
homework = await client.get_homeworks("student_id")
print(homework)
if __name__ == "__main__":
asyncio.run(main())
Replace the credentials and student ID with your own. If your account requires QCM verification, provide the corresponding answers in the client’s qcm_json argument.
Development - DevContainer (recommended)
If you use Visual Studio Code with Docker or GitHub CodeSpaces, you can leverage the available devcontainer. This will install all required dependencies and tools and has the right Python version available. Easy!
Credits
This package was created with Cookiecutter and the audreyr/cookiecutter-pypackage project template.
Metadata
Release files for ecoledirecte 0.4.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| ecoledirecte-0.4.2.tar.gz | 12.9 kB | With provenance | Details for ecoledirecte-0.4.2.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| ecoledirecte-0.4.2-py3-none-any.whl | Python 3 | none | any | Details for ecoledirecte-0.4.2-py3-none-any.whl |
Total release size: 25.9 kB
Release files / ecoledirecte-0.4.2.tar.gz
| Download URL | ecoledirecte-0.4.2.tar.gz |
|---|---|
| Size | 12.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
1ece8c8e2412ad281c5e737b3cd152188eebf5a402d30f08fc3d1d3e51d588ae
|
|
BLAKE2b-256 checksum How to use checksums |
7bdf3a315928e94ba9935d07e8047243e3053f8007f62badcbc39cc98f554edb
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 7, 2026.
Transparency logRelease files / ecoledirecte-0.4.2-py3-none-any.whl
| Download URL | ecoledirecte-0.4.2-py3-none-any.whl |
|---|---|
| Size | 13.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
aa9072a3c48b4a00fdad974e01badcb867505ae73c8726a4013fd03085213d04
|
|
BLAKE2b-256 checksum How to use checksums |
8d456260d751e2e08a3de7331a542d885013143bf23d287d26f3e21969185c40
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 7, 2026.
Transparency logSecurity for ecoledirecte 0.4.2
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
Both files in this release have been uploaded with provenance metadata.
Attestation for ecoledirecte-0.4.2.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 7, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.