…rations

- Introduced `SessionContextHolder` to manage SQLAlchemy sessions using context variables.
- Added `Transactional` decorator to ensure session commits and rollbacks during CRUD operations.
- Refactored `CrudRepository` methods to utilize the new session management, enhancing code clarity and reducing session handling boilerplate.
- Updated tests to reflect changes in the repository methods, ensuring proper functionality without session parameters.

…Management

- Updated CRUD methods in `PySpringModelRestService` and `CrudRepositoryImplementationService` to use `SessionContextHolder` for session handling, replacing the previous context manager approach.
- Added `@Transactional` decorator to relevant methods to ensure proper transaction management.
- Enhanced error handling in the `Transactional` decorator to raise specific exceptions.
- Updated tests to clear session state before and after tests to maintain isolation and prevent side effects.

…iguration for clarity

- Implement outermost transaction detection using SessionContextHolder.has_session()
- Session lifecycle (commit/rollback/close) only managed by outermost @transactional
- Nested @transactional methods reuse existing session without interference
- Prevent premature session closure in nested transaction scenarios
- Maintain transaction integrity across multiple decorated method calls

…` for improving readability.

… session management

- Removed commented-out explanations for clarity.
- Streamlined the docstring to focus on the transaction behavior of the decorator.

- Added TransactionalDepth enum to define transaction levels.
- Enhanced SessionContextHolder with methods to manage session depth.
- Updated @transactional decorator to utilize session depth for commit/rollback operations.
- Introduced tests for session depth tracking and behavior in nested transactions.

- Changed the condition for clearing the session from checking if the depth is 0 to using TransactionalDepth.ON_EXIT.value for better clarity and alignment with transaction management.

…ved transaction management

- Added @transactional decorator to multiple CRUD methods in CrudRepository to ensure proper transaction handling.
- Updated commit logic in PySpringSession to warn against committing managed transactions.
- Refactored clone method in PySpringModel to return the correct type.
- Improved logging during session commit in PySpringModel for better clarity.
- Introduced a method in SessionContextHolder to check if a transaction is managed.

- Introduced TypeVar for PySpringModel to improve type hinting in the clone method.
- Updated the clone method signature to return the correct type, enhancing clarity and type safety.

…and session context

- Introduced __version__ attribute to specify the current version of the package.
- Updated __all__ to include Query for better module accessibility.