Update repo to python 312

[amrit110]

This pull request makes several important updates focused on modernizing the codebase, improving compatibility, and streamlining the documentation build and deployment process. The most significant changes include upgrading the project to Python 3.12, adopting newer Python type hint syntax, refactoring the documentation CI workflows, and making minor code and typing improvements across the codebase.

CI/CD and Documentation Workflow Updates:

• Consolidated and refactored documentation build and deployment workflows into a single .github/workflows/docs.yml file, replacing the previous separate docs_build.yml and docs_deploy.yml workflows. The new workflow uses standard GitHub-hosted runners, builds documentation with mkdocs, and deploys to GitHub Pages, simplifying the CI process and removing coverage upload steps from the docs workflow. [1] [2] [3]
• Updated the integration tests workflow to use ubuntu-latest runners instead of self-hosted runners, improving portability and maintainability.

Python Version and Typing Modernization:

• Upgraded the project to Python 3.12 by updating .python-version, enabling the use of newer language features and type hint syntax.
• Refactored type hints throughout the codebase to use Python 3.10+ syntax (e.g., list[str] instead of List[str], | None instead of Optional), and removed now-unnecessary imports from typing. [1] [2] [3] [4] [5] [6] [7] [8] [9] [10] [11]

Code Quality and Minor Improvements:

• Improved error messages and type safety, such as providing clearer error messages for invalid file formats in QueryInterface.save.
• Added # type: ignore comments in several places in cycquery/omop.py to suppress mypy typing errors for complex assignments. [1] [2] [3] [4] [5]
• Fixed SQLAlchemy table selection to avoid nested selects by unpacking columns explicitly in cycquery/mimiciv.py. [1] [2] [3]
• Updated pre-commit configuration: added --unsafe to check-yaml, removed unused nbqa-black hook. [1] [2]

Database Reflection and Connection Handling:

• Changed metadata reflection in _setup_table_methods to use a context-managed connection, improving reliability and compatibility with SQLAlchemy 2.x.