Tạo Library
Cách xuất bản và import các library PyneScript V6 tái sử dụng — export có phiên bản, enum type, và selective import binding.
Hợp đồng Library#
- Bắt buộc:
library(...). - Khuyên dùng: export các helper nhỏ, tái sử dụng được hoặc enum type.
- Không cần thiết:
build_indicator_frame,build_signal_frame, hoặc trực quan hóa chart. - Import thông qua
import_library(...)hoặclibrary_import(...).
Library nên tối ưu cho điều gì#
Giữ code library mang tính tất định, hẹp và tái sử dụng được. Nó nên sở hữu logic helper như giải quyết độ dài, gán nhãn xu hướng, helper chuyển đổi, hoặc tiện ích tín hiệu dùng chung — không phải render chart hay mapping strategy.
Các hàm Import#
library_import(name, version=None, exports=None, alias=None)#
Giải quyết một library ATK PyneScript đã xuất bản, xác thực export, ghi metadata vào script context, và trả về một đối tượng namespace chứa các callable đã chọn.
import_library(spec, exports=None, alias=None)#
Wrapper tiện lợi trên library_import. Sử dụng khi library spec đã mã hóa sẵn tên và thông tin phiên bản bạn muốn.
Việc import library nhận biết phiên bản, các callable được export được phát hiện từ module đích, export thiếu sẽ gây ra error, và một library không thể tự import chính nó.
Các library đã xuất bản có thể export callable và enum type. Selective import như Pyne Enum Utils@1::TrendMode,resolve_length được hỗ trợ trong các file Python thuần thông qua import_library(...). Cú pháp import dạng quoted cũng được hỗ trợ, nhưng chỉ sau khi editor tiền xử lý source thành Python hợp lệ.
Khai báo Library và Pattern Import#
from source import library, import_library
library("Pyne Utils", version=2, overlay=False)
def plus_one(value):
return int(value) + 1
# In another script
utils = import_library("Pyne Utils@2", exports=["plus_one"])
result = utils.plus_one(41)