Error in numexpr.validate documentation

Đang mở Phù hợp với người mới
#573 1 bình luận 0 reaction 0 người được giao Xem trên GitHub

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

Từ ngày 11/10/2026.

  • #580 của @syahra712 — đ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
74/100
Loại issue
Tài liệu
Độ rõ ràng
Khá rõ ràng
Mức độ hoạt động
Sôi nổi
Công nghệ
python
Lĩnh vực
documentation

Hướng nghiên cứu

Bắt đầu với phần được liên kết trong NumExpr User Guide và kiểm tra hành vi của validate được mô tả trong issue. Cập nhật tài liệu để phân biệt chính xác giữa việc trả về một đối tượng exception và việc raise một exception, sau đó xác nhận rằng guide được render phản ánh thay đổi này.

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

Mô tả

Hi there,

The NumExpr User Guide mentions:

It is also possible to use NumExpr to validate an expression:
ne.validate('2*a + 3*b')
which returns None on success or raises an exception on invalid inputs.

However after using the function, I realised this isn't true. For example, this snippet does not raise an exception.

import numexpr as ne

try:
    ne.validate("Invalid input!!!")
except:
    print("Exception")
    exit()

print("No exception...")

After digging a bit deeper in the numexpr.validate() source code, I realised that the exception object is being returned, and not raised. I'm not sure if that is an issue or not, but I thought the documentation wording was a bit misleading, so I thought to make an issue of this.

Sorry if it doesn't apply

Ngôn ngữ chính
Python
Star
2.5k
Fork
235
Chỉ số merge pull request
Không có pull request nào được merge trong 30 ngày

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

Dự án này không cung cấp dev container, Dockerfile hay hướng dẫn đóng góp, nên bạn cần tự thiết lập môi trường: hãy bắt đầu từ README và xem hướng dẫn đóng góp lần đầu của chúng tôi để biết các bước chung.

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 pydata/numexpr

Tất cả issue của pydata/numexpr

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.