---
title: "Changelog 3.3.1"
description: "Release notes for ArchiPy 3.3.1"
---

# 3.3.1 — 2025-06-12

[← 3.4.0](3.4.0.md) | [3.3.0 →](3.3.0.md) | [↑ 3.x series](index.md)

## Improvements

### Keycloak Integration Enhancements

- **Enhanced error handling** - Added comprehensive custom error classes and centralized exception handling for better
  Keycloak error management and debugging
- **Improved error messaging** - Introduced `KeycloakErrorMessageType` enum for standardized error handling and clearer
  error messages
- **Extended functionality** - Added `get_realm` method to both synchronous and asynchronous Keycloak ports for better
  realm management
- **Optimized caching** - Updated cache clearing methods in Keycloak adapters for improved performance and reliability

### Datetime Utilities Enhancement

- **Enhanced datetime handling** - Significantly improved datetime utility functions with better timezone support, date
  parsing capabilities, and comprehensive validation for more robust date and time operations
- **Extended functionality** - Added new datetime manipulation methods and improved existing functions for better
  developer experience

### Elasticsearch Adapter Refinements

- **Improved adapter implementation** - Enhanced Elasticsearch adapter with better error handling, improved connection
  management, and optimized query performance
- **Configuration enhancements** - Refined Elasticsearch configuration options for more flexible deployment scenarios
  and better SSL/TLS support

### Configuration Management

- **Enhanced configuration templates** - Updated configuration templates with improved validation, better default
  values, and comprehensive documentation
- **Streamlined setup process** - Simplified configuration management for various adapters and services with clearer
  parameter definitions

### Testing & Quality Assurance

- **Enhanced test coverage** - Significantly improved Keycloak adapter feature tests and datetime utilities with
  comprehensive feature tests and better validation scenarios
- **Development environment** - Updated Keycloak and development configuration in test environment for improved local
  development experience
- **Documentation updates** - Enhanced API reference documentation and configuration guides for better developer
  onboarding

### Code Quality & Maintenance

- **Code organization** - Improved code structure and organization across multiple modules for better maintainability
- **Enhanced validation** - Added better input validation and error handling throughout the codebase

## Bug Fixes

- **Configuration cleanup** - Removed invalid imports and unused Elasticsearch configuration references to prevent
  import errors
- **Code optimization** - Removed redundant error handling code for cleaner and more maintainable codebase

## Community Contributions

- **Collaborative improvements** - Merged contributions from @Mohammadreza-kh94 for Keycloak enhancements and @heysaeid
  for configuration fixes
