[Bug Report] `TransformerBridge.boot_*` methods are invisible to static type checkers

Đang mở Phù hợp với người mới
  • Có gì không ổn?
#1,980 0 bình luận 0 reaction 0 người được giao Xem trên GitHub

Maintainer thường phản hồi trong vòng 1 ngày

@koriyoshi2041 đang làm issue này rồi.

Từ ngày 5/11/2026.

  • #1981 của @koriyoshi2041 — đang mở

Đánh giá

Độ khó
2/5
Thời gian dự kiến
1-3 giờ
Mức phù hợp với người mới
76/100
Loại issue
Lỗi
Độ rõ ràng
Khá rõ ràng
Mức độ hoạt động
Sôi nổi
Công nghệ
python
Lĩnh vực
developer-experience, tooling

Hướng nghiên cứu

Đọc transformer_lens/model_bridge.py và ba vị trí mã nguồn được nêu trong báo cáo: sources/transformers/__init__.py:31, sources/native/__init__.py:115 và sources/tl_legacy.py:226. So sánh các chữ ký của boot_* và quyết định cách cung cấp chúng cho trình kiểm tra kiểu tĩnh trong khi vẫn giữ nguyên hướng import từ bridge đến các nguồn. Hoàn tất khi các lời gọi như TransformerBridge.boot_native(cfg) được nhận diện và có giá trị trả về được định kiểu.

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

Mô tả

bug complexity-simple TransformerBridge

boot_transformers, boot_native and boot_tl_legacy are attached to TransformerBridge at import time with setattr(TransformerBridge, "boot_...", staticmethod(boot)), in sources/transformers/__init__.py:31, sources/native/__init__.py:115 and sources/tl_legacy.py:226. Because the class body never declares them, static type checkers flag every call, even though the package ships py.typed:

from transformer_lens.model_bridge import TransformerBridge
model = TransformerBridge.boot_native(cfg)
# ty: Class `TransformerBridge` has no attribute `boot_native`

It also means no autocomplete and an untyped return value in editors.

Workaround: from transformer_lens.model_bridge.sources import boot_native. This works and is fully typed.

Possible fixes, which keep the bridge → sources import direction intact:

  • Declare the methods on the class under if TYPE_CHECKING:, using the source signatures, or
  • Define them as real @staticmethods on TransformerBridge that lazily import and delegate to the source boot.

Versions: transformer-lens 4.3.0, ty 0.0.97, Python 3.14

Ngôn ngữ chính
Python
Star
3.9k
Fork
708
Merge trung bình
1 ngày 4 giờ
Pull request đã merge (30 ngày)
87

Chuẩn bị môi trường

Mở trong Codespaces

Khởi chạy dev container của dự án ngay trên trình duyệt, bằng tài khoản GitHub của bạn.

  • Không có Dockerfile hay tệp Docker Compose
  • Có mẫu pull request
  • Không có 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.

Issue khác của TransformerLensOrg/TransformerLens

Tất cả issue của TransformerLensOrg/TransformerLens

Issue tương tự

Thêm issue về Python

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.