PyDara

Release 0.6.0a2. PyDara is a modular Python library for financial data. The PyPI distribution is named pydara; its Python import is pydara. The currently implemented public module is pydara.tse, providing TSETMC quotes, instrument lookup, history, market data, sync/async workflows, Pandas outputs, versioned SQLite storage and typed file exports.

Install

Requires Python 3.12 or newer. After publication on PyPI:

python -m pip install --upgrade pydara==0.6.0a2

Optional Excel, Parquet and notebook support:

python -m pip install --upgrade "pydara[files,notebook]==0.6.0a2"

For a local release bundle, activate your Python environment and run python install.py (--core-only omits optional file/notebook dependencies). Restart the Jupyter kernel after installation or upgrade.

Use

from pydara import tse

# Synthetic teaching data; no external request.
sample = tse.load_sample()
reference = tse.api_reference('instrument')

# Real data: network access or an eligible cache entry is required.
matches = tse.instrument(symbol="فولاد", on_multiple="all")
history = tse.history("فولاد", start="1403-01-01", end="1403-12-30")

from pydara.tse import Client, AsyncClient
from pydara.tse.exceptions import DaraError

Instrument lookup defaults to all matching rows. on_multiple="first" returns the first source-ordered match; "error" rejects ambiguity. on_conflict="error" checks supplied constraints. "ins_code" explicitly prioritizes a supplied instrument code.

Scope and data contracts

The TSE module includes public quotes/history, market watch, client types, indices, reported trades/books/states/thresholds, ownership/share counts, adjustment events, source-adjusted chart data, fund/NAV data, messages and options. Availability depends on the source endpoint. The separate futures exchange gateway is experimental. Current catalog coverage is not a complete historical instrument registry. Source-adjusted data does not certify total return or point-in-time history.

Analysis, ML, Bitcoin, exchange rates, gold and other countries' markets are planned extensions. They are not implemented modules in this release.

Importing pydara creates no network connection, database or worker thread. Explicit offline use is tse.FetchPolicy.offline(allow_stale=True). A queued storage receipt is not durable storage. Preserve the JSON sidecar when copying a CSV PyDara archive.

Upgrade to 0.6.0a2

The distribution, source package and Python import are all named pydara. Use from pydara import tse or import pydara.tse in every application and notebook. Exceptions are under pydara.tse.exceptions, with PyDaraError as the base error. New frame metadata uses frame.attrs['pydara']; new archives use pydara-frame. New caches use the pydara application directory and pydara.sqlite3 filename. Existing cache databases and archives can still be read; legacy identifiers are handled only for compatibility. Existing databases are not deleted or renamed. See migration instructions.

Documentation and development

• Persian guide
• API reference
• Roadmap
• Third-party notices

python -m pip install -e ".[test,files]" build twine
python tools/generate_api_reference.py
python -m build --wheel --outdir dist
python tools/update_bundle.py
python -m pytest -q

Offline/synthetic tests verify local contracts and do not certify live source accuracy or endpoint availability. The code is MIT licensed; data rights are separate from the code license.