tse-dara 0.5.0a1

بسته افزایشی برای نسخه 0.4.0a2. فقط فایل‌های جدید و تغییرکرده ارسال شده‌اند. پوشه قبلی و پایگاه داده را حذف نکنید.

نصب و آزمون

فایل‌ها را روی پوشه tse-dara ادغام و جایگزین کنید. در همان محیط فعال پروژه:

python tools/check_patch_0_5.py

python install.py

python tools/check_release_0_5.py

پس از نصب، کرنل ژوپیتر را Restart کنید. نصاب فایل Wheel صحیح را از BUNDLE.json انتخاب می‌کند. نیازی به حذف Wheelهای قبلی نیست.

آزمون واقعی با اتصال مستقیم، فقط با دستور صریح:

python tools/check_release_0_5.py --live --direct

شروع ساده

from tse_dara import data



# Execute before the first default-client call, e.g. in a fresh kernel.

data.setup(network='direct')

df = data.history('فولاد', start='1403-01-01', end='1403-12-30')

display(data.select(df, ['date', 'symbol', 'closing_price']))

گزینه direct انتخاب صریح کاربر است؛ اعتبارسنجی TLS غیرفعال نمی‌شود. پراکسی بدون اجازه دور زده نمی‌شود.

دریافت گروهی و ادامه عملیات

job = data.download(

    ['فولاد', 'شستا'],

    start='1403-01-01', end='1403-12-30',

    checkpoint_dir='dara_jobs', on_error='collect',

)

display(job.data)

display(job.requests)

display(job.errors)

exports = data.export_many(job, 'outputs', formats=['csv', 'excel'], overwrite=True)

ادامه از checkpoint به معنی دریافت تازه نیست. نتیجه علامت کش و قدیمی‌بودن دارد. resume=False یا FetchPolicy.fresh() بازاستفاده از checkpoint را متوقف می‌کند.

محدودیت‌های مهم

- این نسخه فقط بخش داده را توسعه می‌دهد؛ تحلیل و هوش مصنوعی اضافه نشده است.

- get_instruments نمادهای دیده‌بان فعلی را می‌دهد؛ فهرست کامل تاریخی نیست.

- تشخیص روزهای فاقد داده به تقویم صریح کاربر نیاز دارد؛ تعطیلی و توقف حدس زده نمی‌شود.

- تاریخچه مظنه، تغییرات گزارش‌شده است؛ تصویر کامل دفتر سفارش‌ها ساخته نمی‌شود.

- بی‌اعتباربودن معامله حدس زده نمی‌شود؛ cancellation_state=unknown می‌ماند.

- adjustment='source' خروجی تعدیل‌شده سرویس نمودار است؛ تضمین بازده کل یا داده نقطه‌درزمان نیست. قیمت خام حفظ می‌شود.

- get_futures از درگاه جداگانه webgw.tse.ir است و آزمایشی محسوب می‌شود؛ خروجی آن به TSETMC نسبت داده نمی‌شود.

- کش خام برای خانواده‌های جدید فعال است؛ دفتر اصلاحات روزانه همچنان مخصوص قیمت خام سهام است.

- افزودن تابع، موفقیت زنده سرور یا تکمیل کل تاریخچه را اثبات نمی‌کند.

مرجع امضاها و نوع ورودی/خروجی: docs/RELEASE_0_5_API_FA.html

API Reference