python / python/cpython

Bad advice in DeprecationWarning about sqlite3 datetime adapter

Đang mở
#135,834 0 bình luận 12 reaction 0 người được giao Xem trên GitHub

Chưa có ai nhận issue này.

docs topic-sqlite3
Ngôn ngữ chính
Python
Star
77.2k
Fork
36k
Chỉ số merge pull request
Chỉ số pull request đang chờ

Mô tả

When using the datetime adapter of sqlite3, you'll get:

DeprecationWarning: The default datetime adapter is deprecated as of Python 3.12; see the sqlite3 documentation for suggested replacement recipes

The relevant documentation likely is located at https://docs.python.org/3/library/sqlite3.html#default-adapters-and-converters-deprecated

The suggested recipe likely is https://docs.python.org/3/library/sqlite3.html#sqlite3-adapter-converter-recipes

This recipe suggests modifying global state in the sqlite3 module. This is a no-go for libraries as two libraries registering adapters would quickly run into a conflict.

Please offer a recipe suitable for use in libraries or undeprecate the default adapters.

Hướng dẫn đóng góp

Mở hướng dẫn đóng góp

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Hướng nghiên cứu

Bắt đầu với các phần trong tài liệu sqlite3 về adapter và converter mặc định, cùng các recipe về adapter/converter được liên kết trong issue. Kiểm tra xem việc đăng ký toàn cục của recipe được đề xuất có phù hợp với mã thư viện hay không, sau đó xác định liệu tài liệu có cần một recipe an toàn cho thư viện hay liệu có nên xem xét lại deprecation hay không. Công việc được xem là hoàn tất khi hướng dẫn được yêu cầu hoặc quyết định về deprecation được phản ánh rõ ràng trong tài liệu sqlite3 và hành vi được hỗ trợ.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Đánh giá

Công nghệ
python
Lĩnh vực
databases, documentation
Loại issue
Tính năng
Độ khó
5/5
Thời gian dự kiến
Hơn một tuần
Mức độ hoạt động
Đình trệ
Độ rõ ràng
Khá rõ ràng
Mức phù hợp với người mới
35/100

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.