Skip to content

v0.1.1

Latest

Choose a tag to compare

@IdrissaMaiga IdrissaMaiga released this 01 Sep 19:53
· 1 commit to main since this release

v0.1.1 — two-factor login support

Universities such as the University of Debrecen require an authenticator-app code on every login. Their Neptun answers a correct password with HTTP 202 and isTwoFactorRequired: true; 0.1.0 treated that as an error.

  • authenticate(totp_code=...) re-sends the login with the 6-digit code, mirroring the official web client.
  • NeptunAPI(..., two_factor_callback=...) prompts for a code whenever the client needs to (re-)authenticate.
  • NeptunAPI(..., totp_secret=...) generates codes automatically (dependency-free RFC 6238 generate_totp).
  • New NeptunTwoFactorRequired / NeptunCaptchaRequired exceptions with actionable messages.
  • MCP server: NEPTUN_TOTP_SECRET / --totp-secret.
  • README: two-factor section and the Debrecen base URL (https://www-h-ng.neptun.unideb.hu/hallgato_ng/api/).
pip install -U neptun-api