v2.1

Welcome to PESUAuth v2.1.0 🚀

We're thrilled to announce PESUAuth v2.1.0, an update building on the modernization introduced in v2.0. This release focuses on asynchronous resilience, developer tooling, and smarter automation, making PESUAuth lighter, faster, and more production-ready than ever.

⚡ Async, Lightweight, Automated.

FastAPI was just the beginning — now we go further.

🔁 Improvement	Details
Async Enhancements	Refactored for fully async-safe execution across the stack
Docker Optimization	Reduced image size for faster CI/CD deployments
Parsing Reliability	Deterministic profile parsing for consistent output
Background Resilience	Automatic CSRF token refresh job to maintain sessions
Tooling	New PR templates, issue templates, and stricter CI checks
Documentation & DX	Improved contributor workflows in CONTRIBUTING.md

⚙️ Key Improvements

• ✅ Asynchronous refactor for improved concurrency
• ✅ Deterministic parsing of profile fields (no more random order)
• ✅ Background CSRF token refresh loop to keep sessions warm (#89)
• ✅ Smaller Docker image footprint for faster builds
• ✅ 100% test coverage (95% minimum enforced)
• ✅ New GitHub automation — PR source checks and updated staging deployment flows

🧭 Migration Notes

• No breaking API changes — /authenticate and /readme endpoints behave the same.
• Default CSRF token is now auto-refreshed in the background; no manual calls required.
• The deprecated branch-short-code mapping is now fully removed.
• Docker users benefit from reduced image size automatically.

🧪 Testing and Compatibility

• Near 100% test coverage achieved, with stricter CI enforcement.
• New custom exceptions improve error handling consistency.
• All staging and deployment workflows have been revalidated end-to-end.

📚 Docs

• Contributor documentation now details dev vs prod workflows.
• Updated README with live images and contributor badges.

---

Huge thanks to our contributors for making this possible!

Contributors

• Async refactor and automation: by @aditeyabaral in #79, #83, #84-#88
• Deterministic parsing: by @woterr in #81 and deployed by @aditeyabaral in #91
• CSRF token background refresh: by @Spinicle in #109
• Docker image optimizations: by @joshua-rajj in #82
• Custom exceptions: by @abaksy in #60
• Testing and CI updates: by @saiX4, @achyu-dev, and @ndigvijay in #61, #96, and #111
• Docs and contributor updates: by @SakshamBajpayi, @dotpmm, @silicoflare, and others.

Full Changelog: v2.0.0...v2.1

Full Release Notes

• Update Lint Status Badge on README to reflect new ruff linter by @achyu-dev in #59
• fix: use direct image URLs instead of local paths in README.html by @silicoflare in #62
• Increase Test Coverage to 100% and updated Minimum Requirement to 95% by @saiX4 in #61
• Add PR template and GitHub Action to check for PR source by @aditeyabaral in #63
• Update PR workflow to close the PR by @aditeyabaral in #66
• Remove comment and PR closing logic in origin checks by @aditeyabaral in #67
• Added issue templates and moved CONTRIBUTING.md to .github by @aditeyabaral in #68
• Fix formatting errors by @ndigvijay in #70
• Implement custom exceptions by @abaksy in #60
• PESUAuth v2.1 - Refactor for Async Support by @aditeyabaral in #79
• Decreased Docker image size ( #71 ) by @joshua-rajj in #82
• Update benchmark scripts by @aditeyabaral in #83
• Updated workflows for staging deployments by @aditeyabaral in #84
• Updated workflows for staging deployments (#84) by @aditeyabaral in #85
• Updated workflows for staging deployments (#84) (#85) by @aditeyabaral in #86
• Updated workflows for staging deployments (#84) (#85) (#86) by @aditeyabaral in #87
• Updated workflows for staging deployments (#84) (#85) (#86) (#87) by @aditeyabaral in #88
• Deterministic parsing #75 by @woterr in #81
• Removed the depreciated details field by @dotpmm in #90
• Deploy Deterministic Parsing of Profile and update README by @aditeyabaral in #91
• Sync main with dev branch by @ndigvijay in #92
• Sync main into dev by @achyu-dev in #94
• Contributing.md update to include dev and prod workflows by @achyu-dev in #96
• Contributing.md update to include dev and prod workflows (#96) by @aditeyabaral in #97
• Add script to auto sync dev with main by @aditeyabaral in #98
• Add script to auto sync dev with main by @aditeyabaral in #99
• Update sync.yaml by @aditeyabaral in #100
• Update sync.yaml by @aditeyabaral in #101
• Update sync.yaml by @aditeyabaral in #102
• Update sync.yaml by @aditeyabaral in #103
• Sync main to dev (test) by @aditeyabaral in #104
• Update CONTRIBUTING.md by @aditeyabaral in #105
• Update sync.yaml by @aditeyabaral in #106
• updated contributor badge to show all contributor by @SakshamBajpayi in #110
• Added automatic CSRF token refresh background job - #89 by @Spinicle in #109
• Deprecate branch-short-code mapping by @ndigvijay in #58
• Deprecates branch_short_code, auto-refreshes default CSRF token and updates contributor section on README by @ndigvijay in #111

New Contributors

• @saiX4 made their first contribution in #61
• @abaksy made their first contribution in #60
• @joshua-rajj made their first contribution in #82
• @woterr made their first contribution in #81
• @dotpmm made their first contribution in #90
• @SakshamBajpayi made their first contribution in #110
• @Spinicle made their first contribution in #109

PESUAuth v2.0

Welcome to PESUAuth v2.0.0 🚀

We're excited to announce the release of PESUAuth v2.0.0, a major refactor that brings the codebase up to date with modern Python tooling and frameworks! 🎉

This version focuses on performance, developer experience, and future-proofing the project by replacing legacy dependencies with modern, async-ready alternatives.

🆕 Modern Ecosystem.

Flask is so 2020. Welcome to FastAPI.

🔁 Migration	From → To
Web Framework	Flask + Flasgger → FastAPI
HTTP Client	requests → httpx
HTML Parser	BeautifulSoup (lxml) → selectolax
Validation	Manual validation → Pydantic
Dependency Management	requirements.txt → uv (w/ lockfile)

⚙️ Key Improvements

• ✅ Asynchronous support for faster HTTP and IO operations
• ✅ Built-in OpenAPI docs at / thanks to FastAPI
• ✅ Faster HTML parsing via selectolax
• ✅ Robust request validation using Pydantic models
• ✅ Cleaner codebase with type hints and declarative logic
• ✅ Modern dependency management using uv

🧭 Migration Notes

• The /authenticate and /readme endpoints remain unchanged in behavior but are now backed by FastAPI.
• Legacy requirements.txt is still available for Docker-based workflows, but uv is now the preferred method for local development.
• All functionality is preserved, with improved error handling and validation.

🧪 Testing and Compatibility

• All existing tests were updated to reflect the FastAPI and Pydantic interfaces.
• Functional and integration test coverage expanded across endpoints and input validation paths.

📚 Docs

• Interactive API docs now available at:

  • / (Swagger UI)
  • /redoc (ReDoc)

---

This release is the culmination of a focused effort to modernize PESUAuth’s backend infrastructure. Many thanks to everyone involved in this refactor!

Contributors:

• Refactor: Migrate core authentication from requests and BeautifulSoup to httpx and selectolax by @aditeyabaral in #47
• Added validation using Pydantic by @ndigvijay in #48
• Add CONTRIBUTING.md, refactor and clean up directories by @achyu-dev in #51
• Update app to use FastAPI instead of Flask and Flasgger by @silicoflare in #53

Full Changelog: https://github.com/pesu-dev/auth/commits/v2.0.0